Resumen
Modifica las propiedades de una plantilla de diagrama, como su nombre, cómo gestiona los vértices a lo largo de los ejes de la red de entrada, si los diagramas relacionados se pueden almacenar o extender, el margen entre contenedores y su contenido en estos diagramas, la eliminación de sus reglas y diseño y el restablecimiento de la definición predeterminada de la capa de diagrama.
Nota:
El cambio de tamaño del margen de contenedor o la eliminación de la regla de diagrama y las definiciones de diseño hacen que el valor del campo Consistency correspondiente a un diagrama existente basado en la plantilla de diagrama de entrada cambie a incoherente en la base de datos. Todos estos diagramas seguirán siendo incoherentes y presentarán un icono de advertencia de coherencia al abrirlos hasta que se actualicen.
Precaución:
Esta herramienta es una herramienta de configuración y administración.
Uso
Esta herramienta no se admite al trabajar con un servicio de red de servicios o red de trazado. Debe utilizar una red de servicios o red de trazado de una geodatabase de archivos o una conexión de base de datos a una red de servicios o red de trazado de una geodatabase corporativa. Al trabajar con una geodatabase corporativa, existen estos requisitos:
- El valor del parámetro Red de entrada debe provenir de una conexión de base de datos establecida como propietaria de la red de servicios de la base de datos o propietaria de la red de trazado de la base de datos.
- La cuenta del portal de ArcGIS Enterprise conectada debe ser la propietaria de la red de servicios del portal o la propietaria de la red de trazado del portal.
- Esta herramienta se debe conectar a la versión predeterminada, que se espera que sea pública y no protegida.
El elemento de datos de red especificado como parámetro de Red de entrada debe provenir de una red de servicios o red de trazado de una geodatabase de archivos o una conexión de base de datos a una red de servicios o red de trazado de una geodatabase corporativa.
Esta herramienta admite las siguientes modificaciones de las propiedades específicas de la plantilla de diagrama:
- Cambio del nombre de la plantilla
- Definición de una plantilla como plantilla predeterminada
- Eliminación de las definiciones de reglas y diseños
- Restablecimiento de la definición predeterminada de capa de diagrama
- Especificación de la forma en que trabaja con los vértices a lo largo de los ejes de la red de entrada
- Definición del tamaño del margen entre contenedores y su contenido
- Deshabilitar la función de almacenamiento de esos diagramas
- Habilitar las funciones de extensión de diagrama
La inicialización de vértices a lo largo de los ejes de diagrama durante la generación de diagramas y la gestión de estos en la presentación de diagramas requiere tiempo. Para evitar que afecte al rendimiento, active el parámetro Mantener vértices iniciales en los ejes solamente cuando sea necesario. Por ejemplo, si la plantilla se configura para ejecutar un diseño de diagrama automático durante la generación, active este parámetro para los diseños de diagrama Línea principal relativa y Ejes parcialmente superpuestos. Los demás tipos de diseño de diagrama no emplean vértices en los ejes de diagrama durante su ejecución; solo se ocupan de las posiciones de cruce de diagrama.
A partir de ArcGIS Pro 2.6, esta herramienta inicializa sistemáticamente una definición de capa de diagrama predeterminada correspondiente a la plantilla de diagrama de entrada, si no existe.
Al configurar un modelo para definir definiciones de reglas y diseños nuevas para una plantilla de diagrama, utilice la herramienta Modificar plantilla de diagrama con el parámetro Eliminar definiciones de reglas de plantillas de diagrama y diseños activado al principio del modelo. Esto hará que el modelo reinicialice las propiedades de la plantilla a los valores predeterminados.
Sintaxis
arcpy.nd.AlterDiagramTemplate(in_utility_network, template_name, {out_name}, {is_default_template}, {are_rules_and_layouts_removed}, {are_vertices_kept}, {container_margin}, {is_diagram_storage_enabled}, {is_diagram_extension_enabled}, {description}, {are_layer_definitions_removed})
Parámetro | Explicación | Tipo de datos |
in_utility_network | Red de servicios o red de trazado de la plantilla de diagrama que se desea modificar. | Utility Network; Trace Network |
template_name | El nombre de la plantilla de diagrama que se desea modificar. | String |
out_name (Opcional) | El nuevo nombre de la plantilla. | String |
is_default_template (Opcional) | Especifica el estado predeterminado de la plantilla.
La plantilla predeterminada es la utilizada al generar un diagrama si no se especifica ninguna plantilla. | Boolean |
are_rules_and_layouts_removed (Opcional) | Especifica si se eliminarán las definiciones de diseño y regla de la plantilla.
| Boolean |
are_vertices_kept (Opcional) | Especifica cómo se gestionarán los vértices a lo largo de los ejes de SIG en los diagramas basados en la plantilla.
Nota:Para garantizar el rendimiento, utilice la opción KEEP_VERTICES solamente cuando sea necesario. Si la plantilla se configura para ejecutar un diseño automático durante la generación de diagramas, por ejemplo, la opción KEEP_VERTICES es útil para los diseños de diagrama Línea principal relativa y Ejes parcialmente superpuestos. Los demás diseños de diagrama no utilizan la geometría de ejes de diagrama cuando se ejecutan. | Boolean |
container_margin (Opcional) | La distancia mínima entre el centro de cualquier cruce dentro del contenedor y el borde del contenedor. | Linear Unit |
is_diagram_storage_enabled (Opcional) | Especifica si se pueden almacenar los diagramas basados en la plantilla.
| Boolean |
is_diagram_extension_enabled (Opcional) | Especifica si se pueden extender los diagramas basados en la plantilla.
| Boolean |
description (Opcional) | La descripción de la plantilla. | String |
are_layer_definitions_removed (Opcional) | Especifica si la definición de la capa de plantilla de diagrama se va a restablecer en el valor predeterminado.
| Boolean |
Salida derivada
Nombre | Explicación | Tipo de datos |
out_utility_network | Red de servicios o red de trazado actualizada. | Red de servicios; red de trazado |
out_template_name | El nombre de la plantilla de diagrama. | Cadena |
Muestra de código
Este ejemplo aumenta el margen de contenedor para cualquier contenedor que pertenezca a diagramas basados en la plantilla ExpandContainers.
import arcpy
input_Network = "D:/MyProjectLocation/MyDatabaseConnection.sde/MyDatabase.MAP.Electric/MyDatabase.MAP.Electric"
arcpy.AlterDiagramTemplate_nd(input_Network, "ExpandContainers",
"ExpandContainers", "NOT_DEFAULT_TEMPLATE",
"DO_NOT_REMOVE_RULES_AND_LAYOUTS",
"KEEP_VERTICES", "0.3 Meters",
"ENABLE_DIAGRAM_STORAGE",
"DISABLE_DIAGRAM_EXTENSION",
None,
"DO_NOT_REMOVE_LAYER_DEFINITIONS")
Entornos
Información de licenciamiento
- Basic: No
- Standard: Sí
- Advanced: Sí