Génération d’analyses

Article
11/14/2024

Les paramètres de plan de travail qui permettent aux employés d’indiquer leur intention d’entrer au bureau, combinés aux données d’occupation réelles des bâtiments, offrent aux gestionnaires immobiliers et d’installations un outil précieux pour comprendre, analyser et optimiser l’utilisation de l’espace de bâtiment.

En comparant les données du plan de travail, qui reflètent les intentions des employés, aux données d’occupation réelles, vous pouvez identifier les différences entre l’utilisation planifiée et l’utilisation réelle de l’espace.

Voici les signaux utilisés dans l’analytique de création :

Utilisation du bâtiment en fonction de l’intention d’entrer au bureau L’analytique de création utilise les plans de travail des employés pour évaluer l’utilisation de l’espace pilotée par l’intention.
Utilisation du bâtiment en fonction de l’occupation réelle L’analytique des bâtiments utilise les données de badge pour déduire le nombre d’employés présents dans un bâtiment, ce qui fournit une mesure de l’occupation réelle du bâtiment.
Personnes données Microsoft Places l’analytique utilise des données d’API de profil de personnes provenant de données Microsoft Entra ID (ou) via des connecteurs externes pour analyser les employés affectés à un bâtiment spécifique et les employés sous un responsable spécifique. Ces données permettent de mapper les utilisateurs à un bâtiment spécifique, ce qui améliore la couverture des données pour l’analytique de création.

Génération d’un signal d’analytique

Génération de l’utilisation en fonction de l’intention d’utilisation

L’analytique de création utilise des données de plan de travail pour suivre l’occupation prévue des bâtiments et les tendances hybrides attendues, ce qui fournit des informations sur les préférences des employés concernant les visites au bureau.

La source des données du plan de travail provient du paramètre Heures de travail flexibles (FWH) disponible pour les utilisateurs dans Microsoft Places et dans l’application Outlook. Les données du plan de travail dépendent de la disponibilité des données de personnes (à partir de jeux de données de profils de personnes). Personnes données permettent de mapper les employés qui définissent des plans de travail sans choisir les bâtiments comme bâtiments qui leur sont attribués dans les données de personnes.

Utilisation du bâtiment en fonction de l’occupation réelle

L’analytique des bâtiments utilise les données d’occupation pour détecter la présence réelle de personnes dans les bâtiments. Actuellement, nous prenons en charge les données d’occupation des bâtiments suivantes :

Données d’accès au badge

Remarque

Pour que les tableaux de bord d’analyse des bâtiments affichent des valeurs précises, les données de personnes doivent être mappées aux bâtiments intégrés à Mirosoft Places.

Dans la section suivante, nous allons aborder des détails sur l’intégration des données de personnes, ainsi que sur l’intégration des données d’occupation.

Intégrer des données de personnes

Informations générales

Microsoft Places analytics utilise les données de l’API de profil de personnes pour associer des utilisateurs à un emplacement/bâtiment spécifique. Personnes données de profil extrait généralement les données de Microsoft Entra ID et, si vous avez ajouté des connecteurs pour apporter des données de personnes aux applications Microsoft 365, les données pertinentes sont reflétées dans le jeu de données de profil de personnes.

Le nombre d’employés affectés dans l’analytique de construction est dérivé de l’employé au mappage de création.
Pour que les fonctionnalités de filtre de leader fonctionnent avec précision, le mappage du gestionnaire d’employés doit être disponible dans le jeu de données de profil de personnes.

Format de données

Microsoft Places analytics recherche un ensemble spécifique de champs dans le jeu de données de profils de personnes pour créer un mappage entre les employés, les bâtiments qui leur sont attribués et leurs responsables.

OfficeLocation Il s’agit de la propriété d’API de profil de personnes utilisée par Places pour associer un employé à un bâtiment.

Remarque

Cette propriété doit correspondre au nom du bâtiment défini dans Places Directory pour créer le mappage avec précision.

Gérant Il s’agit de la propriété d’API de profil de personnes utilisée par Places pour associer des utilisateurs à leurs responsables/responsables.

Pour en savoir plus sur l’API de profil ici Format de données, consultez Utiliser l’API de profil dans Microsoft Graph pour récupérer des informations sur vous-même ou sur un autre utilisateur.

Mises à jour des données à Microsoft Entra ID

