FRAMES | NO FRAMES | Description | Parameters | Examples | Response |
URL | http://<schematicdiagramtemplate-url>/updateDiagram |
Parent Resource | Schematic Diagram Template |
---|
The updateDiagram operation is performed on a schematic diagram template resource. The result of this operation is a Schematic Diagram Information Object.
It is used to update an existing diagram.
Note: Schematics services published without the Editing operation enabled don't support the updateDiagram operation.
You can provide arguments to the updateDiagram operation as query parameters defined in the parameters table below.
Parameter | Details |
---|---|
f | Description: The
response format. The default response format is html. Values: html | json |
name |
Required Description: The diagram name. Syntax:
Example:
|
user |
Required Description: The login of the user who updates the diagram. Syntax:
Example:
|
builderProperties |
Description:
The builder properties which specifies how the diagram has to be updated.
This parameter is required only for diagram based on the Standard builder.
Syntax: //For a diagram based on the Standard builder, the operation expects the update action that will be used: builderProperties={"action" : "synchronize" | "refresh" | "appendWithFullSynchronization" | "appendWithPartialSynchronization" | "overwrite"} Example:
|
builderContext |
Required Description: The context for the builder which updates the diagram. This parameter syntax depends on the diagram builder:
|
persistOption |
Required Description: The persistence option to specify whether the removed/reduced schematic features are restored after update and the schematic feature links whose connections have been modified are reconnected to be in exact coherence with their associated real features after update. Value: True | False |
Example 1: updateDiagram operation by synchronizing a Standard builder diagram content
Under the S1_Schematics Schematics service, the MainNetwork template is based on the Standard builder and works from input GIS features organized into a geometric network.
Since this sample service was published without the Editing operation enabled, the updateDiagram operation is not supported.
But, with the Editing operation enabled, you could synchronize the MPS_Goldmine schematic diagram based on this template (id=2) by executing the updateDiagram operation with the following parameters:
MPS_Goldmine
for the name parameter{"action" : "synchronize"}
for the builderProperties parameter{"initialObjects": []}
for the builderContext parameteruser3882
for the builderContext parameterTrue
for the persistOption parameterExample 2: updateDiagram operation by appending some new GIS features to a Standard builder diagram without synchronizing all the diagram content
Another kind of updateDiagram operation could be executed to append new GIS features to this schematic diagram without synchronizing all the diagram content. For example, in that case, you could use the following parameters:
MPS_Goldmine
for the name parameter{"action" : "appendWithPartialSynchronization"}
for the builderProperties parameter{"initialObjects": [{"objectClassName": "PrimayLine", "objectIDs": [1]}]}
for the builderContext parameter to append the PrimaryLine with OBJECTID=1 to the diagramuser5001
for the builderContext parameterTrue
for the persistOption parameter{
"name": "DiagramFrom_pug_PUG_gas_plants_ID3",
"id": "0-5",
"templateIdentifier": "0",
"templateObjectID": 892,
"schematicLayerIdentifier": 0,
"folderObjectID": -2,
"folderIdentifier": "-2",
"objectID": 5,
"createdBy": "NCA3885",
"lastModificationBy": "NCA3885",
"lastUpdateBy": "NCA3885",
"creationDate": "05/13/11 14:13:57",
"lastModificationDate": "05/15/11 09:13:57",
"lastUpdateDate": "05/15/11 09:13:57",
"lockedBy": "",
"version": "sde.DEFAULT",
"extent": {
"xmin": -37.342619999999989,
"ymin": -11.398460000000886,
"xmax": -37.342179999999097,
"ymax": -11.398019999999997,
"spatialReference": {
"wkid": 4326,
"latestWkid": 4326
}
}
}