Version

Description

The version resource represents a single version under the Version Management service; it returns information about the version and supports many operations. The version is accessed using the <versionGuid> that is obtained from the Versions resource.

The following table lists the locks required for operations that use the version resource:

Version operations

Operation

Read session required

Edit session required

Alter

Conflicts

Check mark

Delete Forward Edits

Check mark

Differences

Check mark

Inspect Conflicts

Check mark

Post

Check mark

Reconcile

Check mark

Restore Rows

Check mark
Read and edit sessions are established using the startReading and startEditing operations.

Request Parameters

Parameter

Details

f

Description: The response format. The default response format is html.

Values: <html | json>

JSON Response Syntax

{
  "versionName": "<owner.versionName>",
  "versionGuid": <guid>,
  "versionId": <ID>,
  "description": "<description>",
  "creationDate": <dateTime>,
  "modifiedDate": <dateTime>,
  "reconcileDate": <dateTime>,
  "previousAncestorDate": <dateTime>,
  "commonAncestorDate": <dateTime>,
  "evaluationDate": <dateTime>,
  "isBeingEdited": <true | false>,
  "isBeingRead": <true | false>,
  "hasConflicts": <true | false>,
  "hasUninspectedConflicts": <true | false>,
  "isLocked": <true | false>,
  "lockOwner": "<lockOwner>",
  "lockDate": <dateTime>,
  "access": "private" | "public" | "protected",
  "success": <true | false>
}

NoteNote:

The evaluationdate version property is only updated when evaluating with the changesInVersion parameter set as true. To learn more, review the changesInVersion request parameter for the evaluate operation.

Example Usage

The version resource is used to return information about a specific version by using the <versionGUID>. In this example, the <versionGuid> is F93DB9FD-6F39-45D9-A6C7-D43E69EB3076.

Request URL and JSON response:

https://myserver.esri.com/server/rest/services/LandUse/VersionManagementServer/versions/F93DB9FD-6F39-45D9-A6C7-D43E69EB3076

{
 "versionName": "UNADMIN.ProjectA",
 "versionGuid": "{F93DB9FD-6F39-45D9-A6C7-D43E69EB3076}",
 "versionId": 20,
 "description": "",
 "creationDate": 1550771990888,
 "modifiedDate": 1550853280024,
 "reconcileDate": 1550853215169,
 "previousAncestorDate": null,
 "commonAncestorDate": 1550853215169,
 "evaluationDate": null,
 "isBeingEdited": false,
 "isBeingRead": false,
 "hasConflicts": false,
 "hasUninspectedConflicts": false,
 "isLocked": false,
 "lockOwner": "",
 "lockDate": -1,
 "access": "public",
 "success": true
}