Freigeben über


Erstellen von Analysen

Arbeitsplaneinstellungen, die es Mitarbeitern ermöglichen, ihre Absicht anzugeben, in das Büro zu kommen, in Kombination mit tatsächlichen Gebäudebelegungsdaten, bieten Immobilien- und Facility-Managern ein wertvolles Tool, um die Nutzung von Gebäudeflächen zu verstehen, zu analysieren und zu optimieren.

Durch den Vergleich von Arbeitsplandaten, die die Absichten der Mitarbeiter widerspiegeln, mit tatsächlichen Belegungsdaten können Sie Diskrepanzen zwischen geplanter und realer Raumnutzung identifizieren.

Dies sind die Signale, die in der Gebäudeanalyse verwendet werden:

  • Gebäudenutzung basierend auf der Absicht, ins Büro zu kommen Beim Erstellen von Analysen werden Mitarbeiterarbeitspläne verwendet, um die absichtsgesteuerte Raumnutzung zu bewerten.

  • Gebäudenutzung basierend auf der tatsächlichen Belegung Bei der Gebäudeanalyse werden Badgedaten verwendet, um die Anzahl der in einem Gebäude anwesenden Mitarbeiter abzuleiten und ein Maß für die tatsächliche Gebäudebelegung bereitzustellen.

  • Personen Daten Microsoft Places Analysen verwendet API-Daten für Personenprofile, die aus Microsoft Entra ID Daten (oder) über externe Connectors stammen, um Mitarbeiter zu analysieren, die einem bestimmten Gebäude zugewiesen sind, und Mitarbeiter unter einer bestimmten Führungskraft. Diese Daten helfen bei der Zuordnung von Benutzern zu einem bestimmten Gebäude und verbessern die Datenabdeckung für Gebäudeanalysen.

Signal zur Erstellung von Analysen

Erstellen der Nutzungsabsicht

Bei der Erstellungsanalyse werden Arbeitsplandaten verwendet, um die beabsichtigte Gebäudebelegung und die erwarteten Hybridtrends nachzuverfolgen und Einblicke in die Präferenzen der Mitarbeiter bei Bürobesuchen zu erhalten.

Die Quelle für Arbeitsplandaten stammt aus der Einstellung Flexible Arbeitszeit (FWH), die benutzern in Microsoft Places und in der Outlook-App zur Verfügung steht. Die Arbeitsplandaten hängen von der Verfügbarkeit der Personendaten (aus Personenprofildatasets) ab. Personen Daten helfen bei der Zuordnung von Mitarbeitern, die Arbeitspläne festlegen, ohne Gebäude als ihr zugewiesenes Gebäude in Personendaten auszuwählen.

Gebäudenutzung basierend auf der tatsächlichen Belegung

Gebäudeanalysen verwenden Belegungsdaten, um die tatsächliche Anwesenheit von Personen in Gebäuden zu erkennen. Derzeit unterstützen wir die folgenden Gebäudebelegungsdaten:

  • Badge-Zugriffsdaten

Hinweis

Damit die Gebäudeanalysedashboards genaue Werte anzeigen können, müssen Personendaten den Gebäuden zugeordnet werden, die in Mirosoft Places integriert sind.

Im nächsten Abschnitt werden Details zum Onboarding von Personendaten sowie zum Onboarding von Gebäudebelegungsdaten behandelt.

Onboarding von Personendaten

Allgemeine Informationen

Microsoft Places Analytics verwendet die Personenprofil-API-Daten, um Benutzer einem bestimmten Standort/Gebäude zuzuordnen. Personen Profildaten pullen daten im Allgemeinen aus Microsoft Entra ID. Wenn Sie Connectors hinzugefügt haben, um Personendaten in Microsoft 365-Anwendungen zu übertragen, werden die relevanten Daten im Dataset für Das Personenprofil widergegeben.

  • Die zugewiesene Mitarbeiterzahl in der Gebäudeanalyse wird von der Zuordnung der Mitarbeiter zum Gebäude abgeleitet.

  • Damit die Funktionen des Leaderfilters korrekt funktionieren, muss die Zuordnung des Mitarbeitermanagers im Dataset für Personenprofile verfügbar sein.

