Ebene hinzufügen (Utility Network)

Zusammenfassung

Erstellt eine neue Ebene für eine Netzart in einem Versorgungsnetz.

Ebenen sind Sammlungen von Teilnetzen, bei denen Ebene, Namenseinschränkungen und Topologietyp identisch sind. Ebenen sind für die Verwaltung von Teilnetzen erforderlich.

Verwendung

• Bei Netzarten mit einer partitionierten Ebenendefinition für die erste der Netzart hinzugefügten Ebene wird ein Feld für den Teilnetznamen hinzugefügt. Bei Netzarten mit einer hierarchischen Ebenendefinition wird mithilfe des Parameterwertes Teilnetz-Feldname ein Teilnetz-Feldname erstellt. Weitere Informationen finden Sie unter Teilnetzname.

• Bei Netzarten mit einer hierarchischen Ebenendefinition ist der Ebenengruppenname ein erforderlicher Parameter. Mithilfe des Werkzeugs Ebenengruppe hinzufügen können Ebenengruppen für Netzarten mit einer hierarchischen Ebenendefinition erstellt werden.

• Ebenen sollten vor dem Anhängen von Daten in den Utility-Network-Feature-Classes hinzugefügt werden. Wenn Daten vor dem Hinzufügen einer neuen Ebene angehängt werden, tritt ein Fehler auf.

• Die Netzwerk-Topologie muss deaktiviert sein.

• Die folgenden Anforderungen müssen erfüllt werden, wenn mit einer Enterprise-Geodatabase gearbeitet wird:

  • Der Parameterwert Eingabe-Versorgungsnetz muss aus einer Datenbankverbindung stammen, die als Besitzer des Datenbank-Versorgungsnetzes hergestellt wurde.
  • Bei dem verbundenen ArcGIS Enterprise-Portal-Konto muss es sich um den Besitzer des Portal-Versorgungsnetzes handeln.
  • Dieses Werkzeug muss bei der Ausführung mit der Default-Version verbunden sein.

Syntax

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

Parameter	Erklärung	Datentyp
in_utility_network	Das Versorgungsnetz, das die Netzart enthält, der die Ebene hinzugefügt wird.	Utility Network; Utility Network Layer
domain_network	Die Netzart, in der die Ebene erstellt wird.	String
name	Der Name der neuen Ebene. Dieser Name muss im gesamten Versorgungsnetz eindeutig sein.	String
rank	Die Rangstufe der Ebene, die hinzugefügt wird. Die höchste Rangstufe ist die Nummer 1.	Long
topology_type (optional)	Gibt den Topologietyp für die neue Ebene an. Teilnetze der Topologietypen "Sternförmig" und "Vermascht" unterstützen einen oder mehrere Teilnetz-Controller. Dieser Parameter wird im Werkzeugdialogfeld deaktiviert, wenn die Eingabe-Netzart mit einer hierarchischen Ebenendefinition erstellt wurde und der Standard-Topologietyp "Vermascht" verwendet wird. Wenn die Eingabe-Netzart mit einer hierarchischen Ebenendefinition erstellt wurde, wird der Standard-Topologietyp MESH verwendet. Wenn die Eingabe-Netzart mit einer partitionierten Ebenendefinition erstellt wurde, ist der Topologietyp als Parameter erforderlich. Hinweis: Für die Verfolgung oder die Teilnetzverwaltung weist der Parameter derzeit kein unterschiedliches Verhalten auf. Die Funktionalität dieses Parameter befindet sich derzeit in Entwicklung und ist in einer zukünftigen Version verfügbar. RADIAL —Die Teilnetze weisen den Topologietyp "Sternförmig" auf. MESH —Die Teilnetze weisen den Topologietyp "Vermascht" auf. Dies ist der Standard-Topologietyp für eine Ebene, die mit einer hierarchischen Ebenendefinition erstellt wurde.	String
tier_group_name (optional)	Die vorhandene Ebenengruppe, der die neue Ebene hinzugefügt wird. Dieser Parameter ist für Netzarten mit einer hierarchischen Ebenendefinition erforderlich.	String
subnetwork_field_name (optional)	Der Name des Feldes, in dem die Teilnetznamen für diese Ebene gespeichert werden. Dies ist ein vom System verwaltetes Feld, das erstellt wird, wenn eine Ebene zum ersten Mal einer Ebenengruppe hinzugefügt wird. Danach wird es für weitere Ebenen wiederverwendet. Beispielsweise haben Sie zwei Ebenengruppen: Verteilung und Übertragung. Wenn Sie der Gruppe "Verteilung" eine Ebene namens "system" hinzufügen und als Teilnetzwerk-Feldname systemsubnet festlegen, wird das Feld erstellt. Dann fügen Sie der Gruppe "Übertragung" eine zweite Ebene namens "system" hinzu. Dieser Parameter erkennt, dass das Feld systemsubnet als Teilnetzwerk-Feldname verwendet werden soll. Dieser Parameter ist für hierarchische Ebenentypen erforderlich.	String

Abgeleitete Ausgabe

Name	Erklärung	Datentyp
out_utility_network	Das aktualisierte Versorgungsnetz.	Versorgungsnetz

Codebeispiel

AddTier – Beispiel 1 (Python-Fenster)

Es wird eine Ebene im hierarchischen Netzwerk "DistributionSystem" mit dem Topologietyp MESH erstellt.

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

AddTier – Beispiel 2 (Python-Fenster)

Es wird eine Ebene im partitionierten Netzwerk "MediumVoltage" mit dem Topologietyp RADIAL erstellt.

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

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

• Basic: Nein
• Standard: Ja
• Advanced: Ja