Create Diagram Layer Definition (Network Diagram Tools)

Summary

Creates a diagram layer definition for the input diagram template using the settings of the network feature layers in the active map.

This tool allows you to do the following:

• Import the appearance and labeling settings configured on each feature layer in the active map when those layers are related to the utility network or trace network specified in the input.

• Create a set of extra layers that may be relevant to the template, such as layers for system junctions, structural attachments, schematic edges, and so on.

Caution:

This tool is a configuration and administration tool.

Usage

• This tool is not supported when working with a utility network or trace network service. You must use either a utility network or trace network in a file or mobile geodatabase, or a database connection to a utility network or trace network in an enterprise geodatabase. When working with an enterprise geodatabase, the following are requirements:

  • The Input Network parameter value must be from a database connection established as the database utility network owner or database trace network owner.

  • The connected ArcGIS Enterprise portal account must be the portal utility network owner or portal trace network owner.

  • This tool must be connected to the default version, which is expected to be public and not protected.

• This tool must be used in ArcGIS Pro, as it takes an input network layer referenced from an active map and prepares the network diagram composite layer for all diagrams that are based on the input template according to the layers in the input active map. After running with its default settings, each network diagram based on the input template displays the following:

  • One layer for each utility network or trace network layer representing network features in the active map specified as the input.

  • A set of extra layers that can be relevant or not to your template dedicated to the representation of the following types of network elements:

    • Connectivity associations and structural attachments represented as polylines in diagrams

    • Container polygon features, line features, and edge objects that can be transformed as points in diagrams

    • Container point features and container junction objects that can be transformed as polygons in diagrams

    • Junction objects represented as points in diagrams

    • Edge objects represented as polylines in diagrams

  • One layer, Reduction Edges, dedicated to the representation of aggregated network elements between two junctions.

  • When the related utility network exists with a telecom domain, two layers—Virtual Connectivity and Inferred Connectivity—will be created to represent implicit connectivity between sections and contained network elements.

  Note:

  The tool systematically discards layers present in the input map that are out of the utility network or trace network.

• Depending on the Overwrite all layers parameter value, you can do the following:

  • Initialize a custom diagram layer definition on a template. This is the default behavior when the Overwrite all layers parameter is checked.

  • Add new diagram sublayers or overwrite settings on some existing diagram sublayers while preserving others when the Overwrite all layers parameter is unchecked.

  Then you can refine the diagram layer definition on a template.

• When the Overwrite all layers parameter is unchecked, the existing defined layers will be preserved except those representing the same network sources as the input network map's layers. By default, those input layers will replace the existing layers unless the Merging With Existing Layer Definitions parameter value is Replace existing layers.

• Running this tool initializes a layer definition ID on the template. This ID helps the network owner to control how diagram layer definitions are shared between diagram templates and improve this sharing. For a published utility network or trace network service, this ID also improves the service start time.

Parameters

• Dialog
• Python

Label	Explanation	Data type
Input Network	The utility network or trace network layer in the active map.	Utility Network Layer; Trace Network Layer
Input Diagram Template	The name of the diagram template that will be modified.	String
System Junctions (Optional)	Specifies whether system junctions and system junction objects will be represented in the diagrams based on the specified template. Checked—The system junctions along the network lines and the system junction objects along the network edge objects will be represented in the diagrams by the System Junction layer and the System Junction Objects layer, respectively. This is the default. Unchecked—System junctions and system junction objects will not be represented in the diagrams.	Boolean
Connectivity Associations (Optional)	Specifies whether connectivity associations will be represented in the diagrams based on the specified template. Checked—Connectivity associations will be represented in the diagrams by the Connectivity Associations layer. This is the default. Unchecked—Connectivity associations will not be represented in the diagrams.	Boolean
Structural Attachments (Optional)	Specifies whether structural attachment associations will be represented in the diagrams based on the specified template. Checked—Structural attachment associations will be represented in the diagrams by the Structural Attachments layer. This is the default. Unchecked—Structural attachment associations will not be represented in the diagrams.	Boolean
Schematic Edges (Optional)	Specifies whether additional layers will be created to represent schematic edges in the diagrams based on the specified template. Checked—All schematic edges representing aggregated network elements between two junctions will be displayed in the diagrams using the Reduction Edges layer. If a telecom domain exists for the related utility network, two other layers will be added to represent the connectivity that implicitly connect sections, Virtual Connectivity, and the connectivity that connect contained network elements, Inferred Connectivity. This is the default. Unchecked—Schematic edges will not be represented in the diagrams.	Boolean
Points for edges reduced as junctions or collapsed polygons (Optional)	Specifies whether layers will be added to represent container polygon features, network line features, or network edge objects as point features in the diagrams. Value table columns: Network Source—The name of the container polygon source class, network line source class, or network edge object table to include as a point layer. Subtype Layer—The associated layer will be created with subtype group layers or as a simple layer.	Value Table
Polygons for containers (Optional)	Specifies whether layers will be added to represent container point features or container junction objects as polygon features in the diagrams. Value table columns: Network Source—The name of the container point feature source class or container junction object table to include as a polygon layer. Subtype Layer—The associated layer will be created with subtype group layers or as a simple layer.	Value Table
Points for junction objects (Optional)	Specifies whether layers will be added to represent junction objects as point features in the diagrams. Value table columns: Network Source—The name of the network junction object source table to include as a point layer. Subtype Layer—The associated layer will be created with subtype group layers or as a simple layer.	Value Table
Polylines for edge objects (Optional)	Specifies whether layers will be added to represent edge objects as polyline features in the diagrams. Value table columns: Network Source—The name of the network edge object source table to include as a polyline layer. Subtype Layer—The associated layer will be created with subtype group layers or as a simple layer.	Value Table
Overwrite all layers (Optional)	Specifies whether all existing layers under the diagram layer will be overwritten or preserved except those in the input network map and explicitly specified additional sublayers. Checked—The diagram layer definition will be initialized or entirely reset (overwritten) including layers in the input map and specified additional sublayers. This is the default. Unchecked—All existing layers under the diagram layer will be preserved except those in the input network map as well as additional sublayers explicitly specified.	Boolean
Merging With Existing Layer Definitions (Optional)	Specifies how the input network map layers and existing diagram layers will be merged when the Overwrite all layers parameter is unchecked. This parameter applies to input network map layers related to network sources that are already present among the diagram layers. This parameter determines whether these input layers must replace the current diagram layers or be added to the existing diagram layers. Replace existing layers—The input network map layers related to network sources already present among the diagram layers will replace the current diagram layers. This is the default. Add new layers—The input network map layers related to network sources already present among the diagram layers will be added to the existing diagram layers.	String

Derived output

Label	Explanation	Data type
Output Network	The updated utility network or trace network layer.	Utility Network Layer; Trace Network Layer
Output Diagram Template	The name of the diagram template.	String

Environments

This tool does not use any geoprocessing environments.

Licensing information

• Basic: No
• Standard: Yes
• Advanced: Yes

Related topics

• An overview of the Configuration toolset
• Find a geoprocessing tool
• Introduction to the diagram layer definition
• Introduction to diagram templates
• Export Diagram Layer Definition
• Import Diagram Template Definitions