Reconcile Version—ArcGIS REST APIs

URL:https://<LinearReferencingService-url>/reconcileVersion
Required Capability:Event Editing
Version Introduced:10.6

Description

License:

The ArcGIS Location Referencing license is required to use this resource.

Reconciles an edit version against a target version with the option to post changes after a successful reconcile.

Version names are case sensitive and should take the form {owner}.{version}, for example, sde.DEFAULT.

Changes to the same row or feature in the target and edit versions might cause a conflict during the reconcile. The reconcile process will be aborted if conflicts are found. Conflicts must be resolved manually before the next reconcile, and the post process will not start until a reconcile is successfully completed.

If the option is chosen to post after reconcile (withPost=true), a shared version lock will be obtained on the target version during the reconcile process. This ensures that the target version is not modified in the time between the reconcile and the post.

Request parameters


Parameter	Details
f	Description: Optional parameter to specify the response format. The default response format is html. Values: html \| json
targetVersion	Required Description: Name of a version in the ancestry of the edit version, such as the parent version or the default version. Typically contains edits from other versions that the user performing the reconcile would like to pull into their edit version.
editVersion	Required Description: Name of the edit version to be reconciled with the target version.
withPost	Description: If true, changes in the edit version will be posted to the target version after a successful reconcile. The default is false. If true, and checkOnly is also true, this parameter will be ignored. Values: false \| true
lrsId	Description: A unique ID that identifies an LRS workspace. Refer to the LRS service resource for a list of LRS workspaces and their IDs. If there is only one LRS workspace referenced by the map service, that LRS is used by default. Otherwise, the lrsId parameter is required.
checkOnly	Description: If true, this operation only checks if a reconcile is needed between the edit version and the target version. No actual reconciling or posting is performed. The default is false. Values: false \| true

Example usage

Example 1

URL for reconciling (but not posting) edit version 'data_owner.job_42' with target version 'sde.DEFAULT' in the LRS workspace '387ad279-6026-4680-8171-fd17d1b9efd4'.

https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/reconcileVersion?f=json&targetVersion=sde.DEFAULT&editVersion=data_owner.job_42&lrsId=387ad279-6026-4680-8171-fd17d1b9efd4

Example 2

URL for reconciling and posting edit version 'data_owner.job_42' with target version 'sde.DEFAULT' in the LRS workspace '387ad279-6026-4680-8171-fd17d1b9efd4'.

https://sampleserver/arcgis/rest/services/MyLRS/MapServer/exts/LRServer/reconcileVersion?f=json&targetVersion=sde.DEFAULT&editVersion=data_owner.job_42&withPost=true&lrsId=387ad279-6026-4680-8171-fd17d1b9efd4

JSON Response syntax

Example of when it's successful.

{
  "hasConflicts" : <true | false>  // whether there were conflicts during reconcile
}

Example of when checkOnly=true.

{
  "needsReconcile" : <true | false>
}

JSON Response example

Example of when an error occurs.

{
  "error" : {
    "code" : <errorCode>,
    "message" : "<errorMessage>",
    "details" : [ "<detail>", ... ]
  }
}

ArcGIS REST APIs