Gebäudenutzer-Features generieren (Indoors)

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

Zusammenfassung

Erstellt oder aktualisiert Mitarbeiter- und Gebäudenutzer-Punktdaten, die dem ArcGIS Indoors-Informationsmodell entsprechen.

Das Werkzeug generiert Punkt-Features basierend auf Eingabe-Raumeinheiten in Gebäuden (Räume) und reichert diese Punkte mit Gebäudenutzerdaten an. Die Ausgabe dieses Werkzeugs kann verwendet werden, um die Indoor-Analyse und -Funktionalität, z. B. Suche, Routing, Buchung von Bürohotels und Raumplanung, in der Web-App sowie in den mobile Apps von Indoors zu unterstützen.

Verwendung

• Der Parameterwert Eingabe-Raum-Features muss ein Feature-Layer oder eine Feature-Class aus einem Indoor-Dataset oder einer Indoors-Geodatabase sein.

• Der Wert Eingabe-Raum-Features muss das AREA_ID-Feld enthalten, das vom Indoors-Modell für die Units-Feature-Class beschrieben wird.

• Der Parameterwert Eingabetabelle der Gebäudenutzer muss eine Geodatabase-Tabelle, eine Tabelle in einer Microsoft Excel-Arbeitsmappe (.xls- oder .xlsx-Datei) oder eine durch Trennzeichen getrennte Textdatei (.csv) sein.

• Der Wert Eingabetabelle der Gebäudenutzer muss die folgenden Felder enthalten:

  • KNOWNAS: Der Vor- und Nachname, der wahrscheinlich bei der Suche nach einem Gebäudenutzer verwendet wird
  • EMAIL: Die E-Mail-Adresse des Gebäudenutzers
  • CONTACT_PHONE: Die Telefonnummer des Gebäudenutzers
  • CONTACT_EXTENSION: Die Durchwahl des Gebäudenutzers, falls zutreffend

• Sie können die folgenden Felder optional in die Eingabetabelle der Gebäudenutzer aufnehmen, um die Oberfläche der Space Planner-App zu verbessern:

  • ORG_LEVEL_1: Die Abteilung des Gebäudenutzers
  • ORG_LEVEL_2: Das Team des Gebäudenutzers
  • JOB_TITLE: Die Tätigkeitsbezeichnung des Gebäudenutzers
  • START_DATE: Das Eintrittsdatum des Gebäudenutzers
  • SITE_NAME: Der verknüpfte Standort des Gebäudenutzers Werte in diesem Feld müssen den Werten entsprechen, die im Feld NAME in der Sites-Feature-Class enthalten sind, wenn Sie ein Indoor-Dataset verwenden.

  Weitere Informationen zum Laden von Gebäudenutzerdaten

• Das Werkzeug unterstützt das Laden von Gebäudenutzern, die keinem Raum zugewiesen sind. Wenn der Parameter Gebäudenutzer-ID-Feld einen NULL-Wert enthält, wird der Gebäudenutzer als nicht zugewiesen geladen.

• Standardmäßig wird das Koordinatensystem des Parameters Eingabe-Raum-Features für den Parameter Ausgabe-Occupant-Feature-Class verwendet. Dies kann mit der Einstellung der Geoverarbeitungsumgebung "Ausgabe-Koordinatensystem" überschrieben werden.

• Der Parameterwert Ausgabe-Occupant-Feature-Class enthält die folgenden Felder aus dem Parameter Eingabe-Raum-Features:

  • UNIT_ID
  • NAME
  • NAME_LONG
  • LEVEL_ID
  • HEIGHT_RELATIVE

  Diese Felder werden mit den entsprechenden Werten aus dem Parameter Eingabe-Raum-Features ausgefüllt.

  Hinweis:

  Wenn die Werte von Eingabe-Raum-Features aus einer Indoors-Geodatabase stammen, enthält der Wert Ausgabe-Occupant-Feature-Class die folgenden zusätzlichen Felder: NAME_SUBTITLE, DESCRIPTION, SITE_NAME, FACILITY_NAME, LEVEL_NAME, LEVEL_NUMBER, SECTION_ID, SECTION_NAME, ELEVATION_ABSOLUTE, ELEVATION_RELATIVE, HEIGHT_ABSOLUTE und VERTICAL_ORDER. Diese Felder werden mit den entsprechenden Werten aus dem Parameter Eingabe-Raum-Features ausgefüllt.

• Der Wert Ausgabe-Occupant-Feature-Class enthält die folgenden Felder, die von der Indoor Space Planner-App verwendet werden:

  • AREA_ID
  • ORG_LEVEL_1
  • ORG_LEVEL_2
  • JOB_TITLE
  • START_DATE
  • SITE_ID

  Hinweis:

  Das Feld SITE_ID wird wie folgt ausgefüllt:

  • Wenn ein Gebäudenutzer einem Raum zugewiesen ist, wird das Feld SITE_ID basierend auf dem verknüpften Standort des zugewiesenen Raums ausgefüllt.
  • Ist ein Gebäudenutzer keinem Raum zugewiesen, wird das Feld SITE_ID basierend auf dem SITE_NAME ausgefüllt, wenn es im Wert Eingabetabelle der Gebäudenutzer enthalten ist.
  • Falls ein Gebäudenutzer keinem Raum zugewiesen ist und das Feld SITE_NAME nicht im Wert Eingabe-Gebäudenutzer-Tabelle enthalten ist, ein NULL-Wert zugewiesen ist oder ein Wert zugewiesen ist, der einem Wert im Feld NAME in der Sites-Feature-Class entspricht, wird das Feld SITE_ID mit einem NULL-Wert ausgefüllt.

