Generate Occupant Features (Générer des entités d’occupant) (Outils Indoors)

Résumé

Créer ou mettre à jour les données ponctuelles sur les employés ou les occupants conformément au modèle d’information ArcGIS Indoors.

Cet outil génère des entités ponctuelles reposant sur des espaces de bâtiments (unités) en entrée, puis enrichit ces points avec les données sur les occupants. La sortie de cet outil peut être utilisée pour prendre en charge l’analyse et les fonctionnalités Indoor (par exemple, recherche, calcul d’itinéraire, réservation d’espace de travail et planification de l’espace) dans les applications Web et mobiles Indoors.

Héritage :

Il s’agit d’un outil obsolète. Cette fonctionnalité a été remplacée par l’outil Update Occupant Features (Mettre à jour les entités Occupant), qui met à jour la classe d’entités Occupants conforme au modèle d’information ArcGIS Indoors généré automatiquement par l’outil Create Indoors Database (Créer une base de données Indoors) dans ArcGIS Pro 3.0.

Utilisation

La valeur du paramètre Input Unit Features (Entités Unité en entrée) doit être une couche ou une classe d’entités issue d’un jeu de données Indoor ou d’une géodatabase Indoors.
La valeur du paramètre Input Unit Features (Entités Unité en entrée) doit inclure le champ AREA_ID décrit par le modèle Indoors pour la classe d’entités Unités.
La valeur du paramètre Input Occupant Table (Table des occupants en entrée) doit être une table de géodatabase, une feuille d’un classeur Microsoft Excel (fichier .xls ou .xlsx) ou un fichier texte délimité par des virgules (.csv).
La valeur Input Occupant Table (Table des occupants en entrée) doit inclure les champs suivants :
- KNOWNAS—les prénom et nom susceptibles d’être utilisés pour rechercher un occupant ;
- EMAIL—l’adresse e-mail de l’occupant ;
- CONTACT_PHONE—le numéro de téléphone de l’occupant ;
- CONTACT_EXTENSION—le code d’extension associé de l’occupant, le cas échéant.
Vous pouvez inclure les champs suivants dans la Input Occupant Table (Table des occupants en entrée) pour améliorer l’expérience offerte par l’application :
- ORG_LEVEL_1—Service de l’occupant.
- ORG_LEVEL_2—Équipe de l’occupant.
- JOB_TITLE—Intitulé du poste de l’occupant.
- START_DATE—Date de début de l’occupant.
- SITE_NAME—Site associé de l’occupant. Les valeurs de ce champ doivent correspondre à celles du champ NAME dans la classe d’entités Sites.

Si le paramètre Occupant Unit Identifier Field (Champ d’identifiant d’unité Occupant) en entrée est vide (pour un fichier .csv ou une feuille Excel) ou <Null> (pour une table de géodatabase), l’occupant est chargé comme non attribué.

Par défaut, le système de coordonnées du paramètre Input Unit Features (Entités Unité en entrée) est utilisé pour le paramètre Output Occupant Feature Class (Classe d’entités Occupant en sortie). Il peut être remplacé par le paramètre d’environnement Système de coordonnées en sortie.
La classe d’entités Occupants en sortie inclut les champs suivants renseignés selon la valeur de paramètre Input Unit Features (Entités Unité en entrée) :
- LEVEL_ID
- UNIT_ID
- UNIT_NAME
Les champs LEVEL_ID et UNIT_ID sont renseignés avec les valeurs correspondantes du paramètre Input Unit Features (Entités Unité en entrée). Le champ UNIT_NAME est renseigné avec la valeur NAME de l’entité d’unité en entrée correspondante.
La valeur Output Occupant Feature Class (Classe d’entités Occupant en sortie) comprend les champs suivants utilisés par l’application Indoors Space_Planner :
- AREA_ID
- ORG_LEVEL_1
- ORG_LEVEL_2
- JOB_TITLE
- START_DATE
- SITE_ID
Remarque :

Le champ SITE_ID est renseigné en fonction des éléments suivants :

- Si un occupant est attribué à une unité, le champ SITE_ID est renseigné en fonction du site associé de l’unité attribuée.

Si un occupant n’est attribué à aucune unité, le champ SITE_ID est renseigné en fonction du champ SITE_NAME s’il est inclus dans la table des occupants en entrée.