Datenformat

Microsoft Places Analytics sucht nach bestimmten Feldern im Dataset für Personenprofile, um eine Zuordnung zwischen Mitarbeitern, ihren zugewiesenen Gebäuden und ihren Vorgesetzten zu erstellen.

  • OfficeLocation Dies ist die Personenprofil-API-Eigenschaft, die von Places verwendet wird, um einem Gebäude einen Mitarbeiter zuzuordnen.

Hinweis

Diese Eigenschaft muss mit dem in Places Directory festgelegten Gebäudenamen übereinstimmen, um die Zuordnung genau zu erstellen.

  • Manager Dies ist die Personenprofil-API-Eigenschaft, die von Places verwendet wird, um Benutzer ihren Führungskräften/Managern zuzuordnen.

Weitere Informationen zur Profil-API finden Sie unter Verwenden der Profil-API in Microsoft Graph zum Abrufen von Informationen zu sich selbst oder einem anderen Benutzer.

Datenaktualisierungen für Microsoft Entra ID

Um Personenprofildaten mit Anwesenheitsdaten abzugleichen, sollte deren Microsoft Entra ID Standort aktualisiert werden. Dies kann mit einer der folgenden Methoden erfolgen.

Azure-Portal

  1. Zugreifen auf die Azure-Portal: Wechseln Sie zum Azure-Portal, und melden Sie sich mit Ihren Anmeldeinformationen an.
  2. Navigieren Sie zu Azure Active Directory: Wählen Sie im linken Navigationsbereich Azure Active Directory aus.
  3. Benutzer suchen: Wählen Sie unter Verwaltendie Option Benutzer aus, und suchen Sie dann nach dem Benutzer, dessen Speicherort Sie aktualisieren möchten.
  4. Benutzerinformationen bearbeiten: Wählen Sie den Namen des Benutzers aus, um sein Profil zu öffnen, und wählen Sie dann Bearbeiten aus, um seine Informationen zu aktualisieren.
  5. Aktualisieren des Speicherorts: Im Abschnitt Auftragsinformationen können Sie die Standortdetails des Benutzers aktualisieren. Stellen Sie sicher, dass Sie Ihre Änderungen speichern.
  6. Update-Manager: Im Abschnitt Auftragsinformationen können Sie die Vorgesetztendetails des Benutzers aktualisieren. Stellen Sie sicher, dass Sie Ihre Änderungen speichern.

Weitere Informationen zum Aktualisieren Microsoft Entra ID Daten finden Sie unter Hinzufügen oder Aktualisieren der Profilinformationen und Einstellungen eines Benutzers im Microsoft Entra Admin Center.

Aktualisieren Microsoft Entra ID Attribute mithilfe eines PowerShell-Skripts

# Connect to Azure AD 
Connect-AzureAD

Aktualisieren des Benutzerspeicherorts

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

Weitere Informationen finden Sie unter Update-AzADUser.

Aktualisieren Microsoft Entra ID Attribute mithilfe von Graph-API

Beginnen Sie, indem Sie den Benutzerressourcentyp verstehen. Weitere Informationen finden Sie unter Benutzerressourcentyp.

Probe:

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

Datenüberprüfung und Problembehandlung

  • Die Eigenschaft "Headcount" im Microsoft Places Analytics-Dashboard sollte den erwarteten Wert aufweisen.
  • Der Leader filtert auf der Seite Gebäudeanalyse von Places Analysen und sollte die Daten des richtigen Leiters ausgefüllt haben.
  • Wenn die Änderungen durch Aktualisieren des Benutzerstandorts oder Vorgesetzten vorgenommen werden, sollte dies in Places Analysen innerhalb von 3 bis 4 Tagen widerzuspiegeln sein.
  • Verwenden Sie die Feedbackoption in der Anwendung, um Microsoft-Probleme zu senden, die bei Ihnen auftreten.

