Создание аналитики

Статья
11/14/2024

Параметры плана работы, которые позволяют сотрудникам указать свое намерение прийти в офис, в сочетании с фактическими данными о занятости здания, предложить менеджерам недвижимости и объектов ценный инструмент для понимания, анализа и оптимизации использования пространства в здании.

Сравнивая данные плана работы, отражающие намерения сотрудников, с фактическими данными о занятости, можно выявить несоответствия между запланированным и реальным использованием пространства.

Ниже приведены сигналы, используемые при создании аналитики:

Использование здания на основе намерения войти в офис Создание аналитики использует планы работы сотрудников для оценки использования пространства на основе намерений.
Использование здания на основе фактической занятости Аналитика зданий использует данные эмблемы для определения количества сотрудников, присутствующих в здании, обеспечивая меру фактической занятости здания.
Люди данных Microsoft Places аналитика использует данные API профилей людей, полученные из Microsoft Entra ID данных (или) через внешние соединители, для анализа сотрудников, назначенных определенному зданию, и сотрудников определенного руководителя. Эти данные помогают сопоставлять пользователей с конкретным зданием, повышая охват данных для аналитики здания.

Создание сигнала аналитики

Создание использования на основе намерения использования

Аналитика здания использует данные плана работы для отслеживания предполагаемой заполняемости здания и ожидаемых гибридных тенденций, предоставляя представление о предпочтениях сотрудников при посещении офисов.

Источником данных плана работы является настройка гибких рабочих часов (FWH), доступная для пользователей в Microsoft Places и в приложении Outlook. Данные плана работы зависят от доступности данных о людях (из наборов данных профиля людей). Люди данные помогают сопоставлять сотрудников, которые устанавливают рабочие планы, не выбирая здания в качестве назначенных зданий в данных о людях.

Использование здания на основе фактической занятости

Аналитика зданий использует данные о занятости для обнаружения фактического присутствия людей в зданиях. В настоящее время мы поддерживаем следующие данные о заполнении здания:

Данные доступа к индикаторам событий

Примечание.

Чтобы панели мониторинга аналитики зданий отображали точные значения, данные о людях должны быть сопоставлены со зданиями, подключенными к Mirosoft Places.

В следующем разделе мы рассмотрим сведения о подключении данных о людях, а также о подключении данных о занятости здания.

Подключение данных о людях

Общие сведения

Microsoft Places аналитика использует данные API профиля пользователей для связывания пользователей с определенным расположением или зданием. Люди данные профиля обычно извлекает данные из Microsoft Entra ID, и если вы добавили соединители для переноса данных о людях в приложения Microsoft 365, соответствующие данные отражаются в наборе данных профиля людей.

Назначенная учетная запись в аналитике здания является производным от сотрудника к сопоставлению здания.
Чтобы функции фильтра лидеров точно функционировали, сопоставление руководителей сотрудников должно быть доступно в наборе данных профиля людей.

Формат данных

Microsoft Places аналитика ищет определенный набор полей в наборе данных профиля людей для создания сопоставления между сотрудниками, назначенными ими зданиями и руководителями.

OfficeLocation Это свойство API профиля людей, используемое Places для связывания сотрудника со зданием.

Примечание.

Чтобы точно создать сопоставление, это свойство должно совпадать с именем здания, заданным в каталоге Places.

Управляющий Это свойство API профиля людей, используемое Places для связывания пользователей с руководителями и руководителями.

Дополнительные сведения об API профиля см. в статье Использование API профиля в Microsoft Graph для получения сведений о себе или другом пользователе.

Обновления данных в Microsoft Entra ID

Чтобы сопоставить данные профиля пользователей с данными о посещаемости, необходимо обновить их Microsoft Entra ID расположение. Это можно сделать одним из следующих методов.

Портал Azure