Pour faire correspondre les données de profil des personnes aux données de présence, leur emplacement Microsoft Entra ID doit être mis à jour. Elle peut être effectuée à l’aide de l’une des méthodes suivantes.

Portail Azure

Accédez à la Portail Azure : accédez au Portail Azure et connectez-vous avec vos informations d’identification.
Accédez à Azure Active Directory : dans le volet de navigation gauche, sélectionnez Azure Active Directory.
Recherchez l’utilisateur : sous Gérer, sélectionnez Utilisateurs, puis recherchez l’utilisateur dont vous souhaitez mettre à jour l’emplacement.
Modifier les informations utilisateur : sélectionnez le nom de l’utilisateur pour ouvrir son profil, puis sélectionnez Modifier pour mettre à jour ses informations.
Mettre à jour l’emplacement : dans la section Informations sur le travail , vous pouvez mettre à jour les détails de l’emplacement de l’utilisateur. Veillez à enregistrer vos modifications.
Gestionnaire de mises à jour : dans la section Informations sur le travail , vous pouvez mettre à jour les détails du responsable de l’utilisateur. Veillez à enregistrer vos modifications.

Pour en savoir plus sur la mise à jour des données Microsoft Entra ID, consultez Ajouter ou mettre à jour les informations et paramètres de profil d’un utilisateur dans le centre d’administration Microsoft Entra.

Mettre à jour les attributs Microsoft Entra ID à l’aide d’un script PowerShell

# Connect to Azure AD 
Connect-AzureAD

Mettre à jour l’emplacement de l’utilisateur

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

Pour plus d’informations, consultez Update-AzADUser.

Mettre à jour les attributs Microsoft Entra ID à l’aide de API Graph

Commencez par comprendre le type de ressource utilisateur. Pour plus d’informations, consultez Type de ressource utilisateur.

Connectez-vous à Graph Explorer. Pour plus d’informations, consultez Graph Explorer.
Appelez l’utilisateur Update. Pour plus d’informations, consultez Mettre à jour l’utilisateur.

Échantillon:

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

Validation et résolution des problèmes des données

La propriété de nombre d’en-têtes dans le tableau de bord d’analyse Microsoft Places doit avoir la valeur attendue.
Le responsable filtre dans la page Building analytics de Places analytics et doit avoir les données du responsable approprié renseignées.
Si les modifications sont apportées en mettant à jour l’emplacement de l’utilisateur ou le responsable, elles doivent être reflétées dans Places analytique dans 3 à 4 jours.
Utilisez l’option de commentaires dans l’application pour envoyer les problèmes Microsoft que vous rencontrez.

Considérations sur la sécurité et la confidentialité

Microsoft Places analytique agrège toujours les points de données pour afficher les numéros d’utilisation de la construction. Les utilisateurs ne peuvent pas identifier d’informations sur des employés individuels spécifiques. Microsoft Places utilise les données de profil de personnes utilisées par d’autres applications Microsoft 365.

Intégrer des données de badge

Vous pouvez utiliser des systèmes d’accès par badge existants pour améliorer Places rapport Analytics sur la création de tableaux de bord d’occupation.

Processus d’activation des données de badge

Étape 1 : Ajouter des appareils d’accès par badge à Microsoft Places (facultatif, mais fortement recommandé).
Étape 2 : Charger les données de télémétrie des badges sur Microsoft Places.

Remarque

Personnes données doivent être disponibles pour les bâtiments intéressés dans Microsoft Places avant l’intégration des données de badge. Les données de badge sont validées par rapport aux données Personnes. Le système filtre les données de badge des utilisateurs qui ne sont pas mappés à Microsoft Places.

Étape 1 : Ajouter des appareils d’accès par badge à Microsoft Places

La première étape consiste à charger les métadonnées d’appareil d’accès par badge et à mapper les appareils à un Id De place dans Microsoft Places. Cette étape permet de contextualiser les signaux de badge lorsqu’ils atteignent Microsoft Places. Vous pouvez ajouter des appareils d’accès par badge à Microsoft Places à l’aide de deux options :

Option 1 : Utilisation des applets de commande PowerShell
Option 2 : Utilisation des API Microsoft Graph

Option 1 : Utilisation des applets de commande PowerShell

Les applets de commande PowerShell sont disponibles pour gérer les appareils dans Microsoft Places. Pour en savoir plus sur les applets de commande Microsoft Places, consultez le module Microsoft Places cmdlets pour PowerShell.