Überlegungen zu Sicherheit und Datenschutz

Microsoft Places Analytics aggregiert immer die Datenpunkte, um Gebäudenutzungsnummern anzuzeigen. Benutzer können keine Informationen zu bestimmten, einzelnen Mitarbeitern identifizieren. Microsoft Places verwendet die Personenprofildaten, die von anderen Microsoft 365-Anwendungen verwendet werden.

Onboarding von Badgedaten

Sie können vorhandene Badge-Zugriffssysteme verwenden, um Places Analytics-Bericht für Gebäudebelegungsdashboards zu verbessern.

Prozess zum Aktivieren von Badgedaten

  • Schritt 1: Hinzufügen von Signalzugriffsgeräten zu Microsoft Places (optional, aber dringend empfohlen).
  • Schritt 2: Hochladen von Badgedatentelemetriedaten in Microsoft Places.

Hinweis

Personen Daten sollten den interessierten Gebäuden in Microsoft Places vor dem Onboarding von Badgedaten zur Verfügung stehen. Badgedaten werden anhand der Personen Daten überprüft. Das System filtert die Badgedaten von Benutzern heraus, die nicht Microsoft Places zugeordnet sind.

Schritt 1: Hinzufügen von Geräten mit Badgezugriff zu Microsoft Places

Der erste Schritt umfasst das Hochladen von Gerätemetadaten für den Badgezugriff und das Zuordnen von Geräten zu einer PlaceId in Microsoft Places. Dieser Schritt hilft bei der Kontextualisierung der Signalsignale, wenn es Microsoft Places erreicht. Sie können Geräte mit Signalzugriff Microsoft Places mit zwei Optionen hinzufügen:

  • Option 1: Verwenden von PowerShell-Cmdlets
  • Option 2: Verwenden von Microsoft Graph-APIs
Option 1: Verwenden von PowerShell-Cmdlets

PowerShell-Cmdlets stehen zum Verwalten von Geräten in Microsoft Places zur Verfügung. Weitere Informationen zu Microsoft Places Cmdlets finden Sie im Modul Microsoft Places Cmdlets für PowerShell.

Hinweis

Zum Ausführen von Cmdlets muss Ihnen die Rolle TenantPlacesManagement zugewiesen sein.

Gerätedatenformate für Cmdlets
Spalte Beschreibung Anmerkungen Beispiel
DeviceId (erforderlich) Der eindeutige Bezeichner des Geräts (empfohlen: Manufacturer_DeviceUniqueId). Muss mit der ID der gesendeten Telemetriedaten übereinstimmen. Manuf1_3455
DisplayName Der Anzeigename des Geräts. Sie können ggf. einen Anzeigenamen verwenden. Manuf1_3455
Beschreibung Die Beschreibung des Geräts.
MacAddress Die Mac-Adresse des Geräts. Lieferant bereitgestellt (falls verfügbar).
Hersteller (erforderlich) Der Hersteller des Geräts. Vom IT-Administrator bereitgestellt. Manuf1
IPV4Address Die IPV4Address des Geräts. Lieferant bereitgestellt (falls verfügbar).
IPV6Address Die IPV6Address des Geräts. Lieferant bereitgestellt (falls verfügbar).
PlaceId Die PlaceId, der Ihr Gerät in Places zugeordnet ist. Der IT-Administrator ordnet deviceID dem Feld DisplayName aus einer Liste von Räumen zu. 76fe540f-01a9-425e-acd5-5d7d1da44fbf
Tags Eine Liste der benutzerdefinierten Tags, die dem Gerät zugeordnet sind, um die Suche zu erleichtern. ["IsVirtual_False", "Building_121"]
Sensor.SensorId Der eindeutige Bezeichner eines Sensors innerhalb des Geräts. Muss in der Standardtelemetrienutzlast enthalten sein. Abzeichen
Sensor.DisplayName Der Anzeigename des Sensors. Sie können einen Anzeigenamen verwenden (falls zutreffend). Büroklammer
Sensor.SensorType (erforderlich) Der Typ des Sensors. Eine überprüfte Liste (siehe Beispiele). Abzeichen
Sensor.PlaceId Der eindeutige Bezeichner des Orts, der vom Sensor bereitgestellt wird (Sie müssen diese Informationen nur angeben, wenn sich der Sensor an einem anderen Ort befindet als der Standort des Geräts). 76fe540f-01a9-425e-acd5-5d7d1da44fbf
Hinzufügen eines Badgezugriffsgeräts zu Microsoft Places mithilfe von Cmdlets

