Zuordnungsrolle festlegen (Utility Network)

Zusammenfassung

Ändert die Zuordnungsrolle, die einer Network-Feature-Class oder Tabelle auf der Ebene des Asset-Typs zugewiesen wurde.

Mit Zuordnungsrollen wird die Art der Beteiligung bestimmter Netzwerk-Features an einem Versorgungsnetz definiert. Ein Versorgungsnetz enthält vom System bereitgestellte Zuordnungsrollen für Strukturen und Container. Bei einen Netzwerk-Feature, das über Zuordnungen als Container oder Struktur festgelegt werden soll, muss zuerst eine Zuordnungsrolle festgelegt werden. Diese wird auf der Ebene der Feature-Class oder des Objekts für bestimmte Asset-Gruppen und Asset-Typen zugewiesen.

Weitere Informationen zum Festlegen oder Ändern der Zuweisung einer Zuordnungsrolle

Verwendung

  • Mit diesem Werkzeug kann für die Rolle eines Asset-Typs der Maßstab für die Anzeige und die Semantik zum Löschen definiert oder aktualisiert werden.

  • Die Netzwerk-Topologie muss deaktiviert sein.

  • Die Zuordnungsrollen "Container" oder "Struktur" können nur vor der ersten Aktivierung der Netzwerk-Topologie aufgehoben werden. Weitere Beispiele und den jeweils erforderlichen Zustand der Netzwerk-Topologie finden Sie unter Verwaltungsaufgaben für Versorgungsnetze.

  • Wenn Sie mit einer Enterprise-Geodatabase arbeiten, muss das verbundene ArcGIS Enterprise-Portal-Konto der Besitzer des Portal-Versorgungsnetzes sein.

  • Wenn Sie mit einer Enterprise-Geodatabase arbeiten, muss der Parameterwert Eingabe-Versorgungsnetz aus einer Datenbankverbindung stammen, die als Besitzer des Datenbank-Versorgungsnetzes eingerichtet wurde.

Parameter

BeschriftungErläuterungDatentyp
Eingabe-Versorgungsnetz

Das Versorgungsnetz, das den Asset-Typ mit einer festzulegenden Zuordnungsrolle enthält.

Utility Network; Utility Network Layer
Netzart

Die Netzart, die den Asset-Typ mit einer festzulegenden Zuordnungsrolle enthält.

String
Eingabetabelle

Die Utility-Network-Feature-Class oder -Tabelle, in der die Zuordnungsrolle festgelegt wird.

String
Asset-Gruppe

Die Asset-Gruppe, die den Asset-Typ enthält.

String
Asset-Typ

Der Asset-Typ, für den die Zuordnungsrolle festgelegt wird.

String
Rollentyp

Gibt den Typ der Zuordnungsrolle an, die dem Asset-Typ zugewiesen werden soll.

  • ContainerEs wird eine Zuordnungsrolle des Typs "Container" zugewiesen. Features oder Objekte dieses Rollentyps können andere Features und Objekte als Inhalt enthalten.
  • StrukturEs wird eine Zuordnungsrolle des Typs "Struktur" zugewiesen. An Features oder Objekte dieses Rollentyps können andere Features und Objekte angefügt sein.
  • KeineEs werden keine Rollentypen zugewiesen. Bei diesen Features oder Objekten handelt es sich weder um einen Container noch um eine Struktur, sie stellen jedoch eine Verbindung mit anderen Strukturen her.
String
Semantik zum Löschen

Gibt die Semantik zum Löschen von Netzwerk-Features an, die definiert, wie Inhalts- oder Anbau-Netzwerk-Features behandelt werden, wenn der Container oder die Struktur gelöscht wird. Sie gilt sowohl für die Zuordnungsrolle "Container" als auch für die Zuordnungsrolle "Struktur".

  • KaskadeWenn der Container oder die Struktur gelöscht wird, werden alle Inhalts- oder Anbau-Netzwerk-Features gelöscht.
  • KeineBeim Löschen eines Containers oder einer Struktur werden die zugehörigen Inhalts- oder Anbau-Netzwerk-Features nicht gelöscht, sondern aus der Containment- bzw. strukturellen Anbau-Zuordnung entfernt.
  • EingeschränktWenn Inhalts- oder Anbau-Netzwerk-Features vorhanden sind, wird beim Versuch, den Container oder die Struktur zu löschen, ein Fehler zurückgegeben. Die Inhalts- oder Anbau-Netzwerk-Features müssen vor dem Löschen des Containers bzw. der Struktur entfernt werden.
