Generar entidades de ocupantes (Indoors)

Disponible para una organización de ArcGIS con licencia de la extensión 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 hoteleras y planificación espacial) en las aplicaciones móvil y web de Indoors.

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

• Si lo desea, 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 que se encuentran en el campo NAME de la clase de entidad Sites si está utilizando un dataset de interiores.

  Más información sobre la carga de datos de ocupantes

• La herramienta admite la carga de ocupantes que no estén asignados a ningún espacio. Si el parámetro Campo de Id. de ocupante tiene un valor de NULL, 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 de geoprocesamiento Sistema de coordenadas de salida.

• El valor del parámetro Clase de entidad de ocupante de salida incluirá los siguientes campos del parámetro Entidades de unidad de entrada:

  • UNIT_ID
  • NAME
  • NAME_LONG
  • LEVEL_ID
  • HEIGHT_RELATIVE

  Estos campos se rellenarán con los valores correspondientes del parámetro Entidades de unidad de entrada.

  Nota:

  Cuando los valores de Entidades de unidad de entrada provienen de una geodatabase de Indoors, el valor de Clase de entidad de ocupantes de salida incluirá los siguientes campos adicionales: NAME_SUBTITLE, DESCRIPTION, SITE_NAME, FACILITY_NAME, LEVEL_NAME, LEVEL_NUMBER, SECTION_ID, SECTION_NAME, ELEVATION_ABSOLUTE, ELEVATION_RELATIVE, HEIGHT_ABSOLUTE y VERTICAL_ORDER. Estos campos se rellenarán con los valores correspondientes del parámetro Entidades de unidad de entrada.

• 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á en función de SITE_NAME si se incluye en el valor de 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 coincide con un valor del campo NAME de la clase de entidad Sites, el campo SITE_ID se rellena 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 de Id. 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 de Id. de ocupante	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_occupant_table que se usará como clave principal para asociar espacios de edificios con registros del valor del parámetro in_unit_features.	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)

La siguiente secuencia de comandos 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)

La siguiente secuencia de comandos 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

Casos especiales

Información de licenciamiento

• Basic: No
• Standard: No
• Advanced: Requiere Indoors