[!div class="mx-tdBreakAll"]

Cmdlet-Name Beschreibung Parameter
New-PlaceDevice Erstellt ein neues Gerät. DeviceId (erforderlich), DisplayName, Description, MACAddress, Manufacturer (erforderlich), IPV4Address, IPV6Address, PlaceId (erforderlich), TagsSensors (erforderlich)
Remove-PlaceDevice Löscht ein Gerät. ID (erforderlich)
Set-PlaceDevice Updates ein Gerät. ID (erforderlich), DeviceId (erforderlich), DisplayName, Description, MACAddress, Manufacturer (erforderlich), IPV4Address, IPV6Address, PlaceId, Tags, Sensors (erforderlich)
Get-PlaceDevice Ruft ein Gerät ab. Id, Filter, Top

Schritte: Verwenden von PowerShell-Cmdlets

  1. Öffnen Sie PowerShell 7 (nicht als Administrator).

  2. Installieren Sie Microsoft Places, indem Sie das folgende Windows PowerShell-Cmdlet ausführen. Weitere Informationen zur installation Microsoft Places finden Sie im Microsoft Places PowerShell-Katalog.

    Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
    
  3. Importieren Sie das Microsoft Places-Modul, indem Sie das folgende Windows PowerShell-Cmdlet ausführen.

    Import-Module -Name MicrosoftPlaces 
    
  4. Stellen Sie nach dem Installieren und Importieren des Moduls eine Verbindung mit dem Microsoft Places Modul her, indem Sie das folgende Microsoft Places PowerShell-Cmdlet ausführen.

    Connect-MicrosoftPlaces
    
  5. Verwenden Sie New-PlaceDevice Cmdlet, um ein Signalzugriffsgerät hinzuzufügen.

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

    Hinweis

    Der Sensors-Parameter in diesem Beispiel ist ein Objekt vom Typ MicrosoftPlaces.PlacesDevices.Sensor mit den im Beispiel erwähnten Feldern.

  6. Verwenden Sie Get-PlaceDevice, um eine Liste der Geräte anzuzeigen. Standardmäßig werden 10 Geräte zurückgegeben. Um weitere Geräte zurückzugeben, fügen Sie den Parameter -top hinzu, wie in diesem Beispiel gezeigt.

    Get-PlaceDevice -top 100 
    
  7. Verwenden Sie Set-PlaceDevice, um ein Gerät mit einer vorhandenen ID zu aktualisieren.

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

    Hinweis

    Geben Sie Beim Aktualisieren eines Geräts Details zu allen Parametern (obligatorisch und optional) an. Wenn kein Parameterwert vorhanden ist, wird der Wert auf den leeren Standardwert zurückgesetzt.

  8. Verwenden Sie Remove-PlaceDevice, um ein Gerät zu löschen.

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

Schritte: Verwenden des Microsoft-Graph-API

ApIs sind über Microsoft Graph verfügbar, um eine Anwendung zu erstellen, um die Registrierung und das Onboarding von Geräten mit Zugriff auf Badges zu automatisieren. Führen Sie die folgenden Schritte aus, um APIs zu verwenden.

  1. Erstellen Sie eine App-Registrierung in Microsoft Entra. Weitere Informationen zu den Berechtigungen PlaceDeviceRead.All und PlaceDevice.ReadWrite.All finden Sie in der Microsoft Graph-Berechtigungsreferenz.
  2. Erstellen und bereitstellen Sie eine Anwendung, um Geräteinformationen über Microsoft Places und Ihre Partner hinweg zu synchronisieren.
