Reconcile Version

Description

License:

The ArcGIS Pipeline Referencing for Server extension 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

ParameterDetails
f

Description: 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 will be 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'.

http://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'.

http://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
}

JSON Response Syntax

Example of when checkOnly=true.

{
  "needsReconcile" : <true | false>
}

JSON Response Syntax

Example of when an error occurs.

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