분석 빌드

2024-11-14

직원이 실제 건물 점유 데이터와 함께 사무실에 들어오려는 의도를 나타낼 수 있도록 하는 작업 계획 설정은 부동산 및 시설 관리자에게 건물 공간 사용을 이해하고 분석하고 최적화하는 귀중한 도구를 제공합니다.

직원의 의도를 반영하는 작업 계획 데이터를 실제 점유 데이터와 비교하여 계획된 공간 사용량과 실제 공간 사용 간의 불일치를 식별할 수 있습니다.

분석 빌드에 사용되는 신호는 다음과 같습니다.

사무실에 들어오려는 의도에 따라 사용 빌드 분석 빌드는 직원 작업 계획을 사용하여 의도 기반 공간 사용을 평가합니다.
실제 점유를 기반으로 빌드 사용 건물 분석은 배지 데이터를 사용하여 건물에 있는 직원 수를 유추하여 실제 건물 점유율 측정값을 제공합니다.
사람 데이터 Microsoft Places 분석은 외부 커넥터를 통해 Microsoft Entra ID 데이터(또는)에서 출처를 가진 사람 프로필 API 데이터를 사용하여 특정 건물에 할당된 직원 및 특정 리더의 직원을 분석합니다. 이 데이터는 사용자를 특정 건물에 매핑하여 분석을 빌드하기 위한 데이터 범위를 개선하는 데 도움이 됩니다.

분석 신호 빌드

사용 의도에 따라 사용률 빌드

빌드 분석은 작업 계획 데이터를 사용하여 의도된 건물 점유율 및 예상 하이브리드 추세를 추적하여 사무실 방문 시 직원 선호도에 대한 인사이트를 제공합니다.

작업 계획 데이터의 원본은 Microsoft Places 및 Outlook 앱의 사용자가 사용할 수 있는 FWH(유연한 근무 시간) 설정에서 제공됩니다. 작업 계획 데이터는 사용자 프로필 데이터 세트의 사용자 데이터 가용성에 따라 달라집니다. 사람 데이터는 건물을 사람 데이터에서 할당된 건물로 선택하지 않고 작업 계획을 설정하는 직원을 매핑하는 데 도움이 됩니다.

실제 점유를 기반으로 하는 건물 사용률

건물 분석은 점유 데이터를 사용하여 건물에 사람이 실제로 있는지 감지합니다. 현재 다음과 같은 건물 점유 데이터를 지원합니다.

배지 액세스 데이터

참고

건물 분석 대시보드에서 정확한 값을 표시하려면 사용자 데이터를 Mirosoft Places 온보딩된 건물에 매핑해야 합니다.

다음 섹션에서는 점유 데이터 온보딩 빌드와 함께 사용자 데이터 온보딩에 대한 세부 정보를 다룹니다.

사용자 데이터 온보딩

일반 정보

Microsoft Places 분석은 사용자 프로필 API 데이터를 사용하여 사용자를 특정 위치/건물에 연결합니다. 사람 프로필 데이터는 일반적으로 Microsoft Entra ID 데이터를 가져오고, Microsoft 365 애플리케이션에 사용자 데이터를 가져오는 커넥터를 추가한 경우 관련 데이터가 사용자 프로필 데이터 세트에 반영됩니다.

분석 빌드에 할당된 인원은 직원에서 빌드 매핑으로 파생됩니다.
리더 필터 기능이 정확하게 작동하려면 사람 프로필 데이터 세트에서 직원 관리자 매핑을 사용할 수 있어야 합니다.

데이터 형식

Microsoft Places 분석은 직원 프로필 데이터 세트의 특정 필드 집합을 검색하여 직원, 할당된 건물 및 관리자 간에 매핑을 만듭니다.

OfficeLocation Places 직원을 건물에 연결하는 데 사용하는 사람 프로필 API 속성입니다.

참고

이 속성은 매핑을 정확하게 만들려면 Places 디렉터리에 설정된 건물 이름과 일치해야 합니다.

매니저 Places 사용자를 리더/관리자와 연결하는 데 사용하는 사용자 프로필 API 속성입니다.

여기에서 데이터 형식의 프로필 API에 대한 자세한 내용은 Microsoft Graph에서 프로필 API를 사용하여 자신 또는 다른 사용자에 대한 정보를 검색을 참조하세요.

Microsoft Entra ID 대한 데이터 업데이트

사용자 프로필 데이터를 출석 데이터와 일치하려면 해당 Microsoft Entra ID 위치를 업데이트해야 합니다. 다음 방법 중 하나를 사용하여 수행할 수 있습니다.