Im Microsoft-Graph-API verwendete Gerätedatenformate
Spalte Beschreibung Anmerkungen Beispiel
DeviceId (erforderlich) Der eindeutige Bezeichner des Geräts (empfohlen: Manufacturer_DeviceUniqueId). Muss mit der ID der gesendeten Telemetriedaten übereinstimmen. Manuf1_3455
DisplayName Der Anzeigename des Geräts. Sie können ggf. einen Anzeigenamen verwenden. Manuf1_3455
Beschreibung Die Beschreibung des Geräts.
MacAddress Die Mac-Adresse des Geräts. Lieferant bereitgestellt (falls verfügbar).
Hersteller (erforderlich) Der Hersteller des Geräts. Vom IT-Administrator bereitgestellt. Manuf1
IPV4Address Die IPV4Address des Geräts. Lieferant bereitgestellt, falls verfügbar.
IPV6Address Die IPV6Address des Geräts. Lieferant bereitgestellt, falls verfügbar.
PlaceId (erforderlich) Die PlaceId, der Ihr Gerät in Microsoft Places zugeordnet ist. Der IT-Administrator ordnet deviceID dem Feld DisplayName aus einer Liste von Räumen zu. 76fe540f-01a9-425e-acd5-5d7d1da44fbf
Tags Eine Liste der benutzerdefinierten Tags, die dem Gerät zugeordnet sind, um die Suche zu erleichtern. ["IsVirtual_False", "Building_121"]
Sensor.SensorId (erforderlich) Der eindeutige Bezeichner eines Sensors innerhalb des Geräts. Muss in der Standardtelemetrienutzlast enthalten sein. Abzeichen
Sensor.DisplayName Der Anzeigename des Sensors. Sie können einen Anzeigenamen verwenden (falls zutreffend). Büroklammer
Sensor.SensorType (erforderlich) Der Typ des Sensors. Eine überprüfte Liste (siehe Beispiele). Abzeichen
Sensor.PlaceId Der eindeutige Bezeichner des Orts, der vom Sensor bereitgestellt wird (Sie müssen diese Informationen nur angeben, wenn sich der Sensor an einem anderen Ort befindet als der Standort des Geräts). 76fe540f-01a9-425e-acd5-5d7d1da44fbf

Weitere Informationen zu Sensorgeräten finden Sie in den folgenden Microsoft Graph-APIs:

GET https://graph.microsoft.com/beta/workplace/sensorDevices 
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" 
        } 
    ] 
}  
GET https://graph.microsoft.com/beta/workplace/sensorDevices/052062b9-38f6-48d4-a638-05a72c79419b  
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" 
        } 
    ] 
}  
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  

Hochladen von Signaldatentelemetriedaten in Microsoft Places

Laden Sie Daten aus Ihrem Signaleingabesystem hoch, um Gebäudebelegungsdashboards in Places Analytics zu generieren.

  • Die DeviceId wird verwendet, um das Badge-Ereignis einem bestimmten Gebäude zuzuordnen. Wenn keine DeviceId vorhanden ist, wird LocationHint verwendet. Es wird dringend empfohlen, das Onboarding Ihrer Geräte durchzuführen, um die Gebäudebelegung genau zuzuordnen.

  • LocationHint muss mit dem Gebäudenamen in Microsoft Places Verzeichnis übereinstimmen, wenn Sie keine Geräte in Microsoft Places integriert haben.

  • Benutzer aus Badge-Daten werden anhand Personen Daten (aus der Profil-API) überprüft, um sie auf der Seite Gebäudeanalyse verfügbar zu machen.

Option 1: Verwenden des Cmdlets Push-Dataset

Diese Schritte sind erforderlich, um Badgedaten per Push an Microsoft Places:

  • Laden Sie Badgedaten aus vorhandenen Systemen herunter.
  • Bereiten Sie die CSV-Datei gemäß dem badge-data-Format im folgenden Abschnitt vor.
  • Übertragen Sie vorbereitete CSV-Daten per Push an Microsoft Places.
Vorbereiten der CSV-Datei

