Agregar o eliminar atributos personalizados en una tarjeta de perfil mediante la API de tarjeta de perfil (versión preliminar)

  • Artículo

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 muestran en la sección Contacto de la tarjeta de perfil de Microsoft 365.

También puede eliminar atributos personalizados de las tarjetas de perfil de la organización.

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 que los siguientes atributos de Azure Active Directory (Azure AD) sean visibles en las tarjetas de perfil de los usuarios. Estos atributos no distinguen mayúsculas de 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 un atributo personalizado

Puede agregar cualquiera de los 15 atributos de extensión personalizada de Azure AD a las tarjetas de perfil de los usuarios cambiando la configuración de su organización y agregando el valor correspondiente como un profileCardProperty en Microsoft Graph. Puede agregar un recurso profileCardProperty cada 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.

En la tabla siguiente se muestra la correspondencia de los nombres de atributo de extensión personalizada de Azure AD con los valores compatibles de la propiedad directoryPropertyName del recurso profileCardProperty. Estos nombres de atributo de extensión personalizada 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.

Solicitud

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.

Respuesta

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

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

Eliminar un atributo personalizado

Siguiendo la misma asignación entre Azure AD atributos de extensión personalizados y atributos personalizados de tarjeta de perfil (como customAttribute1), tal como se describe en la sección anterior Agregar un atributo personalizado, puede eliminar un atributo personalizado mediante la operación eliminar, como se muestra en el ejemplo siguiente.

Ejemplo

En el siguiente ejemplo se elimina el atributo personalizado customAttribute5 de la configuración de la organización. Una eliminación correcta devuelve HTTP 204.

Solicitud

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

Respuesta

HTTP/1.1 204 No Content

Vea también