Skip To Content
ArcGIS Developer
Dashboard

Reconcile

  • URL: https://<version-url>/reconcile(POST only)
  • Version Introduced:10.6

Description

Use the reconcile operation to reconcile a branch version with the default version. This operation detects differences between the branch version and the default version and flags them as conflicts. The reconcile operation requires that you are the only user currently editing the version and remain so throughout the reconcile process until you save or post your edits. You must have full permissions to all the feature classes that have been modified in the version being edited.

The reconcile operation is supported both synchronously and asynchronously.

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

License:
Organization members must be assigned a license for the ArcGIS Advanced Editing user type extension to use this operation.

Request parameters

ParameterDetails
f

The output response format. The default response format is html.

Values: html | json

sessionId

The client-generated sessionId (GUID). This parameter is required.

Syntax : sessionId = {3F2504E0-4F89-41D3-9A0C-0305E82C3301}

abortIfConflicts

Specifies whether the reconcile will be aborted if conflicts are detected (true). The default is false. This parameter is a Boolean value and is optional.

Values: true | false

conflictDetection

Specifies whether the conditions required for conflicts to occur will be defined by object (row) or attribute (column). The default is byObject. This parameter is optional.

This parameter was introduced at ArcGIS Enterprise 10.8.1.

Values: byObject | byAttribute

withPost

Specifies whether a post of the current version will be included following the reconcile (true). The default is false. This parameter is a Boolean value and is optional.

Values: true | false

async

Specifies whether the request will be processed asynchronously. If true, the request will be processed as an asynchronous job, and a URL will be returned that a client can visit to review the status of the job. The default is false.

Values: true | false

This parameter was introduced at ArcGIS Enterprise 10.9.1.

JSON Response syntax

JSON response (when async = false):

{
  "hasConflicts" : <true | false>,
  "moment" : <datetime>,
  "didPost" : <true | false>,
  "success" : <true | false>,
  "error" : { // only if success is false
    "extendedCode" : <HRESULT>,
    "message" : <error message>,
    "details" : [ <detail> ]
  }
}

JSON response (when async = true):


{
  "statusUrl" : <url>
}

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


{
  "status" : "<Pending | InProgress>",
  "submissionTime" : <datetime>,
  "lastUpdatedTime" : <datetime>
 }

Example usage

Reconcile a named version with the default version using the reconcile operation. Conflicts are defined by setting the conflictDetection parameter to byAttribute. The optional parameters abortIfConflicts and withPost are both set to true.

Request URL and parameters:

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

f=json
sessionId={638ed440-b81f-406c-bd5d-757c91dbfd70}
abortIfConflicts=true
conflictDetection=byAttribute
withPost=true
async=false

JSON response:

{
 "hasConflicts": false,
 "moment": 1582135929926,
 "didPost": true,
 "success": true
}