Agregar propiedades adicionales a la tarjeta de perfil con la API de tarjeta de perfil en Microsoft Graph (versión preliminar)

En la tarjeta de perfil de Microsoft 365, puede encontrar la información de los usuarios que almacena y conserva la organización, por ejemplo Puesto o Ubicación en la oficina.

Use el recurso profileCardProperty para mostrar otras propiedades de Azure AD en las tarjetas de perfil de la organización. Para ello tiene 2 opciones:

  • Hacer que otros atributos sean visibles.
  • Agregar atributos personalizados.

Las propiedades adicionales se mostrarán en la sección Contacto de la tarjeta de perfil de Microsoft 365.

Nota

Las operaciones sobre el recurso profileCardProperty que utilizan permisos delegados requieren que el usuario que ha iniciado la sesión tenga un rol de administrador de inquilinos o de administrador global.

Hacer que otros atributos sean visibles.

Puede hacer visibles los siguientes atributos de Azure Active Directory (Azure AD) en las tarjetas de perfil de los usuarios. Estos atributos no distinguen entre mayúsculas y minúsculas:

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

En la tabla siguiente se muestra cómo se corresponden los atributos de Azure AD con las propiedades de Microsoft Graph de la entidad user.

Atributo de Azure AD Propiedad de entidad del usuario
UserPrincipalName userPrincipalName
Fax faxNumber
StreetAddress streetAddress
PostalCode postalCode
StateOrProvince state
Alias mailNickname

Puede agregar cualquiera de estos atributos a la tarjeta de perfil configurando los ajustes de su organización y añadiendo el atributo como la propiedad directoryPropertyName de un profileCardProperty en Microsoft Graph. Cuando haga que otros atributos sean visibles, debe usar los nombres de propiedades de en-us. No es necesario que agregue valores traducidos. Las propiedades adicionales se mostrarán automáticamente en la configuración de idioma que el usuario especificó para Microsoft 365.

Importante

Cuando se agrega un atributo a la tarjeta de perfil, puede tardar hasta 24 horas en aparecer.

Ejemplo

El siguiente ejemplo muestra el Alias atributo en la tarjeta de perfil.

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

{
  "directoryPropertyName": "Alias"
}

Si se ejecuta correctamente, esta respuesta devuelve un código de respuesta 201 OK y el objeto profileCardProperty en el cuerpo de la respuesta. El valor del atributo Alias se mostraría en la tarjeta de perfil de un usuario.

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

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

Agregar atributos personalizados.

Puede agregar cualquiera de los 15 atributos de extensión personalizados de Azure AD a las tarjetas de perfil de los usuarios configurando los ajustes de su organización y agregando el valor correspondiente como profileCardPropertyy en Microsoft Graph. Puede agregar un recurso profileCardProperty a la vez.

Los cambios tardan hasta 24 horas en mostrarse en las tarjetas de perfil.

Las propiedades personalizadas no se pueden buscar y no se pueden usar para buscar contactos en aplicaciones y servicios de Microsoft.

La siguiente tabla muestra cómo los nombres de atributos de extensión personalizados de Azure AD se corresponden con los valores admitidos para la propiedad directoryPropertyName del recurso profileCardProperty. Estos nombres de atributos de extensión personalizados de Azure AD no distinguen entre mayúsculas y minúsculas:

Atributo de extensión personalizada de Azure AD Valor que se especifica como 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

Ejemplo

En el ejemplo siguiente se agrega el primer atributo de extensión personalizada de Azure AD a la tarjeta de perfil, con el nombre para mostrar Cost center. Para los usuarios que hayan establecido la configuración de idioma en alemán, el nombre para mostrar es Kostenstelle.

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 no se admite un idioma determinado, el nombre de la propiedad se mostrará con el valor predeterminado.

Si se ejecuta correctamente, esta respuesta devuelve un código de respuesta 201 OK y el objeto profileCardProperty en el cuerpo de la respuesta. En este ejemplo, puede suponer que la tarjeta de perfil muestra Kostenstelle para todos los usuarios que han establecido la configuración de idioma en alemán en la tarjeta de perfil. Todos los demás usuarios tendrán en la tarjeta de perfil Cost center.

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

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

Consulta también