Anschlusspunktkonfiguration hinzufügen (Utility Network)

Zusammenfassung

Fügt eine Anschlusspunktkonfiguration zu einem vorhandenen Versorgungsnetz hinzu.

Bei Netzwerk-Features mit Anschlusspunkten sind Einschränkungen erforderlich, die die gültige Konfiguration der internen Konnektivität des Geräts oder Knotenobjekts definieren. Mit diesem Werkzeug können Sie einem Versorgungsnetz eine neue Anschlusspunktkonfiguration hinzufügen, die später mit dem Werkzeug Anschlusspunktkonfiguration festlegen einer Klasse auf der Ebene der Asset-Gruppen oder Asset-Typen zugewiesen werden kann.

Verwendung

  • Anschlusspunkte werden für ein Gerät oder Knotenobjekt konfiguriert, indem eine Anschlusspunktkonfiguration zugewiesen wird. Einem Asset-Typ, der Anschlusspunkte unterstützt, kann nur eine Anschlusspunktkonfiguration zugewiesen werden.

  • Die Anschlusspunkte eines Features oder Objekts verfügen über eine Richtungseinstellung. Sie können als unidirektional (nur eine Fließrichtung ist zulässig) oder bidirektional (beide Fließrichtungen sind zulässig) festgelegt werden.

  • Mindestens zwei Anschlusspunkte müssen angegeben und höchstens acht Anschlusspunkte können angegeben werden. Die Namen der Anschlusspunkte sollten eine aussagekräftige Beschreibung sein, z. B. High-Side oder Source-Side.

  • Für Features mit drei oder vier Anschlusspunkten können gültige Pfade definiert werden. Dies wurde für die Handhabung komplexer Schaltbauteile konzipiert, bei denen die Fließpfade zwischen Anschlusspunktpaaren beschränkt werden müssen. Sie können zum Beispiel an einem Bauteil mit vier Anschlusspunkten mit den Bezeichnungen A, B, C und D die Fließrichtung von A nach B und C, aber nicht von A nach D zulassen.

  • Die Netzwerk-Topologie muss deaktiviert sein.

  • Für die Verwendung einer Enterprise-Geodatabase gelten folgende Voraussetzungen:

    • Dieses Werkzeug muss zur Ausführung mit der Default-Version verbunden sein.
      • Alle anderen Sitzungen, die mit der Default-Version verbunden sind, können während der Aktivierung keine Validierung oder Aktivierung durchführen.
    • 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.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Versorgungsnetz

Das Eingabe-Versorgungsnetz, dem die Anschlusspunktkonfiguration hinzugefügt wird

Utility Network; Utility Network Layer
Name

Der Name der Anschlusspunktkonfiguration

String
Richtungsabhängigkeit

Gibt die Direktionalität der Anschlusspunktkonfiguration an. Ein unidirektionales Passierbarkeitsmodell bedeutet, dass der Fluss durch den Anschlusspunkt nur in einer Richtung möglich ist. Ein bidirektionales Passierbarkeitsmodell bedeutet, dass der Anschlusspunkt den Fluss in beiden Richtungen ermöglicht.

  • UnidirektionalEs ist nur eine Fließrichtung zulässig.
  • BidirektionalBeide Fließrichtungen sind zulässig.
String
Anschlusspunkte
(optional)

Der Name und der gerichtete Fluss der unidirektionalen Anschlusspunkte. Mindestens zwei Anschlusspunkte müssen angegeben und höchstens acht können angegeben werden. Der Name eines Anschlusspunktes darf nicht mehr als 32 Zeichen enthalten. Dieser Parameter ist erforderlich, wenn für den Parameter Richtungsabhängigkeit der Wert Unidirektional angegeben ist.

  • Name: Geben Sie den Namen des Anschlusspunktes an.
  • Flussaufwärts: Geben Sie an, ob der Anschlusspunkt flussaufwärts oder flussabwärts liegt.
    • Aktiviert: Der Anschlusspunkt befindet sich flussaufwärts.
    • Deaktiviert: Der Anschlusspunkt befindet sich flussabwärts.
Value Table
Anschlusspunkte
(optional)

