Create (Circuits)

URL:: https://<root>/<serviceName>/UtilityNetworkServer/circuits/create
Methods:: GETPOST
Version Introduced:: 11.5

The create operation on the circuits resource allows you to create a circuit in a telecom domain network.

Request parameters

Parameter Details

Parameter	Details
`f`	Specifies the output format of the response. The default response format is `html`. Use dark colors for code blocksCopy `1 f=html \| json \| pjson`
`gdbVersion` (Optional)	Specifies the name of the geodatabase version. The default is 'sde.DEFAULT'. Syntax: `gdbVersion=<version>`
`sessionId` (Optional)	Specifies the token (guid) used to lock the version. If a client has previously started an edit session and holds an exclusive lock on the version specified, the request will fail if the sessionId is not provided. If the specified version is currently locked by any other session, the request will fail if the sessionId is not provided or does not match the sessionId that holds the exclusive lock. Syntax: `sessionId=<guid>`
`domainNetworkName` (Required)	Specifies the name of the telecom domain network in which the circuit will be created. Syntax: `domainNetworkName=<string>` Example: `domainNetworkName=Telco`
`circuits` (Required)	The circuit and circuit information to be created. Syntax: Use dark colors for code blocksCopy 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 { "circuits":[ { "name": <string>, "globalId": <guid>, "isSectioned": <boolean>, "sectionOrder": <string>, "circuitType": "Physical" \| "Virtual", // Default is Physical "startPoint" : // Only when isSectioned is false { "sourceId" : <short>, "globalId" : <guid>, "terminalId" : <short>, "firstUnit" : <short>, "numUnits" : <short> }, "stopPoint" : // Only when isSectioned is false { "sourceId" : <short>, "globalId" : <guid>, "terminalId" : <short>, "firstUnit" : <short>, "numUnits" : <short> }, "sections": [ { "sectionId": <long>, "role": "Start and end"\| "Start" \| "End" \| "Midspan", // Default is Start and end "sectionType": "Physical" \| "Virtual", // Default is Physical "startPoint": { "sourceId" : <short>, "globalId" : <guid>, "terminalId" : <short>, "firstUnit" : <short>, "numUnits" : <short> }, "stopPoint": { "sourceId" : <short>, "globalId" : <guid>, "terminalId" : <short>, "firstUnit" : <short>, "numUnits" : <short> } } ], "subcircuits": [ { "name": <string>, "globalId": <guid>, "providerID": <guid>, "consumerId": <guid>, "isReserved": "true" \| "false" // Default is false } ] }

f

Specifies the output format of the response. The default response format is html.

Use dark colors for code blocksCopy
f=html | json | pjson

gdbVersion

(Optional)

Specifies the name of the geodatabase version. The default is 'sde.DEFAULT'.

Syntax: gdbVersion=<version>

sessionId

(Optional)

Specifies the token (guid) used to lock the version. If a client has previously started an edit session and holds an exclusive lock on the version specified, the request will fail if the sessionId is not provided. If the specified version is currently locked by any other session, the request will fail if the sessionId is not provided or does not match the sessionId that holds the exclusive lock.

Syntax: sessionId=<guid>

domainNetworkName

(Required)

Specifies the name of the telecom domain network in which the circuit will be created.

Syntax: domainNetworkName=<string>

Example: domainNetworkName=Telco

circuits

(Required)

The circuit and circuit information to be created.

Syntax:

Use dark colors for code blocksCopy
{
"circuits":[
	{
	"name": <string>,
	"globalId": <guid>,
	"isSectioned": <boolean>,
	"sectionOrder": <string>,
	"circuitType": "Physical" | "Virtual",               // Default is Physical
	"startPoint" :              // Only when isSectioned is false
		{
			"sourceId"   : <short>,
			"globalId"   : <guid>,
			"terminalId" : <short>,
			"firstUnit"  : <short>,
			"numUnits"   : <short>
		},
	"stopPoint" :               // Only when isSectioned is false
		{
			"sourceId"   : <short>,
			"globalId"   : <guid>,
			"terminalId" : <short>,
			"firstUnit"  : <short>,
			"numUnits"   : <short>
		},
	"sections": [
		{
			"sectionId": <long>,
			"role": "Start and end"| "Start" | "End" | "Midspan",               // Default is Start and end
			"sectionType": "Physical" | "Virtual",               // Default is Physical
			"startPoint": {
				"sourceId"   : <short>,
				"globalId"   : <guid>,
				"terminalId" : <short>,
				"firstUnit"  : <short>,
				"numUnits"   : <short>
			},
			"stopPoint": {
				"sourceId"   : <short>,
				"globalId"   : <guid>,
				"terminalId" : <short>,
				"firstUnit"  : <short>,
				"numUnits"   : <short>
			}
		}
	],
	"subcircuits": [
		{
			"name": <string>,
			"globalId": <guid>,
			"providerID": <guid>,
			"consumerId": <guid>,
			"isReserved": "true" | "false"               // Default is false
		}
	]
}

JSON Response syntax

Use dark colors for code blocksCopy
{
 "success" : <boolean>,
  "error" : {                   // only if success is false
    "extendedCode" : <HRESULT>,
    "message" : <string>,
    "details" : [ <string> ]
	}
}

Example usage

Request URL and parameters:

https://myserver.esri.com/server/rest/services/Telco/UtilityNetworkServer/circuits/create

Use the create operation to create a circuit named A32/T3U/79232211/82256420 composed of two sections with a subcircuit in a telecom domain network named Telco.

Use dark colors for code blocksCopy

f=json
gdbVersion=sde.Default
domainNetworkName=Telco
circuit={
	"name": "A32/T3U/79232211/82256420",
	"isSectioned": true,
	"sectionOrder":"",
	"circuitType": "Physical",
	"sections": [
		{
			"sectionId": 1,
			"role": "Start and end",
			"sectionType": "Physical",
			"startPoint": {
				"sourceId": 20,
				"globalId": "{8A1B5A33-3EBA-42CC-9085-31B22DAFE5DC}",
				"terminalId": 1,
				"firstUnit": 1,
				"numUnits": 1
			},
			"stopPoint": {
				"sourceId": 20,
				"globalId": "{F081B917-499E-43FC-AEC9-7C1B313BF128}",
				"terminalId": 1,
				"firstUnit": 1,
				"numUnits": 1
			}
		},
		{
			"sectionId": 2,
			"role": "Start and end",
			"sectionType": "Physical",
			"startPoint": {
				"sourceId": 20,
				"globalId": "{C18AF55D-BCDC-4F97-B59A-F694838E7828}",
				"terminalId": 1,
				"firstUnit": 1,
				"numUnits": 1
			},
			"stopPoint": {
				"sourceId": 20,
				"globalId": "{080CCCAE-9D17-423C-9212-F28AE02F81AD}",
				"terminalId": 1,
				"firstUnit": 1,
				"numUnits": 1
			}
		}
	],
	"subcircuits": [
		{
			"name": "S1A32/T3U/79232211/82256420A",
			"isReserved": "true"
		}
	]
}

JSON response:

Use dark colors for code blocksCopy
{
	"success": true
}

Use the create operation to create a circuit named A33/T3U/79233987/64456498 composed of three sections with a subcircuit serving the role of the midspan section in a telecom domain network named Telco.

Use dark colors for code blocksCopy

f=json
gdbVersion=sde.Default
domainNetworkName=Telco
circuit={
	"name": "A33/T3U/79233987/64456498",
	"isSectioned": true,
	"sections": [
		{
			"sectionId": 1,
			"role": "Start",
			"sectionType": "Physical",
			"startPoint": {
				"sourceId": 20,
				"globalId": "{8A1B5A33-3EBA-42CC-9085-31B22DAFE5DC}",
				"terminalId": 1,
				"firstUnit": 1,
				"numUnits": 1
			},
			"stopPoint": {
				"sourceId": 20,
				"globalId": "{F081B917-499E-43FC-AEC9-7C1B313BF128}",
				"terminalId": 1,
				"firstUnit": 1,
				"numUnits": 1
			}
		},
		{
			"sectionId": 2,
			"role": "Midspan",
			"subcircuit": {
				"name": "Subcircuit_64456498",
				"globalId": "{4BCB013E-AD5A-4598-AA51-256D9C84C145}"
			}
		},
		{
			"sectionId": 3,
			"role": "End",
			"sectionType": "Physical",
			"startPoint": {
				"sourceId": 20,
				"globalId": "{5C179F2F-6F70-4B82-AE02-25FEFB457860}",
				"terminalId": 1,
				"firstUnit": 1,
				"numUnits": 1
			},
			"stopPoint": {
				"sourceId": 20,
				"globalId": "{6EF3FE96-61C2-498A-B336-BA3E85F0D39E}",
				"terminalId": 1,
				"firstUnit": 1,
				"numUnits": 1
			}
		}
	],
	"subcircuits": []
}

JSON response:

Use dark colors for code blocksCopy
{
	"success": true
}