Administración de la prioridad de origen del perfil en Microsoft 365

La prioridad del origen de perfil es una característica que permite a los administradores de inquilinos controlar el origen de los datos de perfil para los usuarios de su organización. Los datos de perfil pueden originarse en Microsoft Entra ID, datos de la organización en Microsoft 365, conectores de Copilot para datos de personas, SharePoint u otros orígenes. Cuando varios orígenes proporcionan datos superpuestos, un administrador de inquilinos puede configurar el origen autoritativo de datos de perfil para los usuarios de su organización. Esta funcionalidad se aplica principalmente a los datos de RRHH y de posición de trabajo en el perfil de usuario, que se tratan como de un solo valor.

Para obtener más información sobre los orígenes de datos de personas y los identificadores de origen, consulte Administración de la configuración del origen de perfil para una organización.

La prioridad de origen relacionada con los datos de RRHH y de posición de trabajo se basa en una ordenación predeterminada por prioridad de origen:

  1. Conectores de Copilot para datos de personas, si están configurados, incluidos conectores para sistemas de RR. HH. populares y conectores personalizados. Una organización puede configurar más de una conexión. La conexión configurada más recientemente tiene la prioridad más alta. Cada conexión tiene un identificador de origen único definido por el administrador.
  2. Microsoft Entra ID. El identificador de origen es 4ce763dd-9214-4eff-af7c-da491cc3782d.
  3. Datos de la organización en Microsoft 365. El identificador de origen es 7986c642-b494-4140-8df4-f5ed125e2c67. Para obtener más información sobre los orígenes de clientes asociados a este origen de Microsoft 365, consulte Datos de la organización en Microsoft 365.

Existen otros orígenes de datos de personas, pero solo los orígenes enumerados son pertinentes cuando se elige el valor autoritativo para los datos de RRHH o de posición de trabajo y cuando se aplica la configuración de precedencia del origen del administrador de inquilinos, como se describe en este artículo.

Nota:

  • El origen de la aplicación de perfil de usuario (UPA) de SharePoint es relevante para un caso de esquina de precedencia de origen. Por ejemplo, si un usuario configura un asistente ejecutivo a través de la tarjeta de personas y el sistema de RR. HH. define un asistente ejecutivo diferente para el mismo usuario, la tarjeta de contacto prioriza el valor especificado por el usuario cuando los valores difieren. Este orden no se puede cambiar.
  • Si los datos de RRHH o posición de trabajo se escriben mediante el origen de usuario de la API de perfil (/me/profileo /users/{id | userPrincipalName}/profile en la versión beta de Microsoft Graph, incluido a través del Explorador de Graph), estos datos no invalidan el conector ni Entra orígenes de identificador. Al leer los datos de perfil mediante microsoft Graph API, los datos aparecen en OData como una instancia independiente de la colección de entidades workPosition.

Un administrador puede cambiar el orden de los orígenes enumerados anteriormente; por ejemplo, al dar a Entra identificador una prioridad mayor que un conector o cambiar la prioridad entre varios orígenes de conector. La prioridad de los orígenes de clientes detrás de los datos organizativos de Microsoft 365 se administra por separado en los datos de la organización de la plataforma Microsoft 365 .

Cómo afecta la prioridad de origen a la representación de personas

La precedencia de origen afecta principalmente a los datos de un solo valor. En este contexto, el valor único significa que existe un valor autoritativo para una propiedad determinada en la representación de personas resultante. Los datos de valor único incluyen la posición del trabajo, los datos de nombre y los datos de la cuenta.

En el caso de los datos de valor único, la lógica de negocios selecciona el valor de una propiedad del origen de mayor prioridad que tiene un valor. Los datos de orígenes de prioridad inferior se omiten cuando un origen de prioridad superior proporciona un valor para la propiedad .

Nota:

Existe una diferencia significativa entre un valor vacío o una cadena y un valor NULL, o una propiedad que no forma parte de la ingesta del conector. Por ejemplo, una cadena vacía ("") se trata como un valor e invalida un origen de prioridad inferior que tiene una cadena no vacía. Este comportamiento permite que un origen del conector tenga control total de una propiedad determinada estableciendo una cadena vacía cuando la propiedad no está pensada para tener un valor.

En el caso de los datos de varios valores, como teléfonos, correos electrónicos, proyectos o aptitudes, la prioridad del origen solo afecta al orden de los datos de varios orígenes. Los clientes deciden cómo consumir estos datos. La carga de API puede contener datos duplicados de varios orígenes.

Configuración de la prioridad de origen mediante Microsoft Graph o PowerShell

Un administrador puede cambiar la prioridad de origen mediante las API de Microsoft Graph o PowerShell. En esta guía se describen los pasos necesarios para agregar o actualizar la configuración de propiedades del perfil relacionada con la prioridad de origen.

Las direcciones URL de origen de prioridad se organizan según la prioridad de los datos, con el primer elemento de la colección con la prioridad más alta.