Der Name jedes bidirektionalen Anschlusspunktes. Mindestens zwei Anschlusspunkte müssen angegeben und höchstens acht können angegeben werden. Der Name eines Anschlusspunktes darf nicht mehr als 32 Zeichen enthalten. Dieser Parameter ist erforderlich, wenn für den Parameter Richtungsabhängigkeit der Wert Bidirektional (traversability_model = "BIDIRECTIONAL" in Python) angegeben ist.

Value Table
Gültige Pfade
(optional)

Der Name bzw. die Namen und der gültige Pfad bzw. die gültigen Pfade für die Anschlusspunktkonfiguration. Für die bidirektionale Durchlassfähigkeit ist dieser Parameter erforderlich, wenn Sie drei oder vier Anschlusspunkte verwenden. Wenn Sie die unidirektionale Durchlassfähigkeit verwenden, muss einer der Anschlusspunkte flussaufwärts liegen, damit eine gültige Konfiguration entsteht. "Gültige Pfade" muss erstellt werden, um anzugeben, welcher Pfad oder welche Pfade in einem Gerät- oder Knotenobjekt gültige Fließwege für eine Ressource sind. Geben Sie für jeden gültigen Pfad einen Namen und einen Wert an.

  • Name: Der Name des gültigen Pfades.
  • Wert: Der Wert des gültigen Pfades.
    • Alle: Mit dem Wert "Alle" erstellen Sie eine Option, die angibt, dass alle Pfade gültig sind.
    • Keine: Mit dem Wert "Keine" erstellen Sie eine Option, die angibt, dass keine Pfade gültig sind.
    • Anschlusspunktpaar(e): Geben Sie ein einzelnes Anschlusspunktpaar oder eine Sammlung von Anschlusspunktpaaren an. Geben Sie für ein einzelnes Anschlusspunktpaar den Pfad von einem Anschlusspunkt zu einem anderen an, und trennen Sie die Punkte durch einen Bindestrich, z. B. A-B. Eine Sammlung von Anschlusspunktpaaren geben Sie durch ein Komma getrennt an, z. B. A-B, A-C.
Value Table
Standardpfad
(optional)

Der Standardpfad der gültigen Konfigurationen. Dieser wird dann neuen Features zugewiesen, deren Asset-Typ diese Anschlusspunktkonfiguration zugewiesen wurde. Wenn keine gültigen Pfade angegeben wurden, wird der Standardpfad Alle verwendet.

  • AlleAlle Pfade sind gültig. Dies ist die Standardeinstellung.
  • KeineKein Pfad ist gültig.
String

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisiertes Versorgungsnetz

Das aktualisierte Versorgungsnetz.

Utility Network

arcpy.un.AddTerminalConfiguration(in_utility_network, terminal_configuration_name, traversability_model, {terminals_directional}, {terminals_bidirectional}, {valid_paths}, {default_path})
NameErläuterungDatentyp
in_utility_network

Das Eingabe-Versorgungsnetz, dem die Anschlusspunktkonfiguration hinzugefügt wird

Utility Network; Utility Network Layer
terminal_configuration_name

Der Name der Anschlusspunktkonfiguration

String
traversability_model

Gibt die Direktionalität der Anschlusspunktkonfiguration an. Ein unidirektionales Passierbarkeitsmodell bedeutet, dass der Fluss durch den Anschlusspunkt nur in einer Richtung möglich ist. Ein bidirektionales Passierbarkeitsmodell bedeutet, dass der Anschlusspunkt den Fluss in beiden Richtungen ermöglicht.

  • DIRECTIONALEs ist nur eine Fließrichtung zulässig.
  • BIDIRECTIONALBeide Fließrichtungen sind zulässig.
String
terminals_directional
[[name, upstream],...]
(optional)

Der Name und der gerichtete Fluss der unidirektionalen Anschlusspunkte. Mindestens zwei Anschlusspunkte müssen angegeben und höchstens acht können angegeben werden. Der Name eines Anschlusspunktes darf nicht mehr als 32 Zeichen enthalten. Dieser Parameter ist erforderlich, wenn für den Parameter traversability_model der Wert DIRECTIONAL angegeben ist.

  • Name: Geben Sie den Namen des Anschlusspunktes an.
  • Upstream: Geben Sie an, ob der Anschlusspunkt flussaufwärts oder flussabwärts liegt.
    • True: Der Anschlusspunkt befindet sich flussaufwärts.
    • False: Der Anschlusspunkt befindet sich flussabwärts.
