Add Portal Items To Catalog Dataset (Data Management)

Summary

Adds ArcGIS Online or ArcGIS Enterprise portal service items—such as feature, map, image, scene, and tile services—to an existing catalog dataset.

Usage

• This tool adds items from the active portal to a catalog dataset. The active portal is assumed from the application. See Access portal items and groups for more information.

• Items must be manually removed from the dataset's attribute table.

• If an item already exists in the catalog dataset, it will not be added again. Any skipped items will be included in the tool messages.

• After the target catalog dataset is specified, you can apply filters to only add certain items. You can filter items based on their data type, sharing level, organizational status, or spatial extent.

• To add portal items to a catalog dataset created in ArcGIS Pro 3.1, the dataset must be upgraded using the Upgrade Dataset tool.

• Items added to the catalog dataset must have an extent.

• OGC feature services, feature collections, table layers, elevation layers, and video layers are not supported and cannot be input as a portal item type.

Parameters

Dialog

Label	Explanation	Data Type
Target Catalog Dataset	The catalog dataset to which portal items will be added.	Catalog Layer
Input portal item types (Optional)	Specifies the item types that will be added to the catalog dataset from the portal. All supported item types will be added by default. Feature layers—Feature layers will be added. This option does not add feature collections. Imagery layers—Imagery layers will be added. Map image and tile layers—Map image and tile layers will be added. Scene layers—Scene layers will be added. Vector tile layers—Vector tile layers will be added. Web Feature Service (WFS) layers—Web Feature Service (WFS) layers will be added. Web Map Service (WMS) layers—Web Map Service (WMS) layers will be added. Web Map Tile Service (WMTS) layers—Web Map Tile Service (WMTS) layers will be added.	String
Content (Optional)	Specifies the collection in the active portal from which items will be added to the catalog dataset. My Content— Items from your My Content collection will be added. This is the default. My Groups—Items from groups to which you belong will be added. My Organization—Items from your ArcGIS organization will be added.	String
Portal folders (Optional)	The portal folders from which items will be added to the catalog dataset.	String
Portal groups (Optional)	The portal groups from which items will be added to the catalog dataset.	String
Access level (Optional)	Specifies the sharing level that portal items must have to be added to the catalog dataset. Public— Items that are shared with the public will be added to the catalog dataset. This is the default. Organization—Items that are shared with the organization, as well as items you own will be added to the catalog dataset. Items that are shared with the organization and one or more groups will also be added. Shared—Items shared with one or more groups, item owners, and those who have access to the item through group membership will be added to the catalog dataset. Private—Items owned by you will be added to the catalog dataset. Only you or administrators who have access to your content can add these items.	String

Derived Output

Label	Explanation	Data Type
Output Catalog Dataset	The updated catalog dataset.	Catalog Layer

Python

arcpy.management.AddPortalItemsToCatalogDataset(target_catalog_dataset, {input_portal_itemtypes}, {content}, {portal_folders}, {portal_groups}, {access_level})

Name	Explanation	Data Type
target_catalog_dataset	The catalog dataset to which portal items will be added.	Catalog Layer
input_portal_itemtypes [input_portal_itemtypes,...] (Optional)	Specifies the item types that will be added to the catalog dataset from the portal. All supported item types will be added by default. FEATURE_SERVICE—Feature layers will be added. This option does not add feature collections. IMAGE_SERVICE—Imagery layers will be added. MAP_SERVICE—Map image and tile layers will be added. SCENE_SERVICE—Scene layers will be added. VECTOR_TILE_SERVICE—Vector tile layers will be added. WFS—Web Feature Service (WFS) layers will be added. WMS—Web Map Service (WMS) layers will be added. WMTS—Web Map Tile Service (WMTS) layers will be added.	String
content (Optional)	Specifies the collection in the active portal from which items will be added to the catalog dataset. MY_CONTENT— Items from your My Content collection will be added. This is the default. MY_GROUPS—Items from groups to which you belong will be added. MY_ORGANIZATION—Items from your ArcGIS organization will be added.	String
portal_folders [portal_folders,...] (Optional)	The portal folders from which items will be added to the catalog dataset.	String
portal_groups [portal_groups,...] (Optional)	The portal groups from which items will be added to the catalog dataset.	String
access_level (Optional)	Specifies the sharing level that portal items must have to be added to the catalog dataset. PUBLIC— Items that are shared with the public will be added to the catalog dataset. This is the default. ORG—Items that are shared with the organization, as well as items you own will be added to the catalog dataset. Items that are shared with the organization and one or more groups will also be added. SHARED—Items shared with one or more groups, item owners, and those who have access to the item through group membership will be added to the catalog dataset. PRIVATE—Items owned by you will be added to the catalog dataset. Only you or administrators who have access to your content can add these items.	String

Derived Output

Name	Explanation	Data Type
out_catalog_dataset	The updated catalog dataset.	Catalog Layer

Code sample

AddPortalItemsToCatalogDataset example 1 (stand-alone script)

This example adds image services that are located in the private SampleTestFolder portal folder to the SampleCatalog dataset.

import arcpy

target_catalog_dataset = r"C:/Dataspace/studyarea.gdb/SampleCatalog"
input_portal_itemtypes = "IMAGE_SERVICE"
content = "MY_CONTENT"
portal_groups = None 
portal_folders = "SampleFolder"
access_level = "PRIVATE"
arcpy.management.AddPortalItemsToCatalogDataset(target_catalog_dataset,
                                        input_portal_itemtypes, content, 
                                        portal_folders, portal_groups,
                                        access_level)

AddPortalItemsToCatalogDataset example 2 (stand-alone script)

This example adds scene and WFS services that belong to the SampleGroup group and are shared with the organization to the SampleCatalog dataset.

import arcpy

target_catalog_dataset = r"C:/Dataspace/studyarea.gdb/SampleCatalog"
input_portal_itemtypes = ["SCENE_SERVICE", "WFS"]
content = "MY_GROUPS"
portal_groups = "SampleGroup" 
portal_folders = None
access_level = "ORG"
arcpy.management.AddPortalItemsToCatalogDataset(target_catalog_dataset,
                                        input_portal_itemtypes, content,
                                        portal_folders, portal_groups,
                                        access_level)

Environments

Geographic Transformations, Extent

Special cases

Extent

If this environment is set to the Intersection of Inputs or the Union of Inputs option, this environment will be ignored.

Licensing information

• Basic: Yes
• Standard: Yes
• Advanced: Yes