Find out what a user has been doing in your organization

2583
7
03-15-2019 04:06 PM
KellyGerrow
Esri Frequent Contributor
3 7 2,583

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... 

 

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

https://community.esri.com/community/gis/web-gis/arcgisonline/blog/2019/03/16/generate-a-token?sr=se...

7 Comments
About the Author
I love interactive maps and apps on the internet! The maps and apps that customers create and share on the web, make my job awesome. I'm a Product Manager with the ArcGIS Online team in Redlands, California. I am a proud graduate from Carleton University and the COGS in Canada, with research focus' in Health Geography. Originally from Bedford, NS, Canada but have spent a lot of time in Haliburton and Ottawa, Ontario. I have a passion for the outdoors and dogs.
Labels