String
Maßstab anzeigen
(optional)

Der Maßstab, bei dem der Containment-Modus zum Bearbeiten von am Container beteiligten Features aufgerufen wird. Wenn beispielsweise der Maßstab für die Anzeige auf 5 festgelegt wird, wird beim Aufrufen des Containment-Modus für die Container-Features der Maßstab 1:5 verwendet. Die Einheiten basieren auf den Einheiten des Versorgungsnetzes, die sich auf der Registerkarte Quelle des Eigenschaftenbereichs des Versorgungsnetz-Layers befinden. Dieser Parameter findet keine Anwendung auf Knoten- und Kantenobjekte.

Double
Inhalt teilen
(optional)

Gibt an, ob der zugehörige Inhalt eines Containers beim Teilen des Container-Features geteilt wird. Dieser Parameter ist nur aktiv, wenn die Zuordnungsrolle "Container" lautet; er wird außerdem nur auf Linien-Features angewendet.

  • Aktiviert: Der Inhalt des Containers wird beim Teilen des Container-Features geteilt. Wenn ein paralleles Inhaltslinien-Feature gefunden wird, wird der Inhalt ebenfalls geteilt, und jeder Abschnitt wird Bestandteil des nächstgelegenen Container-Features. Wenn die Inhaltslinie nicht parallel ist, wird der Inhalt dem Container-Feature zugewiesen, dem er am nächsten liegt. Wenn es sich bei dem Inhalt um ein nichträumliches Knotenobjekt handelt, wird der Inhalt dupliziert, sodass jedes Container-Feature als Inhalt ein Knotenobjekt hat. Wenn es sich bei dem Inhalt um ein nichträumliches Kantenobjekt handelt, wird der Inhalt geteilt, sodass jedes Container-Feature als Inhalt ein Kantenobjekt hat.
  • Deaktiviert: Der Inhalt des Containers wird beim Teilen des Container-Features nicht geteilt. Wenn ein paralleles Inhaltslinien-Feature gefunden wird, wird der Inhalt in beide Abschnitte des Container-Features einbezogen. Wenn die Inhaltslinie nicht parallel ist, wird der Inhalt dem Container-Feature zugewiesen, dem er am nächsten liegt. Bei der Arbeit mit Inhalt in Form eines nichträumlichen Knotenobjekts ist der Inhalt in dem größeren Container enthalten. Bei der Arbeit mit Inhalt in Form eines nichträumlichen Kantenobjekts wird der Inhalt in beiden übergeordneten Containern verwaltet. Dies ist die Standardeinstellung.

Boolean

Abgeleitete Ausgabe

BeschriftungErläuterungDatentyp
Aktualisiertes Versorgungsnetz

Das aktualisierte Versorgungsnetz.

Utility Network

arcpy.un.SetAssociationRole(in_utility_network, domain_network, featureclass, assetgroup, assettype, association_role_type, association_deletion_semantics, {view_scale}, {split_content})
NameErläuterungDatentyp
in_utility_network

Das Versorgungsnetz, das den Asset-Typ mit einer festzulegenden Zuordnungsrolle enthält.

Utility Network; Utility Network Layer
domain_network

Die Netzart, die den Asset-Typ mit einer festzulegenden Zuordnungsrolle enthält.

String
featureclass

Die Utility-Network-Feature-Class oder -Tabelle, in der die Zuordnungsrolle festgelegt wird.

String
assetgroup

Die Asset-Gruppe, die den Asset-Typ enthält.

String
assettype

Der Asset-Typ, für den die Zuordnungsrolle festgelegt wird.

String
association_role_type

Gibt den Typ der Zuordnungsrolle an, die dem Asset-Typ zugewiesen werden soll.

  • CONTAINEREs wird eine Zuordnungsrolle des Typs "Container" zugewiesen. Features oder Objekte dieses Rollentyps können andere Features und Objekte als Inhalt enthalten.
  • STRUCTUREEs wird eine Zuordnungsrolle des Typs "Struktur" zugewiesen. An Features oder Objekte dieses Rollentyps können andere Features und Objekte angefügt sein.
  • NONEEs werden keine Rollentypen zugewiesen. Bei diesen Features oder Objekten handelt es sich weder um einen Container noch um eine Struktur, sie stellen jedoch eine Verbindung mit anderen Strukturen her.
String
association_deletion_semantics

Gibt die Semantik zum Löschen von Netzwerk-Features an, die definiert, wie Inhalts- oder Anbau-Netzwerk-Features behandelt werden, wenn der Container oder die Struktur gelöscht wird. Sie gilt sowohl für die Zuordnungsrolle "Container" als auch für die Zuordnungsrolle "Struktur".

  • CASCADEWenn der Container oder die Struktur gelöscht wird, werden alle Inhalts- oder Anbau-Netzwerk-Features gelöscht.
  • SET_TO_NONEBeim Löschen eines Containers oder einer Struktur werden die zugehörigen Inhalts- oder Anbau-Netzwerk-Features nicht gelöscht, sondern aus der Containment- bzw. strukturellen Anbau-Zuordnung entfernt.
  • RESTRICTEDWenn Inhalts- oder Anbau-Netzwerk-Features vorhanden sind, wird beim Versuch, den Container oder die Struktur zu löschen, ein Fehler zurückgegeben. Die Inhalts- oder Anbau-Netzwerk-Features müssen vor dem Löschen des Containers bzw. der Struktur entfernt werden.
String
view_scale
(optional)

Der Maßstab, bei dem der Containment-Modus zum Bearbeiten von am Container beteiligten Features aufgerufen wird. Wenn beispielsweise der Maßstab für die Anzeige auf 5 festgelegt wird, wird beim Aufrufen des Containment-Modus für die Container-Features der Maßstab 1:5 verwendet. Die Einheiten basieren auf den Einheiten des Versorgungsnetzes, die sich auf der Registerkarte Quelle des Eigenschaftenbereichs des Versorgungsnetz-Layers befinden. Dieser Parameter findet keine Anwendung auf Knoten- und Kantenobjekte.

Double
split_content
(optional)

Gibt an, ob der zugehörige Inhalt eines Containers beim Teilen des Container-Features geteilt wird. Dieser Parameter wird nur aktiviert, wenn die Zuordnungsrolle "Container" lautet; er wird außerdem nur auf Linien-Features angewendet.

  • SPLITDer Inhalt des Containers wird beim Teilen des Container-Features geteilt. Wenn ein paralleles Inhaltslinien-Feature gefunden wird, wird der Inhalt ebenfalls geteilt, und jeder Abschnitt wird Bestandteil des nächstgelegenen Container-Features. Wenn die Inhaltslinie nicht parallel ist, wird der Inhalt dem Container-Feature zugewiesen, dem er am nächsten liegt. Wenn es sich bei dem Inhalt um ein nichträumliches Knotenobjekt handelt, wird der Inhalt dupliziert, sodass jedes Container-Feature als Inhalt ein Knotenobjekt hat. Wenn es sich bei dem Inhalt um ein nichträumliches Kantenobjekt handelt, wird der Inhalt geteilt, sodass jedes Container-Feature als Inhalt ein Kantenobjekt hat.
  • DO_NOT_SPLITDer Inhalt des Containers wird beim Teilen des Container-Features nicht geteilt. Wenn ein paralleles Inhaltslinien-Feature gefunden wird, wird der Inhalt in beide Abschnitte des Container-Features einbezogen. Wenn die Inhaltslinie nicht parallel ist, wird der Inhalt dem Container-Feature zugewiesen, dem er am nächsten liegt. Bei der Arbeit mit Inhalt in Form eines nichträumlichen Knotenobjekts ist der Inhalt in dem größeren Container enthalten. Bei der Arbeit mit Inhalt in Form eines nichträumlichen Kantenobjekts wird der Inhalt in beiden übergeordneten Containern verwaltet. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
out_utility_network

Das aktualisierte Versorgungsnetz.

Utility Network

Codebeispiel

SetAssociationRole: Beispiel (Python-Fenster)

Mit diesem Beispielskript wird die Zuordnungsrolle "Container" für den Asset-Typ "transformer" festgelegt. Der Maßstab für die Anzeige wurde auf 10 festgelegt, und die Semantik zum Löschen wurde eingeschränkt.

import arcpy
arcpy.un.SetAssociationRole("Utility Network", "ElectricDistribution", 
                            "ElectricDistributionAssembly", "Transformer Bank", 
                            "Transformer", "CONTAINER", "RESTRICTED", 10)

Umgebungen

Dieses Werkzeug verwendet keine Geoverarbeitungsumgebungen.

Lizenzinformationen

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

Verwandte Themen