Creación de análisis

Artículo
11/14/2024

La configuración del plan de trabajo que permite a los empleados indicar su intención de entrar en la oficina, combinada con los datos reales de ocupación del edificio, ofrecen a los administradores de bienes raíces y de instalaciones una herramienta valiosa para comprender, analizar y optimizar el uso del espacio de construcción.

Al comparar los datos del plan de trabajo, que reflejan las intenciones de los empleados, con los datos de ocupación reales, puede identificar discrepancias entre el uso de espacio planeado y real.

Estas son las señales que se usan en la creación de análisis:

Creación de un uso basado en la intención de entrar en la oficina El análisis de creación usa planes de trabajo de empleados para evaluar el uso del espacio basado en intenciones.
Uso del edificio en función de la ocupación real Análisis de edificios usa datos de distintivos para deducir el número de empleados presentes en un edificio, lo que proporciona una medida de la ocupación real del edificio.
Personas análisis de datos Microsoft Places hace uso de los datos de API de perfil de personas procedentes de Microsoft Entra ID datos (o) a través de conectores externos para analizar los empleados asignados a un edificio específico y a los empleados de un líder específico. Estos datos ayudan a asignar usuarios a un edificio específico, lo que mejora la cobertura de datos para el análisis de compilación.

Creación de una señal de análisis

Creación de un uso basado en la intención de usar

El análisis de creación usa datos del plan de trabajo para realizar un seguimiento de la ocupación de edificios prevista y las tendencias híbridas esperadas, lo que proporciona información sobre las preferencias de los empleados en las visitas a la oficina.

El origen de los datos del plan de trabajo procede de la configuración De horas de trabajo flexibles (FWH) disponible para los usuarios en Microsoft Places y en la aplicación de Outlook. Los datos del plan de trabajo dependen de la disponibilidad de los datos de personas (de los conjuntos de datos de perfil de personas). Personas datos ayuda a asignar empleados que establecen planes de trabajo sin elegir edificios como su edificio asignado en los datos de personas.

Uso de la compilación en función de la ocupación real

El análisis de edificios usa datos de ocupación para detectar la presencia real de personas en los edificios. Actualmente, se admiten los siguientes datos de ocupación de edificios:

Datos de acceso de distintivo

Nota:

Para que los paneles de análisis de compilación muestren valores precisos, los datos de personas deben asignarse a los edificios incorporados a Mirosoft Places.

En la sección siguiente, trataremos los detalles sobre la incorporación de datos de personas junto con la incorporación de datos de ocupación de edificios.

Incorporación de datos de personas

Información general

Microsoft Places análisis usa los datos de api de perfil de personas para asociar usuarios a una ubicación o compilación específica. Personas datos de perfil suele extraer datos de Microsoft Entra ID y, si ha agregado conectores para llevar datos de personas a aplicaciones de Microsoft 365, los datos pertinentes se reflejan en el conjunto de datos de perfiles de personas.

El recuento de encabezados asignado en el análisis de compilación se deriva del empleado a la asignación de compilación.
Para que las características de filtro de líder funcionen con precisión, la asignación del administrador de empleados debe estar disponible en el conjunto de datos de perfiles de personas.

Formato de datos

Microsoft Places análisis busca un conjunto específico de campos en el conjunto de datos de perfil de personas para crear una asignación entre los empleados, sus edificios asignados y sus administradores.

OfficeLocation Esta es la propiedad de API de perfil de personas usada por Places para asociar un empleado a un edificio.

Nota:

Esta propiedad debe coincidir con el nombre de compilación establecido en Places Directory para crear la asignación con precisión.

Director Esta es la propiedad de API de perfil de personas usada por Places para asociar usuarios a sus líderes o administradores.

Para obtener más información sobre profile API aquí Formato de datos, consulte Uso de profile API en Microsoft Graph para recuperar información sobre usted u otro usuario.

Actualizaciones de datos para Microsoft Entra ID

Para que coincidan los datos de perfil de personas con los datos de asistencia, se debe actualizar su ubicación de Microsoft Entra ID. Se puede hacer con uno de los métodos siguientes.

Portal de Azure

Acceso a la Azure Portal: vaya al Azure Portal e inicie sesión con sus credenciales.
Vaya a Azure Active Directory: en el panel de navegación izquierdo, seleccione Azure Active Directory.
Buscar el usuario: en Administrar, seleccione Usuarios y, a continuación, busque el usuario cuya ubicación desea actualizar.
Editar información de usuario: seleccione el nombre del usuario para abrir su perfil y, a continuación, seleccione Editar para actualizar su información.
Actualizar la ubicación: en la sección Información del trabajo , puede actualizar los detalles de ubicación del usuario. Asegúrese de guardar los cambios.
Administrador de actualizaciones: en la sección Información del trabajo , puede actualizar los detalles del administrador del usuario. Asegúrese de guardar los cambios.

Para obtener más información sobre cómo actualizar Microsoft Entra ID datos, consulte Agregar o actualizar la información y la configuración del perfil de un usuario en el Centro de administración Microsoft Entra.

Actualizar atributos de Microsoft Entra ID mediante un script de PowerShell

# Connect to Azure AD 
Connect-AzureAD

Actualización de la ubicación del usuario

Update-AzADUser -UPNOrObjectId user@domain.com -OfficeLocation “18/2111”

Para obtener más información, consulte Update-AzADUser.

Actualizar los atributos de Microsoft Entra ID mediante Graph API

Para empezar, comprenda el tipo de recurso de usuario. Para obtener más información, vea Tipo de recurso de usuario.

Inicie sesión en Graph Explore. Para obtener más información, consulte El Explorador de Graph.
Invoque al usuario update. Para obtener más información, vea Actualizar usuario.

Muestra:

PATCH https://graph.microsoft.com/v1.0/users/{id} 
Content-type: application/json 
{ 
  "officeLocation": "18/2111" 
}

Validación y solución de problemas de datos

La propiedad headcount del panel de análisis de Microsoft Places debe tener el valor esperado.
El líder filtra en la página Creación de análisis de Places análisis y debe tener los datos del líder adecuados rellenados.
Si los cambios se realizan actualizando la ubicación del usuario o el administrador, debe reflejarse en Places análisis en 3 a 4 días.
Use la opción de comentarios de la aplicación para enviar los problemas de Microsoft que encuentre.

Consideraciones sobre seguridad y privacidad

Microsoft Places análisis siempre agrega los puntos de datos para mostrar los números de uso de compilación. Los usuarios no pueden identificar información sobre empleados específicos e individuales. Microsoft Places usa los datos de perfil de personas que usan otras aplicaciones de Microsoft 365.

Incorporación de datos de distintivo

Puede usar los sistemas de acceso a distintivos existentes para mejorar Places informe de Analytics sobre los paneles de ocupación de edificios.

Proceso para habilitar los datos de distintivo

Paso 1: Agregar dispositivos de acceso de distintivo a Microsoft Places (opcional, pero muy recomendado).
Paso 2: Cargar telemetría de datos de distintivos en Microsoft Places.

Nota:

Personas datos deben estar disponibles para los edificios interesados en Microsoft Places antes de incorporar los datos del distintivo. Los datos de distintivo se validan con los datos de Personas. El sistema filtra los datos de distintivo de los usuarios que no están asignados a Microsoft Places.

Paso 1: Agregar dispositivos de acceso de distintivo a Microsoft Places

El primer paso implica cargar metadatos de dispositivo de acceso de distintivo y asignar dispositivos a un PlaceId en Microsoft Places. Este paso ayuda a contextualizar las señales de distintivo cuando llega a Microsoft Places. Puede agregar dispositivos de acceso de distintivo a Microsoft Places mediante dos opciones:

Opción 1: Uso de cmdlets de PowerShell
Opción 2: Uso de las API de Microsoft Graph

Opción 1: Uso de cmdlets de PowerShell

Los cmdlets de PowerShell están disponibles para administrar dispositivos en Microsoft Places. Para más información sobre los cmdlets de Microsoft Places, consulte el módulo de cmdlets de Microsoft Places para PowerShell.

Nota:

Para ejecutar cmdlets, debe tener asignado el rol TenantPlacesManagement.

Formatos de datos de dispositivo para cmdlets

