Compilazione di analisi

Le impostazioni del piano di lavoro che consentono ai dipendenti di indicare la loro intenzione di entrare in ufficio, combinate con i dati effettivi sull'occupazione degli edifici, offrono ai gestori di immobili e strutture uno strumento prezioso per comprendere, analizzare e ottimizzare l'uso dello spazio degli edifici.

Confrontando i dati del piano di lavoro, che riflettono le intenzioni dei dipendenti, con i dati effettivi sull'occupazione, è possibile identificare le discrepanze tra l'utilizzo dello spazio pianificato e quello reale.

Di seguito sono riportati i segnali usati nell'analisi di compilazione:

• Uso dell'edificio in base all'intento di entrare in ufficio L'analisi della compilazione usa i piani di lavoro dei dipendenti per valutare l'uso dello spazio basato sulle finalità.

• Uso degli edifici in base all'occupazione effettiva L'analisi degli edifici usa i dati dei badge per dedurre il numero di dipendenti presenti in un edificio, fornendo una misura dell'occupazione effettiva degli edifici.

• Persone dati Microsoft Places l'analisi usa i dati dell'API del profilo delle persone originati da dati Microsoft Entra ID (o) tramite connettori esterni per analizzare i dipendenti assegnati a un edificio specifico e i dipendenti sotto un leader specifico. Questi dati consentono di eseguire il mapping degli utenti a un edificio specifico, migliorando la copertura dei dati per la compilazione di analisi.

Creazione di un segnale di analisi

Compilazione dell'utilizzo in base alla finalità di utilizzo

L'analisi degli edifici usa i dati del piano di lavoro per tenere traccia dell'occupazione degli edifici prevista e delle tendenze ibride previste, fornendo informazioni dettagliate sulle preferenze dei dipendenti per le visite in ufficio.

L'origine dei dati del piano di lavoro proviene dall'impostazione Orario di lavoro flessibile (FWH) disponibile per gli utenti in Microsoft Places e nell'app Outlook. I dati del piano di lavoro dipendono dalla disponibilità dei dati degli utenti (dai set di dati del profilo degli utenti). Persone dati consentono di eseguire il mapping dei dipendenti che impostano piani di lavoro senza scegliere gli edifici come edificio assegnato nei dati degli utenti.

Utilizzo degli edifici in base all'occupazione effettiva

L'analisi degli edifici usa i dati sull'occupazione per rilevare la presenza effettiva di persone negli edifici. Attualmente, sono supportano i seguenti dati sull'occupazione degli edifici:

• Dati di accesso badge

Nella sezione successiva verranno illustrati i dettagli sull'onboarding dei dati delle persone insieme all'onboarding dei dati sull'occupazione degli edifici.

Eseguire l'onboarding dei dati delle persone

Informazioni generali

Microsoft Places l'analisi usa i dati dell'API del profilo persone per associare gli utenti a una posizione/edificio specifica. Persone dati del profilo esegue in genere il pull dei dati da Microsoft Entra ID e, se sono stati aggiunti connettori per trasferire i dati degli utenti alle applicazioni Microsoft 365, i dati pertinenti vengono riflessi nel set di dati del profilo degli utenti.

• L'organico assegnato nell'analisi degli edifici deriva dal dipendente al mapping di compilazione.

• Affinché le funzionalità di filtro leader funzionino in modo accurato, il mapping dei manager dei dipendenti deve essere disponibile nel set di dati del profilo degli utenti.

Formato dati

Microsoft Places analytics cerca un set specifico di campi nel set di dati del profilo degli utenti per creare il mapping tra i dipendenti, gli edifici assegnati e i responsabili.

• OfficeLocation Si tratta della proprietà dell'API people profile usata da Places per associare un dipendente a un edificio.

• Direttore Si tratta della proprietà DELL'API del profilo delle persone usata da Places per associare gli utenti ai responsabili/responsabili.

Per altre informazioni sull'API del profilo qui Formato dati, vedere Usare l'API Profilo in Microsoft Graph per recuperare informazioni su se stessi o su un altro utente.

Aggiornamenti dei dati per Microsoft Entra ID

Per associare i dati del profilo delle persone ai dati di partecipazione, è necessario aggiornare la posizione Microsoft Entra ID. Può essere eseguita usando uno dei metodi seguenti.

