Post

Description

The post operation allows the client to post the changes in their version to the default version. The reconcile operation must be performed before the post operation. The sessionId value performing the post operation must match the sessionId value used for the reconcile operation. To post a subset of edits in the current version to the default version, define the rows parameter.

The post operation is supported both synchronously and asynchronously.

Review the read and edit session requirements for version resource operations.

Request parameters

1
2
3
4
5
6
[
 {
   "layerId" : <layerId>,
   "objectIds" : [ <objectId> ]
 }
]

1
2
3
4
5
6
7
8
9
10
[
  {
     "layerId":0,
     "objectIds":[1207,1208]
  },
  {
     "layerId":1,
     "objectIds":[809]
  }
]

JSON Response syntax

JSON response (when async = false):

1
2
3
4
5
6
7
8
9
{
  "moment" : <datetime>,
  "success" : <true | false>,
  "error" : { // only if success is false
    "extendedCode" : <HRESULT>,
    "message" : <error message>,
    "details" : [ <detail> ]
  }
}

JSON response (when async = true):

1
2
3
{
  "statusUrl" : <url>
}

JSON response to the status URL (when pending or in progress):

1
2
3
4
5
{
  "status" : "<Pending | InProgress>",
  "submissionTime" : <datetime>,
  "lastUpdatedTime" : <datetime>
 }

Example usage

Use the post operation to post edits from a named version to the default version.

Example 1

Use the post operation to post all edits from a named version to the default version.

Request URL and parameters:

https://myserver.esri.com/server/rest/services/LandUse/VersionManagementServer/versions/24417758-0DBD-4EC3-95B0-467CAA47FC43/post

1
2
3
f=json
sessionId={3E11BA55-9A50-4EDD-A694-D5C4F21CD40D}
async=false

JSON response:

1
2
3
4
{
 "moment": 1602605793507,
 "success": true
}

Example 2

Use the post operation to post a subset of edits from a named version to the default version using the rows parameter.

The objectIds values provided must be edits in the current version, which can be obtained from the differences operation. In the example, the objectIds values provided for the rows parameter include a subset of edits with combinations of inserts, updates, and deletes. For layerId 0, objectIds 1207 and 1208 represent newly inserted features, and objectIds 12 and 14 are updated and deleted features. For layerId1, objectIds 809 represents an inserted feature.

Request URL and parameters:

https://myserver.esri.com/server/rest/services/LandUse/VersionManagementServer/versions/24417758-0DBD-4EC3-95B0-467CAA47FC43/post

1
2
3
4
5
6
7
8
9
10
11
12
13
f=json
sessionId={3E11BA55-9A50-4EDD-A694-D5C4F21CD40D}
rows=[
  {
     "layerId":0,
     "objectIds":[1207,1208,12,14]
  },
  {
     "layerId":1,
     "objectIds":[809]
  }
]
async=false

JSON response:

1
2
3
4
{
 "moment": 1602605793507,
 "success": true
}