Gerir precedência de origem de perfil no Microsoft 365

A precedência da origem de perfil é uma funcionalidade que capacita os administradores de inquilinos com controlo sobre a origem dos dados de perfil para os utilizadores da respetiva organização. Os dados de perfil podem ter origem em Microsoft Entra ID, dados organizacionais no Microsoft 365, conectores Copilot para dados de pessoas, SharePoint ou outras origens. Quando várias origens fornecem dados sobrepostos, um administrador inquilino pode configurar a origem autoritativa dos dados de perfil para os utilizadores na respetiva organização. Esta capacidade aplica-se principalmente aos dados de RH e posição de trabalho no perfil de utilizador, que é tratado como de valor único.

Para obter mais detalhes sobre as origens de dados de pessoas e os IDs de origem, veja Gerir definições de origem de perfil para uma organização.

A precedência de origem relacionada com os dados de RH e posição de trabalho baseia-se numa ordenação predefinida por prioridade de origem:

  1. Conectores copilot para dados de pessoas, se configurados, incluindo conectores para sistemas de RH populares e conectores personalizados. Uma organização pode configurar mais do que uma ligação. A ligação configurada mais recentemente tem a prioridade mais alta. Cada ligação tem um ID de origem exclusivo definido pelo administrador.
  2. Microsoft Entra ID. O ID de origem é 4ce763dd-9214-4eff-af7c-da491cc3782d.
  3. Dados organizacionais no Microsoft 365. O ID de origem é 7986c642-b494-4140-8df4-f5ed125e2c67. Para obter detalhes sobre as origens de clientes associadas a esta origem do Microsoft 365, consulte Dados organizacionais no Microsoft 365.

Existem outras origens de dados de pessoas, mas apenas as origens listadas são relevantes quando escolhe o valor autoritativo para dados de RH ou posição de trabalho e quando aplica a configuração de precedência de origem de administrador de inquilinos, conforme descrito neste artigo.

Observação

  • A origem da Aplicação de Perfil de Utilizador (UPA) do SharePoint é relevante para um caso de canto de precedência de origem. Por exemplo, se um utilizador configurar um assistente executivo através das pessoas card e o sistema de RH definir um assistente executivo diferente para o mesmo utilizador, as pessoas card prioriza o valor introduzido pelo utilizador quando os valores diferem. Esta encomenda não pode ser alterada.
  • Se os dados de RH ou posição de trabalho forem escritos com a origem de utilizador da API de perfil (/me/profileou /users/{id | userPrincipalName}/profile no Microsoft Graph beta, incluindo através do Graph Explorer), estes dados não substituem o conector ou Entra origens de ID. Quando lê os dados de perfil com o Microsoft API do Graph, os dados são apresentados em OData como uma instância separada na coleção de entidades workPosition.

Um administrador pode alterar a ordem das origens listadas anteriormente; por exemplo, ao dar ao Entra ID uma prioridade mais alta do que um conector ou ao alterar a prioridade em várias origens de conectores. A prioridade das origens de clientes por trás dos dados organizacionais no Microsoft 365 é gerida separadamente na plataforma Dados organizacionais no Microsoft 365 .

Como a precedência de origem afeta a representação de pessoas

A precedência de origem afeta principalmente os dados de valor único. Neste contexto, o valor único significa que existe um valor autoritativo para uma determinada propriedade na representação de pessoas resultante. Os dados de valor único incluem a posição de trabalho, os dados de nome e os dados da conta.

Para dados de valor único, a lógica de negócio seleciona o valor de uma propriedade a partir da origem de prioridade mais alta que tem um valor. Os dados de origens de prioridade inferior são ignorados quando uma origem de prioridade superior fornece um valor para a propriedade.

Observação

Existe uma diferença significativa entre um valor vazio ou uma cadeia e um valor nulo ou uma propriedade que não faz parte da ingestão do conector. Por exemplo, uma cadeia vazia ("") é tratada como um valor e substitui uma origem de prioridade inferior que tem uma cadeia não vazia. Este comportamento permite que uma origem do conector tenha controlo total de uma determinada propriedade ao definir uma cadeia vazia quando a propriedade não se destina a ter um valor.