Value Table
terminals_bidirectional
[[name],...]
(optional)

Der Name jedes bidirektionalen Anschlusspunktes. Mindestens zwei Anschlusspunkte müssen angegeben und höchstens acht können angegeben werden. Der Name eines Anschlusspunktes darf nicht mehr als 32 Zeichen enthalten. Dieser Parameter ist erforderlich, wenn für den Parameter Richtungsabhängigkeit der Wert Bidirektional (traversability_model = "BIDIRECTIONAL" in Python) angegeben ist.

Value Table
valid_paths
[[Name, [Value]],...]
(optional)

Der Name bzw. die Namen und der gültige Pfad bzw. die gültigen Pfade für die Anschlusspunktkonfiguration. Für die bidirektionale Durchlassfähigkeit ist dieser Parameter erforderlich, wenn Sie drei oder vier Anschlusspunkte verwenden. Wenn Sie die unidirektionale Durchlassfähigkeit verwenden, muss einer der Anschlusspunkte flussaufwärts liegen, damit eine gültige Konfiguration entsteht. "Gültige Pfade" muss erstellt werden, um anzugeben, welcher Pfad oder welche Pfade in einem Gerät- oder Knotenobjekt gültige Fließwege für eine Ressource sind. Geben Sie für jeden gültigen Pfad einen Namen und einen Wert an.

  • Name: Der Name des gültigen Pfades.
  • Wert: Der Wert des gültigen Pfades.
    • Alle: Mit dem Wert "Alle" erstellen Sie eine Option, die angibt, dass alle Pfade gültig sind.
    • Keine: Mit dem Wert "Keine" erstellen Sie eine Option, die angibt, dass keine Pfade gültig sind.
    • Anschlusspunktpaar(e): Geben Sie ein einzelnes Anschlusspunktpaar oder eine Sammlung von Anschlusspunktpaaren an. Geben Sie für ein einzelnes Anschlusspunktpaar den Pfad von einem Anschlusspunkt zu einem anderen an, und trennen Sie die Punkte durch einen Bindestrich, z. B. A-B. Eine Sammlung von Anschlusspunktpaaren geben Sie durch ein Komma getrennt an, z. B. A-B, A-C.
Value Table
default_path
(optional)

Der Standardpfad der gültigen Konfigurationen. Dieser wird dann neuen Features zugewiesen, deren Asset-Typ diese Anschlusspunktkonfiguration zugewiesen wurde. Wenn keine gültigen Pfade angegeben wurden, wird der Standardpfad All verwendet.

  • ALLAlle Pfade sind gültig. Dies ist die Standardeinstellung.
  • NONEKein Pfad ist gültig.
String

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_utility_network

Das aktualisierte Versorgungsnetz.

Utility Network

Codebeispiel

AddTerminalConfiguration – Beispiel 1 (Python-Fenster)

Hinzufügen einer bidirektionalen Anschlusspunktkonfiguration mit drei Anschlusspunkten.

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config1', 
                                  'BIDIRECTIONAL', None, 'A;B;C', 
                                  'Top A-B;Bottom A-C', 'Top')
AddTerminalConfiguration – Beispiel 2 (Python-Fenster)

Hinzufügen einer unidirektionalen Anschlusspunktkonfiguration mit drei Anschlusspunkten.

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config2', 
                                  'DIRECTIONAL', 'A true;B true;C false', None, 
                                  'Top A-B;Bottom A-C', 'Bottom')
AddTerminalConfiguration – Beispiel 3 (Python-Fenster)

Hinzufügen einer unidirektionalen Anschlusspunktkonfiguration mit drei Anschlusspunkten. Gültige Pfade werden mit einer Sammlung von Anschlusspunktpaaren angegeben.

import arcpy
arcpy.AddTerminalConfiguration_un('Electric Utility Network', 'config3', 
                                  'DIRECTIONAL', 'A true;B false;C false', None, 
                                  "AB A-B;ABAC 'A-B;A-C'", 'AB')

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen