Upload File To Portal (Data Management)

Summary

Uploads a file to the active portal.

Usage

• The following are supported file types:

  • Map (.mapx)
  • Layer (.lyrx)
  • Layout (.pagx)
  • PDF (.pdf)
  • Presentation (.prsx) (supported for ArcGIS Online and ArcGIS Enterprise 11.5 or later)
  • Report (.rptx)
  • Report template (.rptt)
  • Style (.stylx)

• The file size limit is 500 GB. For more information, see Considerations and limitations.

• You must be signed in to ArcGIS Online or ArcGIS Enterprise with an account that has the privilege to create content.

• Use the Allow geoprocessing tools to overwrite existing datasets option on the Geoprocessing tab of the Options dialog box to control whether the tool can overwrite an existing file on the portal. When the option is checked, if a file with the same name and title exists in the selected portal folder, it will be overwritten.

Parameters

Dialog

Label	Explanation	Data Type
Input File	The file that will be uploaded to the active portal. Supported file types are layer (.lyrx), layout (.pagx), map (.mapx), PDF (.pdf), presentation (.prsx), report (.rptx), report template (.rptt), and style (.stylx).	File
Title	The title of the portal item.	String
Folder (Optional)	The name of an existing folder or a new folder on the portal.	String
Summary (Optional)	A short description of the item.	String
Tags (Optional)	The keywords or terms that describe the item. Separate individual tags with a comma.	String
Sharing Level (Optional)	Specifies the sharing level of the item. Owner—Only the owner of the item will have access. Organization—All members of the organization will have access Everyone (public)—Everyone, including people outside the organization, will have access	String
Groups (Optional)	The groups with which the item will be shared.	String

Derived Output

Label	Explanation	Data Type
File Item ID	The portal item ID of the file.	String
File Item URL	The item URL of the file uploaded to the portal.	String

Python

arcpy.management.UploadFileToPortal(in_file, title, {folder}, {summary}, {tags}, {sharing_level}, {groups})

Name	Explanation	Data Type
in_file	The file that will be uploaded to the active portal. Supported file types are layer (.lyrx), layout (.pagx), map (.mapx), PDF (.pdf), presentation (.prsx), report (.rptx), report template (.rptt), and style (.stylx).	File
title	The title of the portal item.	String
folder (Optional)	The name of an existing folder or a new folder on the portal.	String
summary (Optional)	A short description of the item.	String
tags (Optional)	The keywords or terms that describe the item. Separate individual tags with a comma.	String
sharing_level (Optional)	Specifies the sharing level of the item. OWNER—Only the owner of the item will have access. ORGANIZATION—All members of the organization will have access EVERYONE—Everyone, including people outside the organization, will have access	String
groups [groups,...] (Optional)	The groups with which the item will be shared.	String

Derived Output

Name	Explanation	Data Type
file_item_id	The portal item ID of the file.	String
file_item_url	The item URL of the file uploaded to the portal.	String

Code sample

UploadFileToPortal example (Python window)

The following script uploads a layer file to the active portal.

import arcpy
arcpy.management.UploadFileToPortal(r"C:\states.lyrx", "MyFile", "", 
                              "My Summary", "tag1, tag2", "EVERYONE", 
                              "MYGROUP")

Environments

This tool does not use any geoprocessing environments.

Licensing information

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