- Si aucun occupant n’est attribué à une unité et que le champ SITE_NAME n’est pas inclus dans la valeur Input Occupant Table (Table des occupants en entrée) ou qu’une valeur NULL ou ne correspondant à aucune valeur du champ NAME de la classe d’entités Sites lui a été attribuée, le champ SITE_ID est renseigné avec une valeur NULL.
Lorsque vous préparez une carte pour les applications client Indoors Viewer, Space Planner, ArcGIS Indoors Mobile Classic ou ArcGIS Indoors Mobile Classic, vous pouvez utiliser la sortie de l’outil dans la couche Personnes de la carte.
L’outil met à jour les attributs Input Unit Features (Entités Unité en entrée) utilisés par Space Planner. Si une entité ponctuelle Occupant est générée pour une unité, les attributs de cette unité sont mis à jour comme suit :
- ASSIGNMENT_TYPE est défini sur Bureau.
- AREA_ID est défini sur NULL.

Etiqueter	Explication	Type de données
Entités Unité en entrée	Entités surfaciques en entrée représentant les espaces des bâtiments susceptibles d’être occupés. Dans le modèle d’information ArcGIS Indoors, il s’agit de la couche Unités. Le centroïde de chaque espace sera utilisé comme localisation ponctuelle pour le ou les occupants.	Feature Layer
Champ d’identifiant d’unité	Champ dans les valeurs du paramètre Input Unit Features (Entités Unité en entrée) qui est utilisé comme clé primaire pour associer les espaces des bâtiments aux enregistrements dans la valeur du paramètre Input Occupant Table (Table des occupants en entrée).	Field
Table des occupants en entrée	Table en entrée qui contient des informations sur les occupants d’un bâtiment. Les informations peuvent être stockées dans une table de géodatabase, une feuille d’un classeur Excel (fichier .xls ou `.xlsx`) ou un fichier `.csv`.	Table View
Champ d’identifiant d’unité Occupant	Champ dans la valeur du paramètre Input Occupant Table (Table des occupants en entrée) qui est utilisé comme clé primaire pour associer les occupants aux valeurs du paramètre Input Unit Features (Entités Unité en entrée).	Field
Classe d’entités Occupant en sortie	Classe d’entités en sortie créée en associant les valeurs des paramètres Input Unit Features (Entités Unité en entrée) et Input Occupant Table (Table des occupants en entrée).	Feature Class

Sortie dérivée

Etiqueter	Explication	Type de données
Classe d’entités Unité mise à jour	Couche d’entités Unité en entrée mise à jour.	Feature Class

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

Nom	Explication	Type de données
in_unit_features	Entités surfaciques en entrée représentant les espaces des bâtiments susceptibles d’être occupés. Dans le modèle d’information ArcGIS Indoors, il s’agit de la couche Unités. Le centroïde de chaque espace sera utilisé comme localisation ponctuelle pour le ou les occupants.	Feature Layer
unit_id_field	Champ dans les valeurs du paramètre `in_unit_features` qui est utilisé comme clé primaire pour associer les espaces des bâtiments aux enregistrements dans la valeur du paramètre `in_occupant_table`.	Field
in_occupant_table	Table en entrée qui contient des informations sur les occupants d’un bâtiment. Les informations peuvent être stockées dans une table de géodatabase, une feuille d’un classeur Excel (fichier .xls ou `.xlsx`) ou un fichier `.csv`.	Table View
occupant_id_field	Champ dans la valeur du paramètre `in_occupant_table` qui est utilisé comme clé primaire pour associer les occupants aux valeurs du paramètre `in_unit_features`.	Field
out_occupant_feature_class	Classe d’entités en sortie créée en associant les valeurs des paramètres `in_unit_features` et `in_occupant_table`.	Feature Class

Sortie dérivée

Nom	Explication	Type de données
updated_unit_feature_class	Couche d’entités Unité en entrée mise à jour.	Feature Class

Exemple de code

Exemple 1 d’utilisation de la fonction GenerateOccupantFeatures (fenêtre Python)

Le script de fenêtre Python ci-après illustre l’utilisation de la fonction GenerateOccupantFeatures en mode immédiat. Dans cet exemple, les entrées et les sorties sont toutes dans la même géodatabase.

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')

Exemple 2 d’utilisation de la fonction GenerateOccupantFeatures (script autonome)

Le script autonome ci-après illustre l’utilisation de la fonction GenerateOccupantFeatures.

# 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'

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

Environnements

Espace de travail courant, Système de coordonnées en sortie

Informations de licence

Basic: Non
Standard: Non
Advanced: Requiert ArcGIS Indoors Pro ou ArcGIS Indoors Maps

Generate Occupant Features (Générer des entités d’occupant) (Outils Indoors)

Résumé

Héritage :

Utilisation

Remarque :

Paramètres

Sortie dérivée

Environnements

Informations de licence