Azure Portal

Azure Portal 액세스: Azure Portal 이동하여 자격 증명으로 로그인합니다.
Azure Active Directory로 이동: 왼쪽 탐색 창에서 Azure Active Directory를 선택합니다.
사용자 찾기: 관리에서 사용자를 선택한 다음 위치를 업데이트하려는 사용자를 검색합니다.
사용자 정보 편집: 사용자의 이름을 선택하여 프로필을 연 다음 편집 을 선택하여 정보를 업데이트합니다.
위치 업데이트: 작업 정보 섹션에서 사용자의 위치 세부 정보를 업데이트할 수 있습니다. 변경 내용을 저장해야 합니다.
관리자 업데이트: 작업 정보 섹션에서 사용자의 관리자 세부 정보를 업데이트할 수 있습니다. 변경 내용을 저장해야 합니다.

Microsoft Entra ID 데이터 업데이트에 대한 자세한 내용은 Microsoft Entra 관리 센터 사용자 프로필 정보 및 설정 추가 또는 업데이트를 참조하세요.

PowerShell 스크립트를 사용하여 Microsoft Entra ID 특성 업데이트

# Connect to Azure AD 
Connect-AzureAD

사용자 위치 업데이트

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

자세한 내용은 Update-AzADUser를 참조하세요.

Graph API 사용하여 Microsoft Entra ID 특성 업데이트

먼저 사용자 리소스 유형을 이해합니다. 자세한 내용은 사용자 리소스 유형을 참조하세요.

Graph Explore에 로그인합니다. 자세한 내용은 그래프 Explorer 참조하세요.
업데이트 사용자를 호출합니다. 자세한 내용은 사용자 업데이트를 참조하세요.

견본:

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

데이터 유효성 검사 및 문제 해결

Microsoft Places 분석 dashboard 헤드카운트 속성에는 예상 값이 있어야 합니다.
리더는 Places 분석의 분석 빌드 페이지에서 필터링하고 올바른 리더의 데이터를 채워야 합니다.
사용자 위치 또는 관리자를 업데이트하여 변경되는 경우 3~4일 이내에 Places 분석에 반영되어야 합니다.
애플리케이션의 피드백 옵션을 사용하여 발생한 Microsoft 문제를 보냅니다.

보안 및 개인 정보 보호 고려 사항

Microsoft Places 분석은 항상 데이터 요소를 집계하여 빌드 사용 번호를 표시합니다. 사용자는 특정 개별 직원에 대한 정보를 식별할 수 없습니다. Microsoft Places 다른 Microsoft 365 애플리케이션에서 사용하는 사용자 프로필 데이터를 사용합니다.

배지 데이터 온보딩

기존 배지 액세스 시스템을 사용하여 점유 대시보드 빌드에 대한 Places 분석 보고서를 향상시킬 수 있습니다.

배지 데이터를 사용하도록 설정하는 프로세스

1단계: Microsoft Places 배지 액세스 디바이스를 추가합니다(선택 사항이지만 매우 권장됨).
2단계: 배지 데이터 원격 분석을 Microsoft Places 업로드합니다.

참고

배지 데이터를 등록하기 전에 Microsoft Places 관심 있는 건물에 사람 데이터를 사용할 수 있어야 합니다. 배지 데이터는 사람 데이터에 대해 유효성을 검사합니다. 시스템은 Microsoft Places 매핑되지 않은 사용자의 배지 데이터를 필터링합니다.

1단계: Microsoft Places 배지 액세스 디바이스 추가

첫 번째 단계에서는 배지 액세스 디바이스 메타데이터를 업로드하고 디바이스를 Microsoft Places PlaceId에 매핑합니다. 이 단계는 배지 신호가 Microsoft Places 도달할 때 배지 신호를 컨텍스트화하는 데 도움이 됩니다. 다음 두 가지 옵션을 사용하여 배지 액세스 디바이스를 Microsoft Places 추가할 수 있습니다.

옵션 1: PowerShell cmdlet 사용
옵션 2: Microsoft Graph API 사용

옵션 1: PowerShell cmdlet 사용

PowerShell cmdlet은 Microsoft Places 디바이스를 관리하는 데 사용할 수 있습니다. Microsoft Places cmdlet에 대한 자세한 내용은 PowerShell용 Microsoft Places cmdlet 모듈을 참조하세요.

참고

cmdlet을 실행하려면 TenantPlacesManagement 역할이 할당되어 있어야 합니다.

cmdlet에 대한 디바이스 데이터 형식