Portale di Azure

1. Accedere al portale di Azure: passare al portale di Azure e accedere con le credenziali.
2. Passare ad Azure Active Directory: nel riquadro di spostamento a sinistra selezionare Azure Active Directory.
3. Trovare l'utente: in Gestisci selezionare Utenti e quindi cercare l'utente di cui si vuole aggiornare la posizione.
4. Modifica informazioni utente: selezionare il nome dell'utente per aprire il profilo e quindi selezionare Modifica per aggiornare le informazioni.
5. Aggiornare il percorso: nella sezione Informazioni sul processo è possibile aggiornare i dettagli della posizione dell'utente. Assicurarsi di salvare le modifiche.
6. Gestione aggiornamenti: nella sezione Informazioni sul processo è possibile aggiornare i dettagli del responsabile dell'utente. Assicurarsi di salvare le modifiche.

Per altre informazioni sull'aggiornamento dei dati Microsoft Entra ID, vedere Aggiungere o aggiornare le informazioni e le impostazioni del profilo di un utente nel Interfaccia di amministrazione di Microsoft Entra.

Aggiornare gli attributi Microsoft Entra ID usando uno script di PowerShell

# Connect to Azure AD 
Connect-AzureAD

Aggiornare la posizione dell'utente

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

Per altre informazioni, vedere Update-AzADUser.

Aggiornare gli attributi Microsoft Entra ID usando API Graph

Per iniziare, comprendere il tipo di risorsa utente. Per altre informazioni, vedere Tipo di risorsa utente.

• Accedere a Graph Explore. Per altre informazioni, vedere Graph Explorer.
• Richiamare l'utente update. Per altre informazioni, vedere Aggiornare l'utente.

Campione:

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

Convalida e risoluzione dei problemi dei dati

• La proprietà headcount nel dashboard di analisi Microsoft Places deve avere il valore previsto.
• Il leader filtra nella pagina Analisi di compilazione dell Places analytics e deve avere i dati del leader corretti compilati.
• Se le modifiche vengono apportate aggiornando la posizione dell'utente o il responsabile, dovrebbe essere riflessa nell'analisi Places tra 3 e 4 giorni.
• Usare l'opzione di feedback nell'applicazione per inviare i problemi microsoft riscontrati.

Considerazioni sulla protezione e sulla privacy

Microsoft Places l'analisi aggrega sempre i punti dati per mostrare i numeri di utilizzo degli edifici. Gli utenti non possono identificare informazioni su singoli dipendenti specifici. Microsoft Places usa i dati del profilo persone usati da altre applicazioni di Microsoft 365.

Onboarding dei dati delle notifiche

È possibile usare i sistemi di accesso alle notifiche esistenti per migliorare Places report di Analytics sulla creazione di dashboard di occupazione.

Processo per abilitare i dati delle notifiche

• Passaggio 1: Aggiungere dispositivi di accesso alle notifiche a Microsoft Places (facoltativo, ma altamente consigliato).
• Passaggio 2: Caricare i dati di telemetria dei dati delle notifiche in Microsoft Places.

Passaggio 1: Aggiungere dispositivi di accesso alle notifiche a Microsoft Places

Il primo passaggio prevede il caricamento dei metadati di accesso badge dei dispositivi e il mapping dei dispositivi a un PlaceId in Microsoft Places. Questo passaggio consente di contestualizzare i segnali di notifica quando raggiunge Microsoft Places. È possibile aggiungere dispositivi di accesso badge a Microsoft Places usando due opzioni:

• Opzione 1: Uso dei cmdlet di PowerShell
• Opzione 2: Uso delle API Microsoft Graph

Opzione 1: Uso dei cmdlet di PowerShell

I cmdlet di PowerShell sono disponibili per gestire i dispositivi in Microsoft Places. Per altre informazioni sui cmdlet Microsoft Places, vedere il modulo Microsoft Places cmdlet per PowerShell.

Formati di dati del dispositivo per i cmdlet

Aggiungere un dispositivo di accesso badge a Microsoft Places usando i cmdlet

[!div class="mx-tdBreakAll"]

Passaggi: Uso dei cmdlet di PowerShell

1. Aprire PowerShell 7 (non come amministratore).