Доступ к портал Azure. Перейдите к портал Azure и войдите в систему, используя свои учетные данные.
Перейдите к Azure Active Directory: в области навигации слева выберите Azure Active Directory.
Найдите пользователя: в разделе Управление выберите Пользователи, а затем найдите пользователя, расположение которого требуется обновить.
Изменить сведения о пользователе. Выберите имя пользователя, чтобы открыть его профиль, а затем нажмите кнопку Изменить , чтобы обновить сведения.
Обновление расположения. В разделе Сведения о задании можно обновить сведения о расположении пользователя. Обязательно сохраните изменения.
Диспетчер обновлений. В разделе Сведения о задании можно обновить сведения о диспетчере пользователя. Обязательно сохраните изменения.

Дополнительные сведения об обновлении данных Microsoft Entra ID см. в статье Добавление или обновление сведений профиля пользователя и параметров в Центр администрирования Microsoft Entra.

Обновление атрибутов Microsoft Entra ID с помощью скрипта PowerShell

# Connect to Azure AD 
Connect-AzureAD

Обновление расположения пользователя

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

Дополнительные сведения см. в разделе Update-AzADUser.

Обновление атрибутов Microsoft Entra ID с помощью API Graph

Начните с определения типа ресурса пользователя. Дополнительные сведения см. в разделе Тип ресурса пользователя.

Войдите в Graph Explore. Дополнительные сведения см. в разделе Graph Обозреватель.
Вызов пользователя Update. Дополнительные сведения см. в разделе Обновление пользователя.

Образец:

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

Проверка данных и устранение неполадок

Свойство headcount на панели мониторинга аналитики Microsoft Places должно иметь ожидаемое значение.
Лидер фильтрует на странице Аналитика здания Places аналитики и должен заполнить нужные данные руководителя.
Если изменения вносятся путем обновления расположения пользователя или руководителя, они должны быть отражены в Places аналитике в течение 3–4 дней.
Используйте параметр обратной связи в приложении для отправки проблем Корпорации Майкрософт, с которыми вы столкнулись.

Вопросы безопасности и конфиденциальности

Microsoft Places аналитика всегда агрегирует точки данных для отображения номеров использования здания. Пользователи не могут идентифицировать сведения о каких-либо конкретных отдельных сотрудниках. Microsoft Places использует данные профиля людей, используемые другими приложениями Microsoft 365.

Данные индикатора подключения

Существующие системы доступа к индикаторам событий можно использовать для улучшения Places отчета Аналитики о создании панелей мониторинга занятости.

Процесс включения данных эмблемы

Шаг 1. Добавление устройств доступа с эмблемами в Microsoft Places (необязательно, но настоятельно рекомендуется).
Шаг 2. Отправка данных телеметрии эмблемы в Microsoft Places.

Примечание.

Люди данные должны быть доступны для заинтересованных зданий в Microsoft Places перед подключением данных индикатора. Данные эмблемы проверяются на соответствие данным Люди. Система отфильтровывает данные эмблемы пользователей, которые не сопоставлены с Microsoft Places.

Шаг 1. Добавление устройств с доступом к эмблемам в Microsoft Places

Первый шаг включает в себя передачу метаданных устройства для доступа к индикатору событий и сопоставление устройств с PlaceId в Microsoft Places. Этот шаг помогает контекстуализировать сигналы эмблемы по достижении Microsoft Places. Вы можете добавить устройства доступа к индикаторам событий в Microsoft Places с помощью двух вариантов:

Вариант 1. Использование командлетов PowerShell
Вариант 2. Использование API Microsoft Graph

Вариант 1. Использование командлетов PowerShell

Командлеты PowerShell доступны для управления устройствами в Microsoft Places. Дополнительные сведения о командлетах Microsoft Places см. в модуле Microsoft Places командлетов для PowerShell.

Примечание.

Для выполнения командлетов необходимо назначить роль TenantPlacesManagement.

Форматы данных устройства для командлетов