열	설명	참고	예제
DeviceId (필수)	디바이스의 고유 식별자입니다(권장: Manufacturer_DeviceUniqueId).	전송된 원격 분석의 ID와 일치해야 합니다.	Manuf1_3455
DisplayName	디바이스의 표시 이름입니다.	해당하는 경우 친숙한 이름을 사용할 수 있습니다.	Manuf1_3455
설명	디바이스에 대한 설명입니다.
MacAddress	디바이스의 Mac 주소입니다.	제공된 공급자(사용 가능한 경우).
제조업체 (필수)	디바이스의 제조업체입니다.	IT 관리자가 제공합니다.	Manuf1
IPV4Address	디바이스의 IPV4Address입니다.	제공된 공급자(사용 가능한 경우).
IPV6Address	디바이스의 IPV6Address입니다.	제공된 공급자(사용 가능한 경우).
PlaceId	디바이스가 Places 매핑되는 PlaceId입니다.	IT 관리자는 회의실 목록에서 DeviceID를 DisplayName 필드에 매핑합니다.	76fe540f-01a9-425e-acd5-5d7d1da44fbf
태그	검색에 도움이 되는 디바이스와 연결된 사용자 지정 태그 목록입니다.		["IsVirtual_False", "Building_121"]
Sensor.SensorId	디바이스 내 센서의 고유 식별자입니다.	표준 원격 분석 페이로드에 와야 합니다.	배지
Sensor.DisplayName	센서의 표시 이름입니다.	친숙한 이름을 사용할 수 있습니다(해당하는 경우).	클립
Sensor.SensorType (필수)	센서의 유형입니다.	유효성이 검사된 목록입니다(예제 참조).	배지
Sensor.PlaceId	센서가 제공하는 위치의 고유 식별자입니다(센서가 디바이스 위치와 다른 위치에 있는 경우에만 이 정보를 제공해야 함).		76fe540f-01a9-425e-acd5-5d7d1da44fbf

cmdlet을 사용하여 Microsoft Places 배지 액세스 디바이스 추가

[!div class="mx-tdBreakAll"]

cmdlet 이름	설명	매개 변수
New-PlaceDevice	새 디바이스를 만듭니다.	DeviceId(필수), DisplayName, Description, MACAddress, 제조업체(필수), IPV4Address, IPV6Address, PlaceId(필수), TagsSensors(필수)
Remove-PlaceDevice	디바이스를 삭제합니다.	ID(필수)
Set-PlaceDevice	디바이스를 업데이트.	ID(필수), DeviceId(필수), DisplayName, Description, MACAddress, 제조업체(필수), IPV4Address, IPV6Address, PlaceId, 태그, 센서(필수)
Get-PlaceDevice	디바이스를 가져옵니다.	ID, 필터, 위쪽

단계: PowerShell cmdlet 사용

PowerShell 7(관리자가 아님)을 엽니다.
다음 Windows PowerShell cmdlet을 실행하여 Microsoft Places 설치합니다. Microsoft Places 설치에 대한 자세한 내용은 Microsoft Places PowerShell 갤러리 참조하세요.
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
다음 Windows PowerShell cmdlet을 실행하여 Microsoft Places 모듈을 가져옵니다.
```
Import-Module -Name MicrosoftPlaces 
```
모듈을 설치하고 가져온 후 다음 Microsoft Places PowerShell cmdlet을 실행하여 Microsoft Places 모듈에 연결합니다.
```
Connect-MicrosoftPlaces
```

New-PlaceDevice cmdlet을 사용하여 배지 액세스 디바이스를 추가합니다.

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 사용하여 기존 ID로 디바이스를 업데이트합니다.

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 Graph API 사용

배지 액세스 디바이스 등록 및 온보딩을 자동화하는 애플리케이션을 빌드하기 위해 Microsoft Graph를 통해 API를 사용할 수 있습니다. API를 사용하려면 다음 단계를 수행합니다.

Microsoft Entra 앱 등록을 만듭니다. PlaceDeviceRead.All 및 PlaceDevice.ReadWrite.All 권한에 대한 자세한 내용은 Microsoft Graph 권한 참조를 참조하세요.
애플리케이션을 빌드하고 배포하여 Microsoft Places 및 파트너 간에 디바이스 정보를 동기화합니다.

Microsoft Graph API 사용되는 디바이스 데이터 형식

