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 Features an einem Versorgungsnetz definiert. Ein Versorgungsnetz enthält vom System bereitgestellte Zuordnungsrollen für Strukturen und Container. Bei Features, die über Zuordnungen als Container oder Strukturen festgelegt werden sollen, muss zuerst eine Zuordnungsrolle festgelegt werden. Diese wird auf der Ebene der Feature-Class oder Tabelle 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 das Eingabe-Versorgungsnetz aus einer Datenbankverbindung stammen, die als Besitzer des Datenbank-Versorgungsnetzes eingerichtet wurde.

Syntax

SetAssociationRole(in_utility_network, domain_network, featureclass, assetgroup, assettype, association_role_type, association_deletion_semantics, {view_scale}, {split_content})
ParameterErklärungDatentyp
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 Zuordnungsrollentyp für die Zuordnung zum Asset-Typ.

  • CONTAINERFeatures dieses Asset-Typs können andere Features als Inhalt enthalten.
  • STRUCTUREAn Features dieses Asset-Typs können andere Features angefügt sein.
  • NONEKein Rollentyp. Bei diesen Features 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 für die Features an; diese bestimmt, wie Child-Features behandelt werden, wenn das Parent-Feature gelöscht wird. Sie gilt sowohl für die Zuordnungsrolle "Container" als auch für die Zuordnungsrolle "Struktur".

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

Der Maßstab, bei dem zum Bearbeiten von am Container beteiligten Features der Containment-Modus 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.

Double
split_content
(optional)

Gibt an, was mit dem verknüpften Inhalt eines Containers geschehen soll, wenn das Container-Feature geteilt wird. Dieser Parameter ist nur verfügbar, 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.
  • 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. Dies ist die Standardeinstellung.
Boolean

Abgeleitete Ausgabe

NameErklärungDatentyp
out_utility_network

Das aktualisierte Versorgungsnetz.

Versorgungsnetz

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.SetAssociationRole_un("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