How To: Identify Deprecated Web App Items in ArcGIS Enterprise

Summary

ArcGIS Enterprise 12.0 will include the removal and retirement of many features, including ArcGIS Web AppBuilder and ArcGIS Configurable Apps. With these web apps removed from the software, any web applications built using these apps will no longer be able to open, view, or edit in ArcGIS Enterprise 12.0. Therefore, all ArcGIS Web AppBuilder apps and Configurable Apps should be migrated to modern alternatives, such as ArcGIS Experience Builder and ArcGIS Instant Apps before upgrading to ArcGIS Enterprise 12.0 or later. This script will help with this process by identifying all web apps that will need to be migrated before upgrading to ArcGIS Enterprise 12.0 or later.

Procedure

To get an inventory of your web apps to migrate, follow these steps:

Download the Python script attached to this Knowledge Base article to the machine where your ArcGIS Enterprise environment (versions 11.5 and prior) is installed. If you are using a multi-machine deployment, download to the machine where Portal for ArcGIS is installed.
- Note, you will need permissions on this machine to run the script from the command prompt.
Once downloaded, edit the text file to provide the necessary parameters for the script. This will be your organization URL, and an administrator’s username and password. Save and close the file.
Open a command prompt and navigate to the directory where the script is saved.
- Example: cd C:Users\YourUserName\Downloads\retired_apps_cataloger.py
Run the Python script.
- Example: python retired_apps_cataloger.py
Once the script is complete, an Excel output will be provided with an inventory of your apps that need to be migrated.

The Excel output will include the following fields. Please refer to this table for the definition for each of these fields:

Field Name:	Definition
item_id	Item ID
title	Title of item
snippet	Short summary description of the service
type	Item type
access	Sharing level for item
url	URL for app
tags	Tags used for item
typeKewords	Used to identify if a web app is a Web AppBuilder App or Configurable App
itemUrl	URL for item page in ArcGIS Enterprise portal
numViews	Number of views for item
modified	Last modified date
lastEditDate	Last edited date
lastViewed	Last viewed date – only for ArcGIS Online
created	Date of item creation
protected	Indicates if Delete Protection is enabled
contentStatus	Indicates if item is Authoritative or Deprecated
owner	Owner of item
numberOfSharedGroups	Number of groups item is shared to
groups_	Names of groups item is shared to

After upgrading to ArcGIS Enterprise 12.0, or later, retired web app items will still exist in your ArcGIS Enterprise portal unless those items have been updated prior to upgrading. If you would like to identify retired items that can be deleted after upgrading to ArcGIS Enterprise 12.0, this script can be run again for an inventory of those retired app items.

For questions or feedback about using the script, comment on this Esri Community post or in this GitHub repository.  Cases related this the script are outside of the Scope of Support.  Formal bugs or enhancement requests cannot be logged against this script via Esri Technical Support.  If you have feedback for the script, please leave your ideas on this Esri Community post or in this GitHub repository.

Article ID: 000038795

Software: