- 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
Parameter | Details |
---|---|
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 JSON response:f=json
sessionId={638ed440-b81f-406c-bd5d-757c91dbfd70}
abortIfConflicts=true
conflictDetection=byAttribute
withPost=true
async=false
{
"hasConflicts": false,
"moment": 1582135929926,
"didPost": true,
"success": true
}