Remarque

Pour exécuter des applets de commande, le rôle TenantPlacesManagement doit être attribué.

Formats de données d’appareil pour les applets de commande

Colonne	Description	Notes	Exemple
DeviceId (obligatoire)	Identificateur unique de l’appareil (recommandé : Manufacturer_DeviceUniqueId).	Doit correspondre à l’ID de la télémétrie envoyée.	Manuf1_3455
DisplayName	Nom complet de l’appareil.	Vous pouvez utiliser un nom convivial, le cas échéant.	Manuf1_3455
Description	Description de l’appareil.
MacAddress	Adresse Mac de l’appareil.	Fournisseur fourni (si disponible).
Fabricant (obligatoire)	Fabricant de l’appareil.	Fourni par l’administrateur informatique.	Manuf1
IPV4Address	IPV4Address de l’appareil.	Fournisseur fourni (si disponible).
IPV6Address	IPV6Address de l’appareil.	Fournisseur fourni (si disponible).
PlaceId	PlaceId auquel votre appareil est mappé dans Places.	L’administrateur informatique mappe DeviceID au champ DisplayName à partir d’une liste de salles.	76fe540f-01a9-425e-acd5-5d7d1da44fbf
Tags	Liste des étiquettes personnalisées associées à l’appareil pour faciliter la recherche.		["IsVirtual_False », « Building_121"]
Sensor.SensorId	Identificateur unique d’un capteur au sein de l’appareil.	Doit être fourni dans la charge utile de télémétrie standard.	Insigne
Sensor.DisplayName	Nom d’affichage du capteur.	Vous pouvez utiliser un nom convivial (le cas échéant).	Trombone
Sensor.SensorType (obligatoire)	Type de capteur.	Liste validée (voir les exemples).	Insigne
Sensor.PlaceId	Identificateur unique de l’emplacement desservi par le capteur (vous devez uniquement fournir ces informations si le capteur se trouve à un emplacement différent de l’emplacement de l’appareil).		76fe540f-01a9-425e-acd5-5d7d1da44fbf

Ajouter un appareil d’accès aux badges à Microsoft Places à l’aide d’applets de commande

[ !div class="mx-tdBreakAll"]

Nom de la cmdlet	Description	Paramètres
New-PlaceDevice	Crée un appareil.	DeviceId (obligatoire), DisplayName, Description, MACAddress, Manufacturer (obligatoire), IPV4Address, IPV6Address, PlaceId (obligatoire), TagsSensors (obligatoire)
Remove-PlaceDevice	Supprime un appareil.	ID (obligatoire)
Set-PlaceDevice	Mises à jour un appareil.	ID (obligatoire), DeviceId (obligatoire), DisplayName, Description, MACAddress, Manufacturer (obligatoire), IPV4Address, IPV6Address, PlaceId, Tags, Sensors (obligatoire)
Get-PlaceDevice	Obtient un appareil.	ID, Filtre, Haut

Étapes : Utilisation des applets de commande PowerShell

Ouvrez PowerShell 7 (et non en tant qu’administrateur).
Installez Microsoft Places en exécutant l’applet de commande Windows PowerShell suivante. Pour plus d’informations sur l’installation de Microsoft Places, consultez la Microsoft Places PowerShell Gallery.
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
Importez le module Microsoft Places en exécutant l’applet de commande Windows PowerShell suivante.
```
Import-Module -Name MicrosoftPlaces 
```
Après avoir installé et importé le module, connectez-vous au module Microsoft Places en exécutant l’applet de commande PowerShell Microsoft Places suivante.
```
Connect-MicrosoftPlaces
```

Utilisez New-PlaceDevice applet de commande pour ajouter un appareil d’accès au badge.

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"})

Remarque

Le paramètre Sensors dans cet exemple est un objet de type MicrosoftPlaces.PlacesDevices.Sensor ayant des champs mentionnés dans l’exemple.

Utilisez Get-PlaceDevice pour afficher la liste des appareils. Par défaut, elle retourne 10 appareils. Pour renvoyer d’autres appareils, ajoutez le paramètre -top comme indiqué dans cet exemple.
```
Get-PlaceDevice -top 100 
```

Utilisez Set-PlaceDevice pour mettre à jour un appareil avec l’ID existant.

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"})

Remarque

