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

  • 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. 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. Im folgenden Beispiel ist eine Zuweisung mit mehreren Spalten dargestellt:

    Tabelle mit mehreren Zuweisungsspalten

    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.

    FeldBeschreibungErlaubt 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 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 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

BeschriftungErläuterungDatentyp
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 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 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

BeschriftungErläuterungDatentyp
Aktualisierte Gebäudenutzer-Features

Die aktualisierte Version der Ziel-Gebäudenutzer-Features, die für dieses Werkzeug verwendet wird.

Feature Layer

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})
NameErläuterungDatentyp
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 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 eindeutige Gebäudenutzer-Datensätze hinzugefügt werden.

  • INSERT_OCCUPANTSGebäudenutzer-Datensätze ohne Übereinstimmung werden dem Ziel-Gebäudenutzer-Features-Layer hinzugefügt. Dies ist die Standardeinstellung.
  • NO_INSERT_OCCUPANTSGebä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_OCCUPANTSGebäudenutzer-Datensätze ohne Übereinstimmung werden aus dem Ziel-Gebäudenutzer-Features-Layer gelöscht. Dies ist die Standardeinstellung.
  • NO_DELETE_OCCUPANTSGebäudenutzer-Datensätze ohne Übereinstimmung werden aus dem Ziel-Gebäudenutzer-Features-Layer nicht gelöscht.
Boolean

Abgeleitete Ausgabe

NameErläuterungDatentyp
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)

Lizenzinformationen

  • Basic: Nein
  • Standard: Nein
  • Advanced: Erfordert ArcGIS Indoors Pro or ArcGIS Indoors Maps

Verwandte Themen