Gebäudenutzer-Features aktualisieren (Indoors)

Verfügbar für ArcGIS-Organisationen mit Lizenz für die Erweiterung "Indoors".

Zusammenfassung

Aktualisiert die Occupants-Feature-Class, die dem ArcGIS Indoors-Informationsmodell entspricht.

Mit diesem Werkzeug wird die Occupants-Feature-Class aktualisiert, die mit dem Werkzeug Indoors-Datenbank erstellen erstellt wurde. Gebäudenutzer-Features müssen möglicherweise aktualisiert werden, wenn neue Gebäudenutzer hinzugefügt, vorhandene Gebäudenutzer gelöscht oder vorhandene Gebäudenutzerinformationen aufgrund von Platzzuweisungs- oder Grundrissänderungen geändert werden müssen. Die aktualisierte Occupants-Feature-Class kann zur Unterstützung von Indoor-Analysen und -Funktionalitäten wie Suche, Routing und Workspace-Reservierung in Indoor Viewer und Indoors Mobile und Raumplanung in Indoor Space Planner verwendet werden.

Verwendung

• Beim Parameterwert Ziel-Gebäudenutzer-Features muss es sich um einen Feature-Layer, eine Feature-Class oder einen Feature-Service handeln, für den mit diesem Werkzeug Gebäudenutzer-Datensätze, die der Occupants-Feature-Class im Indoors-Modell entsprechen, hinzugefügt, aktualisiert oder gelöscht werden.

• Beim Parameterwert Eingabe-Raum-Features muss es sich um einen Feature-Layer, eine Feature-Class oder einen Feature-Service handeln, der der Units-Feature-Class im Indoors-Modell entspricht.

• Der Parameterwert für Eingabetabelle der Gebäudenutzer muss eine Geodatabase-Tabelle, eine Tabelle in einer Microsoft Excel-Arbeitsmappe (.xls- oder .xlsx-Datei), eine kommagetrennte Textdatei (.csv) oder eine OLE-DB-Tabelle sein.

• Die Eingabetabelle der Gebäudenutzer muss die Felder KNOWNAS und EMAIL enthalten. Für mehr Benutzerfreundlichkeit in der Space Planner-App können Sie optional die folgenden Felder einfügen bzw. beliebige zusätzliche Felder mit den Informationen, die in der Occupants-Feature-Class ausgefüllt und verwaltet werden sollen: ORG_LEVEL_1, ORG_LEVEL_2, JOB_TITLE, START_DATE und SITE_ID.

  In der Eingabetabelle der Gebäudenutzer können mehrere Zuweisungen in mehreren Spalten gespeichert werden. Das folgende Beispiel zeigt eine Zuweisung mit mehreren Spalten:

  

  In der folgenden Tabelle sind die erforderlichen und optionalen Felder für die Eingabetabelle der Gebäudenutzer aufgeführt.

  Hinweis:

  Das Feld SITE_ID wird nur ausgefüllt, wenn Sie das Feld SITE_ID im Werkzeug im Steuerelement für die Feldzuordnung zuordnen. Wenn Sie das Feld nicht zuordnen, bleibt der Feldwert SITE_ID für Gebäudenutzer NULL.

  Feld	Beschreibung	Erlaubt NULL-Werte
  KNOWNAS	Der Vor- und Nachname, der wahrscheinlich bei der Suche nach einem Gebäudenutzer verwendet wird.	Nein
  EMAIL	Die E-Mail-Adresse des Gebäudenutzers.	Nein
  ORG_LEVEL_1	Die erste Ebene der Organisation.	Ja
  ORG_LEVEL_2	Die zweite Ebene der Organisation.	Ja
  JOB_TITLE	Die Position des Gebäudenutzers	Ja
  START_DATE	Das Eintrittsdatum des Gebäudenutzers.	Ja
  SITE_ID	Der verknüpfe Standort des Gebäudenutzers. Die Werte in diesem Feld müssen den Werten im Feld SITE_ID in der Sites-Feature-Class aus dem Indoors-Modell entsprechen.	Ja

  Weitere Informationen zum Laden von Gebäudenutzerdaten

• Das Werkzeug unterstützt das Laden von Gebäudenutzern, die keinem Raum zugewiesen sind. Wenn das erkannte Feld im Parameter Raumkennung (Eingabetabelle der Gebäudenutzer) einen NULL-Wert enthält oder leer ist, wird der Gebäudenutzer als nicht zugewiesen geladen (er wird keinem Raum zugewiesen). Gebäudenutzer, die Räumen in der Eingabetabelle der Gebäudenutzer zugewiesen sind, die als Hotels, Hotdesks oder nicht zuweisbare Räume in der Units-Feature-Class definiert sind, werden ebenfalls als nicht zugewiesen geladen.

  Hinweis:

  Wenn der Parameter Gebäudenutzer-Raum-Kennungsfeld bei einer .csv-Datei oder einem Excel-Tabellenblatt leer oder bei einer Geodatabase-Tabelle <NULL> ist, wird der Gebäudenutzer als nicht zugewiesen geladen.

