Criar análises

Artigo
11/14/2024

As definições do plano de trabalho que permitem aos funcionários indicar a sua intenção de entrar no escritório, combinadas com dados reais de ocupação de edifícios, oferecem aos gestores de imóveis e instalações uma ferramenta valiosa para compreender, analisar e otimizar a utilização do espaço de construção.

Ao comparar os dados do plano de trabalho, que refletem as intenções dos colaboradores, com os dados de ocupação reais, pode identificar discrepâncias entre a utilização planeada e o espaço real.

Eis os sinais utilizados na criação de análises:

Utilização de edifícios com base na intenção de entrar no escritório A análise de edifícios utiliza planos de trabalho dos colaboradores para avaliar a utilização do espaço orientada por intenções.
Utilização de edifícios com base na ocupação real A análise de edifícios utiliza dados de distintivo para inferir o número de funcionários presentes num edifício, fornecendo uma medida de ocupação real do edifício.
Pessoas análise de dados Microsoft Places utiliza dados da API de perfil de pessoas provenientes de Microsoft Entra ID dados (ou) através de conectores externos para analisar os funcionários atribuídos a um edifício específico e funcionários sob um coordenador específico. Estes dados ajudam a mapear utilizadores para um edifício específico, melhorando a cobertura de dados para a criação de análises.

Sinal de criação de análise

Criar a utilização com base na intenção de utilização

A criação de análise utiliza dados do plano de trabalho para acompanhar a ocupação de edifícios pretendida e as tendências híbridas esperadas, fornecendo informações sobre as preferências dos funcionários nas visitas ao escritório.

Os dados da origem do plano de trabalho provêm da definição Horas de Trabalho Flexíveis (FWH) disponível para os utilizadores no Microsoft Places e na aplicação Outlook. Os dados do plano de trabalho dependem da disponibilidade dos dados das pessoas (de conjuntos de dados de perfis de pessoas). Pessoas dados ajudam a mapear funcionários que definem planos de trabalho sem escolher edifícios como edifícios atribuídos em dados de pessoas.

Utilização de edifícios com base na ocupação real

A análise de edifícios utiliza dados de ocupação para detetar a presença real de pessoas em edifícios. Atualmente, suportamos os seguintes dados de ocupação de edifícios:

Distintivo de dados de acesso

Observação

Para que os dashboards de análise de edifícios mostrem valores precisos, os dados das pessoas têm de ser mapeados para os edifícios integrados na Mirosoft Places.

Na secção seguinte, vamos abordar detalhes sobre a inclusão de dados de pessoas, juntamente com a inclusão de dados de ocupação.

Integrar dados de pessoas

Informações gerais

Microsoft Places análise utiliza os dados da API de perfil de pessoas para associar os utilizadores a uma localização/edifício específico. Pessoas dados de perfil geralmente extraem dados de Microsoft Entra ID e, se adicionou conectores para trazer dados de pessoas para aplicações do Microsoft 365, os dados relevantes são refletidos no conjunto de dados do perfil de pessoas.

A contagem de cabeçalhos atribuída na criação de análises deriva do colaborador para o mapeamento de criação.
Para que as funcionalidades de filtro de coordenador funcionem com precisão, o mapeamento do gestor de funcionários deve estar disponível no conjunto de dados do perfil de pessoas.

Formato de dados

Microsoft Places análise procura um conjunto específico de campos no conjunto de dados de perfis de pessoas para criar mapeamento entre funcionários, edifícios atribuídos e respetivos gestores.

OfficeLocation Esta é a propriedade da API de perfil de pessoas utilizada pelo Places para associar um funcionário a um edifício.

Observação

Esta propriedade tem de corresponder ao nome do edifício definido no diretório Places para criar o mapeamento com precisão.

Gestor Esta é a propriedade da API de perfil de pessoas utilizada pelo Places para associar os utilizadores aos seus líderes/gestores.

Para saber mais sobre a API de perfil aqui Formato de dados, veja Utilizar a API de Perfil no Microsoft Graph para obter informações sobre si ou sobre outro utilizador.

Atualizações de dados para Microsoft Entra ID

Para corresponder os dados de perfil das pessoas aos dados de presença, a respetiva localização Microsoft Entra ID deve ser atualizada. Pode ser feito com um dos seguintes métodos.

