Generar entidades de ocupantes (Indoors)

Resumen

Crea o actualiza datos de punto de empleados u ocupantes según el Modelo de información de ArcGIS Indoors.

Esta herramienta genera entidades de puntos que se basan en espacios de edificios de entrada (unidades) y enriquece dichos puntos con datos de ocupantes. El resultado de esta herramienta se puede usar como apoyo al análisis y funcionalidad de interiores (como búsquedas, generación de rutas, reservas de espacios de trabajo y planificación espacial) en las aplicaciones móvil y web de Indoors.

Heredado:

Esta es una herramienta obsoleta. Esta función ha sido sustituida por la herramienta Actualizar entidades de ocupantes, que actualiza la clase de entidad Occupants que se ajusta al Modelo de información de ArcGIS Indoors generado automáticamente por la herramienta Crear base de datos de Indoors de ArcGIS Pro 3.0.

Uso

• El valor del parámetro Entidades de unidad de entrada debe ser una capa de entidades o una clase de entidad de un dataset de interiores o de una geodatabase de Indoors.

• El valor de Entidades de unidad de entrada debe contener el campo AREA_ID descrito por el modelo Indoors para la clase de entidad Units.

• El valor del parámetro Tabla de ocupantes de entrada debe ser una tabla de geodatabase, una hoja en un libro de trabajo de Microsoft Excel (archivo .xls o .xlsx) o un archivo de texto delimitado por comas (.csv).

• El valor de Tabla de ocupantes de entrada debe incluir estos campos:

  • KNOWNAS- el nombre y los apellidos que es más probable que se utilicen al buscar un ocupante
  • EMAIL- la dirección de correo electrónico del ocupante
  • CONTACT_PHONE- el número de teléfono del ocupante
  • CONTACT_EXTENSION- el código de extensión asociado del ocupante, si corresponde

• Puede incluir los siguientes campos en la Tabla de ocupantes de entrada para mejorar la experiencia de la aplicación de Space Planner:

  • ORG_LEVEL_1- el departamento del ocupante.
  • ORG_LEVEL_2- el equipo del ocupante.
  • JOB_TITLE- el cargo del ocupante.
  • START_DATE- la fecha de ingreso del ocupante.
  • SITE_NAME- el sitio asociado del ocupante. Los valores de este campo deben coincidir con los del campo NAME de la clase de entidad Sites.

• Si el parámetro Campo identificador de unidad de ocupantes de entrada está vacío (para un archivo .csv o una hoja Excel) o es <Null> (para una tabla de geodatabase), el ocupante se cargará como no asignado.

• De forma predeterminada, el sistema de coordenadas del parámetro Entidades de unidad de entrada se usará para el parámetro Clase de entidad de ocupantes de salida. Se puede invalidar mediante la configuración del entorno Sistema de coordenadas de salida.

• La clase de entidad Occupants de salida incluirá los siguientes campos rellenados en función del valor del parámetro Entidades de unidad de entrada:

  • LEVEL_ID
  • UNIT_ID
  • UNIT_NAME

  Los campos LEVEL_ID y UNIT_ID se rellenarán con los valores correspondientes del parámetro Entidades de unidad de entrada. El campo UNIT_NAME se rellenará con el valor NAME para la entidad de unidad de entrada correspondiente.

• El valor de Clase de entidad de ocupantes de salida incluye los siguientes campos que utiliza la aplicación Indoor Space Planner:

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

  Nota:

  El campo SITE_ID se rellenará según lo siguiente:

  • Si se asigna un ocupante a una unidad, el campo SITE_ID se rellenará en función del sitio asociado de la unidad asignada.
  • Si no se asigna un ocupante a una unidad, el campo SITE_ID se rellenará según el campo SITE_NAME si se incluye en la tabla de ocupantes de entrada.
  • Si no se asigna ningún ocupante a una unidad y el campo SITE_NAME no se incluye en el valor de Tabla de ocupantes de entrada, se le asigna un valor NULO, o si se le asigna un valor que no coincide con un valor del campo NAME de la clase de entidad Sites, el campo SITE_ID se rellenará con un valor nulo.