열	설명	참고	예제
DeviceId (필수)	디바이스의 고유 식별자입니다(권장: Manufacturer_DeviceUniqueId).	전송된 원격 분석의 ID와 일치해야 합니다.	Manuf1_3455
DisplayName	디바이스의 표시 이름입니다.	해당하는 경우 친숙한 이름을 사용할 수 있습니다.	Manuf1_3455
설명	디바이스에 대한 설명입니다.
MacAddress	디바이스의 Mac 주소입니다.	제공된 공급자(사용 가능한 경우).
제조업체 (필수)	디바이스의 제조업체입니다.	IT 관리자가 제공합니다.	Manuf1
IPV4Address	디바이스의 IPV4Address입니다.	제공된 공급자(사용 가능한 경우).
IPV6Address	디바이스의 IPV6Address입니다.	제공된 공급자(사용 가능한 경우).
PlaceId (필수)	디바이스가 Microsoft Places 매핑되는 PlaceId입니다.	IT 관리자는 회의실 목록에서 DeviceID를 DisplayName 필드에 매핑합니다.	76fe540f-01a9-425e-acd5-5d7d1da44fbf
태그	검색에 도움이 되는 디바이스와 연결된 사용자 지정 태그 목록입니다.		["IsVirtual_False", "Building_121"]
Sensor.SensorId (필수)	디바이스 내 센서의 고유 식별자입니다.	표준 원격 분석 페이로드에 와야 합니다.	배지
Sensor.DisplayName	센서의 표시 이름입니다.	친숙한 이름을 사용할 수 있습니다(해당하는 경우).	클립
Sensor.SensorType (필수)	센서의 유형입니다.	유효성이 검사된 목록입니다(예제 참조).	배지
Sensor.PlaceId	센서가 제공하는 위치의 고유 식별자입니다(센서가 디바이스 위치와 다른 위치에 있는 경우에만 이 정보를 제공해야 함).		76fe540f-01a9-425e-acd5-5d7d1da44fbf

센서 디바이스에 대한 자세한 내용은 다음 Microsoft Graph API를 참조하세요.

배지 액세스 디바이스 보기: sensorDevices를 나열합니다.

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

특정 디바이스 보기: 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는 배지 이벤트를 특정 건물과 일치시킬 때 사용됩니다. DeviceId가 없는 경우 LocationHint가 사용됩니다. 건물 점유를 정확하게 매핑하기 위해 디바이스를 온보딩하는 것이 좋습니다.
Microsoft Places 디바이스를 온보딩하지 않은 경우 LocationHint는 Microsoft Places 디렉터리의 건물 이름과 일치해야 합니다.
배지 데이터의 사용자는 프로필 API의 사람 데이터에 대해 유효성을 검사하여 빌드 분석 페이지에서 사용할 수 있도록 합니다.

옵션 1: Push-Dataset cmdlet 사용

배지 데이터를 Microsoft Places 푸시하려면 다음 단계가 필요합니다.

기존 시스템에서 배지 데이터를 다운로드합니다.
다음 섹션의 배지 데이터 형식에 따라 CSV 파일을 준비합니다.
준비된 CSV 데이터를 Microsoft Places 푸시합니다.

CSV 파일 준비

배지 데이터 형식: 배지 정보를 업로드할 때 다음 스키마를 사용합니다.

열	유형	설명
DeviceId	String	선택 사항. 디바이스 ID는 신호를 생성한 디바이스를 나타냅니다.
EventType	문자열	센서 유형에 따라 달라지는 배지의 동작입니다. 값은 BadgeIn일 수 있습니다.
UserID	String	선택 사항. 배지가 있는 사용자 ID입니다.
UserName	String	선택 사항. 배지가 있는 사용자 이름입니다.
UserEmail	String	배지가 있는 사용자 이메일 주소입니다.
LocationHint	String	건물 이름입니다. 배지 신호가 기록된 위치입니다.
IngestionTime	Timestamp	이벤트가 발생한 시기를 나타내는 배지 신호의 타임스탬프입니다.

이 데이터를 업로드하는 동안 CSV 열 머리글을 건너뜁니다.
CSV 열 값은 앞에서 언급한 스키마와 일치해야 합니다.
매핑 논리를 Places 사용자의 위치:

DeviceId를 사용할 수 없지만 LocationHint을 사용할 수 있는 경우 LocationHint를 people 디렉터리에 PlaceName과 매핑하고 매핑되지 않는 항목이 필터링됩니다.

LocationHint 및 DeviceId를 모두 사용할 수 있는 경우 People 디렉터리에 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

cmdlet을 사용하여 Microsoft Places 배지 데이터 신호 푸시

Microsoft Places cmdlet에 대한 자세한 내용은 PowerShell용 Microsoft Places cmdlet 모듈을 참조하세요.