Portal do Azure

Aceda ao portal do Azure: aceda à portal do Azure e inicie sessão com as suas credenciais.
Navegue para o Azure Active Directory: no painel de navegação esquerdo, selecione Azure Active Directory.
Localizar o utilizador: em Gerir, selecione Utilizadores e, em seguida, procure o utilizador cuja localização pretende atualizar.
Editar informações do utilizador: selecione o nome do utilizador para abrir o respetivo perfil e, em seguida, selecione Editar para atualizar as respetivas informações.
Atualizar a localização: na secção Informações da tarefa, pode atualizar os detalhes de localização do utilizador. Certifique-se de que guarda as alterações.
Gestor de atualizações: na secção Informações da tarefa, pode atualizar os detalhes do gestor do utilizador. Certifique-se de que guarda as alterações.

Para saber mais sobre como atualizar Microsoft Entra ID dados, consulte Adicionar ou atualizar as definições e informações de perfil de um utilizador no centro de administração do Microsoft Entra.

Atualizar atributos Microsoft Entra ID com um script do PowerShell

# Connect to Azure AD 
Connect-AzureAD

Atualizar a localização do utilizador

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

Para obter mais informações, veja Update-AzADUser.

Atualizar atributos de Microsoft Entra ID com API do Graph

Comece por compreender o tipo de recurso do utilizador. Para obter mais informações, veja Tipo de recurso de utilizador.

Inicie sessão no Graph Explore. Para obter mais informações, veja Graph Explorer.
Invocar Utilizador de atualização. Para obter mais informações, veja Atualizar utilizador.

Exemplo:

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

Validação e resolução de problemas de dados

A propriedade headcount na análise de Microsoft Places dashboard deve ter o valor esperado.
O coordenador filtra na página Análise de edifícios do Places análise e deve ter os dados do coordenador corretos preenchidos.
Se as alterações estiverem a ser efetuadas através da atualização da localização ou do gestor do utilizador, estas deverão ser refletidas na análise de Places dentro de 3 a 4 dias.
Utilize a opção de feedback na aplicação para enviar problemas da Microsoft que encontra.

Considerações sobre segurança e privacidade

Microsoft Places análise agrega sempre os pontos de dados para mostrar números de utilização modulares. Os utilizadores não conseguem identificar informações sobre funcionários individuais específicos. Microsoft Places utiliza os dados de perfil de pessoas utilizados por outras aplicações do Microsoft 365.

Integrar dados do distintivo

Pode utilizar sistemas de acesso de distintivos existentes para melhorar o relatório do Places Analytics sobre a criação de dashboards de ocupação.

Processo para ativar os dados do distintivo

Passo 1: adicionar dispositivos de acesso de distintivo a Microsoft Places (opcional, mas altamente recomendado).
Passo 2: carregar a telemetria de dados do distintivo para Microsoft Places.

Observação

Pessoas dados devem estar disponíveis para os edifícios interessados em Microsoft Places antes de integrar os dados do distintivo. Os dados do distintivo são validados relativamente aos dados Pessoas. O sistema filtra os dados do distintivo dos utilizadores que não estão mapeados para Microsoft Places.

Passo 1: adicionar dispositivos de acesso a distintivos ao Microsoft Places

O primeiro passo envolve carregar metadados do dispositivo de acesso ao distintivo e mapear dispositivos para um PlaceId no Microsoft Places. Este passo ajuda a contextualizar os sinais do distintivo quando atinge Microsoft Places. Pode adicionar dispositivos de acesso de distintivo a Microsoft Places com duas opções:

Opção 1: Utilizar cmdlets do PowerShell
Opção 2: Utilizar as APIs do Microsoft Graph

Opção 1: Utilizar cmdlets do PowerShell

Os cmdlets do PowerShell estão disponíveis para gerir dispositivos no Microsoft Places. Para saber mais sobre Microsoft Places cmdlets, veja o módulo de cmdlets Microsoft Places para o PowerShell.

Observação

Para executar cmdlets, tem de ter a função TenantPlacesManagement atribuída.

Formatos de dados do dispositivo para cmdlets