Para dados de múltiplos valores, como telefones, e-mails, projetos ou competências, a precedência de origem afeta apenas a ordenação de dados de várias origens. Os clientes decidem como consumir estes dados. O payload da API pode conter dados duplicados de várias origens.

Configurar a precedência de origem com o Microsoft Graph ou o PowerShell

Um administrador pode alterar a precedência de origem com as APIs do Microsoft Graph ou o PowerShell. Este guia descreve os passos necessários para adicionar ou atualizar as definições de propriedade do perfil relacionadas com a precedência de origem.

Os URLs de origem de prioridade são organizados de acordo com a precedência dos dados, com o primeiro item na coleção a ter a prioridade mais alta.

Observação

  • Quando configurar a precedência de origem com o Microsoft API do Graph, utilize o tipo de entidade profilePropertySetting que suporta as definições ao nível do inquilino e por propriedade. Uma vez que a precedência de origem é uma definição ao nível do inquilino, tem de omitir o nome e as propriedades displayName ou defini-las para null a diferenciar das definições ao nível da propriedade. Só é permitida uma configuração sem nome por coleção de definições de propriedades de perfil.
  • Em prioritizedSourceUrls, os URLs listados podem utilizar o ou /v1.0 o /beta ponto final. A configuração da prioridade da propriedade do perfil e os dados subjacentes são partilhados em ambos os pontos finais, pelo que especificar um dos pontos finais tem o mesmo efeito.
  • Não deve eliminar um perfilPropertySetting que inclua uma configuração de precedência de origem. Em vez disso, aplicação de patches para um estado predefinido que contém apenas a referência de origem do ID de Entra. Uma operação Eliminar só é suportada depois de a definição ter sido corrigida para este estado predefinido e falha, a menos que a propriedade prioritizedSourceUrls contenha apenas a referência de origem do ID de Entra.

Importante

Quando define uma nova origem de perfil como uma prioridade, os valores das propriedades que os utilizadores na sua organização veem nos perfis de utilizador nas aplicações do Microsoft 365 mudam. Por predefinição, Entra ID é a origem prioritária de dados de perfil numa organização.

Configurar definições de precedência de origem de perfil com o Microsoft API do Graph

Pode utilizar a API profilePropertySetting para configurar a precedência da origem do perfil na sua organização.

Confirmar as definições atuais

Utilize a operação Lista para devolver as definições atuais das definições de propriedade do perfil na sua organização.

O exemplo seguinte obtém a coleção de definições de propriedades de perfil numa organização.

GET https://graph.microsoft.com/v1.0/admin/people/profilePropertySettings

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto profilePropertySetting no corpo da resposta.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "value": [
    {
      "id": "00000000-0000-0000-0000-000000000001",
      "name": null,
      "prioritizedSourceUrls": [
        "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
      ],
      "displayName": null
    }
  ]
}

Adicionar definição de precedência de origem do perfil inicial

Utilize a operação Criar para adicionar a definição de precedência de origem do perfil à sua organização. Só é possível criar uma definição de precedência de origem.

O pedido seguinte define a ordem de precedência:

  1. Uma instância do conector com o ID de contosohr1origem .
  2. Entra ID com o ID 4ce763dd-9214-4eff-af7c-da491cc3782dde origem fixo .

Solicitação

POST https://graph.microsoft.com/v1.0/admin/people/profilePropertySettings
Content-Type: application/json

{
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ]
}

Se for bem-sucedido, este método devolve um 201 Created código de resposta e um objeto profilePropertySetting no corpo da resposta.

Resposta

HTTP/1.1 201 Created
Content-type: application/json

{
  "id": "00000000-0000-0000-0000-000000000001",
  "name": null,
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ],
  "displayName": null
}

Atualizar definição de precedência de origem do perfil

Utilize a operação Atualizar para modificar a definição de precedência de origem do perfil na sua organização.

O exemplo seguinte adiciona outro ID de origem do conector, contosohr2, em comparação com o exemplo de operação de criação anterior (POST).

Solicitação

PATCH https://graph.microsoft.com/v1.0/admin/people/profilePropertySettings/00000000-0000-0000-0000-000000000001
Content-Type: application/json

