- URL:
- https://[root]/community/groups/[groupID]/export
- Methods:
POST
- Required Capability:
- Administrator | Group Owner
- Version Introduced:
- ArcGIS Enterprise 10.8.1
Example usage
The following is a sample POST request for the export
operation:
POST /webadaptor/sharing/rest/community/groups/3ca5299f4b3d423ebd66e9f72f9ef638/export HTTP/1.1
Host: machine.domain.com
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryYhbOXGMMNAbGl1gv
------WebKitFormBoundaryYhbOXGMMNAbGl1gv
Content-Disposition: form-data; name="itemIdList"
------WebKitFormBoundaryYhbOXGMMNAbGl1gv
Content-Disposition: form-data; name="async"
true
------WebKitFormBoundaryYhbOXGMMNAbGl1gv
Content-Disposition: form-data; name="exportContentFolderId"
------WebKitFormBoundaryYhbOXGMMNAbGl1gv
Content-Disposition: form-data; name="exportContentFolder"
testFolder
------WebKitFormBoundaryYhbOXGMMNAbGl1gv
Content-Disposition: form-data; name="previewOnly"
false
------WebKitFormBoundaryYhbOXGMMNAbGl1gv
Content-Disposition: form-data; name="f"
pjson
------WebKitFormBoundaryYhbOXGMMNAbGl1gv--
Description
The export
operation extracts all supported items, or a set of supported items, from a group and exports them into an export package (.epk
) that can be uploaded and imported into a separate ArcGIS Enterprise organization. In addition, the export
operation can be used to extract content so that it can be moved between disconnected environments, as well as assist with workflows where select content needs to be backed up and restored or archived. It is important to note that the receiving organization must be using the same version (or later) of ArcGIS Enterprise as the environment where the export package was generated.
To demonstrate this functionality, consider the following scenario: You are a group owner who wants to move a set of the group's items from your organization's development environment to staging, and then from staging to production. You can call this operation and specify a list of item IDs for the items you wish to move to staging using the item
parameter. Once the selected items have been exported into the downloadable export package, you can upload the package to your staging environment using the Add Item operation and, once added, call the Import operation to add the items to a designated group in your staging environment. This process can then be repeated to move the group's content from staging to production.
Supported items
The following table specifies the items that can be exported and included in an export package.
Item types | Configurable App Template | Configurable Solution Apps |
---|---|---|
ArcPad Package | Attachment Viewer | Web AppBuilder |
CAD Drawing | Story Map Cascade | |
CityEngine Web Scene | Compare | |
Code Attachment | Crowdsource Polling | |
CSV Collection | Directions | |
CSV | Edit | |
Deep Learning Package | GeoForm | |
Desktop Application Template | Image Mask | |
Hosted Feature Services | Imagery Viewer | |
File Geodatabase | Image Visit | |
GeoJson | Impact Summary | |
GeoPackage | Informational Lookup | |
Geoprocessing Sample | Filter | |
Image Collection | Interactive Legend | |
Image | Local Perspective | |
ArcGIS Instant Apps | ||
iWork Keynote | Story Map Journal | |
iWork Numbers | Story Map Series | |
iWork Pages | Map Tools | |
KML Collection | Story Map Tour | |
KML | Media Map | |
Map Template | Minimalist | |
Microsoft Excel | Nearby | |
Microsoft PowerPoint | Classic Viewer | |
Microsoft Word | Elevation Profile | |
Public Information | ||
Shapefile | Simple Map Viewer | |
StoryMap | Story Map Basic | |
StoryMap Theme | Story Map Swipe and Spyglass | |
SQLite Geodatabase | Map Styler | |
Visio Document | Summary Viewer | |
Web Experience | ||
Web Experience Template | ||
Web Map | Time Aware | |
Web Mapping Application | Basic Viewer | |
Web Scene | Zone Look Up |
Additional considerations
Only items contained in the group will be exported. If an item has any dependencies, such as a web map with a dependency on the operation service items contained in the map, both the item and its dependency must be shared with the group. If the dependent items are not included in the export package, and they don't already exist in the receiving portal, any calls made to the dependent items will fail.
An export package cannot exceed 5 GB, and any one item within the package cannot exceed 1 GB. The system will check to ensure that the portal content store has a minimum of 10 GB of disk space available before attempting to either export or import group content.
Request parameters
Parameter | Details |
---|---|
(Optional) | A comma separated list of item IDs, that exist within the group, to be included in the export package. By default, the system will attempt to export all supported item in the group into an export package. If item IDs are specified in this parameter, the system will instead attempt to only export those items. |
| If Values: |
(Optional) | Introduced at 11.4. The ID of the folder the export package will be added to. To set the export package's destination as the root folder, set the value as a forward slash (/) rather than a folder ID. If a value is provided for
|
(Optional) | Introduced at 11.4. The name of the folder the export package will be added to. If no folder name is specified, the export package will be added to a folder named Exports.
|
(Optional) | Introduced at 11.3. Sets a user-defined name for the export package. If no name is provided, the export package will be named using the following format: syntax
For example, if the group's name was "Test Group", and no value for Example
|
| Introduced at 11.4. If set to Values: |
| The response format. The default format is Values: |
Accessing results
If async
is false
, and f
is set to html
, the response is an octet stream a client uses for downloading the export package. If f
is set to json
, the octet stream response cannot be returned on a successful export and an HTTP Status 400 error is returned.
If there are no items to export, a JSON response resembling the one below will be returned:
{
"itemsExported": [],
"itemsSkipped": [],
"itemsFailedExport": []
}
If async
is true
, a job
and key
is returned:
{
"jobId": "0c3d9012681845e4aa3ca3e5f9aae8fa",
"key": "DjUElZ3XQjbJ2S/g7D5644SCEaTfDniHo5XQYYVWGjY="
}
Group owners attempting to export group content, but who are not administrators, must use both the job
and key
values to check the job's results and status using the following URL format:
https://machine.domain.com/webadaptor/sharing/rest/portals/<orgID>/jobs/<jobID>?key=<keyValue>
Administrators can check the job's results and status using the jobID value in the following URL format:
https://machine.domain.com/webadaptor/sharing/rest/portals/<orgID>/jobs/<jobID>
If successful, a success response will be returned containing an item
and other job information. To download the export package, append the item
from the response using the following URL format:
https://machine.domain.com/webadaptor/portal/sharing/rest/content/items/<itemID>/data
JSON Response example
{
"id": "fadcd0a7b58c422ebcf0847aad76885d",
"definition": {
"type": "export",
"operationId": "cm009fe62d885748a4a19050844e1f8c20",
"groupId": "3ca5299f4b3d423ebd66e9f72f9ef638",
"groupTitle": "myGroup"
},
"status": "succeeded",
"created": 1586901221029,
"modified": 1586901241914,
"messages": [
"Starting export of items in group 'myGroup' with id '142b3c7995ec447288f15db4d301fe53'.",
"{\"itemsExported\":[{\"itemId\":\"7c1124277b2f4847ae668de6c5135e6d\"},{\"itemId\":\"ac34a93042bb468faf17e933609ade79\"},{\"itemId\":\"f672235d835d46008b4d68145238ab19\"}],\"itemsSkipped\":[],\"itemsFailedExport\":[]}",
"Added Export Package item with id '63a078b6aef54f1c91102fd9d4aa47f5' for group with id '142b3c7995ec447288f15db4d301fe53'."
],
"result": {
"itemId": "63a078b6aef54f1c91102fd9d4aa47f5",
"created": 1586901241910
}
}