Nota:

  • Al configurar la prioridad de origen mediante microsoft Graph API, use el tipo de entidad profilePropertySetting que admite la configuración de nivel de inquilino y por propiedad. Dado que la prioridad de origen es una configuración de nivel de inquilino, debe omitir las propiedades name y displayName o establecerlas null en para diferenciarlas de la configuración de nivel de propiedad. Solo se permite una configuración sin un nombre por colección de valores de propiedad de perfil.
  • En prioritizedSourceUrls, las direcciones URL enumeradas pueden usar el /beta punto de conexión o /v1.0 . La configuración de prioridad de la propiedad de perfil y los datos subyacentes se comparten entre ambos puntos de conexión, por lo que especificar cualquiera de los puntos de conexión tiene el mismo efecto.
  • No debe eliminar un profilePropertySetting que incluya una configuración de precedencia de origen. En su lugar, re patch it to a default state that contains only the Entra ID source reference. Una operación Delete solo se admite después de que la configuración se haya revisado a este estado predeterminado y se produzca un error a menos que la propiedad prioritizedSourceUrls contenga solo la referencia de origen del identificador de Entra.

Importante

Al establecer un nuevo origen de perfil como prioridad, cambian los valores de las propiedades que los usuarios de su organización ven en los perfiles de usuario de las aplicaciones de Microsoft 365. De forma predeterminada, Entra id. es el origen prioritario de los datos de perfil de una organización.

Configuración de la precedencia del origen del perfil mediante microsoft Graph API

Puede usar profilePropertySetting API para configurar la prioridad del origen de perfil en su organización.

Confirmación de la configuración actual

Use la operación List para devolver la configuración actual de la configuración de propiedades de perfil de su organización.

En el ejemplo siguiente se obtiene la colección de valores de propiedad de perfil de una organización.

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

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto profilePropertySetting en el cuerpo de la respuesta.

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

Adición de la configuración de precedencia de origen del perfil inicial

Use la operación Crear para agregar la configuración de prioridad de origen de perfil para su organización. Solo se puede crear una configuración de precedencia de origen.

La solicitud siguiente define el orden de precedencia:

  1. Una instancia del conector con el identificador contosohr1de origen .
  2. Entra identificador con id4ce763dd-9214-4eff-af7c-da491cc3782d. de origen fijo.

Solicitud

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

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto profilePropertySetting en el cuerpo de la respuesta.

Respuesta

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
}

Actualizar la configuración de precedencia del origen del perfil

Use la operación Actualizar para modificar la configuración de precedencia del origen del perfil en su organización.

En el ejemplo siguiente se agrega otro identificador de origen del conector, contosohr2, en comparación con el ejemplo de operación de creación (POST) anterior.

Solicitud

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

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto profilePropertySetting en el cuerpo de la respuesta.

Respuesta

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
}

Eliminación de la configuración de precedencia del origen del perfil

Use la operación Eliminar para quitar la configuración de precedencia de origen de perfil de la organización después de aplicar la revisión al estado predeterminado que contiene solo la referencia de origen de identificador de Entra.

Solicitud

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

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.

Respuesta

HTTP/1.1 204 No Content

Configuración de la configuración de precedencia del origen del perfil mediante el SDK de PowerShell de Microsoft Graph

Puede usar el SDK de PowerShell de Microsoft Graph para configurar los valores de precedencia del origen de perfil en su organización.

Requisitos previos

Nota:

Los comandos de PowerShell para la configuración de precedencia del origen de perfil solo están disponibles en versión beta. Cambie a la experiencia beta antes de ejecutar los siguientes comandos.

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

Confirmación de la configuración actual

Para obtener la configuración de la propiedad de perfil para una organización, use el siguiente comando.

Get-MgBetaAdminPeopleProfilePropertySetting

Para obtener la configuración de precedencia del origen del perfil en una organización, use el siguiente comando.

Get-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Nota:

Los comandos get requieren el PeopleSettings.Read.All permiso . Para crear una sesión de Microsoft Graph con un ámbito necesario específico, use el siguiente comando y dé su consentimiento a los permisos solicitados.

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

Adición de la configuración de precedencia de origen de perfil en la organización

Puede usar el módulo de PowerShell de Microsoft Graph para configurar la prioridad de perfil en su organización. El nuevo comando requiere el permiso PeopleSettings.ReadWrite.All y para crear una sesión de Microsoft Graph con el ámbito necesario específico, use el siguiente comando y dé su consentimiento a los permisos solicitados.

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

Actualizar la configuración de precedencia del origen del perfil en la organización

Puede usar el módulo de PowerShell de Microsoft Graph para actualizar la configuración de precedencia del origen del perfil en su organización. El comando update requiere el permiso PeopleSettings.ReadWrite.All y, para crear una sesión de Microsoft Graph con el ámbito necesario específico, use el siguiente comando y dé su consentimiento a los permisos solicitados.

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

Eliminación de la configuración de precedencia del origen del perfil en la organización

Puede usar el módulo de PowerShell de Microsoft Graph para quitar la configuración de precedencia de origen de perfil de su organización. El comando remove requiere el permiso PeopleSettings.ReadWrite.All y, para crear una sesión de Microsoft Graph con el ámbito necesario específico, use el siguiente comando y dé su consentimiento a los permisos solicitados.

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

Remove-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Contenido relacionado

  • Last updated on