Gérer la priorité de la source de profil dans Microsoft 365

La priorité de la source de profil est une fonctionnalité qui permet aux administrateurs de locataires de contrôler la source des données de profil pour les utilisateurs de leur organization. Les données de profil peuvent provenir de Microsoft Entra ID, de données organisationnelles dans Microsoft 365, de connecteurs Copilot pour les données de personnes, de SharePoint ou d’autres sources. Lorsque plusieurs sources fournissent des données qui se chevauchent, un administrateur client peut configurer la source faisant autorité des données de profil pour les utilisateurs dans leur organization. Cette fonctionnalité s’applique principalement aux données rh et de position de travail dans le profil utilisateur, qui est traité comme une valeur unique.

Pour plus d’informations sur les sources de données de personnes et les ID de source, consultez Gérer les paramètres de la source de profil pour un organization.

La priorité de la source liée aux données de rh et de position de travail est basée sur un classement par défaut par priorité de source :

  1. Connecteurs Copilot pour les données de personnes, s’ils sont configurés, y compris les connecteurs aux systèmes RH populaires et les connecteurs personnalisés. Un organization peut configurer plusieurs connexions. La dernière connexion configurée a la priorité la plus élevée. Chaque connexion a un ID source unique défini par l’administrateur.
  2. Microsoft Entra ID. L’ID source est 4ce763dd-9214-4eff-af7c-da491cc3782d.
  3. Données organisationnelles dans Microsoft 365. L’ID source est 7986c642-b494-4140-8df4-f5ed125e2c67. Pour plus d’informations sur les sources client associées à cette source Microsoft 365, consultez Données organisationnelles dans Microsoft 365.

Il existe d’autres sources de données de personnes, mais seules les sources répertoriées sont pertinentes lorsque vous choisissez la valeur faisant autorité pour les données de rh ou de poste de travail et lorsque vous appliquez la configuration de priorité de la source de l’administrateur client, comme décrit dans cet article.

Remarque

  • La source de l’application de profil utilisateur SharePoint (UPA) est pertinente pour un cas d’angle de priorité de source. Par exemple, si un utilisateur configure un assistant exécutif via les personnes carte et que le système RH définit un assistant exécutif différent pour le même utilisateur, les personnes carte hiérarchisent la valeur entrée par l’utilisateur lorsque les valeurs diffèrent. Cet ordre ne peut pas être modifié.
  • Si les données de rh ou de position de travail sont écrites à l’aide de la source utilisateur de l’API de profil (/me/profile ou /users/{id | userPrincipalName}/profile sur Microsoft Graph bêta, y compris via graph Explorer), ces données ne remplacent pas les sources de connecteur ou d’ID Entra. Lorsque vous lisez les données de profil à l’aide du API Graph Microsoft, les données apparaissent dans OData sous la forme d’un instance distinct dans la collection d’entités workPosition.

Un administrateur peut modifier l’ordre des sources répertoriées précédemment ; par exemple, en accordant à Entra ID une priorité plus élevée qu’un connecteur ou en modifiant la priorité sur plusieurs sources de connecteur. La priorité des sources client derrière les données organisationnelles dans Microsoft 365 est gérée séparément dans les données organisationnelles dans la plateforme Microsoft 365 .

Comment la priorité de la source affecte la représentation des personnes

La priorité de la source affecte principalement les données à valeur unique. Dans ce contexte, une valeur unique signifie qu’une valeur faisant autorité existe pour une propriété donnée dans la représentation de personnes résultante. Les données à valeur unique incluent la position de travail, les données de nom et les données de compte.

Pour les données à valeur unique, la logique métier sélectionne la valeur d’une propriété à partir de la source de priorité la plus élevée qui a une valeur. Les données provenant de sources de priorité inférieure sont ignorées lorsqu’une source de priorité plus élevée fournit une valeur pour la propriété .

Remarque

Il existe une différence significative entre une valeur ou une chaîne vide et une valeur null, ou une propriété qui ne fait pas partie de l’ingestion du connecteur. Par exemple, une chaîne vide ("") est traitée comme une valeur et remplace une source de priorité inférieure qui a une chaîne non vide. Ce comportement permet à une source de connecteur d’avoir le contrôle total d’une propriété donnée en définissant une chaîne vide lorsque la propriété n’est pas destinée à avoir de valeur.

Pour les données à valeurs multiples telles que les téléphones, les e-mails, les projets ou les compétences, la priorité de la source affecte uniquement l’ordre des données provenant de plusieurs sources. Les clients décident comment consommer ces données. La charge utile de l’API peut contenir des données en double provenant de plusieurs sources.

Configurer la priorité de la source à l’aide de Microsoft Graph ou de PowerShell

Un administrateur peut modifier la priorité de la source à l’aide des API Microsoft Graph ou de PowerShell. Ce guide décrit les étapes nécessaires pour ajouter ou mettre à jour les paramètres de propriété de profil liés à la priorité de la source.

Les URL sources de priorité sont organisées en fonction de la priorité des données, le premier élément de la collection ayant la priorité la plus élevée.

