Teilnetz aktualisieren (Utility Network Tools)

Zusammenfassung

Aktualisiert Teilnetz-Informationen in der Tabelle der Teilnetze, der SubnetLine-Feature-Class und den Teilnetz-Systemschemas der angegebenen Teilnetze.

In der Tabelle der Teilnetze legt dieses Werkzeug den Status der zugeordneten Teilnetz-Controller auf "Validiert" fest (das Attribut Is dirty wird auf "False" festgelegt). Wenn bei der Ausführung des Werkzeugs Fehler bei "Konsistenz überprüfen" oder Teilnetzfehler festgestellt werden, wird der Status der zugeordneten Teilnetz-Controller als ungültig markiert (das Attribut Is dirty wird auf "Ungültig" festgelegt). In der SubnetLine-Feature-Class wird ein Datensatz für neue Teilnetze erstellt. Außerdem werden die Datensätze für alle gelöschten Teilnetze entfernt und die Form und die Informationen für alle geänderten Teilnetze aktualisiert. Es werden auch bestimmte Attribute für Teilnetz-Features erstellt oder aktualisiert.

Wenn die Option Teilnetzrichtlinie aktualisieren für eine Ebene so konfiguriert ist, dass das Attribut Is dirty nicht verwaltet wird, kann der Vorgang "Teilnetz aktualisieren" verwendet werden, um Zeilen in der Teilnetztabelle zu löschen, in der das Is deleted-Attribut auf "true" festgelegt ist.

Weitere Informationen zum Aktualisieren von Teilnetzen

Verwendung

Die folgenden Anforderungen müssen erfüllt werden, wenn mit einer Enterprise-Geodatabase gearbeitet wird:
- Das Versorgungsnetz muss als nach Verzweigung versioniert registriert sein.
- Das Eingabe-Versorgungsnetz muss aus einem Utility Network-Service stammen.
- Der Vorgang "Teilnetz aktualisieren" in der Default-Version kann verwendet werden, um Zeilen aus der Teilnetztabelle für Ebenen zu löschen, in denen das Attribut Is dirty nicht verwaltet wird.
- Wenn dieses Werkzeug in der Default-Version ausgeführt wird, werden die Geometrie, das Attribut des Teilnetznamens und weitergegebene Felder der SubnetLine-Feature-Class lokal aktualisiert. Wird dieses Werkzeug für eine benannte Version ausgeführt, werden Aktualisierungen durch das Standardverhalten (ohne Ereignisse) auf die in der Version bearbeiteten Features und Objekte beschränkt. Der Bearbeitungsmodus kann so geändert werden, dass Ereignisse (mit Ereignissen) verwendet werden. Mit dieser Option, die in der Teilnetzdefinition sowohl für die Default-Version als auch für die benannte Version festgelegt werden kann, werden Verhaltensweisen von Geodatabases ausgeführt.
  
  Weitere Informationen zum verwendeten Bearbeitungsmodus des Werkzeugs Teilnetz aktualisieren
- Aktualisieren Sie ein Teilnetz immer nur mit einem einzelnen Prozess. Führen Sie das Werkzeug nicht mit aktiviertem Parameter Alle Teilnetze in Ebene aus, wenn Sie mehrere Prozesse ausführen. Dies kann zu einem Fehler führen, wenn zwei Prozesse versuchen, gleichzeitig dasselbe Teilnetz zu aktualisieren.
- Lizenz:
  
  Dem aktiven Portal-Konto muss eine Lizenz mit der Benutzertyp-Erweiterung ArcGIS Advanced Editing zugewiesen werden, um dieses Werkzeug in einer Unternehmensbereitstellung zu verwenden.
Dieses Werkzeug wird nur für die Verwendung mit herkömmlichen Netzarten unterstützt.
Mit diesem Werkzeug werden Netzwerkschemas für die aktualisierten Teilnetze erstellt oder aktualisiert, wenn eine Schemavorlage beim Einstellen der Teilnetzdefinition angegeben wurde.
Vor dem Ausführen dieses Werkzeugs müssen alle Änderungen gespeichert werden.
Die Netzwerk-Topologie muss aktiviert sein.
Es gibt keine Dirty Areas, die Teilnetz-Features schneiden.