Fournissez les détails de tous les paramètres (obligatoires et facultatifs) lors de la mise à jour d’un appareil. En l’absence d’une valeur de paramètre, elle rétablit la valeur vide par défaut.

Utilisez Remove-PlaceDevice pour supprimer un appareil.

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

Étapes : Utilisation de Microsoft API Graph

Pour créer une application afin d’automatiser l’inscription et l’intégration des appareils d’accès par badge, les API sont disponibles via Microsoft Graph. Pour utiliser des API, procédez comme suit.

Créez une inscription d’application dans Microsoft Entra. Pour en savoir plus sur les autorisations PlaceDeviceRead.All et PlaceDevice.ReadWrite.All, consultez la référence des autorisations Microsoft Graph.
Créez et déployez une application pour synchroniser les informations d’appareil entre Microsoft Places et vos partenaires.

Formats de données d’appareil utilisés dans microsoft API Graph

Colonne	Description	Notes	Exemple
DeviceId (obligatoire)	Identificateur unique de l’appareil (recommandé : Manufacturer_DeviceUniqueId).	Doit correspondre à l’ID de la télémétrie envoyée.	Manuf1_3455
DisplayName	Nom complet de l’appareil.	Vous pouvez utiliser un nom convivial, le cas échéant.	Manuf1_3455
Description	Description de l’appareil.
MacAddress	Adresse Mac de l’appareil.	Fournisseur fourni (si disponible).
Fabricant (obligatoire)	Fabricant de l’appareil.	Fourni par l’administrateur informatique.	Manuf1
IPV4Address	IPV4Address de l’appareil.	Fournisseur fourni, si disponible.
IPV6Address	IPV6Address de l’appareil.	Fournisseur fourni, si disponible.
PlaceId (obligatoire)	PlaceId auquel votre appareil est mappé dans Microsoft Places.	L’administrateur informatique mappe DeviceID au champ DisplayName à partir d’une liste de salles.	76fe540f-01a9-425e-acd5-5d7d1da44fbf
Tags	Liste des étiquettes personnalisées associées à l’appareil pour faciliter la recherche.		["IsVirtual_False », « Building_121"]
Sensor.SensorId (obligatoire)	Identificateur unique d’un capteur au sein de l’appareil.	Doit être fourni dans la charge utile de télémétrie standard.	Insigne
Sensor.DisplayName	Nom d’affichage du capteur.	Vous pouvez utiliser un nom convivial (le cas échéant).	Trombone
Sensor.SensorType (obligatoire)	Type de capteur.	Liste validée (voir les exemples).	Insigne
Sensor.PlaceId	Identificateur unique de l’emplacement desservi par le capteur (vous devez uniquement fournir ces informations si le capteur se trouve à un emplacement différent de l’emplacement de l’appareil).		76fe540f-01a9-425e-acd5-5d7d1da44fbf

Pour en savoir plus sur les appareils de capteur, consultez les API Microsoft Graph suivantes :

Afficher les appareils d’accès au badge : répertorier les capteurAppareils.

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

Créer des appareils d’accès aux badges : créez 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" 
        } 
    ] 
}

Afficher un appareil spécifique : Obtenir workplaceSensorDevice.

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

Mettre à jour les appareils d’accès aux badges existants : Mettre à jour 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" 
        } 
    ] 
}

Pour supprimer un appareil : Supprimer 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

Charger la télémétrie des données de badge sur Microsoft Places

Chargez des données à partir de votre système de saisie de badge pour générer des tableaux de bord d’occupation des bâtiments dans Places Analytics.

DeviceId est utilisé pour faire correspondre l’événement de badge à un bâtiment spécifique. En l’absence de DeviceId, LocationHint est utilisé. Nous vous recommandons vivement d’intégrer vos appareils pour cartographier avec précision l’occupation des bâtiments.
LocationHint doit correspondre au nom du bâtiment dans Microsoft Places répertoire si vous n’avez pas intégré d’appareils à Microsoft Places.
Les utilisateurs des données de badge sont validés par rapport aux données Personnes (à partir de l’API de profil) pour les rendre disponibles dans la page Générer une analytique.

Option 1 : Utilisation de l’applet de commande Push-Dataset

Ces étapes sont nécessaires pour envoyer des données de badge à Microsoft Places :

Téléchargez les données de badge à partir de systèmes existants.
Préparez le fichier CSV conformément au format de données de badge dans la section suivante.
Envoyer (push) des données CSV préparées à Microsoft Places.

