Netzwerk-Topologie aktivieren (Utility Network)

Zusammenfassung

Aktiviert eine Netzwerk-Topologie für ein Versorgungsnetz.

Dieses Werkzeug wertet die Konnektivität zwischen Features aus und stellt diese her, um die Netzwerk-Topologie für ein Versorgungsnetz zu erstellen. Für Analysevorgänge wie Verfolgungen sowie für die Verwendung von Netzwerkschemas ist eine Netzwerk-Topologie erforderlich. Eine Netzwerk-Topologie kann auch aktiviert werden, um Fehler zu ermitteln.

Hinweis:

Ab ArcGIS Enterprise 10.9.1 wird die Operation "Netzwerk-Topologie aktivieren" asynchron unter Verwendung des Geoverarbeitungsservice "UtilityNetworkTools" verarbeitet, wenn mit einem Versorgungsnetz in einer Enterprise-Geodatabase gearbeitet wird. Für Feature-Services mit einem Versorgungsnetz wird der Service "UtilityNetworkTools" im Systemordner vorkonfiguriert. Er verfügt über eine längere Timeout-Einstellung und ist Geoverarbeitungs-Tasks für Versorgungsnetze vorbehalten.

Weitere Informationen zum Aktivieren einer Netzwerk-Topologie

Verwendung

    Vorsicht:

    Wenn die Netzwerk-Topologie in einem großen Versorgungsnetz aktiviert wird, nimmt dieser Vorgang Zeit in Anspruch und verbraucht Ressourcen im Verhältnis zur Anzahl der Features im Netz. Planen und dimensionieren Sie den Client und die Datenbank entsprechend, um sicherzustellen, dass der Vorgang über einen angemessenen RAM- und Festplattenspeicher verfügt.

  • Bestimmte Tasks für die Netzwerkkonfiguration können nur vor der ersten Aktivierung der Netzwerk-Topologie durchgeführt werden. Informationen zu spezifischen Aufgaben dieses Werkzeugs und dem jeweils erforderlichen Zustand der Netzwerk-Topologie finden Sie unter Netzwerk-Topologie-Aktionen.

  • Alle Utility Network-Feature-Classes müssen über einen räumlichen Index verfügen.

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

    • Wenn der Parameterwert für Eingabe-Versorgungsnetz aus einer Datenbankverbindung stammt, muss die Verbindung als Besitzer des Datenbank-Versorgungsnetzes hergestellt werden.

    • Bei dem verbundenen ArcGIS Enterprise-Portal-Konto muss es sich um den Besitzer des Portal-Versorgungsnetzes handeln.
    • 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.
    • Das Versorgungsnetz muss als nach Verzweigung versioniert registriert sein.
    • Das Versorgungsnetz muss in einem nicht versionierten Status vorliegen, um die erweiterte Option Nur Fehler generieren zu verwenden.
    • Lizenz:
      Dem aktiven Portal-Konto muss eine Lizenz mit der Benutzertyp-Erweiterung ArcGIS Advanced Editing zugewiesen sein, um dieses Werkzeug in einer Enterprise-Bereitstellung verwenden zu können.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Versorgungsnetz

Das Versorgungsnetz, für das die Netzwerk-Topologie aktiviert wird.

Utility Network; Utility Network Layer
Maximale Anzahl der Fehler
(optional)

Die maximal zulässige Fehleranzahl, bevor der Aktivierungsprozesses für die Netzwerk-Topologie beendet wird. Die Fehler werden im Sublayer "Dirty Areas" erfasst. Wird für diesen Parameter kein Wert angegeben, kann eine unendliche Anzahl von Fehlern ermittelt werden. Der Standardwert ist 10000.

Vorsicht:

Wird der Wert erhöht, dauert das Aktivieren der Topologie länger. Ein Standardwert von mehr als 10000 wird nicht empfohlen.

Long
Nur Fehler generieren
(optional)

Gibt an, ob die Topologie aktiviert wird oder nur Netzwerk-Fehler generiert werden.

  • Aktiviert: Das Versorgungsnetz wird nur nach Netzwerkfehlern ausgewertet. Die Topologie wird nicht aktiviert. Bei der Arbeit mit einer Enterprise-Geodatabase können die Daten nicht als versioniert registriert werden. Dadurch können Sie Fehler im Netzwerk überprüfen und beheben, bis Sie die Topologie aktivieren.
  • Deaktiviert: Die Topologie wird aktiviert, und aus eventuell vorhandenen Fehlern werden Dirty Areas mit Fehlern generiert. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisiertes Versorgungsnetz

Das aktualisierte Versorgungsnetz.

Utility Network

arcpy.un.EnableNetworkTopology(in_utility_network, {max_number_of_errors}, {only_generate_errors})
NameErläuterungDatentyp
in_utility_network

Das Versorgungsnetz, für das die Netzwerk-Topologie aktiviert wird.

Utility Network; Utility Network Layer
max_number_of_errors
(optional)

Die maximal zulässige Fehleranzahl, bevor der Aktivierungsprozesses für die Netzwerk-Topologie beendet wird. Die Fehler werden im Sublayer "Dirty Areas" erfasst. Wird für diesen Parameter kein Wert angegeben, kann eine unendliche Anzahl von Fehlern ermittelt werden. Der Standardwert ist 10000.

Vorsicht:

Wird der Wert erhöht, dauert das Aktivieren der Topologie länger. Ein Standardwert von mehr als 10000 wird nicht empfohlen.

Long
only_generate_errors
(optional)

Gibt an, ob die Topologie aktiviert wird oder nur Netzwerk-Fehler generiert werden.

  • ONLY_ERRORSDas Versorgungsnetz wird nur nach Netzwerkfehlern ausgewertet. Die Topologie wird nicht aktiviert. Bei der Arbeit mit einer Enterprise-Geodatabase können die Daten nicht als versioniert registriert werden. Dadurch können Sie Fehler im Netzwerk überprüfen und beheben, bis Sie die Topologie aktivieren.
  • ENABLE_TOPODie Topologie wird aktiviert, und aus eventuell vorhandenen Fehlern werden Dirty Areas mit Fehlern generiert. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_utility_network

Das aktualisierte Versorgungsnetz.

Utility Network

Codebeispiel

EnableNetworkTopology: Beispiel 1 (Python-Fenster)

Mit diesem Beispielskript wird die Netzwerk-Topologie für ein Versorgungsnetz mit der Bezeichnung "MyNetwork" aktiviert. Dabei wird mit der Funktion EnableNetworkTopology die maximale Anzahl der Fehler auf 500 festgelegt.

import arcpy
arcpy.un.EnableNetworkTopology('MyNetwork', 500)
EnableNetworkTopology: Beispiel 2 (Python-Fenster)

Mit diesem Beispielskript werden nur Fehler für ein Versorgungsnetz namens "MyNetwork" generiert. Dafür wird die Funktion EnableNetworkTopology verwendet.

import arcpy
arcpy.un.EnableNetworkTopology('MyNetwork', '', 'ONLY_ERRORS')

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen