Импорт определений контура (Инструменты инженерной сети)

Краткая информация

Импортирует информацию о контуре из серии файлов .csv в таблицы управления контурами специализированной сети телекоммуникаций.

Файлы .csv, созданные инструментом Экспорт определений контуров, могут использоваться как входные для этого инструмента. Импортированные файлы .csv заполняют таблицы Circuit, CircuitSection и Subcircuits информацией о компонентах, из которых состоят контуры в специализированной сети телекоммуникаций.

Более подробно об импорте определений контура

Использование

• Параметр Входная инженерная сеть должен ссылаться на инженерную сеть, содержащую специализированную сеть телекоммуникаций.

• Объекты, перечисленные во входных файлах .csv, должны существовать в инженерной сети.

• Имена Circuit, CircuitSection и Subcircuits должны быть уникальными в специализированной сети телекоммуникаций и не должны превышать 124 символов.

• Несекционный контур может быть создан без начального и конечного местоположения; однако начальное или конечное местоположение для несекционного контура не может быть пустым, если соответствующее начальное или конечное местоположение заполнено.

• При работе с многопользовательской базой геоданных, в значении параметра Входная инженерная сеть должно быть указано подключение к базе данных, установленное от имени владельца базы данных инженерной сети.

• Файлы .csv должны содержать столбцы, описанные в следующих таблицах, и соответствовать заданному формату. Дополнительные пользовательские атрибутные поля могут быть импортированы, когда в целевой таблице управления контуром существует поле с совпадающим именем.

  • Столбцы .csv в таблице Контур

    Столбец	Описание	Пример
    CIRCUITNAME	Название контура, который будет создан. Оно должно быть уникальным в специализированной сети телекоммуникаций.	23/ABC/123456/789/ER/1
    STARTLOCATIONSOURCENAME	Название класса объектов или элементов, к которым относится начальная точка контура. Имя сопоставляется с ID источника для класса. Имя используется при моделировании несекционного контура с одной начальной точкой и точкой остановки. Имя равно NULL, когда значением поля ISSECTIONED является TRUE.	TelcoJunctionObject
    STARTLOCATIONID	Глобальный идентификатор объекта или элемента, связанного с начальной точкой контура. Используется при моделировании несекционного контура с одной начальной точкой и точкой остановки. Оно равно NULL, когда значением поля ISSECTIONED является TRUE.	{4E0AAF9B-F37B-433A-AC3B-EA385DD0AD92}
    STARTLOCATIONFIRSTUNIT	Первый идентификатор устройства в диапазоне для начальной точки контура. Используется при моделировании несекционного контура с одной начальной точкой и точкой остановки. Оно равно NULL, когда значением поля ISSECTIONED является TRUE.	1
    STARTLOCATIONLASTUNIT	Последний идентификатор устройства в диапазоне для начальной точки контура. Используется при моделировании несекционного контура с одной начальной точкой и точкой остановки. Оно равно NULL, когда значением поля ISSECTIONED является TRUE.	12
    STOPLOCATIONSOURCENAME	Название класса объектов или элементов для точки остановки в контуре. Используется при моделировании несекционного контура с одной начальной точкой и точкой остановки. Оно равно NULL, когда значением поля ISSECTIONED является TRUE.	TelcoJunctionObject
    STOPLOCATIONID	Глобальный идентификатор объекта или элемента, связанного с точкой останова контура. Используется при моделировании несекционного контура с одной начальной точкой и точкой остановки. Оно равно NULL, когда значением поля ISSECTIONED является TRUE.	{1877F786-AD5A-4461-83C9-8A8B12479FF8}
    STOPLOCATIONFIRSTUNIT	Первый идентификатор устройства в диапазоне для точки останова контура. Используется при моделировании несекционного контура с одной начальной точкой и точкой остановки. Оно равно NULL, когда значением поля ISSECTIONED является TRUE.	1
    STOPLOCATIONLASTUNIT	Последний идентификатор устройства в диапазоне для точки останова контура. Используется при моделировании несекционного контура с одной начальной точкой и точкой остановки. Оно равно NULL, когда значением поля ISSECTIONED является TRUE.	5
    ISSECTIONED	Указывает, смоделирован ли контур с разделами. True False	False
    CIRCUITTYPE	Указывает, является ли контур физическим или виртуальны контуром. Контур считается виртуальным, если он содержит один или несколько разделов, в которых значение поля SECTIONTYPE является Virtual. Физический Виртуальный	Физический
    SECTIONORDER	График логической связности между секциями для секционированного контура в виде строки в формате JSON. Например, для контура, состоящей из трех секций (1, 2 и 3), когда секция 1 соединена с секцией 2, а секция 2 соединена с секцией 3, порядок секций будет представлен как {"1":[2],"2":[3],"3":[]}. Используя пример с контуром, состоящим из четырех секций (1, 2, 3 и 4), когда секция 1 подключена к секции 2 и секции 4, а секция 2 подключена к секции 3, порядок расположения секций будет представлен как {"1":[2,4],"2":[3],"3":[]}. Если между секциями нет связи, все секции контура интерпретируются как расположенные параллельно, что также может быть представлено как {"1":[],"2":[],"3":[]}. Если значение не указано, а значение поля ISSECTIONED равно TRUE, в поле сохраняется пустая пара фигурных скобок, указывающая на то, что порядок расположения секций контура с секциями не определен. Оно равно NULL, когда значением поля ISSECTIONED является FALSE.	{"1":[2,4],"2":[3],"3":[]}
    GLOBALID	Дополнительный глобальный ID для контура. В качестве глобального ID контура может быть предоставлен пользовательский GUID. GUID должен быть уникальным в специализированной сети телекоммуникаций. Когда это поле пустое, для контура создаётся глобальный ID.	{6EBDCABE-571F-4DB0-AE01-4FDC81EBAE61}

  • Таблица CircuitSection в формате .csv

    Столбец	Описание	Пример
    CIRCUITNAME	Название контура, к которому относится раздел.	34/DEF/789123/456/ER/1
    STARTLOCATIONSOURCENAME	Название класса объектов или элементов, к которым применяется начальная точка для записи раздела. Оно сопоставляется с исходным идентификатором класса.	TelcoJunctionObject
    STARTLOCATIONID	Глобальный идентификатор объекта или элемента, связанного с начальной точкой. Когда раздел контура связан с подконтуром, он должен ссылаться на глобальный идентификатор подконтура.	{939164F0-0EAA-4010-998F-64FAE34CA469}
    STARTLOCATIONFIRSTUNIT	Первый идентификатор устройства в диапазоне для начальной точки раздела. Это значение NULL, если раздел контура связан с подконтуром.	1
    STARTLOCATIONLASTUNIT	Последний идентификатор устройства в диапазоне для начальной точки раздела. Это значение NULL, если раздел контура связан с подконтуром.	6
    STOPLOCATIONSOURCENAME	Название класса объектов или элементов для точки остановки в разделе. Оно сопоставляется с исходным идентификатором класса. Это значение NULL, если раздел контура связан с подконтуром.	TelcoJunctionObject
    STOPLOCATIONID	Глобальный идентификатор объекта или элемента, связанного с точкой останова раздела. Это значение NULL, если раздел контура связан с подконтуром.	{33C63920-0057-44AC-AE69-8D841C6CEA2A}
    STOPLOCATIONFIRSTUNIT	Первый идентификатор устройства в диапазоне для точки останова раздела. Это значение NULL, если раздел контура связан с подконтуром.	2
    STOPLOCATIONLASTUNIT	Последний идентификатор устройства в диапазоне для точки останова раздела. Это значение NULL, если раздел контура связан с подконтуром.	5
    ROLE	Задает роль записи раздела в контуре. Используется для определения начальной, конечной и средней секции контура. При этом используется поддерживаемый системой домен кодированных значений: Start and End Start End Midspan	Начало и Окончание
    SECTIONTYPE	Указывает, является ли секция контура физической или виртуальной. Физический Виртуальный	Виртуальный
    GLOBALID	Опциональный глобальный ID для секции цепи. В качестве глобального ID секции контура может быть предоставлен пользовательский GUID. GUID должен быть уникальным в специализированной сети телекоммуникаций. Когда это поле пусто, для секции создаётся глобальный идентификатор.	{B3D62897-D2FF-40DD-8B23-10C9D6D4EAF4}

  • Столбцы .csv в таблице Подконтур

    Столбец	Описание	Пример
    SUBCIRCUITNAME	Имя подконтура, который будет создан. Оно должно быть уникальным в контуре.	32/SUB/012345/ER/15
    PROVIDERNAME	Имя контура, в которой участвует подконтур.	34/DEF/789123/456/ER/2
    GLOBALID	Дополнительный глобальный ID для подконтура. В качестве глобального ID подконтура может быть предоставлен пользовательский GUID. GUID должен быть уникальным в специализированной сети телекоммуникаций. Когда это поле пустое, для подконтура создаётся глобальный ID.	{E35BFF25-3DCD-4951-AD73-10C1A02CB7F6}

Параметры

• Dialog
• Python

Подпись	Объяснение	Тип данных
Входная инженерная сеть	Инженерная сеть, в которую будут импортированы определения контуров.	Utility Network; Utility Network Layer
Специализированная сеть	Специализированная сеть телекоммуникаций, в которую будет импортировано определение контура.	String
Входной файл контуров (.csv) (Дополнительный)	Файл .csv, содержащий импортируемые определения контуров.	File
Входной файл Разделы контуров (.csv) (Дополнительный)	Файл .csv, содержащий импортируемые определения разделов контуров.	File
Входной файл подконтуров (.csv) (Дополнительный)	Файл .csv, содержащий импортируемые определения подконтуров.	File

Производные выходные данные

Подпись	Объяснение	Тип данных
Выходная инженерная сеть	Обновленная инженерная сеть	Utility Network

Параметры среды

Этот инструмент не использует параметры среды геообработки.

Информация о лицензировании

• Standard: Да
• Advanced: Да

Связанные разделы

• Обзор группы инструментов Администрирование
• Поиск инструмента геообработки