Coluna	Descrição	Observações	Exemplo
DeviceId (obrigatório)	O identificador exclusivo do dispositivo (recomendado: Manufacturer_DeviceUniqueId).	Tem de corresponder ao ID da telemetria enviada.	Manuf1_3455
DisplayName	O nome a apresentar do dispositivo.	Se aplicável, pode utilizar um nome amigável.	Manuf1_3455
Descrição	A descrição do dispositivo.
MacAddress	O endereço Mac do dispositivo.	Fornecedor fornecido (se disponível).
Fabricante (obrigatório)	O fabricante do dispositivo.	Fornecido pelo administrador de TI.	Manuf1
Endereço IPV4	O Endereço IPV4 do dispositivo.	Fornecedor fornecido (se disponível).
Endereço IPV6	O Endereço IPV6 do dispositivo.	Fornecedor fornecido (se disponível).
PlaceId	O PlaceId para o qual o dispositivo está mapeado Places.	O administrador de TI mapeia DeviceID para o campo DisplayName a partir de uma lista de salas.	76fe540f-01a9-425e-acd5-5d7d1da44fbf
Marcas	Uma lista de etiquetas personalizadas associadas ao dispositivo para ajudar na pesquisa.		["IsVirtual_False", "Building_121"]
Sensor.SensorId	O identificador exclusivo de um sensor no dispositivo.	Tem de estar no payload de telemetria padrão.	Distintivo
Sensor.DisplayName	O Nome a apresentar do sensor.	Pode utilizar um nome amigável (se aplicável).	Clipe de papel
Sensor.SensorType (obrigatório)	O tipo de sensor.	Uma lista validada (veja exemplos).	Distintivo
Sensor.PlaceId	O identificador exclusivo do local servido pelo sensor (só tem de fornecer estas informações se o sensor estiver num local diferente da localização do dispositivo).		76fe540f-01a9-425e-acd5-5d7d1da44fbf

Adicionar um dispositivo de acesso de distintivo a Microsoft Places com cmdlets

[!div class="mx-tdBreakAll"]

Nome do cmdlet	Descrição	Parâmetros
New-PlaceDevice	Cria um novo dispositivo.	DeviceId (obrigatório), DisplayName, Description, MACAddress, Manufacturer (obrigatório), IPV4Address, IPV6Address, PlaceId (obrigatório), TagsSensors (obrigatório)
Remove-PlaceDevice	Elimina um dispositivo.	ID (obrigatório)
Set-PlaceDevice	Atualizações um dispositivo.	ID (obrigatório), DeviceId (obrigatório), DisplayName, Description, MACAddress, Manufacturer (obrigatório), IPV4Address, IPV6Address, PlaceId, Tags, Sensors (obrigatório)
Get-PlaceDevice	Obtém um dispositivo.	ID, Filtro, Superior

Passos: Utilizar cmdlets do PowerShell

Abra o PowerShell 7 (não como administrador).
Instale Microsoft Places ao executar o seguinte cmdlet Windows PowerShell. Para obter mais informações sobre Microsoft Places instalação, veja o Microsoft Places Galeria do PowerShell.
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
Importe o módulo Microsoft Places ao executar o seguinte cmdlet Windows PowerShell.
```
Import-Module -Name MicrosoftPlaces 
```
Depois de instalar e importar o módulo, ligue-se ao módulo Microsoft Places ao executar o seguinte cmdlet Microsoft Places PowerShell.
```
Connect-MicrosoftPlaces
```

Utilize New-PlaceDevice cmdlet para adicionar um dispositivo de acesso de distintivo.

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

Observação

O parâmetro Sensors neste exemplo é um objeto do tipo MicrosoftPlaces.PlacesDevices.Sensor com campos mencionados no exemplo.

Utilize Get-PlaceDevice para ver a lista de dispositivos. Por predefinição, devolve 10 dispositivos. Para devolver mais dispositivos, adicione o parâmetro -top, conforme mostrado neste exemplo.
```
Get-PlaceDevice -top 100 
```

Utilize Set-PlaceDevice para atualizar um dispositivo com o ID existente.

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

Observação

Indique os detalhes de todos os parâmetros (obrigatórios e opcionais) durante a atualização de um dispositivo. Na ausência de um valor de parâmetro, repõe o valor para o valor vazio predefinido.