Signaldatenformat: Verwenden Sie beim Hochladen von Badgeinformationen das folgende Schema.

Spalte Typ Beschreibung
DeviceId Zeichenfolge Optional. Die Geräte-ID gibt an, welches Gerät das Signal generiert hat.
EventType Zeichenfolge Die Aktion des Badges, die vom Sensortyp abhängt. Der Wert kann BadgeIn sein.
UserID Zeichenfolge Optional. Die gekennzeichnete Benutzer-ID.
UserName Zeichenfolge Optional. Der badged-Benutzername.
E-Mail-Adresse des Benutzers String Die gekennzeichnete Benutzer-E-Mail-Adresse.
LocationHint String Gebäudename. Speicherort, von dem das Signalsignal in aufgezeichnet wird.
IngestionTime Zeitstempel Der Zeitstempel des Signalsignals, der angibt, wann das Ereignis aufgetreten ist.
  • Überspringen Sie die CSV-Spaltenüberschriften beim Hochladen dieser Daten.

  • CSV-Spaltenwerte sollten mit dem zuvor erwähnten Schema in der Richtigen sein.

  • Standort des Benutzers zum Places Zuordnungslogik:

    Wenn die DeviceId nicht verfügbar ist, LocationHint aber verfügbar ist, ordnen Sie LocationHint mit PlaceName im Verzeichnis people zu, und filtern Sie heraus, was nicht zugeordnet wird.

    Wenn sowohl LocationHint als auch DeviceId verfügbar sind, ordnen Sie LocationHint mit PlaceName im Verzeichnis people zu. Wenn die Zuordnung nicht erfolgt, wird die Zuordnung mit PlaceIdFromDeviceInventory durchgeführt, andernfalls wird heraus gefiltert, was nicht zugeordnet wird.

Inhalt der CSV-Beispieldatei:

Das folgende Beispiel zeigt zwei Einträge in einer CSV-Datei.

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 

Senden eines Signaldatensignals an Microsoft Places mithilfe von Cmdlets

Weitere Informationen zu Microsoft Places Cmdlets finden Sie im Modul Microsoft Places Cmdlets für PowerShell.

Hinweis

Zum Ausführen Microsoft Places Cmdlets muss Ihnen die Rolle TenantPlacesManagement zugewiesen sein.

  1. Öffnen Sie PowerShell 7 (nicht als Administrator).

  2. Installieren Sie Microsoft Places, indem Sie das folgende Windows PowerShell-Cmdlet ausführen. Weitere Informationen zur installation Microsoft Places finden Sie im Microsoft Places PowerShell-Katalog.

    Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
    
  3. Importieren Sie das Microsoft Places-Modul, indem Sie das folgende Windows PowerShell-Cmdlet ausführen.

    Import-Module -Name MicrosoftPlaces
    
  4. Stellen Sie eine Verbindung mit dem Microsoft Places-Modul her, indem Sie das folgende Places PowerShell-Cmdlet ausführen.

    Connect-MicrosoftPlaces 
    
  5. Laden Sie das Badgedataset aus dem Speicherort auf Ihrem Gerät hoch (unter Verwendung des Ordners und Pfads), indem Sie das folgende Microsoft Places PowerShell-Cmdlet ausführen.

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

Dies ist ein CreateOrOverwrite-Vorgang. Beispielsweise werden neue Signaldaten in den Aktuellen Tagordner überschrieben.

Option 2: Automatisieren mit dem Microsoft Graph-API

Die folgenden Schritte sind erforderlich, um Badgedaten mithilfe des Graph-API an Microsoft Places zu pushen:

  • Laden Sie Badgedaten aus vorhandenen Systemen herunter.
  • Bereiten Sie die API-Anforderung mithilfe des Badge-Data-Formats im folgenden Abschnitt vor.
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" 
        } 
    ] 
} 
  • Führen Sie die API aus, um die Daten per Push an Microsoft Places.
