If the diagram is related to a utility network or trace network in an enterprise geodatabase, only the diagram owner and the portal utility network owner or the portal trace network owner can use the Alter Diagram Properties tool to change the access right level of the input diagram.
License:
The active portal account must be assigned a license with the ArcGIS Advanced Editing user type extension to use this tool in an enterprise deployment.
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 or mobile geodatabase.
The input network diagram layer must be from either a utility network or a trace network in a file or mobile geodatabase. or a network diagram service.
The tool alters diagram properties that have been initialized on your stored diagrams. With this tool, you can do the following:
Specifies the access right level of the input diagram.
Public—Other users will have full access to the diagram; everyone can see, edit, update, and overwrite the diagram. However, no one except the diagram owner and the portal utility network owner—in the case of diagrams related to a utility network in an enterprise geodatabase—can use the Alter Diagram Properties tool to change the access right level. This is the default.
Protected—Other users will have read-only access to the diagram. They cannot edit, update, or overwrite the diagram.
Private—Other users will not have access to the diagram. The corresponding diagram item will be hidden from other users in the Find Diagrams pane.
String
Tags (optional)
(Optional)
One or several tags that will help find the stored diagram. These tags can be used in the Find Diagrams pane.
To add several tags, use the number sign (#) to separate each tag. This also allows a more thorough and efficient diagram search.
Specifies the access right level of the input diagram.
PUBLIC—Other users will have full access to the diagram; everyone can see, edit, update, and overwrite the diagram. However, no one except the diagram owner and the portal utility network owner—in the case of diagrams related to a utility network in an enterprise geodatabase—can use the Alter Diagram Properties tool to change the access right level. This is the default.
PROTECTED—Other users will have read-only access to the diagram. They cannot edit, update, or overwrite the diagram.
PRIVATE—Other users will not have access to the diagram. The corresponding diagram item will be hidden from other users in the Find Diagrams pane.
String
tags
(Optional)
One or several tags that will help find the stored diagram. These tags can be used in the Find Diagrams pane.
To add several tags, use the number sign (#) to separate each tag. This also allows a more thorough and efficient diagram search.
String
Derived output
Name
Explanation
Data type
out_network_diagram_layer
The updated network diagram.
Diagram Layer
Code sample
AlterDiagramProperties example (stand-alone script)
The following stand-alone script uses the AlterDiagramProperties tool to retrieve a stored network diagram in the database and change its properties.
# Name: AlterDiagramProperties.py
# Description: Retrieve a stored diagram and change its properties.
# Import system modules
import arcpy
# Initialize variables
input_network = "https://cezembre.esri.com/server/rest/services/Naperville_ORA/FeatureServer/8"
input_DiagramName = "Test"
# Set overwrite option
arcpy.env.overwriteOutput = True
# Retrieving a given stored diagram and transforming it as a diagram layer
arcpy.nd.MakeDiagramLayer(input_network, input_DiagramName, "built_diagramlayer")
# Renaming this diagram to "SmartTree1_Test", changing its access right
# level, and specifying tags
arcpy.nd.AlterDiagramProperties("built_diagramlayer", "SmartTree1_Test",
"PROTECTED",
"Distribution#RMT0003#Naperville North East")
Environments
This tool does not use any geoprocessing environments.