FRAMES | NO FRAMES

 

B U S I N E S S   A N A L Y S T   10.2   R E S T   R E P O S I T O R Y   U T I L I T Y

Edit Features Endpoint

Edits features in a repository feature layer.

 

Availability: Business Analyst Server.

 

URL Example

http://localhost:6080/arcgis/rest/services/DefaultMap/MapServer/exts/BAServer/EditFeatures/execute

Parameters

Parameter

Description

ChangedItem (required)

Folder item containing a feature layer to be edited. Type esriFolderItem.

Features (required)

Array of feature edits. Type array of EditFeature.

f (optional)

Response format. Type string. Available formats: HTML, JSON, PJSON, XML.

Default: HTML.

IsFullErrorMessage (optional)

Mode for composing error messages. Type boolean.

Default: false.

token

Authentication token. This parameter is required if your Business Analyst Server is secured. Type string.

Returns

Variable of type boolean whose value is always true.

Remarks

The ChangedItem layer and feature edits from the Features array should have the same type of geometry and the same spatial reference.

 

All attributes of feature edits contained in the Features array should present in the ChangedItem layer. Values for attributes of features from the edited layer which are missing in the feature edits are not changed.

Example Usage

The example below illustrates a workflow consisting of uploading a custom trade area layer to Business Analyst Server Repository with the Upload Feature Set endpoint, editing the features with this endpoint, and retrieving the modified layer with the Open Feature Layer endpoint. The retrieved feature layer is shown here in the case of a shapefile-based repository.

 

NOTE: The name of the Object ID attribute of features depends on a feature class workspace type used. Typical names for Object ID are "FID", "OID", or "OBJECTID". You can recognize the Object ID field by its type "esriFieldTypeOID" returned within the "fields" array when the feature layer is retrieved with Open Feature Layer task.

 

STEP 1: Upload Custom Trade Area

http://localhost:6080/arcgis/rest/services/DefaultMap/MapServer/exts/BAServer/UploadCustomTradeArea/execute?
Boundaries={"Recordset":{
  "geometryType":"esriGeometryPolygon",
  "spatialReference":{"wkid":4269},
  "features":[
    {
      "geometry":{
        "rings":[[
          [-122.4346,37.8566476371076],[-122.360655858915,37.826739954428],
          [-122.347749703146,37.761714833162],[-122.406398364369,37.7151967133423],
          [-122.488250155425,37.7254855017619],[-122.525947479981,37.784114591287],
          [-122.488335196333,37.8427896412311],[-122.4346,37.8566476371076]
        ]],
        "spatialReference":{"wkid":4269}
      },
      "attributes":{"AREA_ID":"1_1","STORE_ID":"1","RING":1,"RING_DEFN":"5","AREA_DESC":"0 - 5 Miles"}
    },
    {
      "geometry":{
        "rings":[[
          [-122.4329,37.8057482650651],[-122.35900658434,37.775840365754],
          [-122.346109142864,37.7108146974946],[-122.404717633044,37.6642961225184],
          [-122.48651348554,37.6745850161913],[-122.524184911958,37.7332146557964],
          [-122.486598312884,37.791890171551],[-122.4329,37.8057482650651]
        ]],
        "spatialReference":{"wkid":4269}
      },
      "attributes":{"AREA_ID":"2_1","STORE_ID":"2","RING":1,"RING_DEFN":"5","AREA_DESC":"0 - 5 Miles"}
    }
  ]
}}&
OutputAnalysisItem={
  "workspaceName":"Default Workspace",
  "projectName":"Default Project",
  "folderType":"esriFolderTradeAreas",
  "itemName":"EditFeaturesSample"
}&
f=PJSON

 

STEP 2: Edit Features

http://localhost:6080/arcgis/rest/services/DefaultMap/MapServer/exts/BAServer/EditFeatures/execute?
Features=[
  {
    "OID":1,
    "attributes":{"STORE_ID":"200","RING":100, "AREA_DESC":"Changed Area"},
    "geometry":{
      "rings":[[
        [-122.2246,38.0566476371076],[-122.150655858915,38.026739954428],
        [-122.137749703146,37.961714833162],[-122.196398364369,37.9151967133423],
        [-122.278250155425,37.9254855017619],[-122.315947479981,37.984114591287],
        [-122.278335196333,38.0427896412311],[-122.2246,38.0566476371076]
      ]],
      "spatialReference":{"wkid":4269}
    }
  }
]&
ChangedItem={
  "workspaceName":"Default Workspace",
  "projectName":"Default Project",
  "folderType":"esriFolderTradeAreas",
  "itemName":"EditFeaturesSample"
}&
f=PJSON

 

STEP 3: Open Feature Layer

http://localhost:6080/arcgis/rest/services/DefaultMap/MapServer/exts/BAServer/OpenFeaturelayer/execute?
Item={
  "workspaceName":"Default Workspace",
  "projectName":"Default Project",
  "folderType":"esriFolderTradeAreas",
  "itemName":"EditFeaturesSample"
}&
f=PJSON

 

Response

{
  "results":
  [
    {
      "paramName":"OutputFeatureClass",
      "dataType":"GPFeatureRecordSetLayer",
      "value":
      {
        "geometryType":"esriGeometryPolygon",
        "spatialReference":
        {
          "wkid":4326
        },
        "fieldAliases":
        {
          "OBJECTID":"Object ID",
          "AREA_DESC":"AREA_DESC",
          "AREA_ID":"AREA_ID",
          "RING":"RING",
          "RING_DEFN":"RING_DEFN",
          "STORE_ID":"STORE_ID",
          "Shape.area":"Shape.area",
          "Shape.len":"Shape.len"
        },
        "fields":
        [
          {
            "name":"OBJECTID",
            "type":"esriFieldTypeOID",
            "alias":"Object ID"
          },
          ...
          {
            "name":"Shape.len",
            "type":"esriFieldTypeDouble",
            "alias":"Shape.len"
          }
        ],
        "features":
        [
          {
            "geometry":
            {
              "rings":
              [
                [
                  [
                    -122.2246,
                    38.056648
                  ],
                  ...
                  [
                    -122.2246,
                    38.056648
                  ]
                ]
              ],
              "spatialReference":
              {
                "wkid":4326
              }
            },
            "attributes":
            {
              "OBJECTID":1,
              "AREA_DESC":"Changed Area",
              "AREA_ID":"1_1",
              "RING":100,
              "RING_DEFN":"5",
              "STORE_ID":"200",
              "Shape.area":0.0180196727515,
              "Shape.len":0.49830034470522
            }
          },
          {
            "geometry":
            {
              "rings":
              [
                [
                  [
                    -122.4329,
                    37.805748
                  ],
                  ...
                  [
                    -122.4329,
                    37.805748
                  ]
                ]
              ],
              "spatialReference":
              {
                "wkid":4326
              }
            },
            "attributes":
            {
              "OBJECTID":2,
              "AREA_DESC":"0 - 5 Miles",
              "AREA_ID":"2_1",
              "RING":1,
              "RING_DEFN":"5",
              "STORE_ID":"2",
              "Shape.area":0.0180074758195,
              "Shape.len":0.498103034899043
            }
          }
        ]
      }
    }
  ],
  "messages":
  [
  ]
}

 

NOTE: The response has been abbreviated where "..." is noted.

 

See Also

Add Features Endpoint

Delete Features Endpoint

Open Feature Layer Endpoint

Upload Feature Set Endpoint

Business Analyst Server Repository

Business Analyst Server REST Reference