Préparer le fichier CSV

Format des données de badge : utilisez le schéma suivant lors du chargement des informations de badge.

Column	Type	Description
DeviceId	String	Facultatif. L’ID d’appareil indique quel appareil a généré le signal.
EventType	Chaîne	Action du badge, qui dépend du type de capteur. La valeur peut être BadgeIn.
UserID	String	Facultatif. ID d’utilisateur avec badge.
UserName	String	Facultatif. Nom d’utilisateur badgeé.
UserEmail	String	Adresse e-mail de l’utilisateur avec badge.
LocationHint	String	Nom du bâtiment. Emplacement à partir duquel le signal de badge est enregistré.
IngestionTime	Timestamp	Horodatage du signal de badge, qui indique quand l’événement s’est produit.

Ignorez les en-têtes de colonne CSV lors du chargement de ces données.
Les valeurs de colonne CSV doivent être dans l’ordre avec le schéma mentionné précédemment.
Emplacement de l’utilisateur pour Places logique de mappage :

Si DeviceId n’est pas disponible, mais que LocationHint est disponible, mappez LocationHint avec PlaceName dans le répertoire people et filtrez ce qui n’est pas mappé.

Si LocationHint et DeviceId sont disponibles, mappez LocationHint avec PlaceName dans le répertoire people. S’il n’est pas mappé, mapper avec PlaceIdFromDeviceInventory, sinon filtre ce qui n’est pas mappé.

Contenu de l’exemple de fichier CSV :

L’exemple suivant montre deux entrées dans un fichier 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

Envoyer (push) un signal de données de badge à Microsoft Places à l’aide d’applets de commande

Pour en savoir plus sur les applets de commande Microsoft Places, consultez le module Microsoft Places cmdlets pour PowerShell.

Remarque

Pour exécuter Microsoft Places applets de commande, le rôle TenantPlacesManagement doit vous être attribué.

Ouvrez PowerShell 7 (et non en tant qu’administrateur).
Installez Microsoft Places en exécutant l’applet de commande Windows PowerShell suivante. Pour plus d’informations sur Microsoft Places’installation, consultez le Microsoft Places PowerShell Gallery.
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
Importez le module Microsoft Places en exécutant l’applet de commande Windows PowerShell suivante.
```
Import-Module -Name MicrosoftPlaces
```
Connectez-vous au module Microsoft Places en exécutant l’applet de commande PowerShell Places suivante.
```
Connect-MicrosoftPlaces 
```
Chargez le jeu de données de badge à partir de l’emplacement sur votre appareil (à l’aide du dossier et du chemin d’accès) en exécutant l’applet de commande PowerShell Microsoft Places suivante.
```
Push-Dataset -Type BadgeSwipe -Path C:\sensordata\
```

Il s’agit d’une opération CreateOrOverwrite. Par exemple, les nouvelles données de badge sont remplacées dans le dossier jour actuel.

Option 2 : Automatiser à l’aide de Microsoft API Graph

Les étapes suivantes sont requises pour envoyer des données de badge à Microsoft Places à l’aide de la API Graph :

Téléchargez les données de badge à partir de systèmes existants.
Préparez la demande d’API en utilisant le format badge-data dans la section suivante.

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" 
        } 
    ] 
}

Exécutez l’API pour envoyer les données à Microsoft Places.

Badge data signal-data format

Paramètre	Type	Description
télémétrie (obligatoire)	workplaceSensorDeviceTelemetry, collectionText	Collection des données de télémétrie collectées et signalées par un capteur sur un appareil de badge.
deviceId	String	Identificateur unique défini par l’utilisateur de l’appareil fourni au moment de la création. N’utilisez pas l’identificateur généré par le système de l’appareil.
locationHint	String	Informations supplémentaires pour indiquer l’emplacement de l’appareil.
timestamp (obligatoire)	DateTimeOffset	date et heure auxquelles le capteur a mesuré et signalé sa valeur. Le type d’horodatage représente les informations de date et d’heure au format ISO 8601 et est toujours au format UTC. Par exemple, minuit UTC le 1er janvier 2024 est 2024-01-01T00:00:00Z.
sensorType (obligatoire)	workplaceSensorType	Type de capteur. Les valeurs possibles sont : badge.
eventValue (obligatoire)	workplaceSensorEventValue	Valeurs supplémentaires associées aux signaux de badge.
eventValue.eventType (obligatoire)	workplaceSensorEventType	Type de valeur d’événement de capteur possible. Les valeurs possibles sont : badgeIn.
eventValue.user (obligatoire)	emailIdentity	Identificateur unique d’un utilisateur. Il peut s’agir d’un e-mail ou d’un Microsoft Entra ID.
eventValue.user.displayName	String	Nom affiché de l’utilisateur. Hérité de l’identité.
eventValue.user.email (obligatoire)	String	Email’adresse de l’utilisateur.
eventValue.user.id	String	Identificateur unique de l’utilisateur. Hérité de l’identité.

