Análise de edifícios

As configurações do plano de trabalho que permitem que os funcionários indiquem sua intenção de entrar no escritório, combinadas com dados reais de ocupação do edifício, oferecem aos gerentes de imóveis e instalações uma ferramenta valiosa para entender, analisar e otimizar o uso do espaço do edifício.

Ao comparar os dados do plano de trabalho, que refletem as intenções dos funcionários, com os dados reais de ocupação, você pode identificar discrepâncias entre o uso do espaço planejado e real.

Aqui estão os sinais usados na análise de edifícios:

• Uso do edifício com base na intenção de entrar no escritório A análise de construção usa planos de trabalho dos funcionários para avaliar o uso do espaço orientado por intenção.
• Uso do edifício com base na ocupação real A análise de edifícios usa dados de crachás para inferir o número de funcionários presentes em um edifício, fornecendo uma medida da ocupação real do edifício.
• Dados de People O Microsoft Places Analytics usa dados da API de perfil de pessoas provenientes de dados (ou) do Microsoft Entra ID por meio de conectores externos para analisar os funcionários atribuídos a um prédio específico e os funcionários sob um líder específico. Esses dados ajudam a mapear usuários para um edifício específico, melhorando a cobertura de dados para análises de edifícios.

Sinal de análise de construção

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

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

A fonte de dados do plano de trabalho vem da configuração de Horário de Trabalho Flexível (FWH) disponível para usuários no Microsoft Places e no aplicativo Outlook. Os dados do plano de trabalho dependem da disponibilidade dos dados de pessoas (de conjuntos de dados de perfil de pessoas). Os dados de People ajudam a mapear funcionários que definem planos de trabalho sem escolher edifícios como seu edifício atribuído nos dados de pessoas.

Utilização do edifício com base na ocupação real

A análise de edifícios usa dados de ocupação para detectar a presença real de pessoas nos edifícios. Atualmente, oferecemos suporte aos seguintes dados de ocupação do edifício:

• Dados de acesso ao crachá

Na próxima seção, abordaremos detalhes sobre a integração de dados de pessoas, juntamente com a integração de dados de ocupação de edifícios.

Integrar dados de pessoas

Informações gerais

O Microsoft Places Analytics usa os dados da API de perfil de pessoas para associar usuários a um local/edifício específico. Os dados de perfil de People geralmente extraem dados do Microsoft Entra ID e, se você adicionou conectores para trazer dados de pessoas para aplicativos do Microsoft 365, os dados relevantes são refletidos no conjunto de dados de perfil de pessoas.

• O número de funcionários atribuído na análise de edifícios é derivado do funcionário para o mapeamento do edifício.
• Para que os recursos de filtro de líder funcionem com precisão, o mapeamento do gerente 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 perfil de pessoas para criar um mapeamento entre funcionários, seus edifícios atribuídos e seus gerentes.

• OfficeLocation Essa é a propriedade da API de perfil de pessoas usada pelo Places para associar um funcionário a um prédio.

• Gerente Essa é a propriedade da API de perfil de pessoas usada pelo Places para associar usuários a seus líderes/gerentes.

Para saber mais sobre a API de perfil aqui Formato de dados, consulte Usar a API de perfil no Microsoft Graph para recuperar informações sobre você ou outro usuário.

Atualizações de dados para o Microsoft Entra ID

Para combinar os dados de perfil das pessoas com os dados de presença, a localização do Microsoft Entra ID deve ser atualizada. Isso pode ser feito usando um dos seguintes métodos.

Portal do Azure

• Acesse o portal do Azure: acesse o portal do Azure e entre com suas credenciais.
• Navegue até o Azure Active Directory: No painel de navegação esquerdo, selecione Azure Active Directory.
• Localizar o usuário: em Gerenciar, selecione Usuários e, em seguida, pesquise o usuário cuja localização você deseja atualizar.
• Editar informações do usuário: selecione o nome do usuário para abrir seu perfil e, em seguida, selecione Editar para atualizar suas informações.
• Atualize o local: Na seção Informações do trabalho , você pode atualizar os detalhes de localização do usuário. Salve as alterações.
• Atualizar gerente: na seção Informações do trabalho , você pode atualizar os detalhes do gerente do usuário. Salve as alterações.

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

Atualizar os atributos do Microsoft Entra ID usando um script do PowerShell

PowerShell

# Connect to Azure AD
Connect-AzureAD

Atualizar a localização do usuário

PowerShell

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

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

Atualizar os atributos do Microsoft Entra ID usando a API do Graph

Comece entendendo o tipo de recurso do usuário. Para obter mais informações, consulte Tipo de recurso do usuário.