{
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr2')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ]
}

Se for bem-sucedido, este método devolve um 200 OK código de resposta e um objeto profilePropertySetting no corpo da resposta.

Resposta

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "00000000-0000-0000-0000-000000000001",
  "name": null,
  "prioritizedSourceUrls": [
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr1')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='contosohr2')",
    "https://graph.microsoft.com/v1.0/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
  ],
  "displayName": null
}

Remover definição de precedência de origem do perfil

Utilize a operação Eliminar para remover a definição de precedência de origem do perfil na sua organização depois de a corrigir novamente para o estado predefinido que contém apenas a referência de origem do ID de Entra.

Solicitação

DELETE https://graph.microsoft.com/v1.0/admin/people/profilePropertySettings/00000000-0000-0000-0000-000000000001

Se tiver êxito, este método retornará um código de resposta 204 No Content.

Resposta

HTTP/1.1 204 No Content

Configurar a definição de precedência de origem do perfil com o SDK do PowerShell do Microsoft Graph

Pode utilizar o SDK do PowerShell do Microsoft Graph para configurar as definições de precedência de origem do perfil na sua organização.

Pré-requisitos

Observação

Os comandos do PowerShell para as definições de precedência de origem do perfil só estão disponíveis na versão beta. Mude para a experiência beta antes de executar os seguintes comandos.

Install-Module -Name Microsoft.Graph.Beta -MinimumVersion 2.3.0
Update-Module Microsoft.Graph.Beta

Confirmar as definições atuais

Para obter a configuração das definições de propriedade do perfil para uma organização, utilize o seguinte comando.

Get-MgBetaAdminPeopleProfilePropertySetting

Para obter a configuração da precedência de origem do perfil numa organização, utilize o seguinte comando.

Get-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Observação

Os comandos get requerem a PeopleSettings.Read.All permissão. Para criar uma sessão do Microsoft Graph com um âmbito necessário específico, utilize o seguinte comando e consentimento para as permissões pedidas.

Connect-MgGraph -Scopes "PeopleSettings.Read.All"

Adicionar definição de precedência de origem de perfil na sua organização

Pode utilizar o módulo do PowerShell do Microsoft Graph para configurar a precedência de perfis na sua organização. O novo comando requer a permissão PeopleSettings.ReadWrite.All e para criar uma sessão do Microsoft Graph com o âmbito necessário específico, utilize o seguinte comando e consentimento para as permissões pedidas.

Connect-MgGraph -Scopes "PeopleSettings.ReadWrite.All","PeopleSettings.Read.All"

$params = @{
    prioritizedSourceUrls = @(
        "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='hrPlatform1')",
        "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
    )
}

New-MgBetaAdminPeopleProfilePropertySetting -BodyParameter $params

Atualizar a definição de precedência de origem do perfil na sua organização

Pode utilizar o módulo do PowerShell do Microsoft Graph para atualizar a definição de precedência da origem de perfil na sua organização. O comando update requer a permissão PeopleSettings.ReadWrite.All e para criar uma sessão do Microsoft Graph com o âmbito necessário específico, utilize o seguinte comando e consentimento para as permissões pedidas.

Connect-MgGraph -Scopes "PeopleSettings.ReadWrite.All","PeopleSettings.Read.All"

$params = @{
    prioritizedSourceUrls = @(
        "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='contosohr1')",
        "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='contosohr2')",
        "https://graph.microsoft.com/beta/admin/people/profileSources(sourceId='4ce763dd-9214-4eff-af7c-da491cc3782d')"
    )
}

Update-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id -BodyParameter $params

Remover a definição de precedência de origem do perfil na sua organização

Pode utilizar o módulo do PowerShell do Microsoft Graph para remover a definição de precedência de origem do perfil da sua organização. O comando remover requer a permissão PeopleSettings.ReadWrite.All e para criar uma sessão do Microsoft Graph com o âmbito necessário específico, utilize o seguinte comando e consentimento para as permissões pedidas.

Connect-MgGraph -Scopes "PeopleSettings.ReadWrite.All","PeopleSettings.Read.All"

Remove-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Conteúdo relacionado

  • Last updated on