• Der Parameter Raumkennung (Eingabetabelle der Gebäudenutzer) unterstützt mehrere Felder aus einer Eingabetabelle der Gebäudenutzer, in der mehrere Raumzuweisungen eines Gebäudenutzers gespeichert sind. Zum Aktualisieren der Occupants-Feature-Class werden nur die angegebenen Felder verwendet.

  Wenn der Parameter Raumkennung (Eingabetabelle der Gebäudenutzer) nicht angegeben ist, werden die Platzzuweisungen der Gebäudenutzer nicht in der Occupants-Feature-Class aktualisiert. Stattdessen werden die Datensätze in der Occupants-Feature-Class mit den Datensätzen in der Eingabetabelle der Gebäudenutzer abgeglichen, und die Attribute, die im Parameter Zuordnung der Gebäudenutzerattribute zugeordnet sind, werden aktualisiert.

• Gebäudenutzerinformationen werden entsprechend dem eindeutigen Wert im Gebäudenutzer-Kennungsfeld hinzugefügt, gelöscht und geändert.

  Hinweis:

  Bei der Gebäudenutzerkennung kann es sich um ein beliebiges Feld mit Informationen zur eindeutigen Identifizierung der einzelnen Gebäudenutzer handeln. Als Feld wird EMAIL empfohlen.

• Für den Parameterwert Ziel-Gebäudenutzer-Features werden die folgenden Felder mit den entsprechenden Werten aus dem Parameter Eingabetabelle der Gebäudenutzer entsprechend den Platzzuweisungs- oder Grundrissänderungen gefüllt:

  • UNIT_ID
  • UNIT_NAME (Sofern im Wert für den Parameter Ziel-Gebäudenutzer-Features vorhanden)
  • LEVEL_ID
  • SITE_ID (Kann mit Werten aus der Eingabetabelle der Gebäudenutzer im Parameter Zuordnung der Gebäudenutzerattribute verknüpft werden.)

  Hinweis:

  Wenn der Parameter Raumkennung (Eingabetabelle der Gebäudenutzer) nicht angegeben ist, werden nur im Parameter Zuordnung der Gebäudenutzerattribute zugeordnete Felder aktualisiert.

• Der Wert ASSIGNMENT_TYPE der Units-Feature-Class wird aktualisiert, der von Space Planner verwendet wird, um den Raumbelegungsstatus anzuzeigen. Wenn einem Raum ein Gebäudenutzer-Feature zugewiesen wird, wird der ASSIGNMENT_TYPE-Wert des Raumes auf "Büro" festgelegt.

• Wenn die Grundrissdaten mit dem Werkzeug Grundrisse in Indoors-Geodatabase importieren oder BIM in Indoors-Dataset importieren aktualisiert werden und dies Auswirkungen auf Raum-Features mit zugewiesenen Gebäudenutzern hat, wird für Gebäudenutzer, die im aktuellen Grundriss nicht mehr vorhandenen Raum-Features zugewiesen sind, die Zuweisung aufgehoben. Diese Änderung wird auch auf Gebäudenutzer angewendet, die einem Raum zugewiesen sind, für den sich der Feldwert ASSIGNMENT_TYPE nach einer Grundrissaktualisierung in "Nicht zuweisbar" geändert hat. Zum Aktualisieren von Gebäudenutzerdaten zur Ausrichtung am aktuellen Grundriss ist der Parameter Eingabetabelle der Gebäudenutzer nicht erforderlich.

• Sie können das Werkzeug regelmäßig ausführen, um Gebäudenutzerdaten zu aktualisieren und Platzzuweisungen oder Grundrisse zu ändern. Sie können das Werkzeug als Geoverarbeitungsservice veröffentlichen und mit Microsoft Scheduler oder CRON ausführen.

