Summary
Imports trace configurations from JSON format (.json file) to a trace network.
This tool can be used in conjunction with the Export Trace Configurations tool.
Usage
The input trace network must be version 2 or later.
- The following requirements must be met when working with an enterprise geodatabase:
The Input Trace Network parameter value must be from a trace network service.
Note:
The Input Trace Network parameter value can be from a database connection established as the database trace network owner when connected as the portal trace network owner or a portal account with the administrator role.
Trace configurations must be in a single .json file.
The information in the .json file is stored in the following format:
[ { "creator": "<property representing the connected portal account on creation>", "name": "<property representing the trace configuration name>", "description": "<property representing the description of the trace configuration>", "traceType": <property representing the trace type>, "configuration": <property representing the collection of trace configuration parameters>, "resultTypes": "[<property representing the types of results to return>]", "tags": "<property representing user provided tags>" } ]
Example JSON to import into a trace network using the Import Trace Configurations tool:
[ { "creator": "TN_Admin", "name": "Connected trace HUC12", "description": "Connected trace for HUC12", "traceType": 1, "configuration": {"{"includeBarriers":true,"validateConsistency":true,"ignoreBarriersAtStartingPoints":true,"allowIndeterminateFlow":true, "traversabilityScope":"junctionsAndEdges","combineUsingOr":false,"isSpecificValue":true}],"functionBarriers":[], "functions":[],"outputFilters":[],"outputConditions":[],}",}, "resultTypes": "[{"type":"elements","includeGeometry":false,"includePropagatedValues":false,"networkAttributeNames":[],"diagramTemplateName":"","resultTypeFields":[]},{"type":"aggregatedGeometry","includeGeometry":false,"includePropagatedValues":false,"networkAttributeNames":[],"diagramTemplateName":"","resultTypeFields":[]}]", "tags": "connected,nhd,huc12" } ]
Syntax
arcpy.tn.ImportTraceConfigurations(in_trace_network, in_json_file)
Parameter | Explanation | Data Type |
in_trace_network | The target trace network for the imported trace configurations. | Trace Network; Trace Network Layer |
in_json_file | The .json file containing the trace configurations to import. | File |
Derived Output
Name | Explanation | Data Type |
out_trace_network | The updated trace network. | Trace Network |
Code sample
This sample script imports trace configurations into a trace network called HydroTraceNetwork.
import arcpy
arcpy.ImportTraceConfigurations_tn("HydroTraceNetwork",
r"c:\temp\trace_configurations.json")
Environments
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes