Skip To Content

Reassign Features To Record

  • URL:https://<parcelfabricservice-url>/reassignFeaturesToRecord
  • Required Capability:ArcGIS Advanced Editing
  • Version Introduced:11.2

Description

The reassignFeaturesToRecord operation reassigns all parcel features in the specified source record to the specified target record. The source record becomes empty and is not associated with any parcel features.

The record polygon of the target record is updated to match the cumulative geometry of all the parcels associated with it.

Learn more about assigning parcel fabric records

Request parameters

ParameterDetails
gdbVersion

The name of the geodatabase version (the default is the DEFAULT version).

Syntax

gdbVersion=<version>
sessionId

The token (GUID) used to lock the version. If the calling client is editing a named version, the sessionId value is required. If the specified version is currently locked by another session, the request will fail if the sessionId value is not provided or does not match the sessionId value that holds the exclusive lock. If the client is editing the default version, the sessionId value is not required.

Syntax

sessionId=<guid>
sourceRecord

(Required)

The record containing the parcel features to be reassigned.

Syntax

sourceRecord=<guid>
targetRecord

(Required)

The target record to which the parcel features will be reassigned.

Syntax

targetRecord=<guid>

deleteSourceRecord

Specifies whether the original source record will be deleted.

Syntax

deleteSourceRecord=<boolean>

Values: true | false

async

Specifies whether the request will be processed as an asynchronous job and a URL that points to a location displaying the status of the job will be returned. See the topic regarding asynchronous usage for more information. The default is false.

Values: true | false

Syntax

async=true|false
f

The response format. The default response format is html.

Values: html | json

Example usage

This example shows the steps for reassigning parcel features to a different record using the reassignFeaturesToRecord operation.

Note:
The sessionId parameter value must be the same for starting the edit session, performing the edit operation, and stopping the edit session.
The sessionId value must be a unique GUID that has not been used in a previous session. The GUID can be randomly generated.

  1. Start a service session on the version.

    Request URL and parameters.

    
    https://machine.domain.com/webadaptor/rest/services/CountyFabric/VersionManagementServer/versions/E4DAED9D-C859-489B-9053-767A45F1D97C/startReading
    f=json
    sessionId={d5b2acda-fdfc-48bd-996c-16c95756f7a2}

  2. Start an edit session on the version.

    Request URL and parameters.

    
    https://machine.domain.com/webadaptor/rest/services/CountyFabric/VersionManagementServer/versions/E4DAED9D-C859-489B-9053-767A45F1D97C/startEditing
    f=json
    sessionId={d5b2acda-fdfc-48bd-996c-16c95756f7a2}

  3. Reassign parcel features from one record (source record) to another record (target record). Delete the original source record.

    Request URL and parameters.

    
    https://machine.domain.com/webadaptor/rest/services/CountyFabric/ParcelFabricServer/reassignFeaturesToRecord
    f=json
    gdbVersion=admin.Version1
    sessionId={d5b2acda-fdfc-48bd-996c-16c95756f7a2}
    sourceRecord={3FD726F6-69C1-4CDF-9EC5-38E3384CB38C}
    targetRecord={18F944EA-50E9-4792-9814-FD419644934E}
    deleteSourceRecord=true
    async=false
  4. When edits are complete, stop the edit session.
  5. Stop and release the service session.

JSON Response syntax

The following response is returned when async is false:


{
		"moment": <datetime>,  
		"exceededTransferLimit: <true | false>,
		"serviceEdits": [{  // only if transfer limit is not exceeded
    "editedFeatures": {
						"spatialReference": {}
						"updates": [
							[{ "attributes": {}
										"geometry": {}
								}]] 
					...
						"deletes": [
						[{ "attributes": {}
										"geometry": {}
								}]] 

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

The following response is returned when async is true:


{
		"statusUrl": <url>
}

JSON Response example

The following is a response example when async is false:


{
 "moment": 1633648726800,
 "exceededTransferLimit": false,
 "serviceEdits": [
  {
   "id": 17,
   "editedFeatures": {
    "spatialReference": {
     "wkid": 103007,
     "latestWkid": 6424,
     "xyTolerance": 0.0032808333333333331,
     "zTolerance": 0.001,
     "mTolerance": 0.001,
     "falseX": -117608900,
     "falseY": -91881400,
     "xyUnits": 3048.00609601219276,
     "falseZ": -100000,
     "zUnits": 10000,
     "falseM": -100000,
     "mUnits": 10000
    },
    "updates": [
     [
      {
       "attributes": {
        "OBJECTID": 5,
        "GlobalID": "{10740196-42B1-4FA3-8817-5A3C71842A96}",
        "Direction": 359.77388889,
        "Distance": 77.68984462,
        "Radius": null,
        "ArcLength": null,
        "Radius2": null,
        "CreatedByRecord": "{3FD726F6-69C1-4CDF-9EC5-38E3384CB38C}",
        "RetiredByRecord": null,
        "COGOType": null,
        "IsCOGOGround": null,
        "Rotation": null,
        "Scale": null,
        "DirectionAccuracy": 30.0,
        "DistanceAccuracy": 0.492125,
        "ParentLineID": null,
        "created_user": "admin",
        "created_date": 1633639756000,
        "last_edited_user": "admin",
        "last_edited_date": 1633639756000,
        "VALIDATIONSTATUS": 2,
        "Shape__Length": 77.6897534076093308
       },
       "geometry": {
        "hasZ": true,
        "paths": [
         [
          [
           6816365.4399818927,
           1843185.05307964981,
           0
          ],
          [
           6816365.13355205953,
           1843262.74222873151,
           0
          ]
         ]
        ]
       }
      },
      {
       "attributes": {
        "OBJECTID": 5,
        "GlobalID": "{10740196-42B1-4FA3-8817-5A3C71842A96}",
        "Direction": 359.77388889,
        "Distance": 77.68984462,
        "Radius": null,
        "ArcLength": null,
        "Radius2": null,
        "CreatedByRecord": "{18F944EA-50E9-4792-9814-FD419644934E}",
        "RetiredByRecord": null,
        "COGOType": null,
        "IsCOGOGround": null,
        "Rotation": null,
        "Scale": null,
        "DirectionAccuracy": 30.0,
        "DistanceAccuracy": 0.492125,
        "ParentLineID": null,
        "created_user": "admin",
        "created_date": 1633639756000,
        "last_edited_user": "admin",
        "last_edited_date": 1633648728000,
        "VALIDATIONSTATUS": 2,
        "Shape__Length": 77.6897534076093308
       },
       "geometry": {
        "hasZ": true,
        "paths": [
         [
          [
           6816365.4399818927,
           1843185.05307964981,
           0
          ],
          [
           6816365.13355205953,
           1843262.74222873151,
           0
          ]
         ]
        ]
       }
      }
     ],
...
 "success": true
}