Columna	Descripción	Notas	Ejemplo
DeviceId (obligatorio)	Identificador único del dispositivo (recomendado: Manufacturer_DeviceUniqueId).	Debe coincidir con el identificador de la telemetría enviada.	Manuf1_3455
DisplayName	Nombre para mostrar del dispositivo.	Puede usar un nombre descriptivo si procede.	Manuf1_3455
Descripción	Descripción del dispositivo.
MacAddress	Dirección Mac del dispositivo.	Proveedor proporcionado (si está disponible).
Fabricante (obligatorio)	Fabricante del dispositivo.	Proporcionado por el administrador de TI.	Manuf1
IPV4Address	IPV4Address del dispositivo.	Proveedor proporcionado (si está disponible).
IPV6Address	IPV6Address del dispositivo.	Proveedor proporcionado (si está disponible).
PlaceId	PlaceId al que se asigna el dispositivo en Places.	El administrador de TI asigna DeviceID al campo DisplayName de una lista de salas.	76fe540f-01a9-425e-acd5-5d7d1da44fbf
Tags	Una lista de etiquetas personalizadas asociadas al dispositivo para ayudar con la búsqueda.		["IsVirtual_False", "Building_121"]
Sensor.SensorId	Identificador único de un sensor dentro del dispositivo.	Debe aparecer en la carga de telemetría estándar.	Insignia
Sensor.DisplayName	Nombre para mostrar del sensor.	Puede usar un nombre descriptivo (si procede).	Clip
Sensor.SensorType (obligatorio)	Tipo de sensor.	Una lista validada (consulte ejemplos).	Insignia
Sensor.PlaceId	Identificador único del lugar servido por el sensor (solo es necesario proporcionar esta información si el sensor está en un lugar diferente a la ubicación del dispositivo).		76fe540f-01a9-425e-acd5-5d7d1da44fbf

Adición de un dispositivo de acceso de distintivo a Microsoft Places mediante cmdlets

[!div class="mx-tdBreakAll"]

Nombre del cmdlet	Descripción	Parameters
New-PlaceDevice	Crea un nuevo dispositivo.	DeviceId (obligatorio), DisplayName, Description, MACAddress, Manufacturer (obligatorio), IPV4Address, IPV6Address, PlaceId (obligatorio), TagsSensors (obligatorio)
Remove-PlaceDevice	Elimina un dispositivo.	ID (necesario)
Set-PlaceDevice	Novedades un dispositivo.	Id. (obligatorio), DeviceId (obligatorio), DisplayName, Description, MACAddress, Manufacturer (obligatorio), IPV4Address, IPV6Address, PlaceId, Tags, Sensors (obligatorio)
Get-PlaceDevice	Obtiene un dispositivo.	Id., Filter, Top

Pasos: Uso de cmdlets de PowerShell

Abra PowerShell 7 (no como administrador).
Instale Microsoft Places ejecutando el siguiente cmdlet de Windows PowerShell. Para obtener más información sobre Microsoft Places instalación, consulte el Microsoft Places Galería de PowerShell.
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
Importe el módulo Microsoft Places mediante la ejecución del siguiente cmdlet de Windows PowerShell.
```
Import-Module -Name MicrosoftPlaces 
```
Después de instalar e importar el módulo, conéctese al módulo Microsoft Places mediante la ejecución del siguiente cmdlet de PowerShell Microsoft Places.
```
Connect-MicrosoftPlaces
```

Use New-PlaceDevice cmdlet para agregar un dispositivo de acceso de distintivo.

New-PlaceDevice -DeviceId "contoso_9D6816" -DisplayName "Contoso 9D6816 Device" -Description "Contoso 9D6816 Device" -MACAddress "00:0A:95:9D:68:16" -Manufacturer "Contoso" -IPV4Address "192.168.1.100" -IPV6Address "2001:db8::ff00:42:8329" -PlaceId "acfa3bc0- 2b83-425b-8910-84a0250e9671" -Tags "BuildingA" -Sensors (New-Object MicrosoftPlaces.PlacesDevices.Sensor -Property @{SensorType="badge"})

Nota:

El parámetro Sensors de este ejemplo es un objeto de tipo MicrosoftPlaces.PlacesDevices.Sensor que tiene campos mencionados en el ejemplo.

Use Get-PlaceDevice para ver la lista de dispositivos. De forma predeterminada, devuelve 10 dispositivos. Para devolver más dispositivos, agregue el parámetro -top como se muestra en este ejemplo.
```
Get-PlaceDevice -top 100 
```

Use Set-PlaceDevice para actualizar un dispositivo con el identificador existente.

