KGerrow-esristaff

Find out what a user has been doing in your organization

Blog Post created by KGerrow-esristaff Employee on Mar 15, 2019

The History endpoint of the REST API is a great tool to dig into information about events occurring in your organization. Although you easily download a comprehensive CSV of events as an administrator in ArcGIS Online, the REST API, provides the option to customize the data returned and to ask more specific questions. For an example of how to use the history CSV, check out this blog: https://www.esri.com/arcgis-blog/products/arcgis-/administration/exploring-the-organization-activity-log-csv 

 

For this blog I am going to outline the query and results about a specific member of my ArcGIS Online organization.

 

Scenario: It’s time for Karate_Kelly’s year end review. She wants to prove to her boss that she has been busy creating and managing content in the organization. Using the History API, She’ll query all of the events that she has initiated in 2018.

 

Detective Steps:

  1. Formulate the Query

Url: https:/webapps.maps.arcgis.com/sharing/rest/portals/self/history?

Parameters:

all=true – returns events for all members in the organization

start=0 – Starts at the first record

num=10000 – largest amount of events returned (requires csv format)

f=csv – Returns result in a csv

sortOrder=asc – information output in ascending order

token = “6hVsODGfBpk5X_hGc0MOrnxmddIk4bL4hP8FyOAxM0QxL3VEw86iTdB” – admin token required

fromDate =2018-01-01 – start of date range

actors= Karate_KElly – events to be returned (Note, usernames are case sensitive, so if you hit a key by accident while creating your username, check the casing just to be sure... #Karate_KEllyIsNotAMistake)

 

Sample Url constructed:

https://webapps.maps.arcgis.com/sharing/rest/portals/self/history?all=true&start=0&actors=Karate_KElly&sortOrder=asc&fromDate=2018-01-01&num=10000&f=csv&token=Qian2inO2Cqf0tsljaLVJC5YbmjpQvg-CQ565QE75vesENzX5Yorf40K4ai_7fHn8

  1. Submit the request and view the resulting CSV
  2. Perform analysis or use pivot tables to provide insight into actions

 

ActionCount of Actions
Add412
Add Users7
Create12
Delete104
Failed Login15
Login192
Remove Users1
Share252
Update1448

 

Tracking my events by Month:

JanFebMarchAprilMayJuneJulyAugSeptOctNovDec
# of Actions10185727427614829149129101261445

Test: When did I go on Summer vacation last year?

 

This is a neat way to look at your actions and your organizations members actions over time.

 

*Note. Only available in ArcGIS Online

 

Generate a Token

Outcomes