Beschriftung	Erläuterung	Datentyp
Eingabe-Versorgungsnetz	Das Versorgungsnetz, in dem das Teilnetz enthalten ist.	Utility Network; Utility Network Layer
Netzart	Die Netzart, in der das Teilnetz enthalten ist.	String
Ebene	Die Ebene, in der das Teilnetz enthalten ist.	String
Alle Teilnetze in Ebene	Gibt an, ob alle Teilnetze in der Ebene aktualisiert werden sollen. Um eine Teilmenge der Teilnetze in der Ebene zu aktualisieren, verwenden Sie den Parameter Teilnetzname. Aktiviert—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. Deaktiviert—Nur die im Parameter Teilnetzname angegebenen Teilnetze werden aktualisiert. Dies ist die Standardeinstellung.	Boolean
Teilnetzname (Optional)	Der Name des Teilnetzes, das aus der Ebene aktualisiert werden soll. Dieser Parameter wird ignoriert, wenn der Parameter Alle Teilnetze in Ebene aktiviert ist. Wenn die Teilnetztabelle 10.000 oder mehr Datensätze für eine Ebene enthält, ist die Auswahlliste des Parameters nicht gefüllt, und für den Teilnetznamen wird ein leeres Feld angezeigt.	String
Bei Fehler fortfahren (Optional)	Gibt an, ob der Aktualisierungsprozess gestoppt werden soll, wenn die Aktualisierung eines Teilnetzes beim Aktualisieren mehrerer Teilnetze fehlschlägt. Aktiviert—Wenn ein Teilnetzfehler auftritt, wird der Aktualisierungsprozess nicht gestoppt, sondern fortgesetzt. Deaktiviert—Wenn ein Teilnetzfehler auftritt, wird der Aktualisierungsprozess gestoppt. Dies ist die Standardeinstellung.	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 `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. Weitere Informationen zum Verwenden von mehreren Bedingungsausdrücken Hinweis: Dieser Parameter ist nur für Python verfügbar. Spalten der Wertetabelle: Name—Filter by network attribute name. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Type—Filter by a specific type. Specific value—Filter by a specific value or network category. Network attribute—Filter by a network attribute. Value—Filter by a specific value. Combine Using—Use this parameter to combine multiple condition barriers. And—Combine the condition barriers. Or—Use if either condition barrier is met.	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. Hinweis: Dieser Parameter ist nur für Python verfügbar. Spalten der Wertetabelle: Function—Filter by a function. Min—The minimum of the input values will be identified. Max—The maximum of the input values will be identified. Average—The average of the input values will be calculated. Count—The number of features will be identified. Add—The sum of the input values will be calculated. Subtract—The difference in the input values will be calculated. Subnetwork controllers and loops trace types do not support the subtract function. Attribute—Filter by a network attribute. Operator—Filter by an operator. Is equal to—The attribute is equal to the value. Does not equal—The attribute is not equal to the value. Is greater than—The attribute is greater than the value. Is greater than or equal to—The attribute is greater than or equal to the value. Is less than—The attribute is less than the value. Is less than or equal to—The attribute is less than or equal to the value. Includes the values (bitwise AND equals the value)—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). Does not include the values (bitwise AND does not equal the value)—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). Includes any (bitwise AND equals True)—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). Does not include any (bitwise AND equals False)—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). Value—Filter by a specific value. Use Local Values—Boolean value to use local variables instead of a global variable.	Value Table
Barrieren-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. Aktiviert—Barrieren für die Durchlassfähigkeit werden in die Verfolgungsergebnisse einbezogen. Dies ist die Standardeinstellung. Deaktiviert—Barrieren für die Durchlassfähigkeit werden nicht in die Verfolgungsergebnisse einbezogen.	Boolean
Durchlassfähigkeit anwenden auf (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. Hinweis: Dieser Parameter ist nur für Python verfügbar. Knoten und Kanten—Die Durchlassfähigkeit wird sowohl auf Knoten als auch auf Kanten angewendet. Dies ist die Standardeinstellung. Nur Knoten—Die Durchlassfähigkeit wird nur auf Knoten angewendet. Nur Kanten—Die Durchlassfähigkeit wird nur auf Kanten angewendet.	String
Weitergabemodule (Optional)	Legt fest, welche Netzwerkattribute weitergegeben werden sollen und wie diese Weitergabe während einer Verfolgung in einer herkömmlichen Netzart 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. Hinweis: Dieser Parameter ist nur für Python verfügbar. Spalten der Wertetabelle: Attribute—Filter by a network attribute. Substitution Attribute—The field that will be used for attribute substitution. Function—Filter by a function. Operator—Filter by an operator. Value—Filter by a specific value.	Value Table

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisiertes Versorgungsnetz	Das aktualisierte Versorgungsnetz.	Utility Network

arcpy.un.UpdateSubnetwork(in_utility_network, domain_network, tier, all_subnetworks_in_tier, {subnetwork_name}, {continue_on_failure}, {condition_barriers}, {function_barriers}, {include_barriers}, {traversability_scope}, {propagators})

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	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. `SPECIFIC_SUBNETWORK`—Nur die im Parameter `subnetwork_name` angegebenen Teilnetze werden aktualisiert. Dies ist die Standardeinstellung.	Boolean
subnetwork_name (Optional)	Der Name des Teilnetzes, das aus der Ebene aktualisiert werden soll. Dieser Parameter wird ignoriert, wenn der Parameter `all_subnetworks_in_tier` auf `ALL_SUBNETWORKS_IN_TIER` festgelegt 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. Weitere Informationen zum Verwenden von mehreren Bedingungsausdrücken Hinweis: Dieser Parameter ist nur für Python verfügbar. Spalten der Wertetabelle: `Name`—Filter by network attribute name. `Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Type`—Filter by a specific type. `SPECIFIC_VALUE`—Filter by a specific value or network category. `NETWORK_ATTRIBUTE`—Filter by a network attribute. `Value`—Filter by a specific value. `Combine Using`—Use this parameter to combine multiple condition barriers. `AND`—Combine the condition barriers. `OR`—Use if either condition barrier is met.	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. Hinweis: Dieser Parameter ist nur für Python verfügbar. Spalten der Wertetabelle: `Function`—Filter by a function. `MIN`—The minimum of the input values will be identified. `MAX`—The maximum of the input values will be identified. `AVERAGE`—The average of the input values will be calculated. `COUNT`—The number of features will be identified. `ADD`—The sum of the input values will be calculated. `SUBTRACT`—The difference in the input values will be calculated. Subnetwork controllers and loops trace types do not support the subtract function. `Attribute`—Filter by a network attribute. `Operator`—Filter by an operator. `IS_EQUAL_TO`—The attribute is equal to the value. `DOES_NOT_EQUAL`—The attribute is not equal to the value. `IS_GREATER_THAN`—The attribute is greater than the value. `IS_GREATER_THAN_OR_EQUAL_TO`—The attribute is greater than or equal to the value. `IS_LESS_THAN`—The attribute is less than the value. `IS_LESS_THAN_OR_EQUAL_TO`—The attribute is less than or equal to the value. `INCLUDES_THE_VALUES`—A bitwise AND operation in which all bits in the value are present in the attribute (bitwise AND == value). `DOES_NOT_INCLUDE_THE_VALUES`—A bitwise AND operation in which not all of the bits in the value are present in the attribute (bitwise AND != value). `INCLUDES_ANY`—A bitwise AND operation in which at least one bit in the value is present in the attribute (bitwise AND == True). `DOES_NOT_INCLUDE_ANY`—A bitwise AND operation in which none of the bits in the value are present in the attribute (bitwise AND == False). `Value`—Filter by a specific value. `Use Local Values`—Boolean value to use local variables instead of a global variable.	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 in einer herkömmlichen Netzart 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. Hinweis: Dieser Parameter ist nur für Python verfügbar. Spalten der Wertetabelle: `Attribute`—Filter by a network attribute. `Substitution Attribute`—The field that will be used for attribute substitution. `Function`—Filter by a function. `Operator`—Filter by an operator. `Value`—Filter by a specific value.	Value Table

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
out_utility_network	Das aktualisierte Versorgungsnetz.	Utility Network

Codebeispiel

UpdateSubnetwork: Beispiel 1 (Python-Fenster)

Mit diesem Beispielskript wird ein bestimmtes Teilnetz mit der Bezeichnung "RMT004" aktualisiert.

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution",
                          "Medium Voltage", "SPECIFIC_SUBNETWORK", "RMT004",
                          "CONTINUE_ON_FAILURE")

UpdateSubnetwork: Beispiel 2 (Python-Fenster)

Mit diesem Beispielskript werden alle Teilnetze in der Ebene "Mittelspannung" aktualisiert.

import arcpy
arcpy.un.UpdateSubnetwork("Utility Network", "ElectricDistribution",
                          "Medium Voltage", "ALL_SUBNETWORKS_IN_TIER")

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzierungsinformationen

Basic: Nein
Standard: Ja
Advanced: Ja

Teilnetz aktualisieren (Utility Network Tools)

Zusammenfassung

Verwendung

Lizenz:

Parameter

Hinweis:

Hinweis:

Hinweis:

Hinweis:

Abgeleitete Ausgabe

Umgebungen

Lizenzierungsinformationen

Verwandte Themen