2. Installare Microsoft Places eseguendo il cmdlet di Windows PowerShell seguente. Per altre informazioni sull'installazione Microsoft Places, vedere il Microsoft Places PowerShell Gallery.

   Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
   

3. Importare il modulo Microsoft Places eseguendo il cmdlet Windows PowerShell seguente.

   Import-Module -Name MicrosoftPlaces 
   

4. Dopo aver installato e importato il modulo, connettersi al modulo Microsoft Places eseguendo il cmdlet di PowerShell Microsoft Places seguente.

   Connect-MicrosoftPlaces
   

5. Usare New-PlaceDevice cmdlet per aggiungere il dispositivo di accesso alle notifiche.

   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

   Il parametro Sensors in questo esempio è un oggetto di tipo MicrosoftPlaces.PlacesDevices.Sensor con campi menzionati nell'esempio.

6. Usare Get-PlaceDevice per visualizzare l'elenco dei dispositivi. Per impostazione predefinita, restituisce 10 dispositivi. Per restituire altri dispositivi, aggiungere il parametro -top come illustrato in questo esempio.

   Get-PlaceDevice -top 100 
   

7. Usare Set-PlaceDevice per aggiornare un dispositivo con ID esistente.

   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

   Specificare i dettagli di tutti i parametri (obbligatori e facoltativi) durante l'aggiornamento di un dispositivo. In assenza di un valore di parametro, il valore viene reimpostato sul valore vuoto predefinito.

8. Usare Remove-PlaceDevice per eliminare un dispositivo.

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

Passaggi: Uso di Microsoft API Graph

Per creare un'applicazione per automatizzare la registrazione e l'onboarding dei dispositivi di accesso alle notifiche, le API sono disponibili tramite Microsoft Graph. Per usare le API, seguire questa procedura.

1. Creare una registrazione dell'app in Microsoft Entra. Per altre informazioni sulle autorizzazioni PlaceDeviceRead.All e PlaceDevice.ReadWrite.All, vedere Informazioni di riferimento sulle autorizzazioni di Microsoft Graph.
2. Compilare e distribuire un'applicazione per sincronizzare le informazioni sui dispositivi tra Microsoft Places e i partner.

Formati di dati dei dispositivi usati in Microsoft API Graph

Per altre informazioni sui dispositivi sensore, vedere le API di Microsoft Graph seguenti:

• Visualizzare i dispositivi di accesso alle notifiche: elencare i sensoriDispositivi.

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

• Creare nuovi dispositivi di accesso badge: Creare 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" 
        } 
    ] 
}  

• Visualizzare un dispositivo specifico: Ottenere workplaceSensorDevice.

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

• Aggiornare i dispositivi di accesso alle notifiche esistenti: aggiornare 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" 
        } 
    ] 
}  

• Per eliminare un dispositivo: Eliminare 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  

Caricare i dati di telemetria dei dati delle notifiche in Microsoft Places

Caricare i dati dal sistema di immissione badge per generare dashboard di occupazione degli edifici in Places Analytics.

• DeviceId viene usato per associare l'evento di notifica a un edificio specifico. In assenza di un DeviceId, viene usato LocationHint. È consigliabile eseguire l'onboarding dei dispositivi per mappare accuratamente l'occupazione degli edifici.

• LocationHint deve corrispondere al nome dell'edificio nella directory Microsoft Places se non sono stati caricati dispositivi per Microsoft Places.