Envoyer (push) un signal de données de badge à Microsoft Places à l’aide de Microsoft API Graph

Pour créer une application pour automatiser et charger des données de télémétrie, les API sont disponibles via Microsoft Graph. Pour utiliser des API, procédez comme suit.

Créez une inscription d’application dans Microsoft Entra.

Pour en savoir plus sur les autorisations PlaceDeviceRead.All et PlaceDevice.ReadWrite.All, consultez la référence des autorisations Microsoft Graph.
Créez et déployez une application pour synchroniser les données de télémétrie entre Microsoft Places et vos partenaires.
Utilisez l’API IngestTelemetry pour envoyer des données de badge à Microsoft Places.

Pour plus d’informations, consultez workplaceSensorDevice.

Exemple :

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" 
        } 
    ] 
}

Validation des données et résolution des problèmes liés à l’analytique de création

Assurez-vous que l’ID d’e-mail de l’utilisateur intégré correspond à l’ID d’e-mail de l’utilisateur dans Microsoft Entra ID.
Assurez-vous que l’emplacement de l’utilisateur correspond à l’emplacement de l’utilisateur dans Microsoft Entra ID.
Vous devriez être en mesure d’afficher le tableau de bord basé sur l’occupation du bâtiment dans les 48 heures une fois que vous avez intégré les données du badge.

Considérations relatives à la sécurité et à la confidentialité pour la création d’analyses

La conservation des données de badge chargées est de 28 jours. Les données traitées agrégées sont stockées pendant 90 jours.
Les données sont stockées dans un lac de données Azure conforme à la confidentialité.
Les dirigeants ayant moins de 10 membres sous eux ne sont pas affichés dans la hiérarchie des leaders en raison des risques liés à la confidentialité.
Les jours où moins de 10 membres viennent dans les bâtiments ne sont pas affichés dans les tableaux de bord d’occupation des bâtiments en raison des risques de confidentialité.

Partager via

Génération d’analyses

Génération d’un signal d’analytique

Génération de l’utilisation en fonction de l’intention d’utilisation

Utilisation du bâtiment en fonction de l’occupation réelle

Intégrer des données de personnes

Informations générales

Format de données

Mises à jour des données à Microsoft Entra ID

Portail Azure

Mettre à jour les attributs Microsoft Entra ID à l’aide d’un script PowerShell

Mettre à jour l’emplacement de l’utilisateur

Mettre à jour les attributs Microsoft Entra ID à l’aide de API Graph

Validation et résolution des problèmes des données

Considérations sur la sécurité et la confidentialité

Intégrer des données de badge

Processus d’activation des données de badge

Étape 1 : Ajouter des appareils d’accès par badge à Microsoft Places

Option 1 : Utilisation des applets de commande PowerShell

Formats de données d’appareil pour les applets de commande

Ajouter un appareil d’accès aux badges à Microsoft Places à l’aide d’applets de commande

Étapes : Utilisation des applets de commande PowerShell

Étapes : Utilisation de Microsoft API Graph

Formats de données d’appareil utilisés dans microsoft API Graph

Charger la télémétrie des données de badge sur Microsoft Places

Option 1 : Utilisation de l’applet de commande Push-Dataset

Préparer le fichier CSV

Envoyer (push) un signal de données de badge à Microsoft Places à l’aide d’applets de commande

Option 2 : Automatiser à l’aide de Microsoft API Graph

Badge data signal-data format

Envoyer (push) un signal de données de badge à Microsoft Places à l’aide de Microsoft API Graph

Validation des données et résolution des problèmes liés à l’analytique de création

Considérations relatives à la sécurité et à la confidentialité pour la création d’analyses

Commentaires

Ressources supplémentaires