Append network elements to a network diagram

Appending network elements to a network diagram allows you to add any network features and network objects that were not included when the diagram was generated. In particular, it allows you to add any new network elements that didn't exist at the time the diagram was generated.

You can append network elements to a network diagram using the Append commands in the Manage group on the Network Diagram ribbon, or in the Diagram group on the Data tab of the Utility Network or Trace Network tab set. The Append to Diagram geoprocessing tool can also be used.

Note:

Appending network elements to subnetwork system diagrams is not allowed because these diagrams are exclusively maintained by the Update Subnetwork tool.

Requirements

The following prerequisites must be met before appending network elements to a diagram:

• The network topology must be enabled.
• Since this operation is transactional, edits must be saved before it is run.
• This operation applies to a network diagram layer that is from either a utility network or trace network in a file geodatabase, or a network diagram service. When working with a utility network or trace network in an enterprise geodatabase, the input network diagram layer must be from a service.
• The related diagram template must enable the diagram to be extended.
• There are network features or network objects selected in the network map you specified for the appending process.
• The network features or network objects selected in the specified network map and the network diagram must share the same trace network or the same utility network branch version.
• There are no dirty areas on the network features initially used to generate the diagram, whether they are visible or aggregated.
• There are no dirty areas on the container features related to the network objects initially used to generate the diagram, whether they are visible or aggregated.
• There are no dirty areas on the network features appended to the diagram.
• There are no dirty areas on the container features related to the network objects appended to the diagram.
• The All Layers diagram mode must be turned on for the diagram layer to which the operation applies so all layers are present in the Contents pane whether they contain diagram features or not. If it is turned off, click All Layers in the Manage group of the Network Diagram tab.

Caution:

With this version, if you have an edit session open, you must save edits before appending network elements to your diagram. This allows the network and diagram edits to be consistent. Without saving, none of the unsaved edits will be reflected in this diagram.

Append network elements to a network diagram

There are two possible ways to append network elements to an existing diagram: either from the Utility Network or Trace Network contextual tab or from the Network Diagram home tab.

Before you begin one of the workflows below, complete the following steps to open the desired diagram and select the network elements you want to append to it:

1. If the diagram you want to modify is not already open, run the Find Diagram function on the Network Diagram tab. Alternatively, under the Utility Network or Trace Network tab set, on the Data tab, find and open the diagram you want to work with.
2. Open the map view that references the network.
3. Select the network features and network objects you want to append to the diagram.

Append network elements currently selected in the active map to a network diagram

1. Activate the map that references the network elements you selected and want to append to your diagram.
2. Click the network layer in the Contents pane.
3. Under the Utility Network or Trace Network tab set, on the Data tab, click the drop-down arrow under the Append button on the Diagram group, and click the diagram to which you want the selected network elements to be appended.

   The diagrams proposed in the drop-down list are those referenced in any open map and currently displayed with the All Layers mode turned on. If none of the open diagrams fit these conditions, the drop-down list displays No valid maps.

Append network elements currently selected in a map to the active network diagram

1. Activate the diagram map referencing the network diagram to which you want to append network elements.
2. Click the network diagram layer corresponding to the diagram to which you want to append network elements.
3. On the Network Diagram tab, click the drop-down arrow under the Append button in the Modify group. Click the map containing the set of network elements you want to append to the active diagram.

   The maps proposed in the drop-down list are those that are open and reference the same network as the one related to the active diagram.

About the network diagram appending process

In both workflows, when the tool runs, the append process creates diagram features corresponding to network features and network objects selected on the map and executes a complete update of the diagram content with regard to the network elements that were initially used to generate the diagram. It also reruns any rules that may be configured on the diagram template. The positions of the diagram features that existed before the append are preserved; any new features added or appended to the diagram display according to the following rules:

• Any diagram point junction representing a network point feature displays at the point feature geographic position.
• Any diagram point junction representing a network polygon feature is placed at the center of the feature boundary envelope.
• Any diagram point junction representing a network junction object is placed at best inside the diagram polygon container representing its spatial container with some or all other contents.
• Any diagram polygon container representing a container point feature displays as a rectangle around its contents which center is placed at the point feature geographic position.
• Any diagram polygon container representing a container polygon feature displays as a rectangle around its contents which center is placed at the center of the feature boundary envelope.
• Any diagram polygon container representing a container junction object displays as a rectangle around its contents and placed at best inside its own diagram polygon container.
• Any diagram edge representing a network edge object displays as a straight line between its from and to diagram junction.
• Any diagram edge representing a network line feature displays with the line feature geometry when the diagram template is configured to keep initial vertices on edges, otherwise it displays as a straight line between its from and to diagram junction.