Ajouter ou supprimer des attributs personnalisés de la carte de visite à l’aide de l’API de carte de visite (préversion)

  • Article
  • 3 minutes de lecture

Sur la carte de visite dans Microsoft 365, vous pouvez trouver des informations sur les utilisateurs stockés et gérés par votre organisation, par exemple Poste ou Emplacement de bureau.

Utilisez la ressource profileCardProperty pour afficher des propriétés supplémentaires à partir d’Azure AD sur les cartes de visite pour une organisation, en procédant comme suit :

  • Rendre les attributs supplémentaires visibles
  • Ajout d’attributs personnalisés

D’autres propriétés s’affichent dans la section Contact de la carte de visite dans Microsoft 365.

Vous pouvez également supprimer des attributs personnalisés des cartes de visite de l’organisation.

Remarque

Les opérations sur la ressource profileCardProperty qui utilisent des autorisations déléguées nécessitent que l’utilisateur connecté ait un rôle d’administrateur général ou d’administrateur de clients.

Rendre les attributs supplémentaires visibles

Vous pouvez rendre les attributs suivants d'Azure Active Directory (Azure AD) visibles sur les cartes de visite des utilisateurs. Ces attributs ne respectent pas la casse:

  • UserPrincipalName
  • Fax
  • StreetAddress
  • PostalCode
  • StateOrProvince
  • Alias

Le tableau suivant montre comment les attributs Azure AD correspondent aux propriétés de l’entité utilisateur Microsoft Graph.

Attribut Azure Active Directory Propriété de l’entité utilisateur
UserPrincipalName userPrincipalName
Fax faxNumber
StreetAddress streetAddress
PostalCode postalCode
StateOrProvince état
Alias mailNickname

Vous pouvez ajouter l’un de ces attributs à la carte de visite en configurant vos paramètres d’organisation et en ajoutant l’attribut en tant que propriété directoryPropertyName* d’une profileCardProperty dans Microsoft Graph. Lorsque vous rendez d’autres attributs visibles, vous devez utiliser les noms de propriétés pour en-us. Vous n’êtes pas obligé d’ajouter des valeurs localisées. Les propriétés supplémentaires s’affichent automatiquement dans les paramètres de langue spécifiés par l’utilisateur pour Microsoft 365.

Importante

Lors de l’ajout d’un attribut à une carte de visite, l’ajout de l’ajout prend jusqu’à 24 heures.

Exemple

L’exemple suivant affiche l’attribut Alias sur la carte de visite :

POST https://graph.microsoft.com/beta/organization/{tenantid}/settings/profileCardProperties
Content-Type: application/json

{
  "directoryPropertyName": "Alias"
}

Si elle réussit, la réponse renvoie un code de réponse 201 OK et un objet profileCardProperty dans le corps de la réponse. La valeur de l’attribut Alias s’affiche dans la carte de visite d’un utilisateur.

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

{
  "directoryPropertyName": "Alias",
  "annotations": []
}

Ajouter un attribut personnalisé

Vous pouvez ajouter n’importe lequel des 15 attributs d’extension personnalisée d’Azure AD aux cartes de visite des utilisateurs en configurant les paramètres de votre organisation et en ajoutant la valeur correspondante en tant que profileCardProperty dans Microsoft Graph. Vous pouvez ajouter une ressource profileCardProperty à la fois.

L’affichage des modifications sur les cartes de profil prend jusqu’à 24 heures.

Les propriétés personnalisées ne peuvent pas faire l’objet d’une recherche et ne peuvent pas être utilisées pour rechercher des contacts dans les applications et services Microsoft.

Le tableau suivant indique la correspondance entre les noms d’attribut d’extension personnalisés Azure AD et les valeurs prises en charge pour la propriété directoryPropertyName de la ressource profileCardProperty. Ces noms d’attributs d’extension personnalisés d’Azure AD ne respectent pas la casse:

Attribut d’extension personnalisée d’Azure AD Valeur à spécifier comme directoryPropertyName
extensionAttribute1 customAttribute1
extensionAttribute2 customAttribute2
extensionAttribute3 customAttribute3
extensionAttribute4 customAttribute4
extensionAttribute5 customAttribute5
extensionAttribute6 customAttribute6
extensionAttribute7 customAttribute7
extensionAttribute8 customAttribute8
extensionAttribute9 customAttribute9
extensionAttribute10 customAttribute10
extensionAttribute11 customAttribute11
extensionAttribute12 customAttribute12
extensionAttribute13 customAttribute13
extensionAttribute14 customAttribute14
extensionAttribute15 customAttribute15

Exemple

L’exemple suivant montre comment ajouter le premier attribut d’extension personnalisée d’Azure AD à la carte de visite, à l’aide du nom complet Centre de coûts. Pour les utilisateurs qui ont défini leurs paramètres linguistiques sur l'allemand, le nom complet est Kostenstelle.

Demande

POST https://graph.microsoft.com/beta/organization/{tenantid}/settings/profileCardProperties
Content-Type: application/json

{
  "directoryPropertyName": "customAttribute1",
  "annotations": [
    {
      "displayName": "Cost center",
      "localizations": [
        {
          "languageTag": "de",
          "displayName": "Kostenstelle"
        }
      ]
    }
  ]
}

Si une langue n’est pas prise en charge, le nom de la propriété s’affiche avec la valeur par défaut.

Si elle réussit, la réponse renvoie un code de réponse 201 OK et un objet profileCardProperty dans le corps de la réponse. Dans cet exemple, vous pouvez supposer que la carte de visite affiche Kostenstelle pour tous les utilisateurs qui ont défini leurs paramètres linguistiques sur l’allemand sur la carte de visite. Pour tous les autres utilisateurs, Centre de coûts s’affiche sur la carte de visite.

Réponse

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

{
  "directoryPropertyName": "customAttribute1",
  "annotations": [
    {
      "displayName": "Cost center",
      "localizations": [
        {
          "languageTag": "de",
          "displayName": "Kostenstelle"
        }
      ]
    }
  ]
}

Supprimer un attribut personnalisé

En suivant le même mappage entre les attributs d’extension personnalisés Azure AD et les attributs personnalisés de carte de visite (tels que customAttribute1) comme décrit dans la section précédente Ajout d’un attribut personnalisé, vous pouvez supprimer un attribut personnalisé à l’aide de l’opération supprimer, comme illustré dans l’exemple ci-dessous.

Exemple

L’exemple suivant supprime l’attribut personnalisé customAttribute5 des paramètres de l’organisation. Une suppression réussie renvoie HTTP 204.

Demande

DELETE https://graph.microsoft.com/beta/organization/{organizationId}/settings/profileCardProperties/customAttribute5

Réponse

HTTP/1.1 204 No Content

Voir aussi