Set-PlaceDevice -Id "e5a216ff-1d32-4647-8dab-a2523ee5796e" -DeviceId "contoso_7D6816" -DisplayName "Contoso 7D6816 Device" -Description "Contoso 9D6816 Device" -MACAddress "00:0A:95:9D:68:16" -Manufacturer "Contoso" -IPV4Address "192.168.1.100" -IPV6Address "2001:db8::ff00:42:8329" -PlaceId "acfa3bc0- 2b83-425b-8910-84a0250e9671" -Tags "BuildingA" -Sensors (New-Object MicrosoftPlaces.PlacesDevices.Sensor -Property @{SensorType="badge"})

Nota:

Proporcione detalles de todos los parámetros (obligatorios y opcionales) al actualizar un dispositivo. En ausencia de un valor de parámetro, restablece el valor al valor vacío predeterminado.

Use Remove-PlaceDevice para eliminar un dispositivo.

Remove-PlaceDevice -Id "e5a216ff-1d32-4647-8dab-a2523ee5796e"

Pasos: Uso de Microsoft Graph API

Para crear una aplicación para automatizar el registro y la incorporación de dispositivos de acceso de distintivo, las API están disponibles a través de Microsoft Graph. Para usar las API, siga estos pasos.

Cree un registro de aplicación en Microsoft Entra. Para obtener más información sobre los permisos PlaceDeviceRead.All y PlaceDevice.ReadWrite.All, consulte la Referencia de permisos de Microsoft Graph.
Compile e implemente una aplicación para sincronizar la información del dispositivo entre Microsoft Places y sus asociados.

Formatos de datos de dispositivo usados en microsoft Graph API

Columna	Descripción	Notas	Ejemplo
DeviceId (obligatorio)	Identificador único del dispositivo (recomendado: Manufacturer_DeviceUniqueId).	Debe coincidir con el identificador de la telemetría enviada.	Manuf1_3455
DisplayName	Nombre para mostrar del dispositivo.	Puede usar un nombre descriptivo, si procede.	Manuf1_3455
Descripción	Descripción del dispositivo.
MacAddress	Dirección Mac del dispositivo.	Proveedor proporcionado (si está disponible).
Fabricante (obligatorio)	Fabricante del dispositivo.	Proporcionado por el administrador de TI.	Manuf1
IPV4Address	IPV4Address del dispositivo.	Proveedor proporcionado, si está disponible.
IPV6Address	IPV6Address del dispositivo.	Proveedor proporcionado, si está disponible.
PlaceId (obligatorio)	PlaceId al que se asigna el dispositivo en Microsoft Places.	El administrador de TI asigna DeviceID al campo DisplayName de una lista de salas.	76fe540f-01a9-425e-acd5-5d7d1da44fbf
Tags	Una lista de etiquetas personalizadas asociadas al dispositivo para ayudar con la búsqueda.		["IsVirtual_False", "Building_121"]
Sensor.SensorId (obligatorio)	Identificador único de un sensor dentro del dispositivo.	Debe aparecer en la carga de telemetría estándar.	Insignia
Sensor.DisplayName	Nombre para mostrar del sensor.	Puede usar un nombre descriptivo (si procede).	Clip
Sensor.SensorType (obligatorio)	Tipo de sensor.	Una lista validada (consulte ejemplos).	Insignia
Sensor.PlaceId	Identificador único del lugar servido por el sensor (solo es necesario proporcionar esta información si el sensor está en un lugar diferente a la ubicación del dispositivo).		76fe540f-01a9-425e-acd5-5d7d1da44fbf

Para obtener más información sobre los dispositivos de sensor, consulte las siguientes API de Microsoft Graph:

Visualización de dispositivos de acceso de distintivos: enumerar sensorDispositivos.

GET https://graph.microsoft.com/beta/workplace/sensorDevices

Crear nuevos dispositivos de acceso a distintivos: cree workplaceSensorDevice.

POST https://graph.microsoft.com/beta/workplace/sensorDevices 

{ 
    "deviceId": "contoso_7D6816", 
    "displayName": "Contoso 7D6816 Device", 
    "description": "Contoso 7D6816 Device", 
    "macAddress": "00:0A:95:9D:68:16", 
    "manufacturer": "Contoso", 
    "ipV4Address": "192.168.1.100", 
    "ipV6Address": "2001:db8::ff00:42:8329", 
    "placeId": "acfa3bc0- 2b83-425b-8910-84a0250e9671", 
    "tags": [ 
        "BuildingA" 
    ], 
    "sensors": [ 
        { 
            "sensorId": "Badge", 
            "displayName": null, 
            "sensorType": "badge", 
            "placeId": "acfa3bc0- 2b83-425b-8910-84a0250e9671" 
        } 
    ] 
}

Ver un dispositivo específico: Obtener workplaceSensorDevice.

GET https://graph.microsoft.com/beta/workplace/sensorDevices/052062b9-38f6-48d4-a638-05a72c79419b

Actualizar dispositivos existentes de acceso a distintivos: actualice workplaceSensorDevice.

PATCH https://graph.microsoft.com/beta/workplace/sensorDevices/052062b9-38f6-48d4-a638-05a72c79419b 

{ 
    "deviceId": "contoso_7D6816", 
    "displayName": "Contoso 7D6816 Device", 
    "description": "Contoso 7D6816 Device", 
    "macAddress": "00:0A:95:9D:68:16", 
    "manufacturer": "Contoso2", 
    "ipV4Address": "192.168.1.100", 
    "ipV6Address": "2001:db8::ff00:42:8329", 
    "placeId": "acfa3bc0- 2b83-425b-8910-84a0250e9671", 
    "tags": [ 
         "BuildingA" 
     ], 
    "sensors": [ 
        { 
            "sensorId": "Badge", 
            "displayName": null, 
            "sensorType": "badge", 
            "placeId": "acfa3bc0- 2b83-425b-8910-84a0250e9671" 
        } 
    ] 
}

Para eliminar un dispositivo: elimine workplaceSensorDevice.

DELETE https://graph.microsoft.com/beta/workplace/sensorDevices/052062b9-38f6-48d4-a638-05a72c79419b GET https://graph.microsoft.com/beta/workplace/sensorDevices/052062b9-38f6-48d4-a638-05a72c79419b

Carga de telemetría de datos de distintivos en Microsoft Places

Cargue datos del sistema de entrada de distintivos para generar paneles de ocupación de edificios en Places Analytics.

DeviceId se usa para hacer coincidir el evento de distintivo con un edificio específico. En ausencia de un DeviceId, se usa LocationHint. Se recomienda incorporar los dispositivos para asignar con precisión la ocupación de los edificios.
LocationHint debe coincidir con el nombre de compilación en Microsoft Places directorio si no ha incorporado dispositivos a Microsoft Places.
Los usuarios de los datos del distintivo se validan con Personas datos (de la API de perfil) para que estén disponibles en la página Análisis de creación.

Opción 1: Usar el cmdlet Push-Dataset

Estos pasos son necesarios para insertar datos de distintivo en Microsoft Places:

Descargue los datos de distintivos de los sistemas existentes.
Prepare el archivo CSV según el formato de datos de distintivo de la sección siguiente.
Insertar datos CSV preparados en Microsoft Places.

Preparación del archivo CSV

Formato de datos de distintivo: use el siguiente esquema al cargar la información del distintivo.

Column	Tipo	Descripción
DeviceId	Cadena	Opcional. El identificador de dispositivo indica qué dispositivo generó la señal.
EventType	Cadena	La acción del distintivo, que depende del tipo de sensor. El valor puede ser BadgeIn.
UserID	Cadena	Opcional. Identificador de usuario con distintivo.
UserName	Cadena	Opcional. Nombre de usuario con distintivo.
UserEmail	Cadena	Dirección de correo electrónico del usuario con distintivo.
LocationHint	Cadena	Nombre de compilación. Ubicación desde donde se registra la señal de distintivo.
IngestionTime	Timestamp	Marca de tiempo de la señal de distintivo, que indica cuándo se produjo el evento.

Omita los encabezados de columna CSV al cargar estos datos.
Los valores de columna CSV deben estar en orden con el esquema mencionado anteriormente.
Ubicación del usuario para Places lógica de asignación:

Si DeviceId no está disponible, pero LocationHint está disponible, asigne LocationHint con PlaceName en el directorio people y filtra lo que no se asigna.

Si LocationHint y DeviceId están disponibles, asigne LocationHint con PlaceName en el directorio people. Si no se asigna, mapear con PlaceIdFromDeviceInventory, de lo contrario, filtra lo que no se asigna.

Contenido del archivo de ejemplo CSV:

En el ejemplo siguiente se muestran dos entradas en un archivo CSV.

BadgeEntry1_BANGALORE-FERNS_MIRPL,BadgeIn,167b4de9-05c8-422e-916e-9d5be5b381b2,AlexW,AlexW@SkelligeIsland.OnMicrosoft.com,BANGALORE-FERNS_MIRPL,2024-06-28T09:36:05.144Z 

BadgeEntry1_BANGALORE-FERNS_MIRPL,BadgeIn,167b4de9-05c8-422e-916e-9d5be5b381b2,AllanD,AllanD@SkelligeIsland.OnMicrosoft.com,BANGALORE-FERNS_MIRPL,2024-06-28T10:36:05.144Z

Inserción de una señal de datos de distintivo en Microsoft Places mediante cmdlets

Para más información sobre los cmdlets de Microsoft Places, consulte el módulo de cmdlets de Microsoft Places para PowerShell.

Nota:

Para ejecutar Microsoft Places cmdlets, debe tener asignado el rol TenantPlacesManagement.

Abra PowerShell 7 (no como administrador).
Instale Microsoft Places ejecutando el siguiente cmdlet de Windows PowerShell. Para obtener más información sobre Microsoft Places instalación, consulte el Microsoft Places Galería de PowerShell.
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
Importe el módulo Microsoft Places mediante la ejecución del siguiente cmdlet de Windows PowerShell.
```
Import-Module -Name MicrosoftPlaces
```
Conéctese al módulo Microsoft Places mediante la ejecución del siguiente cmdlet de PowerShell Places.
```
Connect-MicrosoftPlaces 
```
Cargue el conjunto de datos de distintivos desde la ubicación del dispositivo (mediante la carpeta y la ruta de acceso) mediante la ejecución del siguiente cmdlet de PowerShell Microsoft Places.
```
Push-Dataset -Type BadgeSwipe -Path C:\sensordata\
```

Se trata de una operación CreateOrOverwrite. Por ejemplo, los nuevos datos de distintivo se sobrescriben en la carpeta de día actual.

Opción 2: Automatizar el uso de Microsoft Graph API

Los pasos siguientes son necesarios para insertar datos de distintivo en Microsoft Places mediante el Graph API:

Descargue los datos de distintivos de los sistemas existentes.
Prepare la solicitud de API con el formato de datos de distintivo en la sección siguiente.

POST https://graph.microsoft.com/beta/workplace/sensorDevices/ingestTelemetry 
{ 
    "telemetry": [ 
        { 
            "deviceId": "BadgeEntry1_BANGALORE-FERNS_MIRPL", 
            "sensorType": "badge", 
            "eventValue": { 
                "eventType": "badgeIn", 
                "user": { 
                    "id": "167b4de9-05c8-422e-916e-9d5be5b381b2", 
                    "displayName": "AlexW", 
                    "email": "AlexW@SkelligeIsland.OnMicrosoft.com" 
                } 
             }, 
             "locationHint": "BANGALORE-FERNS_MIRPL", 
             "timestamp": "2024-06-28T09:36:05.144Z" 
        } 
    ] 
}

Ejecute la API para insertar los datos en Microsoft Places.

Formato de datos de señal de datos de distintivo

Parámetro	Tipo	Descripción
telemetría (obligatorio)	workplaceSensorDeviceTelemetry, collectionText	Colección de los datos de telemetría recopilados y notificados por un sensor en un dispositivo de distintivo.
deviceId	Cadena	Identificador único definido por el usuario del dispositivo proporcionado en el momento de la creación. No use el identificador generado por el sistema del dispositivo.
locationHint	Cadena	Información adicional para indicar la ubicación del dispositivo.
timestamp (obligatorio)	DateTimeOffset	la fecha y hora en que el sensor midió e informó de su valor. El tipo de marca de tiempo representa la información de fecha y hora mediante el formato ISO 8601 y siempre está en UTC. Por ejemplo, medianoche UTC del 1 de enero de 2024 es 2024-01-01T00:00:00Z.
sensorType (obligatorio)	workplaceSensorType	Tipo de sensor. Los valores posibles son: distintivo.
eventValue (obligatorio)	workplaceSensorEventValue	Valores adicionales asociados a señales de distintivo.
eventValue.eventType (obligatorio)	workplaceSensorEventType	Tipo de posible valor de evento de sensor. Los valores posibles son: badgeIn.
eventValue.user (obligatorio)	emailIdentity	Identificador único de un usuario. Puede ser un correo electrónico o un Microsoft Entra ID.
eventValue.user.displayName	Cadena	El nombre para mostrar del usuario. Se hereda de la identidad.
eventValue.user.email (obligatorio)	Cadena	Email dirección del usuario.
eventValue.user.id	String	El identificador único del usuario. Se hereda de la identidad.