Столбец	Описание	Примечания	Пример
DeviceId (обязательный)	Уникальный идентификатор устройства (рекомендуется: Manufacturer_DeviceUniqueId).	Должен соответствовать идентификатору отправленной телеметрии.	Manuf1_3455
DisplayName	Отображаемое имя устройства.	При необходимости можно использовать понятное имя.	Manuf1_3455
Описание	Описание устройства.
MacAddress	Mac-адрес устройства.	Поставщик предоставлен (при наличии).
Производитель (обязательно)	Производитель устройства.	Предоставляется ИТ-администратором.	Manuf1
IPV4Address	IPV4Address устройства.	Поставщик предоставлен (при наличии).
IPV6Address	IPV6Address устройства.	Поставщик предоставлен (при наличии).
PlaceId	Идентификатор PlaceId, с которым устройство сопоставлено в Places.	ИТ-администратор сопоставляет DeviceID с полем DisplayName из списка комнат.	76fe540f-01a9-425e-acd5-5d7d1da44fbf
Tags	Список настраиваемых тегов, связанных с устройством, которые помогут с поиском.		["IsVirtual_False", "Building_121"]
Sensor.SensorId	Уникальный идентификатор датчика в устройстве.	Должны входить в стандартные полезные данные телеметрии.	Значок
Sensor.DisplayName	Отображаемое имя датчика.	Можно использовать понятное имя (если применимо).	Скрепки
Sensor.SensorType (обязательно)	Тип датчика.	Проверенный список (см. примеры).	Значок
Sensor.PlaceId	Уникальный идентификатор места, обслуживаемого датчиком (необходимо указать эту информацию только в том случае, если датчик находится в другом месте, отличном от расположения устройства).		76fe540f-01a9-425e-acd5-5d7d1da44fbf

Добавление устройства с доступом к эмблемам в Microsoft Places с помощью командлетов

[!div class="mx-tdBreakAll"]

Имя командлета	Описание	Параметры
New-PlaceDevice	Создает новое устройство.	DeviceId (обязательный), DisplayName, Description, MACAddress, Manufacturer (обязательно), IPV4Address, IPV6Address, PlaceId (обязательно), TagsSensors (обязательно)
Remove-PlaceDevice	Удаляет устройство.	Идентификатор (обязательный)
Set-PlaceDevice	Обновления устройство.	Id (обязательный), DeviceId (обязательный), DisplayName, Description, MACAddress, Manufacturer (обязательно), IPV4Address, IPV6Address, PlaceId, Tags, Sensors (обязательно)
Get-PlaceDevice	Возвращает устройство.	Id, Filter, Top

Действия. Использование командлетов PowerShell

Откройте PowerShell 7 (не от имени администратора).
Установите Microsoft Places, выполнив следующий командлет Windows PowerShell. Дополнительные сведения об установке Microsoft Places см. в Microsoft Places коллекция PowerShell.
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
Импортируйте модуль Microsoft Places, выполнив следующий командлет Windows PowerShell.
```
Import-Module -Name MicrosoftPlaces 
```
После установки и импорта модуля подключитесь к модулю Microsoft Places, выполнив следующий командлет PowerShell Microsoft Places.
```
Connect-MicrosoftPlaces
```

Используйте командлет New-PlaceDevice для добавления устройства доступа к индикаторам событий.

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

Примечание.

Параметр Sensors в этом примере представляет собой объект типа MicrosoftPlaces.PlacesDevices.Sensor с полями, указанными в примере.

Используйте Get-PlaceDevice для просмотра списка устройств. По умолчанию возвращается 10 устройств. Чтобы вернуть больше устройств, добавьте параметр -top, как показано в этом примере.
```
Get-PlaceDevice -top 100 
```
Используйте Set-PlaceDevice, чтобы обновить устройство с помощью существующего идентификатора.
```
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"})
```
Примечание.

Укажите сведения обо всех параметрах (обязательных и необязательных) при обновлении устройства. При отсутствии значения параметра он сбрасывает значение до пустого значения по умолчанию.
Используйте Remove-PlaceDevice для удаления устройства.
```
Remove-PlaceDevice -Id "e5a216ff-1d32-4647-8dab-a2523ee5796e"  
```

