Summary
Overwrites the contents of a network diagram with the network elements currently selected in the specified map. These network elements become the new initial content of the diagram.
Caution:
If you have an open edit session, you must save your edits prior to running this tool. This ensures that the diagram reflects the latest changes made to the network topology in the database. If you fail to save your edits, the edits will not be reflected in the diagram.
Usage
This tool is not supported when working with a database connection to a utility network or trace network in an enterprise geodatabase. You must use either the related published utility network or trace network service, or a utility network or trace network in a file geodatabase.
The input network diagram layer must be from either a utility network or a trace network in a file geodatabase or a network diagram service.
The input network diagram layer and network data in the input map must share the same utility network or trace network in a file geodatabase, or the same branch version of a utility network or trace network service.
The All Layers mode must be enabled on the input network diagram layer.
Use this tool to quickly change the contents of a diagram.
This tool can operate on network features selected in layers and network objects selected in nonspatial tables that are referenced in the input map.
Any nonnetwork elements that have been selected will not be included in the diagram. If only nonnetwork elements have been selected, the process fails.
For a temporary diagram, overwriting completely re-creates the diagram from the network elements specified as input. However, overwriting a stored diagram persists the position of the diagram features that already existed in the diagram prior to the operation.
Running this tool on subnetwork system diagrams will fail; these diagrams are exclusively maintained by the Update Subnetwork tool. You cannot alter this type of diagram.
The Overwrite Diagram tool fails in the following situations:
- There are dirty areas on input network features used to overwrite the diagram.
- There are dirty areas on container network features related to network objects used as input to overwrite the diagram.
Syntax
arcpy.nd.OverwriteDiagram(in_network_diagram_layer, map)
| Parameter | Explanation | Data Type |
in_network_diagram_layer | The network diagram to overwrite. | Diagram Layer |
map | The map referencing the set of selected network elements to use to overwrite the input network diagram. | Map |
Derived Output
| Name | Explanation | Data Type |
| out_network_diagram_layer | The updated network diagram. | Diagram Layer |
Code sample
Overwrite a diagram with the set of network features and network objects currently selected in the active map (Map1).
import arcpy
arcpy.OverwriteDiagram_nd('Temporary Diagram', 'Map1')Environments
Licensing information
- Basic: No
- Standard: Yes
- Advanced: Yes