• Entre no Graph Explore. Para obter mais informações, consulte Graph Explorer.
• Invocar usuário de atualização. Para obter mais informações, consulte Atualizar usuário.

amostra:

PowerShell

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

{
  "officeLocation": "18/2111"
}

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

• Verifique se a propriedade headcount no dashboard de análise do Microsoft Places mostra o mesmo número de usuários que foram atribuídos a esse edifício.
• O líder filtra na página Análise de construção da análise do Places e deve ter os dados do líder certo preenchidos.
• Se as alterações estiverem sendo feitas atualizando a localização do usuário ou do gerente, elas deverão ser refletidas na análise do Places em 3 a 4 dias.

Considerações sobre segurança e privacidade

O Microsoft Places Analytics sempre agrega os pontos de dados para mostrar os números de uso do edifício. Os usuários não conseguem identificar informações sobre funcionários individuais específicos. O Microsoft Places usa os dados de perfil de pessoas usados por outros aplicativos do Microsoft 365.

Dados do selo de integração

Você pode usar os sistemas de acesso por crachá existentes para aprimorar o relatório do Places Analytics nos painéis de ocupação do edifício.

Processo para habilitar os dados do selo

• Etapa 1: adicionar dispositivos de acesso por crachá ao Microsoft Places (opcional, mas altamente recomendado).
• Etapa 2: carregar a telemetria de dados do selo no Microsoft Places.

Etapa 1: adicionar dispositivos de acesso por crachá ao Microsoft Places

A primeira etapa envolve o upload de metadados de dispositivo de acesso a crachás e mapeamento de dispositivos para um PlaceId no Microsoft Places. Esta etapa ajuda a contextualizar os sinais de notificação quando chegam ao Microsoft Places. Você pode adicionar dispositivos de acesso por crachá ao Microsoft Places usando duas opções:

• Opção 1: usando cmdlets do PowerShell
• Opção 2: usar APIs do Microsoft Graph

Opção 1: usando cmdlets do PowerShell

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

Adicionar dispositivo de acesso por selo ao Microsoft Places usando cmdlets

Etapas: Usando cmdlets do PowerShell

• Abra o PowerShell 7 (não como administrador).

• Instale o Microsoft Places executando o seguinte cmdlet do Windows PowerShell. Para obter mais informações sobre Microsoft Places instalação, consulte o Microsoft Places Galeria do PowerShell.

PowerShell

Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force

• Importe o módulo do Microsoft Places executando o seguinte cmdlet do Windows PowerShell.

PowerShell

Import-Module -Name MicrosoftPlaces

• Depois de instalar e importar o módulo, conecte-se ao módulo do Microsoft Places executando o seguinte cmdlet do PowerShell do Microsoft Places.

PowerShell

Connect-MicrosoftPlaces

• Use New-PlaceDevice cmdlet para adicionar o dispositivo de acesso ao crachá.

PowerShell

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

• Use Get-PlaceDevice para exibir a lista de dispositivos. Por padrão, ele retorna 10 dispositivos. Para retornar mais dispositivos, adicione o parâmetro -top conforme mostrado neste exemplo.

PowerShell

Get-PlaceDevice -top 100

• Use Set-PlaceDevice para atualizar um dispositivo com ID existente.

PowerShell

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

• Use Remove-PlaceDevice para excluir um dispositivo.

PowerShell

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

Etapas: Usar a API do Graph

Para criar um aplicativo para automatizar o registro e a integração de dispositivos de acesso por crachá, as APIs estão disponíveis por meio do Microsoft Graph. Para usar APIs, siga estas etapas.

• Crie um registro de aplicativo 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 implante um aplicativo para sincronizar informações de dispositivos no Microsoft Places e em seus parceiros.

Formatos de dados do dispositivo usados na API do Graph Microsoft

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

• Exibir dispositivos de acesso ao crachá: liste sensorDevices.

PowerShell

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

• Criar novos dispositivos de acesso de crachá: Crie workplaceSensorDevice.

PowerShell

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

• Exibir um dispositivo específico: Obter workplaceSensorDevice.

PowerShell

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

• Atualize os dispositivos de acesso a crachás existentes: atualize workplaceSensorDevice.

PowerShell

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 excluir um dispositivo: Excluir workplaceSensorDevice.

PowerShell

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 a telemetria dos dados do selo no Microsoft Places

Carregue dados do seu sistema de entrada de crachás para gerar painéis de ocupação do edifício no Places Analytics.

• A DeviceId é usada para corresponder o evento de selo a um edifício específico. Na ausência de uma DeviceId, LocationHint é usada. Recomendamos fortemente que você integre seus dispositivos para mapear com precisão a ocupação do edifício.
• A LocationHint deve corresponder ao nome do edifício no diretório do Microsoft Places se você não tiver integrado dispositivos ao Microsoft Places.
• Os usuários dos dados do Badge são validados em relação aos dados do People (da API do perfil) para disponibilizá-los na página Building analytics.

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