Действия. Использование microsoft API Graph

Чтобы создать приложение для автоматизации регистрации и подключения устройств с доступом к индикаторам событий, API доступны через Microsoft Graph. Чтобы использовать API, выполните следующие действия.

Создайте регистрацию приложения в Microsoft Entra. Дополнительные сведения о разрешениях PlaceDeviceRead.All и PlaceDevice.ReadWrite.All см. в справочнике по разрешениям Microsoft Graph.
Создание и развертывание приложения для синхронизации сведений об устройстве между Microsoft Places и партнерами.

Форматы данных устройства, используемые в microsoft API Graph

Столбец	Описание	Примечания	Пример
DeviceId (обязательный)	Уникальный идентификатор устройства (рекомендуется: Manufacturer_DeviceUniqueId).	Должен соответствовать идентификатору отправленной телеметрии.	Manuf1_3455
DisplayName	Отображаемое имя устройства.	При необходимости можно использовать понятное имя.	Manuf1_3455
Описание	Описание устройства.
MacAddress	Mac-адрес устройства.	Поставщик предоставлен (при наличии).
Производитель (обязательно)	Производитель устройства.	Предоставляется ИТ-администратором.	Manuf1
IPV4Address	IPV4Address устройства.	Поставщик предоставлен, если он доступен.
IPV6Address	IPV6Address устройства.	Поставщик предоставлен, если он доступен.
PlaceId (обязательный)	Идентификатор PlaceId, с которым устройство сопоставлено в Microsoft Places.	ИТ-администратор сопоставляет DeviceID с полем DisplayName из списка комнат.	76fe540f-01a9-425e-acd5-5d7d1da44fbf
Tags	Список настраиваемых тегов, связанных с устройством, которые помогут с поиском.		["IsVirtual_False", "Building_121"]
Sensor.SensorId (обязательно)	Уникальный идентификатор датчика в устройстве.	Должны входить в стандартные полезные данные телеметрии.	Значок
Sensor.DisplayName	Отображаемое имя датчика.	Можно использовать понятное имя (если применимо).	Скрепки
Sensor.SensorType (обязательно)	Тип датчика.	Проверенный список (см. примеры).	Значок
Sensor.PlaceId	Уникальный идентификатор места, обслуживаемого датчиком (необходимо указать эту информацию только в том случае, если датчик находится в другом месте, отличном от расположения устройства).		76fe540f-01a9-425e-acd5-5d7d1da44fbf

Дополнительные сведения об устройствах с датчиками см. в следующих API Microsoft Graph:

Просмотр устройств доступа к эмблемам: список датчиковУстройства.

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

Создание новых устройств для доступа к эмблемам: создание 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" 
        } 
    ] 
}

Просмотр определенного устройства: Get workplaceSensorDevice.

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

Обновление существующих устройств с доступом к значкам: обновление 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" 
        } 
    ] 
}

Удаление устройства: удаление 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

Отправка данных телеметрии эмблемы в Microsoft Places

Отправьте данные из системы ввода значков для создания панелей мониторинга занятости здания в Places Analytics.

Идентификатор устройства используется для сопоставления события эмблемы с определенным зданием. При отсутствии DeviceId используется LocationHint. Мы настоятельно рекомендуем подключить устройства, чтобы точно сопоставить заполненность здания.
LocationHint должен соответствовать имени здания в каталоге Microsoft Places, если вы не подсоединили устройства к Microsoft Places.
Пользователи из данных эмблемы проверяются на соответствие Люди данным (из API профиля), чтобы сделать их доступными на странице Аналитика здания.

Вариант 1. Использование командлета Push-Dataset

Для отправки данных эмблемы в Microsoft Places необходимо выполнить следующие действия:

Скачайте данные эмблемы из существующих систем.
Подготовьте CSV-файл в соответствии с форматом эмблемы с данными в следующем разделе.
Отправка подготовленных данных CSV в Microsoft Places.