참고

Microsoft Places cmdlet을 실행하려면 TenantPlacesManagement 역할이 할당되어 있어야 합니다.

PowerShell 7(관리자가 아님)을 엽니다.
다음 Windows PowerShell cmdlet을 실행하여 Microsoft Places 설치합니다. Microsoft Places 설치에 대한 자세한 내용은 Microsoft Places PowerShell 갤러리 참조하세요.
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
다음 Windows PowerShell cmdlet을 실행하여 Microsoft Places 모듈을 가져옵니다.
```
Import-Module -Name MicrosoftPlaces
```
다음 Places PowerShell cmdlet을 실행하여 Microsoft Places 모듈에 연결합니다.
```
Connect-MicrosoftPlaces 
```
다음 Microsoft Places PowerShell cmdlet을 실행하여 디바이스의 위치에서 배지 데이터 세트를 업로드합니다(폴더 및 경로 사용).
```
Push-Dataset -Type BadgeSwipe -Path C:\sensordata\
```

CreateOrOverwrite 작업입니다. 예를 들어 새 배지 데이터는 현재 날짜 폴더에 덮어씁니다.

옵션 2: Microsoft Graph API 사용하여 자동화

배지 데이터를 Graph API 사용하여 Microsoft Places 푸시하려면 다음 단계가 필요합니다.

기존 시스템에서 배지 데이터를 다운로드합니다.
다음 섹션에서 배지 데이터 형식을 사용하여 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	디바이스의 위치를 나타내는 추가 정보입니다.
timestamp(필수)	DateTimeOffset	센서가 해당 값을 측정하고 보고한 날짜 및 시간입니다. 타임스탬프 형식은 ISO 8601 형식을 사용하는 날짜 및 시간 정보를 나타내며 항상 UTC입니다. 예를 들어 2024년 1월 1일 자정 UTC는 2024-01-01T00:00:00Z입니다.
sensorType(필수)	workplaceSensorType	센서의 유형입니다. 가능한 값은 배지입니다.
eventValue(필수)	workplaceSensorEventValue	배지 신호와 연결된 추가 값입니다.
eventValue.eventType(필수)	workplaceSensorEventType	가능한 센서 이벤트 값의 형식입니다. 가능한 값은 badgeIn입니다.
eventValue.user(필수)	emailIdentity	사용자의 고유 식별자입니다. 전자 메일 또는 Microsoft Entra ID 수 있습니다.
eventValue.user.displayName	String	사용자 표시 이름입니다. ID에서 상속 됩니다.
eventValue.user.email(필수)	String	사용자의 Email 주소입니다.
eventValue.user.id	String	사용자의 고유 식별자입니다. ID에서 상속 됩니다.

Microsoft Graph API 사용하여 배지 데이터 신호를 Microsoft Places 푸시

원격 분석 업로드를 자동화하는 애플리케이션을 빌드하기 위해 Microsoft Graph를 통해 API를 사용할 수 있습니다. API를 사용하려면 다음 단계를 수행합니다.

Microsoft Entra 앱 등록을 만듭니다.

PlaceDeviceRead.All 및 PlaceDevice.ReadWrite.All 권한에 대한 자세한 내용은 Microsoft Graph 권한 참조를 참조하세요.
애플리케이션을 빌드하고 배포하여 Microsoft Places 및 파트너 간에 원격 분석을 동기화합니다.
IngestTelemetry API를 사용하여 배지 데이터를 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" 
        } 
    ] 
}

데이터 유효성 검사 및 빌드 분석 문제 해결

온보딩된 사용자 전자 메일 ID가 Microsoft Entra ID 사용자 전자 메일 ID와 일치하는지 확인합니다.
사용자 위치가 Microsoft Entra ID 사용자 위치와 일치하는지 확인합니다.
배지 데이터를 온보딩한 후 48시간 이내에 건물 점유 기반 dashboard 표시등을 볼 수 있어야 합니다.

분석을 빌드하기 위한 보안 및 개인 정보 고려 사항

업로드된 배지 데이터 보존 기간은 28일입니다. 집계된 처리된 데이터는 90일 동안 저장됩니다.
데이터는 개인 정보 보호 준수 Azure 데이터 레이크에 저장됩니다.
구성원 수가 10명 미만인 리더는 개인 정보 보호 위험으로 인해 리더 계층 구조에 표시되지 않습니다.
10명 미만의 구성원이 건물에 오는 날은 개인 정보 보호 위험으로 인해 실제 건물 점유 대시보드에 표시되지 않습니다.