Cómo agregar atributos personalizados de perfiles de usuario al elemento web Employee Directory

Este artículo explica cómo mostrar propiedades personalizadas de perfiles de usuario de SharePoint en el elemento web Vitextra Employee Directory cuando utiliza el origen Perfiles de usuario: preparar la propiedad en SharePoint, hacerla accesible mediante la búsqueda y agregarla al elemento web como columna personalizada.

Introducción

Además de los campos integrados -nombre, puesto, departamento, teléfonos y otros-, Employee Directory puede mostrar cualquier atributo adicional que necesite: un centro de costes, un número de empleado, un edificio o una afición. Estos atributos se denominan columnas personalizadas y se configuran en el editor Columnas personalizadas del elemento web.

Con el origen Perfiles de usuario, el elemento web lee los datos de los empleados mediante la búsqueda de SharePoint. Por tanto, una propiedad personalizada del perfil solo está disponible una vez indexada y asignada a una propiedad administrada. El proceso consta de tres pasos:

1. Cree una propiedad de perfil de usuario, o reutilice una existente, y configure su indexación.
2. Asigne su propiedad rastreada a una propiedad administrada recuperable en el esquema de búsqueda.
3. Agregue la propiedad administrada al elemento web como columna personalizada.

Preparar la propiedad de perfil de usuario

Estos pasos se realizan en el Centro de administración de SharePoint y requieren permisos de administrador de SharePoint. Si la propiedad ya existe y está asignada a una propiedad administrada, vaya a Agregar la columna personalizada al elemento web.

Crear la propiedad de perfil de usuario

1. En el Centro de administración de SharePoint, vaya a Más características y seleccione Abrir en Perfiles de usuario.
2. En Personas, seleccione Administrar propiedades de usuario y después Nueva propiedad.
3. Introduzca el Nombre -el nombre interno, por ejemplo, CostCenter-, el Nombre para mostrar y el Tipo.
4. En Configuración de búsqueda, seleccione Indizado. Sin esta opción, la propiedad no se rastrea y el elemento web no puede mostrarla.
5. Establezca la directiva y la configuración de edición según los requisitos de su organización y seleccione Aceptar.

Rellene la propiedad para los usuarios, desde el perfil, mediante su proceso de importación o con un script. La búsqueda crea la propiedad rastreada People:<Name>, por ejemplo, People:CostCenter, al rastrear perfiles que contienen un valor para ella.

Asignarla a una propiedad administrada

1. En el Centro de administración de SharePoint, vaya a Más características y seleccione Abrir en Búsqueda.
2. Seleccione Administrar esquema de búsqueda.
3. Elija una propiedad administrada para el valor. La opción más sencilla es una de las propiedades integradas sin utilizar, RefinableString00–RefinableString99: ya permiten consultas, recuperación, refinamiento y ordenación. También puede crear una propiedad administrada de tipo Texto con la opción Recuperable activada.
4. Abra la propiedad administrada y, en Asignaciones a propiedades rastreadas, seleccione Agregar una asignación, busque People:<Name> y agréguela.
5. Guarde la propiedad administrada.

Anote el nombre exacto de la propiedad administrada, por ejemplo, RefinableString05, para introducirlo en el elemento web.

Agregar la columna personalizada al elemento web

1. Abra la página con Employee Directory, seleccione Editar y después el icono de edición, con forma de lápiz, del elemento web para abrir su panel de propiedades.
2. En la sección Origen de datos, compruebe que Origen de datos está establecido en Perfiles de usuario.
3. En Columnas personalizadas, seleccione Configurar.

4. Se abre el panel Columnas. En la fila vacía al final de la tabla, introduzca el nombre de la propiedad administrada en Columna y la etiqueta que verán los usuarios en Título. Elija dónde se mostrará la columna.
5. Seleccione Agregar nuevo elemento, el icono de suma al final de la fila. La columna se agrega a la tabla. Repita el proceso para cada atributo necesario.
6. Utilice Orden para cambiar la posición de las columnas y seleccione Guardar.
7. Vuelva a publicar la página.

Cada columna personalizada tiene las siguientes opciones:

Para quitar una columna personalizada, seleccione Eliminar fila, el icono de papelera al final de la fila, y después Guardar. Cancelar cierra el panel sin aplicar los cambios.

Dónde aparecen las columnas personalizadas

Una vez guardada, una columna personalizada puede utilizarse en los mismos lugares que los campos integrados:

• Vista Detalles: como columna de la lista, cuando está seleccionado Mostrar en la lista.
• Panel de detalles: debajo de los atributos integrados, cuando está seleccionado Mostrar en la tarjeta y la persona tiene un valor. Consulte KB10199. Employee Directory: personalizar el panel de detalles.
• Tarjetas de contacto: como una de las líneas seleccionadas en la sección Campos de contenido.
• Agrupar por: la lista Agrupar por de la sección Apariencia incluye todas las columnas personalizadas. Puede agrupar personas, por ejemplo, por centro de costes o edificio.
• Exportar a Excel: las columnas con Mostrar en la lista seleccionado se incluyen en la hoja de cálculo exportada.
• Panel de refinamiento: una propiedad administrada que permita refinamiento, como RefinableString05, también puede agregarse como refinador. Consulte KB10313. Cómo configurar el panel de refinamiento en Employee Directory.

Si una columna personalizada está vacía

Si la columna o el panel de detalles no muestra ningún valor, compruebe lo siguiente:

• La propiedad de perfil de usuario está marcada como Indizado y la persona tiene realmente un valor para ella.
• La propiedad rastreada People:<Name> está asignada a la propiedad administrada y esta es Recuperable.
• Los perfiles se han rastreado después de cambiar el esquema de búsqueda: las nuevas asignaciones no se aplican de inmediato.
• El nombre de Columna coincide exactamente con el de la propiedad administrada.

El panel de detalles solo muestra un atributo personalizado cuando contiene datos; los valores vacíos simplemente no aparecen.

Origen de datos Microsoft Entra ID

Cuando el elemento web lee datos de Microsoft Entra ID mediante Microsoft Graph, una columna personalizada hace referencia a una propiedad del objeto de usuario de Entra ID en lugar de a una propiedad administrada: una propiedad estándar del usuario, una extensión de directorio (extension_{appId}_{name}) o uno de los atributos de extensión locales extensionAttribute1–extensionAttribute15. El esquema de búsqueda no interviene.