Добавить уровень (Инженерная сеть)

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

Создает новый уровень в специализированной сети инженерной сети.

Уровни являются наборами подсетей одного уровня, с одинаковыми правилами именования и типом топологии. Уровни требуются для управления подсетями.

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

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

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

• Уровни должны добавляться до присоединения данных в класс объектов инженерной сети. Если данные присоединяются перед добавлением нового уровня, это приведет к ошибке инструмента.

• Топология сети должна быть отключена.

• При работе с многопользовательской базой геоданных должны быть выполнены следующие требования:

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

Параметры

Диалог

Подпись	Описание	Тип данных
Входная инженерная сеть	Инженерная сеть, которая содержит специализированную сеть, к которой будет добавлена группа уровней.	Utility Network; Utility Network Layer
Специализированная сеть	Специализированная сеть, в которой будет создан уровень.	String
Имя	Название нового уровня. Имя должно быть уникальным по всей инженерной сети.	String
Ранг	Ранг добавляемого уровня. Высший ранг имеет номер 1.	Long
Тип топологии (Дополнительный)	Указывает тип топологии нового уровня. Подсети с типами топологии Радиальный и Сетка поддерживают один или несколько контроллеров подсети. В диалоговом окне инструмента этот параметр отключается, если входная специализированная сеть создана с иерархическим определением уровня, а тип топологии по умолчанию становится Сетка. Если специализированная сеть была создана с частичным определением уровня, этот параметр позволяет выбрать любой тип топологии с помощью ниспадающего списка. Для трассировки или управления подсетями этот параметр в настоящее время не обеспечивает разницы в поведении сети. Функциональность этого параметра пока находится в разработке и будет реализована в будущих версиях. Радиальный—Подсети будут иметь тип топологии Радиальный. Сетка—Подсети будут иметь тип топологии Сетка. Этот тип топологии используется по умолчанию для уровня, созданного с иерархическим определением уровня.	String
Имя группы уровней (Дополнительный)	Группа уровней, в которую будет добавлен новый уровень. Этот параметр является обязательным для специализированных сетей с иерархическим определением уровней.	String
Имя поля подсети (Дополнительный)	Имя поля, в котором будут храниться имена подсетей для данного уровня. Это системное поле, которое будет создано при первом добавлении уровня в группу уровней и которое будет снова использоваться для любых дополнительных уровней при их добавлении. Например, у вас две группы уровней: Распределение и Передача. Это поле будет создано, когда вы добавите в группу Распределение уровень с именем systemsubnet и укажете для поля подсети имя systemsubnet. Далее, второй уровень с именем system вы добавите в группу Передача. Этот параметр будет определять, будет ли использоваться поле systemsubnet как имя поля подсети. Для иерархических уровней этот параметр является обязательным.	String

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

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

Python

arcpy.un.AddTier(in_utility_network, domain_network, name, rank, {topology_type}, {tier_group_name}, {subnetwork_field_name})

Имя	Описание	Тип данных
in_utility_network	Инженерная сеть, которая содержит специализированную сеть, к которой будет добавлена группа уровней.	Utility Network; Utility Network Layer
domain_network	Специализированная сеть, в которой будет создан уровень.	String
name	Название нового уровня. Имя должно быть уникальным по всей инженерной сети.	String
rank	Ранг добавляемого уровня. Высший ранг имеет номер 1.	Long
topology_type (Дополнительный)	Указывает тип топологии нового уровня. Подсети с типами топологии Радиальный и Сетка поддерживают один или несколько контроллеров подсети. В диалоговом окне инструмента этот параметр отключается, если входная специализированная сеть создана с иерархическим определением уровня, а тип топологии по умолчанию становится Сетка. Если входная специализированная сеть создана с иерархическим определением уровня, по умолчанию используется тип топологии MESH. Если входная специализированная сеть создана с частичным определением уровня, параметр типа топологии является обязательным. Примечание: Для трассировки или управления подсетями этот параметр в настоящее время не обеспечивает разницы в поведении сети. Функциональность этого параметра пока находится в разработке и будет реализована в будущих версиях. RADIAL—Подсети будут иметь тип топологии Радиальный. MESH—Подсети будут иметь тип топологии Сетка. Этот тип топологии используется по умолчанию для уровня, созданного с иерархическим определением уровня.	String
tier_group_name (Дополнительный)	Группа уровней, в которую будет добавлен новый уровень. Этот параметр является обязательным для специализированных сетей с иерархическим определением уровней.	String
subnetwork_field_name (Дополнительный)	Имя поля, в котором будут храниться имена подсетей для данного уровня. Это системное поле, которое будет создано при первом добавлении уровня в группу уровней и которое будет снова использоваться для любых дополнительных уровней при их добавлении. Например, у вас две группы уровней: Распределение и Передача. Это поле будет создано, когда вы добавите в группу Распределение уровень с именем systemsubnet и укажете для поля подсети имя systemsubnet. Далее, второй уровень с именем system вы добавите в группу Передача. Этот параметр будет определять, будет ли использоваться поле systemsubnet как имя поля подсети. Для иерархических уровней этот параметр является обязательным.	String

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

Имя	Описание	Тип данных
out_utility_network	Обновленная инженерная сеть	Инженерная сеть

Пример кода

AddTier, пример 1 (окно Python)

Создание уровня в иерархической сети DistributionSystem с типом топологии MESH.

import arcpy
arcpy.AddTier_un("Utility Network", "GasDistribution", "Distribution System", 
                 1, "MESH", "Distribution", "System")

AddTier, пример 2 (окно Python)

Создание уровня в частичной сети MediumVoltage с типом топологии RADIAL.

import arcpy
arcpy.AddTier_un("Utility Network", "ElectricDistribution", "Medium Voltage", 
                 1, "RADIAL")

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

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

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

• Basic: Нет
• Standard: Да
• Advanced: Да