Estas etapas são necessárias para enviar dados do selo para o Microsoft Places:

• Baixe dados de selos de sistemas existentes.
• Prepare o arquivo CSV de acordo com o formato de dados de selo na seção a seguir.
• Envie os dados CSV preparados para o Microsoft Places.

Prepare o arquivo CSV

Formato dos dados do selo: use o esquema a seguir ao carregar informações do crachá.

• Ignore os cabeçalhos das colunas CSV ao carregar esses dados.
• Os valores das colunas CSV devem estar em ordem com o esquema mencionado anteriormente.
• Localização do usuário para a lógica de mapeamento do Places:

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

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

Conteúdo do arquivo de exemplo CSV:

O exemplo a seguir mostra duas entradas em um arquivo CSV.

PowerShell

BadgeEntry1_BENGALURU (BANGALORE)-FERNS_MIRPL,BadgeIn,167b4de9-05c8-422e-916e-9d5be5b381b2,AlexW,AlexW@SkelligeIsland.OnMicrosoft.com,BENGALURU (BANGALORE)-FERNS_MIRPL,2024-06-28T09:36:05.144Z

BadgeEntry1_BENGALURU (BANGALORE)-FERNS_MIRPL,BadgeIn,167b4de9-05c8-422e-916e-9d5be5b381b2,AllanD,AllanD@SkelligeIsland.OnMicrosoft.com,BENGALURU (BANGALORE)-FERNS_MIRPL,2024-06-28T10:36:05.144Z

Enviar o sinal de dados do selo por push para o Microsoft Places usando cmdlets

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

PowerShell

Install-Module -Name MicrosoftPlaces -AllowPrerelease -Force

• Importe o módulo do Microsoft Places executando o seguinte cmdlet do Windows PowerShell.

PowerShell

Import-Module -Name MicrosoftPlaces

• Conecte-se ao módulo do Microsoft Places executando o seguinte cmdlet do PowerShell do Places.

PowerShell

Connect-MicrosoftPlaces

• Carregue o conjunto de dados do selo do local em seu dispositivo (usando a pasta e o caminho) executando o seguinte cmdlet do PowerShell do Microsoft Places.

PowerShell

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

Essa é uma operação CreateOrOverwrite. Por exemplo, os novos dados do selo são substituídos para a pasta do dia atual.

Opção 2: Automatizar usando a API do Graph

As etapas a seguir são necessárias para enviar dados de notificação para o Microsoft Places usando a API do Graph:

• Baixe dados de selos de sistemas existentes.
• Prepare a solicitação de API usando o formato badge-data na seção a seguir.

PowerShell

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": "BENGALURU (BANGALORE)-FERNS_MIRPL",
             "timestamp": "2024-06-28T09:36:05.144Z"
        }
    ]
}

• Execute a API para enviar os dados para o Microsoft Places.

Formato de dados de sinal de notificação

Enviar o sinal de dados do selo por push para o Microsoft Places usando a API do Graph

Para criar um aplicativo para automatizar, o upload de telemetria, as APIs estão disponíveis no Microsoft Graph. Para usar APIs, siga estas etapas.

• Crie um registro de aplicativo 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 implante um aplicativo para sincronizar a telemetria entre o Microsoft Places e seus parceiros.
• Use a API IngestTelemetry para enviar dados de selo para o Microsoft Places.

Para obter mais informações, consulte workplaceSensorDevice.

Exemplo:

PowerShell

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": "BENGALURU (BANGALORE)-FERNS_MIRPL",
            "timestamp": "2024-06-28T09:36:05.144Z"
        }
    ]
}

Validação de dados e solução de problemas de análise de construção

• Verifique se a ID de email do usuário integrado corresponde à ID de email do usuário no Microsoft Entra ID.
• Verifique se a localização do usuário corresponde à localização do usuário no Microsoft Entra ID.
• Você deve ser capaz de ver o dashboard baseado em ocupação do edifício acender dentro de 48 horas após integrar os dados do selo.

Considerações sobre segurança e privacidade para análise de construção

• A retenção de dados de crachá carregados é de 28 dias. Os dados processados agregados são armazenados por 90 dias.
• Os dados são armazenados no data lake do Azure em conformidade com a privacidade.
• Os líderes com menos de 10 membros abaixo deles não são mostrados na hierarquia do líder devido a riscos de privacidade.

Os dias com menos de 10 membros chegando aos edifícios não são mostrados nos painéis de ocupação real do edifício devido a riscos de privacidade.