Подготовка CSV-файла

Формат данных индикатора событий. При отправке сведений о эмблеме используйте следующую схему.

Столбец	Тип	Описание
DeviceId	String	Необязательный параметр. Идентификатор устройства указывает, какое устройство создало сигнал.
EventType	String	Действие значка, которое зависит от типа датчика. Значением может быть BadgeIn.
UserID	String	Необязательный параметр. Идентификатор пользователя с эмблемой.
UserName	String	Необязательный параметр. Имя пользователя с эмблемой.
Электронный адрес пользователя	String	Адрес электронной почты пользователя с эмблемой.
LocationHint	String	Имя здания. Расположение, откуда записан сигнал индикатора событий.
IngestionTime	Timestamp	Метка времени сигнала индикатора событий, указывающая, когда произошло событие.

Пропустите заголовки столбцов CSV при отправке этих данных.
Значения столбцов CSV должны быть в порядке, указанном в схеме, упомянутой ранее.
Расположение пользователя для логики сопоставления Places:

Если Идентификатор устройства недоступен, но LocationHint доступен, сопоставьте LocationHint с PlaceName в каталоге людей и отфильтрует, что не сопоставляется.

Если доступны и LocationHint, и DeviceId, сопоставьте LocationHint с PlaceName в каталоге людей. Если он не сопоставляется, сопоставляется с PlaceIdFromDeviceInventory, в противном случае фильтрует, который не сопоставляется.

Содержимое примера csv-файла:

В следующем примере показаны две записи в 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

Отправка сигнала данных индикатора Microsoft Places с помощью командлетов

Дополнительные сведения о командлетах Microsoft Places см. в модуле Microsoft Places командлетов для PowerShell.

Примечание.

Для выполнения командлетов Microsoft Places должна быть назначена роль TenantPlacesManagement.

Откройте PowerShell 7 (не от имени администратора).
Установите Microsoft Places, выполнив следующий командлет Windows PowerShell. Дополнительные сведения об установке Microsoft Places см. в Microsoft Places коллекция PowerShell.
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
Импортируйте модуль Microsoft Places, выполнив следующий командлет Windows PowerShell.
```
Import-Module -Name MicrosoftPlaces
```
Подключитесь к модулю Microsoft Places, выполнив следующий командлет Places PowerShell.
```
Connect-MicrosoftPlaces 
```
Отправьте набор данных индикатора событий из расположения на устройстве (с помощью папки и пути), выполнив следующий командлет PowerShell Microsoft Places.
```
Push-Dataset -Type BadgeSwipe -Path C:\sensordata\
```

Это операция CreateOrOverwrite. Например, новые данные эмблемы перезаписываются в папку текущего дня.

Вариант 2. Автоматизация с помощью microsoft API Graph

Для отправки данных эмблемы в Microsoft Places с помощью API Graph необходимо выполнить следующие действия:

Скачайте данные эмблемы из существующих систем.
Подготовьте запрос API, используя формат эмблемы с данными в следующем разделе.

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

Запустите API, чтобы отправить данные в Microsoft Places.

Формат сигналов данных индикатора

Параметр	Тип	Описание
данные телеметрии (обязательно)	workplaceSensorDeviceTelemetry, collectionText	Коллекция данных телеметрии, собираемых и сообщаемых датчиком на устройстве с индикатором событий.
deviceId	String	Определяемый пользователем уникальный идентификатор устройства, предоставленный во время создания. Не используйте созданный системой идентификатор устройства.
locationHint	String	Дополнительные сведения для указания расположения устройства.
метка времени (обязательно)	DateTimeOffset	дата и время, когда датчик измерял и сообщал о своем значении. Тип метки времени представляет сведения о дате и времени в формате ISO 8601 и всегда находится в формате UTC. Например, полночь в формате UTC 1 января 2024 г. — 2024-01-01T00:00:00Z.
sensorType (обязательный)	workplaceSensorType	Тип датчика. Возможные значения: значок.
eventValue (обязательно)	workplaceSensorEventValue	Дополнительные значения, связанные с сигналами индикатора событий.
eventValue.eventType (обязательный)	workplaceSensorEventType	Тип возможного значения события датчика. Возможные значения: badgeIn.
eventValue.user (обязательно)	emailIdentity	Уникальный идентификатор пользователя. Это может быть сообщение электронной почты или Microsoft Entra ID.
eventValue.user.displayName	String	Отображаемое имя пользователя. Наследуется от удостоверения.
eventValue.user.email (обязательно)	String	Email адрес пользователя.
eventValue.user.id	String	Уникальный идентификатор пользователя. Наследуется от удостоверения.