Utilize Remove-PlaceDevice para eliminar um dispositivo.

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

Passos: Utilizar o Microsoft API do Graph

Para criar uma aplicação para automatizar o registo e a inclusão de dispositivos de acesso de distintivo, as APIs estão disponíveis através do Microsoft Graph. Para utilizar APIs, siga estes passos.

Crie um registo de aplicação no Microsoft Entra. Para saber mais sobre as permissões PlaceDeviceRead.All e PlaceDevice.ReadWrite.All, consulte a Referência de Permissões do Microsoft Graph.
Crie e implemente uma aplicação para sincronizar informações do dispositivo entre Microsoft Places e os seus parceiros.

Formatos de dados do dispositivo utilizados no Microsoft API do Graph

Coluna	Descrição	Observações	Exemplo
DeviceId (obrigatório)	O identificador exclusivo do dispositivo (recomendado: Manufacturer_DeviceUniqueId).	Tem de corresponder ao ID da telemetria enviada.	Manuf1_3455
DisplayName	O nome a apresentar do dispositivo.	Pode utilizar um nome amigável, se aplicável.	Manuf1_3455
Descrição	A descrição do dispositivo.
MacAddress	O endereço Mac do dispositivo.	Fornecedor fornecido (se disponível).
Fabricante (obrigatório)	O fabricante do dispositivo.	Fornecido pelo administrador de TI.	Manuf1
Endereço IPV4	O Endereço IPV4 do dispositivo.	Fornecedor fornecido, se disponível.
Endereço IPV6	O Endereço IPV6 do dispositivo.	Fornecedor fornecido, se disponível.
PlaceId (obrigatório)	O PlaceId para o qual o dispositivo está mapeado Microsoft Places.	O administrador de TI mapeia DeviceID para o campo DisplayName a partir de uma lista de salas.	76fe540f-01a9-425e-acd5-5d7d1da44fbf
Marcas	Uma lista de etiquetas personalizadas associadas ao dispositivo para ajudar na pesquisa.		["IsVirtual_False", "Building_121"]
Sensor.SensorId (obrigatório)	O identificador exclusivo de um sensor no dispositivo.	Tem de estar no payload de telemetria padrão.	Distintivo
Sensor.DisplayName	O Nome a apresentar do sensor.	Pode utilizar um nome amigável (se aplicável).	Clipe de papel
Sensor.SensorType (obrigatório)	O tipo de sensor.	Uma lista validada (veja exemplos).	Distintivo
Sensor.PlaceId	O identificador exclusivo do local servido pelo sensor (só tem de fornecer estas informações se o sensor estiver num local diferente da localização do dispositivo).		76fe540f-01a9-425e-acd5-5d7d1da44fbf

Para saber mais sobre dispositivos de sensor, consulte as seguintes APIs do Microsoft Graph:

Ver dispositivos de acesso a distintivos: Sensor de listaDispositivos.

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

Criar novos dispositivos de acesso a distintivos: crie 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" 
        } 
    ] 
}

Ver um dispositivo específico: Obter workplaceSensorDevice.

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

Atualizar dispositivos de acesso a distintivos existentes: Atualizar 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" 
        } 
    ] 
}

Para eliminar um dispositivo: Elimine 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

Carregar telemetria de dados do distintivo para Microsoft Places

Carregue dados do seu sistema de introdução de distintivos para gerar dashboards de ocupação modulares no Places Analytics.

O DeviceId é utilizado para corresponder o evento do distintivo a um edifício específico. Na ausência de um DeviceId, é utilizado LocationHint. Recomendamos vivamente que integre os seus dispositivos para mapear com precisão a ocupação do edifício.
LocationHint tem de corresponder ao nome do edifício no diretório Microsoft Places se não tiver integrado dispositivos para Microsoft Places.
Os utilizadores dos dados do Distintivo são validados relativamente a dados Pessoas (da API de perfil) para os disponibilizar na página Análise de edifícios.

Opção 1: Utilizar o cmdlet Push-Dataset

Estes passos são necessários para enviar dados do distintivo para Microsoft Places:

Transfira dados de distintivos a partir de sistemas existentes.
Prepare o ficheiro CSV de acordo com o formato badge-data na secção seguinte.
Envie dados CSV preparados por push para Microsoft Places.

