Verfolgungskonfiguration hinzufügen (Utility Network Tools)
Zusammenfassung
Mit diesem Werkzeug können Sie in einem Versorgungsnetz eine benannte Verfolgungskonfiguration erstellen.
Damit können Sie die Eigenschaften komplexer Verfolgungen zum Wiederverwenden und Freigeben konfigurieren und speichern. Benannte Verfolgungskonfigurationen, die in einem Versorgungsnetz erstellt wurden, können in ArcGIS Pro mit dem Werkzeug Verfolgen oder durch Verwenden der Registerkarte Benannte Konfigurationen im Bereich Verfolgung verwendet werden. Bei Verwendung einer Enterprise-Bereitstellung können benannte Verfolgungskonfigurationen auch über eine Webkarte freigegeben und durch Web-Apps und (mobile) Apps für den Außendienst verwendet werden.
Weitere Informationen zum Erstellen einer benannten Verfolgungskonfiguration
Verwendung
Der Parameterwert für Eingabe-Versorgungsnetz muss Version 5 oder höher lauten.
Wenn Sie mit einer Enterprise-Geodatabase arbeiten, muss das Eingabe-Versorgungsnetz aus einem Versorgungsnetz-Service stammen.
Das verbundene Portal-Konto wurde als Ersteller der benannten Verfolgungskonfiguration festgelegt. Der Ersteller der benannten Verfolgungskonfiguration wird mittels Betriebssystemauthentifizierung gespeichert, wenn er mit einem Versorgungsnetz in einer Einzelbenutzerbereitstellung arbeitet.
Lizenz:
Dem aktiven Portal-Konto muss eine Lizenz mit der Benutzertyp-Erweiterung ArcGIS Advanced Editing zugewiesen sein, um dieses Werkzeug in einer Enterprise-Bereitstellung zu verwenden.
Parameter
| Beschriftung | Erläuterung | Datentyp |
|---|---|---|
|
Eingabe-Versorgungsnetz |
Das Versorgungsnetz, das die neue benannte Verfolgungskonfiguration enthält. |
Utility Network; Utility Network Layer |
|
Name der Verfolgungskonfiguration |
Der Name der benannten Verfolgungskonfiguration. |
String |
|
Verfolgungstyp |
Gibt den zu verwendenden Netzverfolgungstyp an.
|
String |
|
Beschreibung (Optional) |
Die Beschreibung der benannten Verfolgungskonfiguration. |
String |
|
Tags (Optional) |
Verschiedene Tags, die zur Kennzeichnung der benannten Verfolgungskonfiguration verwendet werden. Die Tags können bei Suchvorgängen und zum Indizieren verwendet werden. |
String |
|
Netzart (Optional) |
Der Name der Ebene in einer herkömmlichen Netzart, auf der die Verfolgung ausgeführt wird. Dieser Parameter ist erforderlich, wenn die Verfolgungen vom Typ "Teilnetz", "Teilnetz-Controller", "Flussaufwärts", "Flussabwärts" oder "Stromkreisverfolgung" ausgeführt werden. |
String |
|
Ebene (Optional) |
Der Name der Ebene, auf der die Verfolgung gestartet wird. Dieser Parameter ist erforderlich, wenn die Verfolgungen vom Typ "Teilnetz", "Teilnetz-Controller", "Flussaufwärts" und "Flussabwärts" ausgeführt werden. |
String |
|
Zielebene (Optional) |
Der Name der Zielebene in einer herkömmlichen Netzart, in deren Richtung die Eingabeebene in einer unidirektionalen Verfolgung fließt. Wenn dieser Parameter in Verfolgungen vom Typ "Flussaufwärts" und "Flussabwärts" nicht angegeben wird, 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 |
|
Teilnetzname (Optional) |
Der Name des Teilnetzes in einer herkömmlichen Netzart, in dem die Verfolgung ausgeführt wird. Dieser Parameter kann zum Ausführen einer Teilnetz-Verfolgung verwendet werden. Wenn ein Teilnetzname angegeben wird, sind keine Startpunkte erforderlich. 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 |
|
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" verwendet wird. Die kürzeste Verbindung wird 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 eine Pfadverfolgung optional, jedoch beim Ausführen einer Verfolgung vom Typ "Kürzeste Verbindung" erforderlich. |
String |
|
Container einbeziehen (Optional) |
Gibt an, ob die Container-Features in die Verfolgungsergebnisse einbezogen werden.
|
Boolean |
|
Inhalt einbeziehen (Optional) |
Gibt an, ob die Verfolgung in den Ergebnissen den Inhalt in Container-Features zurückgibt.
|
Boolean |
|
Strukturen einbeziehen (Optional) |
Gibt an, ob Struktur-Features und Objekte in die Verfolgungsergebnisse einbezogen werden.
|
Boolean |
|
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. Dieser Parameter gilt nicht für Bauteil-Features mit Anschlusspunkten.
|
Boolean |
|
Konsistenz überprüfen (Optional) |
Gibt an, ob ein Fehler ausgegeben wird, wenn in den durchlaufenen Features Dirty Areas gefunden werden. Dies ist die einzige Möglichkeit sicherzustellen, dass eine Verfolgung Features mit einem konsistenten Status im Netzwerk weitergibt. Um Dirty Areas zu entfernen, validieren Sie die Netzwerk-Topologie.
|
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 "Bauteilstatus" eines Features dem spezifischen Wert Weitere Informationen zum Verwenden von mehreren Bedingungsausdrücken 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 an, ob Durchlassfähigkeit auf Knoten, Kanten oder beides angewendet 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 eine 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. Bei Verwendung mehrerer Attribute können Sie mit der Option Kombination verwenden eine And- oder eine Or-Bedingung definieren. Weitere Informationen zum Verwenden von mehreren Bedingungsausdrücken 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 |
|
Funktionen (Optional) |
Die Berechnungsfunktionen, die auf die Verfolgungsergebnisse angewendet werden. Spalten der Wertetabelle:
|
Value Table |
|
Weitergabemodule (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. In einer Telekommunikationsnetzart können Sie Wellenlängenwerte von Features weitergeben, die als Stromkreispositionen definiert sind. Hinweis:Dieser Parameter ist nur in Python verfügbar. Spalten der Wertetabelle:
|
Value Table |
|
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. Weitere Informationen zum Verwenden von mehreren Bedingungsausdrücken Spalten der Wertetabelle:
|
Value Table |
|
Isolierte Features einbeziehen (Optional) |
Gibt an, ob isolierte Features in die Verfolgungsergebnisse einbezogen werden. Dieser Parameter wird zum Ausführen einer Isolationsverfolgung verwendet.
|
Boolean |
|
Barrieren bei Startpunkten ignorieren (Optional) |
Gibt an, ob dynamische Barrieren in der Verfolgungskonfiguration für Startpunkte ignoriert werden. Dies kann nützlich sein, wenn eine Verfolgung der Schutzbauteile flussaufwärts durchgeführt wird und die ermittelten Schutzbauteile (Barrieren) als Startpunkte verwendet werden, um nachfolgende Schutzbauteile flussaufwärts zu finden.
|
Boolean |
|
Bis ersten räumlichen Container einbeziehen (Optional) |
Gibt an, ob die zurückgegebenen Container begrenzt werden, sodass nur Container bis einschließlich des ersten räumlichen Containers für jedes Netzwerkelement in die Verfolgungsergebnisse einbezogen werden. Wenn keine räumlichen Container erkannt werden, aber nichträumliche Container für ein bestimmtes Netzwerkelement vorhanden sind, werden alle nichträumlichen Container in die Ergebnisse einbezogen. Dieser Parameter ist nur aktiviert, wenn
|
Boolean |
|
Ergebnistypen (Optional) |
Gibt den Typ der Ergebnisse an, die von der Verfolgung zurückgegeben werden.
|
String |
|
Unbestimmbare Fließrichtung zulassen (Optional) |
Gibt an, ob Features mit einer unbestimmbaren Fließrichtung verfolgt werden. Dieser Parameter ist nur bei der Ausführung einer Verfolgung flussaufwärts, einer Verfolgung flussabwärts oder einer Isolationsverfolgung anwendbar.
|
Boolean |
|
Verortbarkeit überprüfen (Optional) |
Gibt an, ob während der Verfolgung ein Fehler zurückgegeben wird, wenn nichträumliche Knoten- oder Kantenobjekte ohne die erforderliche Konnektivitäts-, Containment- oder Anbauzuordnung in der Zuordnungshierarchie gefunden werden. Dieser Parameter stellt sicher, dass nichträumliche Objekte, die von einer Verfolgung zurückgegeben werden, durch die Zuordnung mit Features oder anderen verortbaren Objekten verortet werden können.
|
Boolean |
|
Digitalisierrichtung verwenden (Optional) |
Gibt an, ob die Fließrichtung bei Verfolgungen flussaufwärts oder flussabwärts mithilfe der Digitalisierrichtung der Linie, der Von- und Bis-Global-ID des Kantenobjekts in der Zuordnung sowie des Attributs Hinweis:Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 11.3 oder höher.
|
Boolean |
|
Geometrien darstellen (Optional) |
Gibt an, ob Geometrien für Zuordnungen und Kantenobjekte, die bei einer Verfolgung durchquert werden, abgeleitet und erstellt (dargestellt) werden. Dieser Parameter kann nur für Ergebnisse des Typs "Aggregierte Geometrie" verwendet werden. Hinweis:Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 11.3 oder höher.
|
Boolean |
|
Pfadanzahl (Optional) |
Die maximale Pfadanzahl, die zwischen mehreren angegebenen Start- und Endpunkten in einer pfadbasierten Verfolgung zurückgegeben wird. Die Standardeinstellung ist 2. Dieser Parameter ist nur aktiv, wenn der Parameter Verfolgungstyp auf Pfad festgelegt ist. Hinweis:Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 12.1 oder höher. |
Long |
|
Maximale Hop-Anzahl (Optional) |
Die maximale Hop-Anzahl zwischen Kanten, die im Pfad 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. Die Standardeinstellung ist 100. Dieser Parameter ist nur aktiv, wenn der Parameter Verfolgungstyp auf Pfad festgelegt ist. Hinweis:Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 12.1 oder höher. |
Long |
|
Stromkreisname (Optional) |
Der Name des Stromkreises in einer Telekommunikationsnetzart, in der die Stromkreisverfolgung durchgeführt wird. Hinweis:Für Enterprise-Geodatabases erfordert dieser Parameter ArcGIS Enterprise 12.0 oder höher. |
String |
|
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 finden. Dieser Parameter wird 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-Versorgungsnetz |
Das aktualisierte Versorgungsnetz. |
Utility Network |
Umgebungen
Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.
Lizenzierungsinformationen
- Basic: Nein
- Standard: Ja
- Advanced: Ja