Generar entidades de ocupantes (Indoors)

Available for an ArcGIS organization licensed with the Indoors extension.

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. La salida de esta herramienta puede usarse para admitir la representación cartográfica y la generación de rutas de Indoors.

Uso

• El parámetro Entidades de unidad de entrada debe ser una capa de entidades o clase de entidad según el modelo de información de Indoors para la clase de entidad Units.

• Las Entidades de unidad de entrada deben contener el campo AREA_ID descrito por el modelo de información de Indoors de la clase de entidad Units.

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

• La 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

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

• De forma predeterminada, el sistema de coordenadas de las 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.

• La salida de la herramienta incluye estos campos que utiliza la aplicación de Indoor Space Planner:

  • AREA_ID
  • ORG_LEVEL_1
  • ORG_LEVEL_2
  • JOB_TITLE
  • START_DATE

  Precaución:

  No es necesario ni recomendable que agregue el campo AREA_ID a la tabla de entrada. Este campo se administra mediante la aplicación de Indoor Space Planner. Actualice la tabla de entrada con los otros campos y proporcione valores rellenados para disfrutar de una experiencia mejorada.

• Al preparar un mapa para las aplicaciones cliente Viewer, Indoors for iOS o 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 Office.
  • AREA_ID se establece en NULL.

Sintaxis

GenerateOccupantFeatures(in_unit_features, unit_id_field, in_occupant_table, occupant_id_field, out_occupant_feature_class)

Parámetro	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 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 las Entidades de unidad de entrada que se usará como clave principal para asociar espacios de edificios con registros en la Tabla de ocupantes de entrada.	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 de la Tabla de ocupantes de entrada que se usará como clave principal para asociar ocupantes con Entidades de unidad de entrada.	Field
out_occupant_feature_class	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

Nombre	Explicación	Tipo de datos
updated_unit_feature_class	La capa Entidades de unidad de entrada actualizada.	Clase de entidad

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 en 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/Indoors/Units', 
                                       'UNIT_ID', 
                                       'C:/Indoors/ExampleCampus.gdb/EMPLOYEEINFO', 
                                       'LOCATION', 
                                       'C:/Indoors/ExampleCampus.gdb/Indoors/People')

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 
#              points feature class in an Indoors geodatabase.

import arcpy

# Use the Indoors geodatabase's Units feature class as the input unit features
in_unit_features = 'C:/Indoors/ExampleCampus.gdb/Indoors/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 People Points feature class
out_occupant_feature_class = 'C:/Indoors/ExampleCampus.gdb/Indoors/People'

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