Preparar o ficheiro CSV

Formato badge-data: utilize o seguinte esquema ao carregar informações do distintivo.

Coluna	Tipo	Descrição
DeviceId	String	Opcional. O ID do dispositivo indica que dispositivo gerou o sinal.
EventType	String	A ação do distintivo, que depende do tipo de sensor. O valor pode ser BadgeIn.
UserID	String	Opcional. O ID de utilizador com distintivo.
UserName	String	Opcional. O nome de utilizador com distintivo.
UserEmail	Cadeia de caracteres	O endereço de e-mail do utilizador com distintivo.
LocationHint	Cadeia de caracteres	Nome do edifício. Localização a partir do local onde o sinal de distintivo foi gravado.
IngestionTime	Carimbo de data/hora	O carimbo de data/hora do sinal do distintivo, que indica quando ocorreu o evento.

Ignore os cabeçalhos de coluna CSV ao carregar estes dados.
Os valores das colunas CSV devem estar ordenados com o esquema mencionado anteriormente.
Localização do Utilizador para Places Lógica de Mapeamento:

Se o DeviceId não estiver disponível, mas LocationHint estiver disponível, mapeie LocationHint com PlaceName no diretório people e filtre o que não mapeia.

Se o LocationHint e o DeviceId estiverem disponíveis, mapeie LocationHint com PlaceName no diretório people. Se não mapear, mapeie com PlaceIdFromDeviceInventory, caso contrário, filtra o que não mapeia.

Conteúdo do ficheiro de exemplo CSV:

O exemplo seguinte mostra duas entradas num ficheiro 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

Enviar um sinal de dados de distintivo para Microsoft Places com cmdlets

Para saber mais sobre Microsoft Places cmdlets, veja o módulo de cmdlets Microsoft Places para o PowerShell.

Observação

Para executar Microsoft Places cmdlets, tem de ter a função TenantPlacesManagement atribuída.

Abra o PowerShell 7 (não como administrador).
Instale Microsoft Places ao executar o seguinte cmdlet Windows PowerShell. Para obter mais informações sobre Microsoft Places instalação, veja o Microsoft Places Galeria do PowerShell.
```
Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force 
```
Importe o módulo Microsoft Places ao executar o seguinte cmdlet Windows PowerShell.
```
Import-Module -Name MicrosoftPlaces
```
Ligue-se ao módulo Microsoft Places ao executar o seguinte cmdlet Places PowerShell.
```
Connect-MicrosoftPlaces 
```
Carregue o conjunto de dados do distintivo a partir da localização no seu dispositivo (utilizando a pasta e o caminho) ao executar o seguinte Microsoft Places cmdlet do PowerShell.
```
Push-Dataset -Type BadgeSwipe -Path C:\sensordata\
```

Esta é uma operação CreateOrOverwrite. Por exemplo, os novos dados do distintivo são substituídos na pasta dia atual.

Opção 2: automatizar com o Microsoft API do Graph

Os seguintes passos são necessários para enviar dados de distintivos para Microsoft Places através do API do Graph:

Transfira dados de distintivos a partir de sistemas existentes.
Prepare o pedido da API com o formato badge-data na secção seguinte.

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

Execute a API para enviar os dados para Microsoft Places.

Formato de dados de sinal de distintivo-dados

