Verfolgungsregel hinzufügen (Network Diagram Tools)
Zusammenfassung
Fügt einer Regelsequenz, die für eine Schemavorlage angegeben wurde, eine Schemaregel hinzu, um bei der Erstellung von Schemas automatisch eine Verfolgung in einem Versorgungs- oder Verfolgungsnetz auszuführen. Mit den bei der Verfolgung berücksichtigten Netzwerk-Features und Netzwerkobjekten wird der Schemainhalt erstellt.
Weitere Informationen zur Verwendung der Verfolgungsregel zum Erstellen von Schemas
Achtung:
Dieses Werkzeug ist ein Konfigurations- und Verwaltungswerkzeug.
Hinweis:
Dieses Werkzeug hat Auswirkungen auf die Konsistenz aller vorhandenen Schemas, die auf der Eingabe-Schemavorlage basieren. Alle vorhandenen Schemas werden inkonsistent und werden beim Öffnen mit dem Konsistenzwarnsymbol
angezeigt, bis sie aktualisiert werden.
Verwendung
Bei Verwendung eines Utility Network- oder Trace Network-Service wird dieses Werkzeug nicht unterstützt. Sie müssen entweder ein Versorgungs- oder Verfolgungsnetz in einer File- oder Mobile-Geodatabase oder eine Datenbankverbindung zu einem Versorgungs- oder Verfolgungsnetz in einer Enterprise-Geodatabase verwenden. Für die Verwendung einer Enterprise-Geodatabase gelten folgende Voraussetzungen:
Der Parameterwert Eingabe-Netzwerk muss aus einer Datenbankverbindung stammen, die als Besitzer des Datenbank-Versorgungsnetzes oder als Besitzer des Datenbank-Verfolgungsnetzes hergestellt wurde.
Bei dem verbundenen ArcGIS Enterprise-Portal-Konto muss es sich um den Besitzer des Portal-Versorgungsnetzes oder den Besitzer des Portal-Verfolgungsnetzes handeln.
Dieses Werkzeug muss mit der Default-Version verbunden sein, von der vorausgesetzt wird, dass sie öffentlich und nicht geschützt ist.
Die Regel "Verfolgung" dient zur Ausführung einer Verfolgung in Netzwerk-Features oder Netzwerkobjekten, die aktuell in einem Schema dargestellt werden, oder ab bestimmten Startpunkten, die entweder als Eingabe oder mit der Regel "Startpunkte festlegen" festgelegt wurden.
Je nach angegebenem Verfolgungstyp muss das Schema wie folgt Startpunkte aufweisen, damit die Verfolgungsregel ausgeführt werden kann:
Für die Verfolgungstypen "Verbunden", "Teilnetz", "Flussaufwärts", "Flussabwärts" und "Stromkreis" werden alle Versorgungsnetz- oder Verfolgungsnetz-Elemente, die zum Zeitpunkt des Starts der Verfolgungsregel im Schema dargestellt werden, als Startpunkte für die Verfolgung betrachtet, es sei denn, die Erstellung des Schemas startet an bestimmten als Eingabe bereitgestellten Verfolgungspositionen, oder es wird eine Regel zum Festlegen von Startpunkten für die Schemavorlage konfiguriert, um bestimmte Startpunkte vorab eindeutig zu identifizieren.
Der Verfolgungstyp "Pfad" muss über mindestens eine Start- und mindestens eine Endposition verfügen, um ordnungsgemäß zu funktionieren. Der Verfolgungstyp "Pfad" hat im Vergleich zu den anderen Verfolgungstypen spezifische Anforderungen, wenn er als Schema-Verfolgungstyp verwendet wird, da Endpunkte nicht durch Schemaregeln festgelegt werden können. Um Schemas basierend auf einer Schemavorlage zu erstellen, die so konfiguriert ist, dass eine Regel vom Verfolgungstyp "Pfad" angewendet wird, muss das Werkzeug Schema erstellen mit aktiviertem Parameter Schema aus Verfolgungspositionen erstellen ausgeführt werden.
Tipp:
Die Konfiguration des Parameters "Name des Netzwerkattributs für 'Kürzester Pfad'" ermöglicht es, die kürzeste Verbindung zwischen den angegebenen Start- und Endpositionen zu berechnen und die erkannte kürzeste Verbindung als Schema anzuzeigen.
Wenn Sie eine Vorlage basierend auf der Verfolgungsregel konfigurieren, wird die Verfolgung bei jeder Aktualisierung des Schemas im Versorgungs- oder Verfolgungsnetz systematisch erneut ausgeführt. Dies bedeutet, dass jedes auf dieser Vorlage basierende Schema nach einer Aktualisierung stets das aktuelle Netzverfolgungsergebnis widerspiegelt.
Ab Utility Network-Version 7 können Sie Verfolgungsregeln so konfigurieren, dass bei flussaufwärts oder -abwärts gerichteten Verfolgungen der Fluss anhand der Digitalisierrichtung der Linien und anhand des Attributs
Flow directionanstelle der Position der Teilnetz-Controller bestimmt wird.Ab Utility Network-Version 7 und Trace Network-Version 4 können Sie Verfolgungsregeln zudem mit benannten Verfolgungskonfigurationen konfigurieren.
Ab ArcGIS Pro 3.6 können Sie die Verfolgungsregel so konfigurieren, dass die Ausgabe-Asset-Typen oder der Feature-Typ anhand der Netzwerkattribute oder -kategorie, die zurückgegeben werden sollen, gefiltert werden.
Ab Utility Network-Version 8 können Sie, falls Sie ein Versorgungsnetz mit Telekommunikationsnetzarten verwenden, eine Verfolgungsregel zum Ausführen von Stromkreisverfolgungen in einer Telekommunikationsnetzart konfigurieren.
Parameter
| Beschriftung | Erläuterung | Datentyp |
|---|---|---|
|
Eingabe-Netzwerk |
Das Versorgungs- oder Verfolgungsnetz, das die zu ändernde Schemavorlage enthält. |
Utility Network; Trace Network |
|
Eingabe-Schemavorlage |
Der Name der Schemavorlage, die geändert werden soll. |
String |
|
Active |
Gibt an, ob die Regel aktiviert ist, wenn Schemas basierend auf der angegebenen Vorlage erstellt und aktualisiert werden.
|
Boolean |
|
Verfolgungstyp |
Gibt den Verfolgungstyp an, der zum Erstellen des Schemainhalts ausgeführt wird.
|
String |
|
Netzart (Optional) |
Der Name der Netzart, in der die Verfolgung eines Versorgungsnetzes ausgeführt wird. Dieser Parameter ist erforderlich, wenn die Verfolgungstypen für Teilnetze, flussaufwärts, flussabwärts und Stromkreise ausgeführt werden. |
String |
|
Ebene (Optional) |
Der Name der Ebene, auf der die Verfolgung eines Versorgungsnetzes gestartet wird. Dieser Parameter ist beim Ausführen der Verbindungsverfolgung optional; er ist erforderlich, wenn die Verfolgungstypen für Teilnetze, flussaufwärts und flussabwärts ausgeführt werden. |
String |
|
Zielebene (Optional) |
Der Name der Zielebene, in deren Richtung die Eingabeebene eines Versorgungsnetzes fließt. Wenn dieser Parameter in Verfolgungen vom Typ "Flussaufwärts" und "Flussabwärts" fehlt, enden diese Verfolgungen an der Grenze des Start-Teilnetzes. Dieser Parameter kann verwendet werden, um die Verfolgungen darüber hinaus fortzusetzen, also in der Hierarchie weiter nach oben oder weiter nach unten. |
String |
|
Strukturen einbeziehen (Optional) |
Gibt an, ob Struktur-Features und Objekte in die Verfolgungsergebnisse einbezogen werden.
|
Boolean |
|
Barriere-Features einbeziehen (Optional) |
Gibt an, ob die Barrieren-Features für die Durchlassfähigkeit in die Verfolgungsergebnisse einbezogen werden. Barrieren für die Durchlassfähigkeit sind optional, auch wenn sie in der Teilnetzdefinition voreingestellt wurden. Dieser Parameter gilt nicht für Bauteil-Features mit Anschlusspunkten.
|
Boolean |
|
Bedingende Barrieren (Optional) |
Legt für Features eine Bedingungsbarriere für Durchlässigkeit basierend auf einem Vergleich mit einem Netzwerkattribut fest, oder führt eine Überprüfung der Kategoriezeichenfolge durch. Eine Bedingungsbarriere verwendet ein Netzwerkattribut oder eine Netzwerkkategorie, einen Operator und einen Typ sowie einen Attributwert. Halten Sie eine Verfolgung beispielsweise an, wenn das Attribut Spalten der Wertetabelle:
|
Value Table |
|
Funktionsbarrieren (Optional) |
Legt für Features eine Durchlässigkeitsbarriere basierend auf einer Funktion fest. Funktionsbarrieren können beispielsweise verwendet werden, um die Entfernung der Verfolgung vom Startpunkt einzuschränken oder einen Maximalwert zum Anhalten einer Verfolgung festzulegen. Die Länge der jeweils zurückgelegten Linie wird beispielsweise der bisher zurückgelegten Gesamtentfernung hinzugefügt. Wenn die zurückgelegte Gesamtlänge den angegebenen Wert erreicht hat, wird die Verfolgung angehalten. Spalten der Wertetabelle:
|
Value Table |
|
Durchlassfähigkeit anwenden auf (Optional) |
Gibt den Typ der Durchlassfähigkeit an, der erzwungen wird. Der Umfang der Durchlassfähigkeit bestimmt, ob die Durchlassfähigkeit an Knoten, an Kanten oder an Knoten und an Kanten umgesetzt wird. Beispiel: Wenn eine Bedingungsbarriere definiert wurde, um die Verfolgung zu stoppen, wenn der Bauteilstatus dem Wert "Offen" entspricht und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, wird die Verfolgung auch dann nicht gestoppt, wenn ein offenes Bauteil vorhanden ist, da der Bauteilstatus nur für Knoten gilt. Anders gesagt wird mit diesem Parameter angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen.
|
String |
|
Filterbarrieren (Optional) |
Gibt an, wann die Verfolgung aufgrund eines bestimmten Kategorie- oder Netzwerkattributs beendet wird. Beispiel: Eine Verfolgung bei Features beenden, die ein Attribut für den Lebenszyklusstatus aufweisen, das einem bestimmten Wert entspricht. Dieser Parameter wird verwendet, um ein abschließendes Feature basierend auf dem im System definierten Wert eines Netzwerkattributs festzulegen. Spalten der Wertetabelle:
|
Value Table |
|
Filterfunktionsbarrieren (Optional) |
Diese filtern die Ergebnisse der Verfolgung entsprechend einer bestimmten Kategorie. Spalten der Wertetabelle:
|
Value Table |
|
Filter anwenden auf (Optional) |
Gibt an, ob der Filter für eine bestimmte Kategorie bei Knoten oder Kanten oder bei Knoten und Kanten angewendet wird. Beispiel: Wenn eine Filterbarriere definiert wurde, um die Verfolgung zu stoppen, wenn der Bauteilstatus dem Wert "Offen" entspricht und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, wird die Verfolgung auch dann nicht gestoppt, wenn ein offenes Bauteil vorhanden ist, da der Bauteilstatus nur für Knoten gilt. Anders gesagt wird mit diesem Parameter angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen.
|
String |
|
Filtern nach Bitset-Netzwerkattribut (Optional) |
Der Name des Netzwerkattributs, das zum Filtern nach Bitset verwendet wird. Dieser Parameter kann nur für Verfolgungen vom Typ "Flussaufwärts", "Flussabwärts" oder "Schleifen" verwendet werden. Mit diesem Parameter kann während der Verfolgung eine spezielle Logik hinzugefügt werden, sodass mit der Verfolgung Szenarien realitätsgetreuer abgebildet werden. Bei einer Verfolgung vom Typ "Schleifen" kann das Netzwerkattribut "Phasenstrom" beispielsweise ermitteln, ob es sich bei einer Schleife um eine echte elektrische Schleife handelt (d. h. in der gesamten Schleife führt Phase A Strom), und nur diese als Verfolgungsergebnis zurückgeben. Ein Beispiel für eine Verfolgung vom Typ "Flussaufwärts" ist die Verfolgung eines Stromverteilungsnetzes durch Festlegen des Netzwerkattributs "Phasenstrom", wobei in den Verfolgungsergebnissen nicht alle Pfade, sondern nur im Netzwerkattribut angegebene gültige Pfade enthalten sind. |
String |
|
Filtern nach nächstgelegenen (Optional) |
Gibt an, ob der Algorithmus "Nächster Nachbar (K)" verwendet werden soll, um eine Reihe von Features eines bestimmten Typs innerhalb einer angegebenen Entfernung zurückzugeben. Sie können Anzahl und Kosten sowie eine Sammlung von Kategorien und/oder einen Asset-Typ angeben.
|
Boolean |
|
Anzahl (Optional) |
Die Anzahl der Features, die zurückgegeben werden, wenn Filtern nach nächstgelegenen aktiviert ist. |
Long |
|
Kosten-Netzwerkattribut (Optional) |
Das numerische Netzwerkattribut, das zum Berechnen von Nähe, Kosten oder Entfernung verwendet werden soll, wenn Filtern nach nächstgelegenen aktiviert ist, zum Beispiel Shape-Länge. |
String |
|
Nächstgelegene Kategorien (Optional) |
Die Kategorien, die zurückgegeben werden sollen, wenn Filtern nach nächstgelegenen aktiviert ist, zum Beispiel Schutz. |
String |
|
Nächstgelegene Asset-Gruppen/-Typen (Optional) |
Die Asset-Gruppen und Asset-Typen, die zurückgegeben werden sollen, wenn Filtern nach nächstgelegenen aktiviert ist, zum Beispiel "ElectricDistributionDevice/Transformer/Step Down". |
String |
|
Weitergabemodule (Optional) |
Dieser Parameter ist nur über Python verfügbar. Spalten der Wertetabelle:
|
Value Table |
|
Beschreibung (Optional) |
Die Beschreibung der Regel. |
String |
|
Unbestimmbare Fließrichtung zulassen (Optional) |
Gibt an, ob Verfolgungsnetz-Features mit einer unbestimmbaren oder nicht initialisierten Fließrichtung verfolgt werden. Dieser Parameter wird nur bei der Ausführung einer Verfolgung flussaufwärts oder flussabwärts berücksichtigt.
|
Boolean |
|
Pfadrichtung (Optional) |
Gibt die Richtung der kürzesten Verbindung für ein Verfolgungsnetz an. Die Kosten, die beim Passieren des Pfades entstehen, werden mit dem Parameterwert Name des Netzwerkattributs für "Kürzester Pfad" ermittelt. Dieser Parameter wird nur beim Anwenden einer Verfolgung vom Typ Kürzeste Verbindung auf ein Verfolgungsnetz berücksichtigt.
|
String |
|
Name des Netzwerkattributs für "Kürzester Pfad" (Optional) |
Das Netzwerkattribut, das zum Berechnen der kürzesten Verbindung mit dem Verfolgungstyp "Pfad" oder "Kürzeste Verbindung" für ein Versorgungs- oder Verfolgungsnetz verwendet wird. Bei der Ausführung einer Verfolgung vom Typ "Kürzester Pfad" wird der kürzeste Pfad mithilfe eines numerischen Netzwerkattributs wie etwa Shape-Länge berechnet. Es können sowohl kosten- als auch entfernungsbasierte Pfade ermittelt werden. Dieser Parameter ist für die Ausführung einer Verfolgung vom Typ "Kürzester Pfad" erforderlich. |
String |
|
Verfolgungskonfiguration verwenden (Optional) |
Gibt an, ob eine vorhandene benannte Verfolgungskonfiguration zum Definieren der Verfolgungseigenschaften verwendet wird. Dieser Parameter ist nur bei Utility Network-Version 7 und höher aktiviert.
|
Boolean |
|
Name der Verfolgungskonfiguration (Optional) |
Der Name der vorhandenen benannten Verfolgungskonfiguration, die zum Definieren der Verfolgungseigenschaften verwendet wird. Dieser Parameter ist nur aktiv, wenn der Parameter Verfolgungskonfiguration verwenden aktiviert wurde. |
String |
|
Digitalisierrichtung verwenden (Optional) |
Gibt an, ob der Fluss bei flussaufwärts und flussabwärts gerichteten Verfolgungen anhand der Digitalisierrichtung der Linie und des Attributs "Fließrichtung" bestimmt wird. Dieser Parameter ist nur für Utility Network-Version 7 aktiviert, wenn für den Parameter Verfolgungstyp die Option Flussaufwärts oder Flussabwärts festgelegt wurde. Hinweis:Bei Verwendung einer Enterprise-Geodatabase ist für diesen Parameter ArcGIS Enterprise 11.3 oder höher erforderlich.
|
Boolean |
|
Ausgabe-Asset-Typen (Optional) |
Filtert die Ausgabe-Asset-Typen, die in die Ergebnisse einbezogen werden sollen, z. B. nur Freileitungstransformatoren. |
String |
|
Ausgabebedingungen (Optional) |
Die Typen der Features, die basierend auf einem Netzwerkattribut oder einer Netzwerkkategorie zurückgegeben werden sollen. Bei einer Verfolgung, die beispielsweise zum Herausfiltern aller Features außer Abzweigungs-Features konfiguriert wurde, sind in den Ergebnissen keine verfolgten Features enthalten, denen nicht die Kategorie "Abzweigung" zugewiesen wurde. Verfolgte Features, denen die Ablaufventil-Kategorie zugewiesen wurde, werden im Ergebnisauswahlsatz zurückgegeben. Spalten der Wertetabelle:
|
Value Table |
|
Pfadanzahl (Optional) |
Die maximale Pfadanzahl, die in einer Pfad- oder Stromkreisverfolgung zurückgegeben wird. Die Standardeinstellung ist 1. Dieser Parameter ist nur aktiv, wenn der Parameter Verfolgungstyp auf Pfad oder Stromkreis festgelegt wurde. |
Long |
|
Maximale Hop-Anzahl (Optional) |
Die maximale Hop-Anzahl zwischen Kanten, die im Pfad oder Stromkreis zulässig sind, wobei der Startpunkt ausgenommen ist. Alle Zuordnungen der Kanten- und Knoten-Knoten-Konnektivität werden bei der Durchquerung mit einer festen Einheitslänge von 1 ausgewertet. Anschlusspunktbauteile werden mit einer festen Einheitslänge von 2 ausgewertet. Die Standardeinstellung ist 100. Dieser Parameter ist nur aktiv, wenn der Parameter Verfolgungstyp auf Pfad oder Stromkreis festgelegt wurde. |
Long |
|
Konnektivität ableiten (Optional) |
Gibt an, ob die Pfadverfolgung die Konnektivitätsinferenz verwendet, um Containment-Zuordnungen zu durchqueren und einen Pfad zwischen der angegebenen Start- und Endposition zu identifizieren. Dieser Parameter wird nur bei der Pfadverfolgung in Telekommunikationsnetzarten unterstützt und ermöglicht die Ermittlung von Pfaden zwischen Abschnitten, wenn Konnektivitätsinformationen nicht explizit verfügbar sind. Weitere Informationen finden Sie unter Konnektivität ableiten.
|
Boolean |
Abgeleitete Ausgabe
| Beschriftung | Erläuterung | Datentyp |
|---|---|---|
|
Ausgabe-Netzwerk |
Das aktualisierte Versorgungs- oder Verfolgungsnetz. |
Utility Network; Trace Network |
|
Ausgabe-Schemavorlage |
Der Name der Schemavorlage. |
String |
Umgebungen
Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.
Lizenzierungsinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja