Importar definiciones de circuito (Herramientas de red de servicios)

Resumen

Importa información de circuitos de una serie de archivos .csv a las tablas de administración de circuitos de una red de dominio de telecomunicaciones.

Los archivos .csv generados por la herramienta Exportar definiciones de circuito pueden utilizarse como entrada para esta herramienta. Los archivos .csv importados rellenarán las tablas Circuitos, Sección de circuitos y Subcircuitos con información sobre los componentes que forman los circuitos de la red de dominio de telecomunicaciones.

Más información sobre la importación de definiciones de circuitos

Uso

El parámetro Red de servicios de entrada debe hacer referencia a una red de servicios que contenga una red de dominio de telecomunicaciones.
Las entidades enumeradas en los archivos .csv de entrada deben existir en la red de servicios.
Los nombres de Circuitos, Sección de circuitos y Subcircuitos deben ser únicos en la red de dominio de telecomunicaciones y no pueden superar los 124 caracteres.
Los circuitos sin secciones se pueden importar y crear sin información sobre la ubicación de partida y parada; sin embargo, la ubicación de partida o parada de un circuito sin secciones no puede estar vacía si la ubicación de inicio o fin correspondiente está ocupada.
Al trabajar con una geodatabase corporativa, el valor del parámetro Red de servicios 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.

Los .csv archivos deben contener las columnas descritas en las siguientes tablas y ajustarse al formato especificado. Se pueden importar campos de atributos adicionales definidos por el usuario siempre que exista un campo con el mismo nombre en la tabla de administración de circuitos de destino.

Columnas .csv de la tabla Circuito


Columna	Descripción	Ejemplo
`CIRCUITNAME`	El nombre del circuito que se creará. Debe ser único en la red de dominio de telecomunicaciones.	23/ABC/123456/789/ER/1
`STARTLOCATIONSOURCENAME`	El nombre de la clase de entidad u objeto a la que se aplica el punto inicial del circuito. El nombre se corresponde con el Id. de origen de la clase. El nombre se utiliza cuando se modela un circuito no seccionado con un único punto de inicio y parada. El nombre es NULO cuando el valor del campo `ISSECTIONED` es `TRUE`.	TelcoJunctionObject
`STARTLOCATIONID`	El Id. global de la entidad u objeto que está asociado con el punto de inicio en el circuito. Se utiliza cuando se modela un circuito no seccionado con un único punto de inicio y parada. Es NULO cuando el valor del campo `ISSECTIONED` es `TRUE`.	{4E0AAF9B-F37B-433A-AC3B-EA385DD0AD92}
`STARTLOCATIONFIRSTUNIT`	El primer identificador de unidad en el rango para el punto de inicio del circuito. Se utiliza cuando se modela un circuito no seccionado con un único punto de inicio y parada. Es NULO cuando el valor del campo `ISSECTIONED` es `TRUE`.	1
`STARTLOCATIONLASTUNIT`	El último identificador de unidad en el rango para el punto de inicio del circuito. Se utiliza cuando se modela un circuito no seccionado con un único punto de inicio y parada. Es NULO cuando el valor del campo `ISSECTIONED` es `TRUE`.	12
`STOPLOCATIONSOURCENAME`	El nombre de la clase de entidad u objeto utilizada para el punto de parada en el circuito. Se utiliza cuando se modela un circuito no seccionado con un único punto de inicio y parada. Es NULO cuando el valor del campo `ISSECTIONED` es `TRUE`.	TelcoJunctionObject
`STOPLOCATIONID`	El Id. global de la entidad u objeto que está asociado con el punto de parada en el circuito. Se utiliza cuando se modela un circuito no seccionado con un único punto de inicio y parada. Es NULO cuando el valor del campo `ISSECTIONED` es `TRUE`.	{1877F786-AD5A-4461-83C9-8A8B12479FF8}
`STOPLOCATIONFIRSTUNIT`	El primer identificador de unidad en el rango para el punto de parada del circuito. Se utiliza cuando se modela un circuito no seccionado con un único punto de inicio y parada. Es NULO cuando el valor del campo `ISSECTIONED` es `TRUE`.	1
`STOPLOCATIONLASTUNIT`	El último identificador de unidad en el rango para el punto de parada del circuito. Se utiliza cuando se modela un circuito no seccionado con un único punto de inicio y parada. Es NULO cuando el valor del campo `ISSECTIONED` es `TRUE`.	5
`ISSECTIONED`	Especifica si el circuito se modela con secciones. True False	False
`CIRCUITTYPE`	Especifica si el circuito es un circuito físico o un circuito virtual. Un circuito se considera virtual cuando contiene una o más secciones en las que el valor del campo `SECTIONTYPE` es `Virtual`. Postal Virtual	Postal
`SECTIONORDER`	Gráfico de conectividad lógica entre secciones de un circuito dividido como cadena de caracteres en formato JSON. Por ejemplo, con un circuito que consta de tres secciones (1, 2 y 3), el orden de las secciones debería representarse como `{"1":[2],"2":[3],"3":[]}` cuando la sección 1 está conectada a la sección 2 y la sección 2 está conectada a la sección 3. Si se utiliza un ejemplo con un circuito que consta de cuatro secciones (1, 2, 3 y 4), el orden de las secciones debería representarse como `{"1":[2,4],"2":[3],"3":[]}` cuando la sección 1 está conectada a la sección 2 y la sección 4 y la sección 2 está conectada a la sección 3. Cuando no existe ninguna conexión entre secciones, todas las secciones del circuito se interpretan como dispuestas en paralelo, lo que también podría representarse como `{"1":[],"2":[],"3":[]}`. Si no se proporciona ningún valor y el valor del campo `ISSECTIONED` es `TRUE`, se almacena un par de llaves vacías en el campo para indicar que no se ha definido el orden de esa sección correspondiente al circuito dividido. Es NULO cuando el valor del campo `ISSECTIONED` es `FALSE`.	`{"1":[2,4],"2":[3],"3":[]}`
`GLOBALID`	El Id. global opcional para el circuito. Se puede proporcionar un GUID proporcionado por el usuario para servir como Id. global del circuito. Este GUID ser único en la red de dominio de telecomunicaciones. Cuando este campo está vacío, se crea un Id. global para el circuito.	{6EBDCABE-571F-4DB0-AE01-4FDC81EBAE61}

Columnas .csv de la tabla CircuitSection


Columna	Descripción	Ejemplo
`CIRCUITNAME`	El nombre del circuito al que se aplica la sección.	34/DEF/789123/456/ER/1
`STARTLOCATIONSOURCENAME`	El nombre de la clase de entidad u objeto al que se aplica el punto de inicio del registro de sección. Se corresponde con el Id. de origen de la clase.	TelcoJunctionObject
`STARTLOCATIONID`	El Id. global de la entidad u objeto que está asociado con el punto de inicio. Si la sección del circuito está asociada a un subcircuito, debe hacer referencia al Id. global del subcircuito.	{939164F0-0EAA-4010-998F-64FAE34CA469}
`STARTLOCATIONFIRSTUNIT`	El primer identificador de unidad en el rango para el punto de inicio de la sección. Es NULL cuando la sección del circuito está asociada a un subcircuito.	1
`STARTLOCATIONLASTUNIT`	El último identificador de unidad en el rango para el punto de inicio de la sección. Es NULL cuando la sección del circuito está asociada a un subcircuito.	6
`STOPLOCATIONSOURCENAME`	El nombre de la clase de entidad u objeto utilizada para el punto de parada de la sección. Se corresponde con el Id. de origen de la clase. Es NULL cuando la sección del circuito está asociada a un subcircuito.	TelcoJunctionObject
`STOPLOCATIONID`	El Id. global de la entidad u objeto que está asociado con el punto de parada de la sección. Es NULL cuando la sección del circuito está asociada a un subcircuito.	{33C63920-0057-44AC-AE69-8D841C6CEA2A}
`STOPLOCATIONFIRSTUNIT`	El primer identificador de unidad en el rango para el punto de parada de la sección. Es NULL cuando la sección del circuito está asociada a un subcircuito.	2
`STOPLOCATIONLASTUNIT`	El último identificador de unidad en el rango para el punto de parada de la sección. Es NULL cuando la sección del circuito está asociada a un subcircuito.	5
`ROLE`	Especifica el rol del registro de sección en el circuito. Se utiliza para identificar las secciones de inicio, fin y punto intermedio de un circuito. Utiliza un dominio de valores codificados mantenido por el sistema, como sigue: `Start and End` `Start` `End` `Midspan`	Inicio y fin
`SECTIONTYPE`	Especifica si la sección del circuito es física o virtual. Postal Virtual	Virtual
`GLOBALID`	El Id. global opcional para la sección de circuito. Se puede proporcionar un GUID proporcionado por el usuario para servir como Id. global de la sección del circuito. Este GUID ser único en la red de dominio de telecomunicaciones. Cuando este campo está vacío, se crea un Id. global para la sección.	{B3D62897-D2FF-40DD-8B23-10C9D6D4EAF4}

Columnas .csv de la tabla Subcircuito


Columna	Descripción	Ejemplo
`SUBCIRCUITNAME`	El nombre del subcircuito que se creará. Debe ser único en el circuito.	32/SUB/012345/ER/15
`PROVIDERNAME`	El nombre del circuito en el que participa el subcircuito.	34/DEF/789123/456/ER/2
`GLOBALID`	El Id. global opcional para el subcircuito. Se puede proporcionar un GUID proporcionado por el usuario para servir como Id. global del subcircuito. Este GUID ser único en la red de dominio de telecomunicaciones. Cuando este campo está vacío, se crea un Id. global para el subcircuito.	{E35BFF25-3DCD-4951-AD73-10C1A02CB7F6}

Etiqueta	Explicación	Tipo de datos
Red de servicios de entrada	La red de servicios a la que se importarán las definiciones de circuitos.	Utility Network; Utility Network Layer
Red de dominio	La red de dominio de telecomunicaciones a la que se importará la definición del circuito.	String
Archivo de circuitos de entrada (.csv) (Opcional)	El archivo `.csv` que contiene las definiciones de circuito que se importarán.	File
Archivo de secciones del circuito de entrada (.csv) (Opcional)	El archivo `.csv` que contiene las definiciones de la sección del circuito que se importarán.	File
Archivo de subcircuitos de entrada (.csv) (Opcional)	El archivo `.csv` que contiene las definiciones de subcircuito que se importarán.	File

Salida derivada

Etiqueta	Explicación	Tipo de datos
Red de servicios de salida	La red de servicios actualizada.	Utility Network

arcpy.un.ImportCircuitDefinitions(in_utility_network, domain_network, {circuits_csv_file}, {circuit_sections_csv_file}, {subcircuits_csv_file})

Nombre	Explicación	Tipo de datos
in_utility_network	La red de servicios a la que se importarán las definiciones de circuitos.	Utility Network; Utility Network Layer
domain_network	La red de dominio de telecomunicaciones a la que se importará la definición del circuito.	String
circuits_csv_file (Opcional)	El archivo `.csv` que contiene las definiciones de circuito que se importarán.	File
circuit_sections_csv_file (Opcional)	El archivo `.csv` que contiene las definiciones de la sección del circuito que se importarán.	File
subcircuits_csv_file (Opcional)	El archivo `.csv` que contiene las definiciones de subcircuito que se importarán.	File

Salida derivada

Nombre	Explicación	Tipo de datos
out_utility_network	La red de servicios actualizada.	Utility Network

Muestra de código

Ejemplo de ImportCircuitDefinitions (ventana de Python)

Este script de muestra importa definiciones de circuitos para rellenar las tablas Sección de circuitos y Subcircuito utilizando dos archivos .csv en una red de dominio de telecomunicaciones llamada Telco y una red de servicios llamada TelcoNetwork. El archivo .csv de la tabla Circuito no se incluye, ya que se importó anteriormente para que los circuitos existan como referencia al importar las secciones y subcircuitos.

import arcpy
arcpy.un.ImportCircuitDefinitions("TelcoNetwork", "Telco", "",
                                  "C:\\Temp\\myCircuitSectionSources.csv",
                                  "C:\\Temp\\mySubcircuitSources.csv")

Entornos

Esta herramienta no utiliza ningún entorno de geoprocesamiento.

Información de licenciamiento

Standard: Sí
Avanzado: Sí

Importar definiciones de circuito (Herramientas de red de servicios)

Resumen

Uso

Parámetros

Salida derivada

Entornos

Información de licenciamiento

Temas relacionados