• Mit diesem Werkzeug wird eine temporäre Zusammenfassungstextdatei bereitgestellt, die in der ArcGIS Pro-Sitzung gültig ist. Wenn Sie einen permanenten Datensatz der Zusammenfassungstextdatei speichern möchten, müssen Sie die Datei in einem Ordner außerhalb der ArcGIS Pro-Sitzung speichern.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Ziel-Gebäudenutzer-Features	Der Ziel-Feature-Layer, die Ziel-Feature-Class oder der Ziel-Feature-Service, in dem Gebäudenutzer-Datensätze hinzugefügt, aktualisiert oder gelöscht werden. Die Eingabe muss Einzelwerte zur Identifizierung der einzelnen Gebäudenutzer enthalten und der Occupants-Feature-Class im Indoors-Modell entsprechen.	Feature Layer
Eingabe-Raum-Features (optional)	Die Eingabe-Polygon-Features, die die Räume im Gebäude darstellen, die möglicherweise genutzt werden. Im ArcGIS Indoors-Informationsmodell ist dies der Layer "Units". Der Schwerpunkt der einzelnen Räume wird als Punktposition für die Gebäudenutzer verwendet.	Feature Layer
Eingabetabelle der Gebäudenutzer (optional)	Die Eingabetabelle, die Informationen über Gebäudenutzer enthält. Die Informationen können in einer Geodatabase-Tabelle, einer Tabelle in einer Excel-Arbeitsmappe (.xls- oder .xlsx-Datei) oder einer durch Trennzeichen getrennten Textdatei (.csv) gespeichert werden.	Table View
Gebäudenutzerkennung (Ziel-Gebäudenutzer-Features) (optional)	Das Feld im Parameterwert Ziel-Gebäudenutzer-Features, das als Primärschlüssel verwendet wird, um Gebäudenutzer mit den Werten des Parameters Eingabetabelle der Gebäudenutzer zu verknüpfen. Die Feldwerte müssen eindeutig sein.	Field
Gebäudenutzerkennung (Eingabetabelle der Gebäudenutzer) (optional)	Das Feld im Parameterwert Eingabetabelle der Gebäudenutzer, das als Primärschlüssel verwendet wird, um Gebäudenutzer mit den Werten des Parameters Ziel-Gebäudenutzer-Features zu verknüpfen. Die Feldwerte müssen eindeutig sein.	Field
Raumkennung (Eingabe-Raum-Features) (optional)	Das Feld im Parameterwert Eingabe-Raum-Features, in dem die Informationen zur eindeutigen Raumidentifikation gespeichert werden, die der Raumkennung aus dem Parameterwert Eingabetabelle der Gebäudenutzer entsprechen. Die Feldwerte müssen eindeutig sein.	Field
Raumkennung (Eingabetabelle der Gebäudenutzer) (optional)	Das Feld im Parameterwert Eingabetabelle der Gebäudenutzer, das als Primärschlüssel verwendet wird, um Raumzuweisung für den Gebäudenutzer mit den Werten des Parameters Eingabe-Raum-Features zu verknüpfen. Wenn ein Feldwert leer ist, wird der Gebäudenutzer als nicht zugewiesen geladen.	Field
Zuordnung der Gebäudenutzerattribute (optional)	Die Attributfelder im Parameter Ziel-Gebäudenutzer-Features, die mit den Feldwerten aus dem Parameterwert Eingabetabelle der Gebäudenutzer gefüllt werden. Die Felder müssen im Parameterwert Ziel-Gebäudenutzer-Features bereits vorhanden sein, wenn das Werkzeug ausgeführt wird. Es wird empfohlen, Felder aus dem Parameterwert Eingabetabelle der Gebäudenutzer Feldern aus dem Parameterwert Ziel-Gebäudenutzer-Features zuzuordnen, die denselben Feldtyp aufweisen.	Field Mappings
Neue Gebäudenutzer einfügen (optional)	Gibt an, ob für den Parameterwert Eingabetabelle der Gebäudenutzer eindeutige Gebäudenutzer-Datensätze zum Layer der Ziel-Gebäudenutzer-Features hinzugefügt werden. Aktiviert: Gebäudenutzer-Datensätze ohne Übereinstimmung werden dem Ziel-Gebäudenutzer-Features-Layer hinzugefügt. Dies ist die Standardeinstellung. Deaktiviert: Gebäudenutzer-Datensätze ohne Übereinstimmung werden dem Ziel-Gebäudenutzer-Features-Layer nicht hinzugefügt.	Boolean
Nicht in der Eingabetabelle der Gebäudenutzer enthaltene Gebäudenutzer löschen (optional)	Gibt an, ob für den Parameterwert Eingabetabelle der Gebäudenutzer eindeutige Gebäudenutzer-Datensätze aus dem Ziel-Gebäudenutzer-Features-Layer gelöscht werden. Aktiviert: Gebäudenutzer-Datensätze ohne Übereinstimmung werden aus dem Ziel-Gebäudenutzer-Features-Layer gelöscht. Dies ist die Standardeinstellung. Deaktiviert: Gebäudenutzer-Datensätze ohne Übereinstimmung werden aus dem Ziel-Gebäudenutzer-Features-Layer nicht gelöscht.	Boolean

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Gebäudenutzer-Features	Die aktualisierte Version der Ziel-Gebäudenutzer-Features, die für dieses Werkzeug verwendet wird.	Feature Layer

Python

arcpy.indoors.UpdateOccupantFeatures(target_occupant_features, {in_unit_features}, {in_occupant_table}, {occupant_id_from_target_occupant_features}, {occupant_id_from_input_table}, {unit_id_from_units_features}, {unit_id_from_input_table}, {occupant_attributes_mapping}, {allow_insert}, {allow_delete})

Name	Erläuterung	Datentyp
target_occupant_features	Der Ziel-Feature-Layer, die Ziel-Feature-Class oder der Ziel-Feature-Service, in dem Gebäudenutzer-Datensätze hinzugefügt, aktualisiert oder gelöscht werden. Die Eingabe muss Einzelwerte zur Identifizierung der einzelnen Gebäudenutzer enthalten und der Occupants-Feature-Class im Indoors-Modell entsprechen.	Feature Layer
in_unit_features (optional)	Die Eingabe-Polygon-Features, die die Räume im Gebäude darstellen, die möglicherweise genutzt werden. Im ArcGIS Indoors-Informationsmodell ist dies der Layer "Units". Der Schwerpunkt der einzelnen Räume wird als Punktposition für die Gebäudenutzer verwendet.	Feature Layer
in_occupant_table (optional)	Die Eingabetabelle, die Informationen über Gebäudenutzer enthält. Die Informationen können in einer Geodatabase-Tabelle, einer Tabelle in einer Excel-Arbeitsmappe (.xls- oder .xlsx-Datei) oder einer durch Trennzeichen getrennten Textdatei (.csv) gespeichert werden.	Table View
occupant_id_from_target_occupant_features (optional)	Das Feld im Parameterwert target_occupant_features, das als Primärschlüssel verwendet wird, um Gebäudenutzer mit den Werten des Parameters in_occupant_table zu verknüpfen. Die Feldwerte müssen eindeutig sein.	Field
occupant_id_from_input_table (optional)	Das Feld im Parameterwert in_occupant_table, das als Primärschlüssel verwendet wird, um Gebäudenutzer mit den Werten des Parameters target_occupant_features zu verknüpfen. Die Feldwerte müssen eindeutig sein.	Field
unit_id_from_units_features (optional)	Das Feld im Parameterwert in_units_features in dem die Informationen zur eindeutigen Raumidentifikation gespeichert werden, die der Raumkennung aus dem Parameterwert in_occupant_table entsprechen. Die Feldwerte müssen eindeutig sein.	Field
unit_id_from_input_table [unit_id_from_input_table,...] (optional)	Das Feld im Parameterwert in_occupant_table, das als Primärschlüssel verwendet wird, um die Raumzuweisung für den Gebäudenutzer mit den Werten des Parameters in_units_features zu verknüpfen. Wenn ein Feldwert leer ist, wird der Gebäudenutzer als nicht zugewiesen geladen.	Field
occupant_attributes_mapping (optional)	Die Attributfelder im Parameter target_occupant_features die mit den Feldwerten aus dem Parameterwert in_occupant_table gefüllt werden. Die Felder müssen im Parameterwert target_occupant_features bereits vorhanden sein, wenn das Werkzeug ausgeführt wird. Es wird empfohlen, Felder aus dem Parameterwert in_occupant_table Feldern aus dem Parameterwert target_occupant_features zuzuordnen, die denselben Feldtyp aufweisen.	Field Mappings
allow_insert (optional)	Gibt an, ob dem Ziel-Gebäudenutzer-Features-Layer für den Parameterwert in_occupant_table eindeutige Gebäudenutzer-Datensätze hinzugefügt werden. INSERT_OCCUPANTS—Gebäudenutzer-Datensätze ohne Übereinstimmung werden dem Ziel-Gebäudenutzer-Features-Layer hinzugefügt. Dies ist die Standardeinstellung. NO_INSERT_OCCUPANTS—Gebäudenutzer-Datensätze ohne Übereinstimmung werden dem Ziel-Gebäudenutzer-Features-Layer nicht hinzugefügt.	Boolean
allow_delete (optional)	Gibt an, ob für den Parameterwert in_occupant_table eindeutige Gebäudenutzer-Datensätze aus dem Ziel-Gebäudenutzer-Features-Layer gelöscht werden. DELETE_OCCUPANTS—Gebäudenutzer-Datensätze ohne Übereinstimmung werden aus dem Ziel-Gebäudenutzer-Features-Layer gelöscht. Dies ist die Standardeinstellung. NO_DELETE_OCCUPANTS—Gebäudenutzer-Datensätze ohne Übereinstimmung werden aus dem Ziel-Gebäudenutzer-Features-Layer nicht gelöscht.	Boolean

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
updated_occupant_features	Die aktualisierte Version der Ziel-Gebäudenutzer-Features, die für dieses Werkzeug verwendet wird.	Feature Layer

