Générer des entités Occupant (Indoors)

Disponible pour une organisation ArcGIS disposant d’une licence pour l’extension Indoors.

Synthèse

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 coworking et planification de l’espace) dans les applications Web et mobiles Indoors.

Utilisation

• La valeur du paramètre 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 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 Table des occupants en entrée doit être une table de géodatabase, une feuille d’un classeur Microsoft Excel (.xls ou .xlsx) ou un fichier texte délimité par des virgules (.csv).

• La valeur Table des occupants en entrée doit inclure les champs suivants :

  • KNOWNAS: prénom et nom susceptibles d’être utilisés pour rechercher un occupant.
  • EMAIL: adresse e-mail de l’occupant.
  • CONTACT_PHONE: numéro de téléphone de l’occupant.
  • CONTACT_EXTENSION: code d’extension associé de l’occupant, le cas échéant.

• Si vous le souhaitez, vous pouvez inclure les champs suivants dans la Table des occupants en entrée pour améliorer l’expérience offerte par l’application Space Planner :

  • 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 d’arrivée 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 vous utilisez un jeu de données Indoor.

  En savoir plus sur le chargement de données sur les occupants

• L’outil prend en charge le chargement d’occupants non attribués à un espace. Si le paramètre Champ ID d’occupant comporte une valeur NULL, l’occupant est chargé comme non attribué.

• Par défaut, le système de coordonnées du paramètre Entités Unité en entrée est utilisé pour le paramètre Classe d’entités Occupant en sortie. Il peut être remplacé par le paramètre d’environnement de géotraitement Système de coordonnées en sortie.

• La valeur du paramètre Classe d’entités Occupant en sortie inclut les champs suivants du paramètre Entités Unité en entrée :

  • UNIT_ID
  • NAME
  • NAME_LONG
  • LEVEL_ID
  • HEIGHT_RELATIVE

  Ces champs sont renseignés avec les valeurs correspondantes du paramètre Entités Unité en entrée.

  Remarque :

  Lorsque les valeurs Entités Unité en entrée proviennent d’une géodatabase Indoors, la valeur Classe d’entités Occupant en sortie comprend les champs supplémentaires suivants : NAME_SUBTITLE, DESCRIPTION, SITE_NAME, FACILITY_NAME, LEVEL_NAME, LEVEL_NUMBER, SECTION_ID, SECTION_NAME, ELEVATION_ABSOLUTE, ELEVATION_RELATIVE, HEIGHT_ABSOLUTE et VERTICAL_ORDER. Ces champs sont renseignés avec les valeurs correspondantes du paramètre Entités Unité en entrée.

• La valeur Classe d’entités Occupant en sortie comprend les champs suivants utilisés par l’application Indoor 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 valeur Table des occupants en entrée.
  • Si un occupant n’est attribué à aucune unité et que le champ SITE_NAME n’est pas inclus dans la valeur Table des occupants en entrée, est attribué à une valeur NULL ou est attribué à une valeur ne correspondant à aucune valeur du champ NAME de la classe d’entités Sites, le champ SITE_ID est renseigné avec une valeur NULL.

• Lors de la préparation d’une carte pour les applications clientes Indoor Viewer, Space Planner, ArcGIS Indoors for iOS ou ArcGIS Indoors for Android, vous pouvez utiliser la sortie de l’outil dans la couche Personnes de la carte.

• L’outil met à jour les attributs 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.

Paramètres

Boîte de dialogue

Étiquette	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 ID d’unité	Champ dans les valeurs du paramètre 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 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 ID d’occupant	Champ dans la valeur du paramètre Table des occupants en entrée qui est utilisé comme clé primaire pour associer les occupants aux valeurs du paramètre 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 Entités Unité en entrée et Table des occupants en entrée.	Feature Class

Sortie obtenue

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

Python

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 obtenue

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 ci-dessous pour la fenêtre Python 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-dessous 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'

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

Cas particuliers

Informations de licence

• Basic: Non
• Standard: Non
• Advanced: Nécessite Indoors