• Beim Vorbereiten einer Karte für die Client-Apps Indoor Viewer, Space Planner, ArcGIS Indoors for iOS oder ArcGIS Indoors for Android können Sie die Ausgabe des Werkzeugs im Karten-Layer "People" verwenden.

• Das Werkzeug aktualisiert die von Space Planner verwendeten Eingabe-Raum-Features-Attribute. Wenn ein Gebäudenutzer-Punkt-Feature für eine Einheit generiert wird, werden die Attribute dieser Einheit wie folgt aktualisiert:

  • ASSIGNMENT_TYPE ist auf Office festgelegt.
  • AREA_ID ist auf NULL festgelegt.

Parameter

Dialogfeld

Beschriftung	Erläuterung	Datentyp
Eingabe-Raum-Features	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
Raum-ID-Feld	Das Feld in den Werten des Parameters Eingabe-Raum-Features, das als Primärschlüssel verwendet wird, um Räume im Gebäude mit Datensätzen im Parameterwert Eingabetabelle der Gebäudenutzer zu verknüpfen.	Field
Eingabetabelle der Gebäudenutzer	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äudenutzer-ID-Feld	Das Feld im Parameterwert Eingabetabelle der Gebäudenutzer, das als Primärschlüssel verwendet wird, um Gebäudenutzer mit den Werten des Parameters Eingabe-Raum-Features zu verknüpfen.	Field
Ausgabe-Occupant-Feature-Class	Die Ausgabe-Feature-Class, die durch Verknüpfen der Parameterwerte für Eingabe-Raum-Features und Eingabetabelle der Gebäudenutzer erstellt wird.	Feature Class

Abgeleitete Ausgabe

Beschriftung	Erläuterung	Datentyp
Aktualisierte Unit-Feature-Class	Der aktualisierte Eingabe-Raum-Feature-Layer.	Feature Class

Python

arcpy.indoors.GenerateOccupantFeatures(in_unit_features, unit_id_field, in_occupant_table, occupant_id_field, out_occupant_feature_class)

Name	Erläuterung	Datentyp
in_unit_features	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
unit_id_field	Das Feld in den Werten des Parameters in_unit_features, das als Primärschlüssel verwendet wird, um Räume im Gebäude mit Datensätzen im Parameterwert in_occupant_table zu verknüpfen.	Field
in_occupant_table	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_field	Das Feld im Parameterwert in_occupant_table, das als Primärschlüssel verwendet wird, um Gebäudenutzer mit den Werten des Parameters in_unit_features zu verknüpfen.	Field
out_occupant_feature_class	Die Ausgabe-Feature-Class, die durch Verknüpfen der Parameterwerte in_unit_features und in_occupant_table erstellt wird.	Feature Class

Abgeleitete Ausgabe

Name	Erläuterung	Datentyp
updated_unit_feature_class	Der aktualisierte Eingabe-Raum-Feature-Layer.	Feature Class

Codebeispiel

GenerateOccupantFeatures – Beispiel 1 (Python-Fenster)

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

import arcpy
arcpy.indoors.GenerateOccupantFeatures('C:/Indoors/ExampleCampus.gdb/Indoor/Units', 
                                       'UNIT_ID', 
                                       'C:/Indoors/ExampleCampus.gdb/EMPLOYEEINFO', 
                                       'LOCATION', 
                                       'C:/Indoors/ExampleCampus.gdb/Indoor/Occupants')

GenerateOccupantFeatures – Beispiel 2 (eigenständiges Skript)

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

# Name: Indoors_GenerateOccupantFeatures_example2.py
# Description: Imports occupant information from an Excel spreadsheet to a 
#              point feature class in an indoor dataset or Indoors geodatabase.

import arcpy

# Use the Units feature class in the indoor dataset or Indoors geodatabase as the input unit features
in_unit_features = 'C:/Indoors/ExampleCampus.gdb/Indoor/Units'

# The join will use the NAME field from Units feature class
unit_id_field = 'NAME'

# Use an Excel spreadsheet as the input occupant table
in_occupant_table = r'C:\Indoors\EmployeeInfo.xls\MarketingDept$'

# The spreadsheet's OFFICE column has values that match those in Units' NAME field
occupant_id_field = 'OFFICE'

# Output Occupants feature class
out_occupant_feature_class = 'C:/Indoors/ExampleCampus.gdb/Indoor/Occupants'

# Execute GenerateOccupantFeatures
arcpy.indoors.GenerateOccupantFeatures(in_unit_features, unit_id_field, 
                                       in_occupant_table, occupant_id_field, 
                                       out_occupant_feature_class)

Umgebungen

Aktueller Workspace, Ausgabe-Koordinatensystem

Sonderfälle

Lizenzinformationen

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