| Name | Erläuterung | Datentyp |
in_utility_network | Das Versorgungsnetz, in dem das Teilnetz enthalten ist. | Utility Network; Utility Network Layer |
domain_network | Die Netzart, in der das Teilnetz enthalten ist. | String |
tier | Die Ebene, in der das Teilnetz enthalten ist. | String |
all_subnetworks_in_tier (optional) | Gibt an, ob alle Teilnetze in der Ebene aktualisiert werden sollen. Verwenden Sie den Parameter subnetwork_name, um eine Teilmenge der Teilnetze in der Ebene zu aktualisieren. - ALL_SUBNETWORKS_IN_TIER—Alle Teilnetze in der Ebene werden aktualisiert. Für diese Option wird eine asynchrone Verarbeitung genutzt, um das Teilnetz mit dem Geoverarbeitungsservice "UtilityNetworkTools" des Systems zu aktualisieren. Der Service ist Geoverarbeitungs-Tasks für Versorgungsnetze vorbehalten und verfügt über eine längere Standard-Timeout-Einstellung. Dies ist die Standardeinstellung.
- SPECIFIC_SUBNETWORK—Nur die im Parameter subnetwork_name angegebenen Teilnetze werden aktualisiert.
| Boolean |
subnetwork_name (optional) | Der Name des Teilnetzes, das aus der Ebene aktualisiert werden soll. Dieser Parameter wir ignoriert, wenn für den Parameter all_subnetworks_in_tier der Wert ALL_SUBNETWORKS_IN_TIER angegeben ist. | String |
continue_on_failure (optional) | Gibt an, ob der Aktualisierungsprozess gestoppt werden soll, wenn die Aktualisierung eines Teilnetzes beim Aktualisieren mehrerer Teilnetze fehlschlägt. - CONTINUE_ON_FAILURE—Wenn ein Teilnetzfehler auftritt, wird der Aktualisierungsprozess nicht gestoppt, sondern fortgesetzt.
- STOP_ON_FAILURE—Wenn ein Teilnetzfehler auftritt, wird der Aktualisierungsprozess gestoppt. Dies ist die Standardeinstellung.
| Boolean |
condition_barriers [[Name, Operator, Type, Value, Combine Using],...] (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 Device Status dem spezifischen Wert Open entspricht. Wenn ein Feature diese Bedingung erfüllt, wird die Verfolgung angehalten. Bei Verwendung mehrerer Attribute können Sie mit dem Parameter Kombination verwenden eine And- oder eine Or-Bedingung definieren.
Die Komponenten der Bedingungsbarrieren sind folgende: - Name: Filtern Sie nach einem Netzwerkattribut, das im System definiert ist, oder geben Sie für die Verwendung einer Netzwerkkategorie "Category" an.
- Operator: Wählen Sie aus verschiedenen Operatoren aus.
- Type: Geben Sie je nach Wertetyp, der im Parameter Name als Barriere fungiert, den Eintrag Specific value oder Network attribute an. Der Parameter Type muss auf Specific value festgelegt werden, wenn der Parameter Name auf Category festgelegt ist.
- Value: Hier können Sie einen bestimmten Wert für das Eingabeattribut oder die Eingabekategorie angeben, das bzw. die je nach dem Wert des Operators zur Beendigung führt.
- Combine Using: Legen Sie diesen Wert fest, wenn Sie mehrere Bedingungen hinzufügen möchten. Sie können sie mit einer And- oder einer Or-Bedingung verbinden.
Die Operator-Werte für die Bedingungsbarriere lauten wie folgt: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
- INCLUDES_THE_VALUES—Eine Operation mit "Bitwise AND", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
- DOES_NOT_INCLUDE_THE_VALUES—Eine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
- INCLUDES_ANY—Eine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Eine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
Die type-Optionen für die Bedingungsbarriere lauten wie folgt: - SPECIFIC_VALUE—Nach einem bestimmten Wert oder einer bestimmten Netzwerkkategorie filtern.
- NETWORK_ATTRIBUTE—Nach einem Netzwerkattribut filtern.
Die Combine Using-Werte lauten wie folgt: - AND—Die Bedingungsbarrieren kombinieren.
- OR—Verwenden, wenn eine der Bedingungsbarrieren erfüllt ist.
Weitere Informationen zum Verwenden von mehreren Bedingungsausdrücken | Value Table |
function_barriers [[Function, Attribute, Operator, Value, Use Local Values],...] (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.
Die Komponenten der Funktionsbarrieren sind folgende: - Function: Hier können Sie unter mehreren Berechnungsfunktionen wählen.
- Attribute: Hier können Sie nach einem beliebigen Netzwerkattribut, das im System definiert ist, filtern.
- Operator: Hier können Sie unter mehreren Operatoren wählen.
- Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp festlegen, der zur Beendigung führt, wenn er ermittelt wird.
- Use Local Values: Hier können Sie Werte in jeder Richtung berechnen, im Gegensatz zu einem allgemeinen globalen Wert. Verwenden Sie dies beispielsweise für eine Funktionsbarriere, die die Summe von Shape length berechnet, wobei die Verfolgung beendet wird, wenn der Wert größer als oder gleich 4 ist. Wenn Sie im globalen Fall zwei Kanten mit dem Wert 2 durchlaufen haben, wird die Verfolgung beendet, da Sie bereits die Shape-Länge 4 erreicht haben. Wenn lokale Werte verwendet werden, dann läuft die Verfolgung weiter, da sich die lokalen Werte auf jedem Pfad ändern.
- TRUE—Lokale Werte werden verwendet.
- FALSE—Globale Werte werden verwendet. Dies ist die Standardeinstellung.
Die function-Optionen für die Funktionsbarriere lauten wie folgt: - AVERAGE—Der Durchschnitt der Eingabewerte wird berechnet.
- COUNT—Die Anzahl der Features wird ermittelt.
- MAX—Das Maximum der Eingabewerte wird ermittelt.
- MIN—Das Minimum der Eingabewerte wird ermittelt.
- ADD—Die Summe der Eingabewerte wird berechnet.
- SUBTRACT—Die Differenz der Eingabewerte wird berechnet.Bei Verfolgungen vom Typ "Teilnetz-Controller" und "Schleifen" wird die Subtrahieren-Funktion nicht unterstützt.
Das Startpunkt-Feature weist beispielsweise den Wert 20 auf. Das nächste Feature hat den Wert 30. Mit der Funktion "Minimum" ist das Ergebnis 20, mit "Maximum" ist es 30, mit "Addieren" ist es 50, mit "Durchschnitt " ist es 25, mit "Anzahl" ist es 2, und mit "Subtrahieren" ist es -10. Die operator-Wertoptionen für die Funktionsbarriere lauten wie folgt: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
- INCLUDES_THE_VALUES—Eine Operation mit "Bitwise AND", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
- DOES_NOT_INCLUDE_THE_VALUES—Eine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
- INCLUDES_ANY—Eine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Eine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
| Value Table |
include_barriers (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. - INCLUDE_BARRIERS—Barrieren für die Durchlassfähigkeit werden in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung.
- EXCLUDE_BARRIERS—Barrieren für die Durchlassfähigkeit werden nicht in die Verfolgungsergebnisse einbezogen.
| Boolean |
traversability_scope (optional) | Gibt den Typ der Durchlassfähigkeit an, der angewendet wird. Der Umfang der Durchlassfähigkeit bestimmt, ob die Durchlassfähigkeit auf Knoten, auf Kanten oder auf Knoten und auf Kanten angewendet wird. Beispiel: Wenn eine Bedingungsbarriere definiert wurde, um die Verfolgung zu stoppen, wenn DEVICESTATUS gleich "Offen" ist und der Umfang der Durchlassfähigkeit nur für Kanten festgelegt ist, würde die Verfolgung auch dann nicht gestoppt, wenn ein offenes Bauteil vorhanden ist, da DEVICESTATUS nur für Knoten gilt. Anders gesagt wird mit diesem Parameter angegeben, ob bei der Verfolgung Knoten, Kanten oder beides ignoriert werden sollen. - BOTH_JUNCTIONS_AND_EDGES—Die Durchlassfähigkeit wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung.
- JUNCTIONS_ONLY—Die Durchlassfähigkeit wird nur auf Knoten angewendet.
- EDGES_ONLY—Die Durchlassfähigkeit wird nur auf Kanten angewendet.
| String |
propagators [[Attribute, Substitution Attribute, Function, Operator, Value],...] (optional) | Legt fest, welche Netzwerkattribute weitergegeben werden sollen und wie diese Weitergabe während einer Verfolgung durchgeführt wird. Weitergegebene Klassenattribute geben die Schlüsselwerte für Teilnetz-Controller an, die auf die restlichen Features im Teilnetz verteilt werden. In einem Stromversorgungsmodell können Sie beispielsweise die Phasenwerte weitergeben. Folgende Komponenten stehen bei den Weitergabemodulen zur Verfügung: - Attribute: Legen Sie die Filterung nach einem beliebigen im System definierten Netzwerkattribut fest.
- Substitution Attribute: Verwendet einen Ersatzwert anstelle von Bitset-Netzwerkattributwerten. Ersetzungen werden basierend auf der Anzahl der Bits im weitergegebenen Netzwerkattribut codiert. Eine Ersetzung ist die Zuordnung der Bits in einer Phase zu jeweils einem anderen Bit. Bei Phase AC kann im Rahmen einer Ersetzung z. B. Bit A zu B und Bit C zu NULL zugeordnet werden. In diesem Beispiel lautet die Ersetzung für 1010 (Phase AC) 0000-0010-0000-0000 (512). In der Ersetzung ist die Zuordnung ersichtlich, damit Sie wissen, dass Phase A zu B zugeordnet und Phase C zu NULL zugeordnet wurde und nicht andersherum (d. h. Phase A wurde nicht zu NULL zugeordnet und Phase C nicht zu B).
- Function: Wählen Sie aus verschiedenen Berechnungsfunktionen aus.
- Operator: Wählen Sie aus verschiedenen Operatoren aus.
- Value: Hier können Sie einen bestimmten Wert für den Eingabeattributtyp angeben, der je nach dem Wert des Operators zur Beendigung führt.
Die function-Wertoptionen für die Verteilungsmodule lauten wie folgt: - PROPAGATED_BITWISE_AND—Die Werte aus einem Feature mit dem nächsten vergleichen.
- PROPAGATED_MIN—Den Minimalwert abrufen.
- PROPAGATED_MAX—Den Maximalwert abrufen.
Die operator-Wertoptionen für die Verteilungsmodule lauten wie folgt: - IS_EQUAL_TO—Das Attribut ist gleich dem Wert.
- DOES_NOT_EQUAL—Das Attribut ist nicht gleich dem Wert.
- IS_GREATER_THAN—Das Attribut ist größer als der Wert.
- IS_GREATER_THAN_OR_EQUAL_TO—Das Attribut ist größer als oder gleich dem Wert.
- IS_LESS_THAN—Das Attribut ist kleiner als der Wert.
- IS_LESS_THAN_OR_EQUAL_TO—Das Attribut ist kleiner als oder gleich dem Wert.
- INCLUDES_THE_VALUES—Eine Operation mit "Bitwise AND", in der alle Bits im Wert im Attribut vorhanden sind (Bitwise AND == Wert).
- DOES_NOT_INCLUDE_THE_VALUES—Eine Operation mit "Bitwise AND", in der nicht alle Bits im Wert im Attribut vorhanden sind (Bitwise AND != Wert).
- INCLUDES_ANY—Eine Operation mit "Bitwise AND", in der mindestens ein Bit im Wert im Attribut vorhanden ist (Bitwise AND == True).
- DOES_NOT_INCLUDE_ANY—Eine Operation mit "Bitwise AND", in der keine der Bits im Wert im Attribut vorhanden sind (Bitwise AND == False).
| Value Table |