Codebeispiel

UpdateOccupantFeatures – Beispiel 1 (Python-Fenster)

Das folgende Skript für das Python-Fenster veranschaulicht, wie die Funktion UpdateOccupantFeatures im unmittelbaren Modus verwendet wird. In diesem Beispiel sind die Eingaben und Ausgaben in der gleichen Geodatabase enthalten.

import arcpy
arcpy.indoors.UpdateOccupantFeatures('C:/ExampleCampus.gdb/Indoors/Occupants', 
                                    'C:/ExampleCampus.gdb/Indoors/Units', 'C:/OccupantsData/2022Occupants.xlsx/2022Q2$',
                                    'EMAIL', 'EMAIL',
                                    'UNIT_ID', 'SPACE_ASSIGNMENT', 'KNOWNAS "Known As" true false false 255 Text 0 
                                    0,First,#,C:/OccupantsData/2022Occupants.xlsx/2022Q2$,KNOWNAS,0,255;SITE_ID "Site ID" true true false 255 Text 
                                    0 0,First,#',
                                    True, True)

UpdateOccupantFeatures – Beispiel 2 (eigenständiges Skript)

Das folgende eigenständige Skript veranschaulicht, wie die Funktion UpdateOccupantFeatures verwendet wird.

# Import system modules import arcpy
# Set local variables 

target_occupant_features = r'C:\ExampleCampus.gdb\Indoors\Occupants'
in_unit_features = r'C:\ExampleCampus.gdb\Indoors\Units'
in_occupant_table = r'C:\OccupantSpreadsheets\BuildingL.xlsx\OccupantsSeatingAssignment$'
occupant_id_from_target_occupant_features = 'EMAIL' 
occupant_id_from_input_table = 'EMAIL' 
unit_id_from_units_features = 'UNIT_ID'
unit_id_from_input_table = "SPACE_ASSIGNMENT"
occupant_attributes_mapping = 'KNOWNAS "Known As" true false false 255 Text 0 0,First,#,
C:\OccupantSpreadsheets\BuildingL.xlsx\OccupantsSeatingAssignment$,KNOWNAS,0,255;CONTACT_PHONE "Contact Phone" true true false 255 Text 0 0,First,#,
C:\OccupantSpreadsheets\BuildingL.xlsx\OccupantsSeatingAssignment$,CONTACT_PHONE,0,255;CONTACT_EXTENSION "Contact Extension" true true false 255 Text 0 0,First,#,
C:\OccupantSpreadsheets\BuildingL.xlsx\OccupantsSeatingAssignment$,CONTACT_EXTENSION,-1,-1;SITE_ID "Site ID" true true false 255 Text 0 0,First,#;JOB_TITLE "Job Title" true true false 255 Text 0 0,First,#,
C:\OccupantSpreadsheets\BuildingL.xlsx\OccupantsSeatingAssignment$,JOB_TITLE,0,255;ORG_LEVEL_1 "Department" true true false 255 Text 0 0,First,#,
C:\OccupantSpreadsheets\BuildingL.xlsx\OccupantsSeatingAssignment$,ORG_LEVEL_1,0,255;ORG_LEVEL_2 "Team" true true false 255 Text 0 0,First,#,
C:\OccupantSpreadsheets\BuildingL.xlsx\OccupantsSeatingAssignment$,ORG_LEVEL_2,0,255;START_DATE "Start Date" true true false 8 Date 0 0,First,#,
C:\OccupantSpreadsheets\BuildingL.xlsx\OccupantsSeatingAssignment$,START_DATE,-1,-1' 

allow_insert = True
allow_delete = True

# Run the tool 
arcpy.indoors.UpdateOccupantFeatures(target_occupant_features, in_unit_features, in_occupant_table,
                                     occupant_id_from_target_occupant_features, occupant_id_from_input_table,
                                     unit_id_from_units_features, unit_id_from_input_table, occupant_attributes_mapping,
                                     allow_insert, allow_delete)

Umgebungen

Aktueller Workspace

Lizenzinformationen

• Basic: Nein
• Standard: Nein
• Advanced: Erfordert Indoors