Signaldatensignal-Datenformat
Parameter Typ Beschreibung
Telemetrie (erforderlich) workplaceSensorDeviceTelemetry, collectionText Eine Sammlung der Telemetriedaten, die von einem Sensor auf einem Signalgerät gesammelt und gemeldet werden.
deviceId String Der benutzerdefinierte eindeutige Bezeichner des Geräts, das zum Zeitpunkt der Erstellung bereitgestellt wurde. Verwenden Sie nicht den vom System generierten Bezeichner des Geräts.
locationHint String Die zusätzlichen Informationen, um den Standort des Geräts anzugeben.
Zeitstempel (erforderlich) DateTimeOffset Das Datum und die Uhrzeit, zu dem der Sensor seinen Wert gemessen und gemeldet hat. Der Zeitstempeltyp stellt Datums- und Uhrzeitinformationen im ISO 8601-Format dar und ist immer in UTC angegeben. Mitternacht UTC am 1. Januar 2024 lautet beispielsweise 2024-01-01T00:00:00Z.
sensorType (erforderlich) workplaceSensorType Der Typ des Sensors. Die möglichen Werte sind: Badge.
eventValue (erforderlich) workplaceSensorEventValue Die zusätzlichen Werte, die Signalsignalen zugeordnet sind.
eventValue.eventType (erforderlich) workplaceSensorEventType Der Typ des möglichen Sensorereigniswerts. Mögliche Werte: badgeIn.
eventValue.user (erforderlich) emailIdentity Der eindeutige Bezeichner eines Benutzers. Dabei kann es sich um eine E-Mail oder eine Microsoft Entra ID.
eventValue.user.displayName String Der Anzeigename des Benutzers. Geerbt von der Identität.
eventValue.user.email (erforderlich) String Email Adresse des Benutzers.
eventValue.user.id String Der eindeutige Bezeichner des Benutzers. Geerbt von der Identität.

Senden eines Signaldatensignals an Microsoft Places mithilfe von Microsoft Graph-API

Um eine Anwendung zum Automatisieren und Hochladen von Telemetriedaten zu erstellen, sind APIs über Microsoft Graph verfügbar. Führen Sie die folgenden Schritte aus, um APIs zu verwenden.

  1. Erstellen Sie eine App-Registrierung in Microsoft Entra.

    Weitere Informationen zu den Berechtigungen PlaceDeviceRead.All und PlaceDevice.ReadWrite.All finden Sie in der Microsoft Graph-Berechtigungsreferenz.

  2. Erstellen Sie eine Anwendung, und stellen Sie sie bereit, um Telemetriedaten über Microsoft Places und Ihre Partner hinweg zu synchronisieren.

  3. Verwenden Sie die IngestTelemetry-API, um Badgedaten per Push an Microsoft Places.

Weitere Informationen finden Sie unter workplaceSensorDevice.

Beispiel:

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

Datenüberprüfung und Problembehandlung beim Erstellen von Analysen

  • Stellen Sie sicher, dass die E-Mail-ID des integrierten Benutzers mit der Benutzer-E-Mail-ID in Microsoft Entra ID übereinstimmt.
  • Stellen Sie sicher, dass der Benutzerstandort mit dem Benutzerstandort in Microsoft Entra ID übereinstimmt.
  • Sie sollten in der Lage sein, gebäudebelegungsbasierte Dashboard innerhalb von 48 Stunden nach dem Onboarding der Badgedaten anzuzeigen.

Sicherheits- und Datenschutzaspekte beim Erstellen von Analysen

  • Die Datenaufbewahrung für hochgeladene Badges beträgt 28 Tage. Aggregierte verarbeitete Daten werden 90 Tage lang gespeichert.
  • Daten werden in datenschutzkonformem Azure Data Lake gespeichert.
  • Führungskräfte mit weniger als 10 Mitgliedern werden aufgrund von Datenschutzrisiken nicht in der Führungshierarchie angezeigt.
  • Tage mit weniger als 10 Mitgliedern, die zu Gebäuden kommen, werden aufgrund von Datenschutzrisiken nicht in den Dashboards für die tatsächliche Gebäudebelegung angezeigt.