Remarque

  • Lorsque vous configurez la priorité de la source à l’aide du API Graph Microsoft, utilisez le type d’entité profilePropertySetting qui prend en charge les paramètres au niveau du locataire et par propriété. Étant donné que la priorité de la source est un paramètre au niveau du locataire, vous devez omettre les propriétés name et displayName ou les définir sur null pour les différencier des paramètres au niveau de la propriété. Une seule configuration sans nom est autorisée par collection de paramètres de propriété de profil.
  • Dans priordSourceUrls, les URL répertoriées peuvent utiliser le point de /beta terminaison ou /v1.0 . La configuration de priorité de la propriété de profil et les données sous-jacentes sont partagées entre les deux points de terminaison, de sorte que la spécification de l’un ou l’autre des points de terminaison a le même effet.
  • Vous ne devez pas supprimer un profilePropertySetting qui inclut une configuration de priorité source. Au lieu de cela, corrigez-le à un état par défaut qui contient uniquement la référence source de l’ID Entra. Une opération Delete est prise en charge uniquement après que le paramètre a été corrigé à cet état par défaut, et elle échoue, sauf si la propriété priordSourceUrls contient uniquement la référence source de l’ID Entra.

Importante

Lorsque vous définissez une nouvelle source de profil comme priorité, les valeurs des propriétés que les utilisateurs de votre organization voient sur les profils utilisateur dans les applications Microsoft 365 changent. Par défaut, l’ID Entra est la source prioritaire des données de profil dans un organization.

Configurer les paramètres de priorité de la source de profil à l’aide de Microsoft API Graph

Vous pouvez utiliser l’API profilePropertySetting pour configurer la priorité de la source de profil dans votre organization.

Confirmer vos paramètres actuels

Utilisez l’opération Liste pour renvoyer les paramètres actuels des paramètres de propriété de profil dans votre organization.

L’exemple suivant obtient la collection de paramètres de propriété de profil dans un organization.

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

Si elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet profilePropertySetting dans le corps de la réponse.

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

Ajouter le paramètre de priorité de la source de profil initial

Utilisez l’opération Créer pour ajouter le paramètre de priorité de la source de profil pour votre organization. Un seul paramètre de priorité source peut être créé.

La requête suivante définit l’ordre de priorité :

  1. Un connecteur instance avec l’ID contosohr1source .
  2. ID Entra avec l’ID 4ce763dd-9214-4eff-af7c-da491cc3782dde source fixe .

Demande

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 elle réussit, cette méthode renvoie un 201 Created code de réponse et un objet profilePropertySetting dans le corps de la réponse.

Réponse

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
}

Mettre à jour le paramètre de priorité de la source de profil

Utilisez l’opération De mise à jour pour modifier le paramètre de priorité de la source de profil dans votre organization.

L’exemple suivant ajoute un autre ID source de connecteur, contosohr2, par rapport à l’exemple d’opération de création (POST) précédent.

Demande

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 elle réussit, cette méthode renvoie un 200 OK code de réponse et un objet profilePropertySetting dans le corps de la réponse.

Réponse

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
}

Supprimer le paramètre de priorité de la source de profil

Utilisez l’opération Supprimer pour supprimer le paramètre de priorité de la source de profil dans votre organization après avoir rétabli l’état par défaut qui contient uniquement la référence source de l’ID Entra.

Demande

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

Si elle réussit, cette méthode renvoie un code de réponse 204 No Content.

Réponse

HTTP/1.1 204 No Content

Configurer le paramètre de priorité de la source de profil à l’aide du Kit de développement logiciel (SDK) Microsoft Graph PowerShell

Vous pouvez utiliser le Kit de développement logiciel (SDK) Microsoft Graph PowerShell pour configurer les paramètres de priorité de la source de profil dans votre organization.

Configuration requise

Remarque

Les commandes PowerShell pour les paramètres de priorité de la source de profil sont disponibles uniquement dans la version bêta. Basculez vers l’expérience bêta avant d’exécuter les commandes suivantes.

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

Confirmer vos paramètres actuels

Pour obtenir la configuration des paramètres de propriété de profil pour un organization, utilisez la commande suivante.

Get-MgBetaAdminPeopleProfilePropertySetting

Pour obtenir la configuration de priorité de la source de profil dans un organization, utilisez la commande suivante.

Get-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Remarque

Les commandes get nécessitent l’autorisation PeopleSettings.Read.All . Pour créer une session Microsoft Graph avec une étendue requise spécifique, utilisez la commande suivante et consentez aux autorisations demandées.

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

Ajouter le paramètre de priorité de la source de profil dans votre organization

Vous pouvez utiliser le module Microsoft Graph PowerShell pour configurer la priorité des profils dans votre organization. La nouvelle commande nécessite l’autorisation PeopleSettings.ReadWrite.All. Pour créer une session Microsoft Graph avec l’étendue requise spécifique, utilisez la commande suivante et donnez votre consentement aux autorisations demandées.

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

Mettre à jour le paramètre de priorité de la source de profil dans votre organization

Vous pouvez utiliser le module Microsoft Graph PowerShell pour mettre à jour le paramètre de priorité de la source de profil dans votre organization. La commande de mise à jour nécessite l’autorisation PeopleSettings.ReadWrite.All. Pour créer une session Microsoft Graph avec l’étendue requise spécifique, utilisez la commande suivante et consentez aux autorisations demandées.

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

Supprimer le paramètre de priorité de la source de profil dans votre organization

Vous pouvez utiliser le module Microsoft Graph PowerShell pour supprimer le paramètre de priorité de la source de profil de votre organization. La commande remove nécessite l’autorisation PeopleSettings.ReadWrite.All. Pour créer une session Microsoft Graph avec l’étendue requise spécifique, utilisez la commande suivante et donnez votre consentement aux autorisations demandées.

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

Remove-MgBetaAdminPeopleProfilePropertySetting -ProfilePropertySettingId $id

Contenu connexe

  • Last updated on