Сигнал данных индикатора отправки в Microsoft Places с помощью Microsoft API Graph

Чтобы создать приложение для автоматизации, отправки данных телеметрии, API доступны через Microsoft Graph. Чтобы использовать API, выполните следующие действия.

Создайте регистрацию приложения в Microsoft Entra.

Дополнительные сведения о разрешениях PlaceDeviceRead.All и PlaceDevice.ReadWrite.All см. в справочнике по разрешениям Microsoft Graph.
Создайте и разверните приложение для синхронизации данных телеметрии между Microsoft Places и партнерами.
Используйте API IngestTelemetry для отправки данных эмблемы в Microsoft Places.

Дополнительные сведения см. в разделе workplaceSensorDevice.

Пример:

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

Проверка данных и устранение неполадок в аналитике здания

Убедитесь, что идентификатор подключенной электронной почты пользователя совпадает с идентификатором электронной почты пользователя в Microsoft Entra ID.
Убедитесь, что расположение пользователя совпадает с расположением пользователя в Microsoft Entra ID.
Вы сможете просматривать панель мониторинга на основе заполненности здания загорится в течение 48 часов после подключения данных индикатора событий.

Вопросы безопасности и конфиденциальности при создании аналитики

Срок хранения переданных данных эмблемы составляет 28 дней. Агрегированные обработанные данные хранятся в течение 90 дней.
Данные хранятся в озере данных Azure, совместимом с конфиденциальностью.
Лидеры, имеющие менее 10 членов, не отображаются в иерархии лидеров из-за рисков конфиденциальности.
Дни с менее чем 10 членов, приходящих в здания, не отображаются на фактических панелях мониторинга занятости здания из-за рисков конфиденциальности.

Поделиться через

Создание аналитики

Создание сигнала аналитики

Создание использования на основе намерения использования

Использование здания на основе фактической занятости

Подключение данных о людях

Общие сведения

Формат данных

Обновления данных в Microsoft Entra ID

Портал Azure

Обновление атрибутов Microsoft Entra ID с помощью скрипта PowerShell

Обновление расположения пользователя

Обновление атрибутов Microsoft Entra ID с помощью API Graph

Проверка данных и устранение неполадок

Вопросы безопасности и конфиденциальности

Данные индикатора подключения

Процесс включения данных эмблемы

Шаг 1. Добавление устройств с доступом к эмблемам в Microsoft Places

Вариант 1. Использование командлетов PowerShell

Форматы данных устройства для командлетов

Добавление устройства с доступом к эмблемам в Microsoft Places с помощью командлетов

Действия. Использование командлетов PowerShell

Действия. Использование microsoft API Graph

Форматы данных устройства, используемые в microsoft API Graph

Отправка данных телеметрии эмблемы в Microsoft Places

Вариант 1. Использование командлета Push-Dataset

Подготовка CSV-файла

Отправка сигнала данных индикатора Microsoft Places с помощью командлетов

Вариант 2. Автоматизация с помощью microsoft API Graph

Формат сигналов данных индикатора

Сигнал данных индикатора отправки в Microsoft Places с помощью Microsoft API Graph

Проверка данных и устранение неполадок в аналитике здания

Вопросы безопасности и конфиденциальности при создании аналитики

Обратная связь

Дополнительные ресурсы