Parâmetro	Tipo	Descrição
telemetria (obrigatório)	workplaceSensorDeviceTelemetry, collectionText	Uma coleção dos dados telemétricos recolhidos e comunicados por um sensor num dispositivo de distintivo.
deviceId	Cadeia de caracteres	O identificador exclusivo definido pelo utilizador do dispositivo fornecido no momento da criação. Não utilize o identificador gerado pelo sistema do dispositivo.
locationHint	Cadeia de caracteres	As informações adicionais para indicar a localização do dispositivo.
carimbo de data/hora (obrigatório)	DateTimeOffset	a data e hora em que o sensor mediu e comunicou o respetivo valor. O tipo de carimbo de data/hora representa informações de data e hora com o formato ISO 8601 e está sempre em UTC. Por exemplo, meia-noite UTC a 1 de janeiro de 2024 é 2024-01-01T00:00:00Z.
sensorType (obrigatório)	workplaceSensorType	O tipo de sensor. Os valores possíveis são: distintivo.
eventValue (obrigatório)	workplaceSensorEventValue	Os valores adicionais associados aos sinais do distintivo.
eventValue.eventType (obrigatório)	workplaceSensorEventType	O tipo de possível valor de evento do sensor. Os valores possíveis são: badgeIn.
eventValue.user (obrigatório)	emailIdentity	O identificador exclusivo de um utilizador. Pode ser um e-mail ou um Microsoft Entra ID.
eventValue.user.displayName	Cadeia de caracteres	Nome de exibição do usuário. Herdado da identidade.
eventValue.user.email (obrigatório)	Cadeia de caracteres	Email endereço do utilizador.
eventValue.user.id	String	O identificador exclusivo do usuário. Herdado da identidade.

Enviar um sinal de dados de distintivo para Microsoft Places com o Microsoft API do Graph

Para criar uma aplicação para automatizar, o carregamento de telemetria está disponível através do Microsoft Graph. Para utilizar APIs, siga estes passos.

Crie um registo de aplicação no Microsoft Entra.

Para saber mais sobre as permissões PlaceDeviceRead.All e PlaceDevice.ReadWrite.All, consulte a Referência de Permissões do Microsoft Graph.
Crie e implemente uma aplicação para sincronizar a telemetria entre Microsoft Places e os seus parceiros.
Utilize a API IngestTelemetry para enviar dados do distintivo para Microsoft Places.

Para obter mais informações, veja workplaceSensorDevice.

Exemplo:

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

Validação de dados e resolução de problemas de análise de compilação

Certifique-se de que o ID de e-mail do utilizador integrado corresponde ao ID de e-mail do utilizador no Microsoft Entra ID.
Certifique-se de que a localização do utilizador corresponde à localização do utilizador no Microsoft Entra ID.
Deverá conseguir ver a opção Construir com base na ocupação dashboard acender-se dentro de 48 horas depois de integrar os dados do distintivo.

Considerações de segurança e privacidade para criar análises

A retenção de dados do distintivo carregado é de 28 dias. Os dados processados agregados são armazenados durante 90 dias.
Os dados são armazenados no Azure Data Lake em conformidade com a privacidade.
Os líderes com menos de 10 membros abaixo dos mesmos não são apresentados na hierarquia de coordenadores devido a riscos de privacidade.
Dias com menos de 10 membros a chegar a edifícios não são mostrados em dashboards de ocupação real de edifícios devido a riscos de privacidade.

Partilhar via

Criar análises

Sinal de criação de análise

Criar a utilização com base na intenção de utilização

Utilização de edifícios com base na ocupação real

Integrar dados de pessoas

Informações gerais

Formato de dados

Atualizações de dados para Microsoft Entra ID

Portal do Azure

Atualizar atributos Microsoft Entra ID com um script do PowerShell

Atualizar a localização do utilizador

Atualizar atributos de Microsoft Entra ID com API do Graph

Validação e resolução de problemas de dados

Considerações sobre segurança e privacidade

Integrar dados do distintivo

Processo para ativar os dados do distintivo

Passo 1: adicionar dispositivos de acesso a distintivos ao Microsoft Places

Opção 1: Utilizar cmdlets do PowerShell

Formatos de dados do dispositivo para cmdlets

Adicionar um dispositivo de acesso de distintivo a Microsoft Places com cmdlets

Passos: Utilizar cmdlets do PowerShell

Passos: Utilizar o Microsoft API do Graph

Formatos de dados do dispositivo utilizados no Microsoft API do Graph

Carregar telemetria de dados do distintivo para Microsoft Places

Opção 1: Utilizar o cmdlet Push-Dataset

Preparar o ficheiro CSV

Enviar um sinal de dados de distintivo para Microsoft Places com cmdlets

Opção 2: automatizar com o Microsoft API do Graph

Formato de dados de sinal de distintivo-dados

Enviar um sinal de dados de distintivo para Microsoft Places com o Microsoft API do Graph

Validação de dados e resolução de problemas de análise de compilação

Considerações de segurança e privacidade para criar análises

Comentários

Recursos adicionais