• Gli utenti dei dati badge vengono convalidati in base ai dati Persone (dall'API del profilo) per renderli disponibili nella pagina Analisi di compilazione.

Opzione 1: uso del cmdlet Push-Dataset

Questi passaggi sono necessari per eseguire il push dei dati delle notifiche in Microsoft Places:

• Scaricare i dati delle notifiche dai sistemi esistenti.
• Preparare il file CSV in base al formato badge-data nella sezione seguente.
• Eseguire il push dei dati CSV preparati in Microsoft Places.

Preparare il file CSV

Formato dei dati badge: usare lo schema seguente durante il caricamento delle informazioni sulle notifiche.

• Ignorare le intestazioni di colonna CSV durante il caricamento di questi dati.

• I valori delle colonne CSV devono essere in ordine con lo schema indicato in precedenza.

• Percorso dell'utente per Places logica di mapping:

  Se DeviceId non è disponibile, ma LocationHint è disponibile, eseguire il mapping di LocationHint con PlaceName nella directory people e filtrare il mapping.

  Se sono disponibili sia LocationHint che DeviceId, eseguire il mapping di LocationHint con PlaceName nella directory people. Se non esegue il mapping, eseguire il mapping con PlaceIdFromDeviceInventory, altrimenti filtra il mapping che non esegue il mapping.

Contenuto del file di esempio CSV:

L'esempio seguente mostra due voci in un file 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 

Eseguire il push del segnale dei dati delle notifiche in Microsoft Places usando i cmdlet

Per altre informazioni sui cmdlet Microsoft Places, vedere il modulo Microsoft Places cmdlet per PowerShell.

1. Aprire PowerShell 7 (non come amministratore).

2. Installare Microsoft Places eseguendo il cmdlet di Windows PowerShell seguente. Per altre informazioni sull'installazione di Microsoft Places, vedere il Microsoft Places PowerShell Gallery.

   Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
   

3. Importare il modulo Microsoft Places eseguendo il cmdlet Windows PowerShell seguente.

   Import-Module -Name MicrosoftPlaces
   

4. Connettersi al modulo Microsoft Places eseguendo il cmdlet di PowerShell Places seguente.

   Connect-MicrosoftPlaces 
   

5. Caricare il set di dati delle notifiche dal percorso nel dispositivo (usando la cartella e il percorso) eseguendo il seguente Microsoft Places cmdlet di PowerShell.

   Push-Dataset -Type BadgeSwipe -Path C:\sensordata\
   

Si tratta di un'operazione CreateOrOverwrite. Ad esempio, i nuovi dati delle notifiche vengono sovrascritti nella cartella del giorno corrente.

Opzione 2: Automatizzare l'uso di Microsoft API Graph

I passaggi seguenti sono necessari per eseguire il push dei dati delle notifiche in Microsoft Places usando il API Graph:

• Scaricare i dati delle notifiche dai sistemi esistenti.
• Preparare la richiesta API usando il formato badge-data nella sezione seguente.

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

• Eseguire l'API per eseguire il push dei dati in Microsoft Places.

Formato dei dati badge signal-data

Eseguire il push del segnale dei dati delle notifiche in Microsoft Places usando Microsoft API Graph

Per creare un'applicazione per automatizzare il caricamento dei dati di telemetria, le API sono disponibili tramite Microsoft Graph. Per usare le API, seguire questa procedura.

1. Creare una registrazione dell'app in Microsoft Entra.

   Per altre informazioni sulle autorizzazioni PlaceDeviceRead.All e PlaceDevice.ReadWrite.All, vedere Informazioni di riferimento sulle autorizzazioni di Microsoft Graph.

2. Compilare e distribuire un'applicazione per sincronizzare i dati di telemetria tra Microsoft Places e i partner.

3. Usare l'API IngestTelemetry per eseguire il push dei dati delle notifiche in Microsoft Places.

Per altre informazioni, vedere workplaceSensorDevice.

Esempio:

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

Convalida dei dati e risoluzione dei problemi di compilazione dell'analisi

• Verificare che l'ID di posta elettronica dell'utente sottoposto a onboarding corrisponda all'ID di posta elettronica dell'utente in Microsoft Entra ID.
• Assicurarsi che la posizione dell'utente corrisponda alla posizione dell'utente in Microsoft Entra ID.
• Dovrebbe essere possibile visualizzare l'illuminazione del dashboard basato sull'occupazione dell'edificio entro 48 ore dopo l'onboarding dei dati del badge.

Considerazioni sulla sicurezza e sulla privacy per la compilazione di analisi

• La conservazione dei dati delle notifiche caricate è di 28 giorni. I dati elaborati aggregati vengono archiviati per 90 giorni.
• I dati vengono archiviati in Azure Data Lake conforme alla privacy.
• I leader con meno di 10 membri al loro interno non vengono visualizzati nella gerarchia dei leader a causa dei rischi per la privacy.
• I giorni con meno di 10 membri che arrivano negli edifici non vengono visualizzati nei dashboard effettivi per l'occupazione degli edifici a causa dei rischi per la privacy.