Gebäudenutzer-Features aktualisieren (Indoors)

Verfügbar mit der Erweiterung "ArcGIS Indoors Pro" oder "ArcGIS Indoors Maps".

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 sowie die Raumplanung in Indoor Space Planner verwendet werden.

Verwendung

• Die Eingabetabelle der Gebäudenutzer muss die Felder KNOWNAS und EMAIL enthalten. Für mehr Benutzerfreundlichkeit in der Space Planner-App können Sie auch die folgenden Felder bzw. zusätzliche Felder mit den Informationen, die in der Occupants-Feature-Class ausgefüllt und verwaltet werden sollen, einfügen: 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. Im folgenden Beispiel ist eine Zuweisung mit mehreren Spalten dargestellt:

  

  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 Arbeitsplätze, 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.

• 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 Parameterwert 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 Parameterwert 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 "Office" festgelegt.

• Wenn die Grundrissdaten mit einem Werkzeug, das Auswirkungen auf Raum-Features mit zugewiesenen Gebäudenutzern hat, wie z. B. Grundrisse in Indoors-Geodatabase importieren oder BIM in Indoors-Dataset importieren aktualisiert werden, geschieht bei Ausführung des Werkzeugs Folgendes:

  • Wenn ein Raum nach einer Grundrissaktualisierung nicht mehr vorhanden ist, wird die Zuweisung von Gebäudenutzern, die diesem Raum zugewiesen waren, aufgehoben.
  • Wenn sich der ASSIGNMENT_TYPE-Feldwert nach einer Grundrissaktualisierung in Not Assignable geändert hat, wird die Zuweisung der diesem Raum zugewiesenen Gebäudenutzer aufgehoben.
  • Wenn sich ein Gebäudenutzer-Feature nach einer Grundrissaktualisierung nicht mehr innerhalb des Raums befindet, dem es zugewiesen ist, wird das Gebäudenutzer-Feature zurück zum zugewiesenen Schwerpunkt des Raums verschoben.

  Hinweis:

  Zum Aktualisieren von Gebäudenutzerdaten zur Ausrichtung an einem aktualisierten Grundriss ist keine Eingabe für den Parameter Eingabetabelle der Gebäudenutzer 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 auch als Geoverarbeitungsservice veröffentlichen und mit Microsoft Scheduler oder CRON ausführen.

• Mit diesem Werkzeug wird eine Zusammenfassungstextdatei im temporären Verzeichnis erstellt, 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. Bei der Eingabe 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 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 Eingabetabelle muss eine Geodatabase-Tabelle, eine Tabelle in einer Microsoft Excel-Arbeitsmappe (.xls- oder .xlsx-Datei), eine durch Komma getrennte Textdatei (.csv) oder eine OLE-DB-Tabelle sein.	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 oder die Felder im Parameterwert Eingabetabelle der Gebäudenutzer, das bzw. die als Primärschlüssel verwendet werden, um die 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. Dieser Parameter 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 kein Parameterwert 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.	Field
Zuordnung der Gebäudenutzerattribute (optional)	Die Attributfelder im Parameterwert 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 Gebäudenutzer-Datensätze ohne Übereinstimmung 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 Gebäudenutzer-Datensätze ohne Übereinstimmung 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. Bei der Eingabe 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 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 Eingabetabelle muss eine Geodatabase-Tabelle, eine Tabelle in einer Microsoft Excel-Arbeitsmappe (.xls- oder .xlsx-Datei), eine durch Komma getrennte Textdatei (.csv) oder eine OLE-DB-Tabelle sein.	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 oder die Felder im Parameterwert in_occupant_table, das bzw. die als Primärschlüssel verwendet werden, 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. Dieser Parameter 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 kein Parameterwert 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 occupant_attributes_mapping zugeordnet sind, werden aktualisiert.	Field
occupant_attributes_mapping (optional)	Die Attributfelder im Parameterwert 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 Gebäudenutzer-Datensätze ohne Übereinstimmung 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 Gebäudenutzer-Datensätze ohne Übereinstimmung 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 ArcGIS Indoors Pro oder ArcGIS Indoors Maps