• Al preparar un mapa para las aplicaciones cliente Indoor Viewer, Space Planner, ArcGIS Indoors for iOS o ArcGIS Indoors for Android, puede usar la salida de la herramienta en la capa People del mapa.

• La herramienta actualiza los atributos Entidades de unidad de entrada utilizados por Space Planner. Si se genera una entidad de punto de ocupante para una unidad, los atributos de dicha unidad se actualizan de la siguiente manera:

  • ASSIGNMENT_TYPE se establece en Oficina.
  • AREA_ID se establece en NULO.

Parámetros

Cuadro de diálogo

Etiqueta	Explicación	Tipo de datos
Entidades de unidad de entrada	Las entidades poligonales de entrada que representan espacios de edificios que podrían estar ocupados. En el modelo de información de ArcGIS Indoors, es la capa Units. El centroide de cada espacio se usará como la ubicación de punto de los ocupantes.	Feature Layer
Campo identificador de unidad	El campo de los valores del parámetro Entidades de unidad de entrada que se usará como clave principal para asociar espacios de edificios con registros del valor del parámetro Tabla de ocupantes de entrada.	Field
Tabla de ocupantes de entrada	La tabla de entrada que contiene información sobre los ocupantes de un edificio. La información se puede almacenar en una tabla de geodatabase, en una hoja de un libro de trabajo de Excel (archivo .xls o .xlsx) o en un archivo .csv.	Table View
Campo identificador de unidad de ocupantes	El campo del valor del parámetro Tabla de ocupantes de entrada que se usará como clave principal para asociar ocupantes con valores del parámetro Entidades de unidad de entrada.	Field
Clase de entidad de ocupantes de salida	La clase de entidad de salida creada tras unir los valores de los parámetros Entidades de unidad de entrada y Tabla de ocupantes de entrada.	Feature Class

Salida derivada

Etiqueta	Explicación	Tipo de datos
Clase de entidad de unidad actualizada	La capa Entidades de unidad de entrada actualizada.	Feature Class

Python

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

Nombre	Explicación	Tipo de datos
in_unit_features	Las entidades poligonales de entrada que representan espacios de edificios que podrían estar ocupados. En el modelo de información de ArcGIS Indoors, es la capa Units. El centroide de cada espacio se usará como la ubicación de punto de los ocupantes.	Feature Layer
unit_id_field	El campo de los valores del parámetro in_unit_features que se usará como clave principal para asociar espacios de edificios con registros del valor del parámetro in_occupant_table.	Field
in_occupant_table	La tabla de entrada que contiene información sobre los ocupantes de un edificio. La información se puede almacenar en una tabla de geodatabase, en una hoja de un libro de trabajo de Excel (archivo .xls o .xlsx) o en un archivo .csv.	Table View
occupant_id_field	El campo del valor del parámetro in_occupant_table que se usará como clave principal para asociar ocupantes con valores del parámetro in_unit_features.	Field
out_occupant_feature_class	La clase de entidad de salida creada tras unir los valores de los parámetros in_unit_features y in_occupant_table.	Feature Class

Salida derivada

Nombre	Explicación	Tipo de datos
updated_unit_feature_class	La capa Entidades de unidad de entrada actualizada.	Feature Class

Muestra de código

Ejemplo 1 de GenerateOccupantFeatures (ventana de Python)

El siguiente script de la ventana de Python demuestra cómo utilizar la función GenerateOccupantFeatures de modo inmediato. En este ejemplo, las entradas y las salidas están todas en la misma geodatabase.

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

Ejemplo 2 de GenerateOccupantFeatures (script independiente)

El siguiente script independiente muestra cómo utilizar la función 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)

Entornos

Espacio de trabajo actual, Sistema de coordenadas de salida

Información de licenciamiento

• Basic: No
• Standard: No
• Advanced: Requiere ArcGIS Indoors Pro o ArcGIS Indoors Maps