Inserción de una señal de datos de distintivo en Microsoft Places mediante Microsoft Graph API

Para compilar una aplicación para automatizar la carga de telemetría, las API están disponibles a través de Microsoft Graph. Para usar las API, siga estos pasos.

Cree un registro de aplicación en Microsoft Entra.

Para obtener más información sobre los permisos PlaceDeviceRead.All y PlaceDevice.ReadWrite.All, consulte la Referencia de permisos de Microsoft Graph.
Compile e implemente una aplicación para sincronizar la telemetría entre Microsoft Places y sus asociados.
Use la API IngestTelemetry para insertar datos de distintivo en Microsoft Places.

Para obtener más información, vea workplaceSensorDevice.

Ejemplo:

POST https://graph.microsoft.com/beta/workplace/sensorDevices/ingestTelemetry  

{ 
    "telemetry": [ 
        { 
            "deviceId": "BadgeEntry1_BANGALORE-FERNS_MIRPL", 
            "sensorType": "badge", 
            "eventValue": { 
            "eventType": "badgeIn", 
                "user": { 
                    "id": "167b4de9-05c8-422e-916e-9d5be5b381b2", 
                    "displayName": "AlexW", 
                    "email": "AlexW@SkelligeIsland.OnMicrosoft.com" 
                } 
             }, 
            "locationHint": "BANGALORE-FERNS_MIRPL", 
            "timestamp": "2024-06-28T09:36:05.144Z" 
        } 
    ] 
}

Validación de datos y solución de problemas de análisis de compilación

Asegúrese de que el identificador de correo electrónico de usuario incorporado coincide con el identificador de correo electrónico de usuario en Microsoft Entra ID.
Asegúrese de que la ubicación del usuario coincide con la ubicación del usuario en Microsoft Entra ID.
Debería poder ver la luz del panel basado en la ocupación de la compilación en un plazo de 48 horas una vez que incorpore los datos del distintivo.

Consideraciones de seguridad y privacidad para la creación de análisis

La retención de datos de distintivo cargados es de 28 días. Los datos procesados agregados se almacenan durante 90 días.
Los datos se almacenan en un lago de datos de Azure compatible con la privacidad.
Los líderes con menos de 10 miembros bajo ellos no se muestran en la jerarquía de líderes debido a los riesgos de privacidad.
Los días con menos de 10 miembros que llegan a los edificios no se muestran en los paneles de ocupación real del edificio debido a riesgos de privacidad.

Compartir a través de

Creación de análisis

Creación de una señal de análisis

Creación de un uso basado en la intención de usar

Uso de la compilación en función de la ocupación real

Incorporación de datos de personas

Información general

Formato de datos

Actualizaciones de datos para Microsoft Entra ID

Portal de Azure

Actualizar atributos de Microsoft Entra ID mediante un script de PowerShell

Actualización de la ubicación del usuario

Actualizar los atributos de Microsoft Entra ID mediante Graph API

Validación y solución de problemas de datos

Consideraciones sobre seguridad y privacidad

Incorporación de datos de distintivo

Proceso para habilitar los datos de distintivo

Paso 1: Agregar dispositivos de acceso de distintivo a Microsoft Places

Opción 1: Uso de cmdlets de PowerShell

Formatos de datos de dispositivo para cmdlets

Adición de un dispositivo de acceso de distintivo a Microsoft Places mediante cmdlets

Pasos: Uso de cmdlets de PowerShell

Pasos: Uso de Microsoft Graph API

Formatos de datos de dispositivo usados en microsoft Graph API

Carga de telemetría de datos de distintivos en Microsoft Places

Opción 1: Usar el cmdlet Push-Dataset

Preparación del archivo CSV

Inserción de una señal de datos de distintivo en Microsoft Places mediante cmdlets

Opción 2: Automatizar el uso de Microsoft Graph API

Formato de datos de señal de datos de distintivo

Inserción de una señal de datos de distintivo en Microsoft Places mediante Microsoft Graph API

Validación de datos y solución de problemas de análisis de compilación

Consideraciones de seguridad y privacidad para la creación de análisis

Comentarios

Recursos adicionales