Employee Directory Introducción
Vitextra Employee Directory lee información de empleados en Microsoft 365: en Microsoft Entra ID mediante Microsoft Graph, o en perfiles de SharePoint mediante la búsqueda de SharePoint. El elemento web de Entra ID puede guardar una copia en la caché del navegador. Los perfiles completos mejoran el directorio: los departamentos coherentes facilitan los filtros, las relaciones jerárquicas alimentan Mi equipo y los apellidos permiten la navegación A–Z.
Esta referencia se dirige a administradores de Microsoft 365, administradores de identidades y equipos de Recursos Humanos que mantienen los datos. Explica qué atributo utiliza cada función, dónde se edita, cuánto tardan en aparecer los cambios y qué comprobar antes de la puesta en producción.
💡 Sugerencia
Si aún no ha elegido un elemento web, consulte KB10310. Employee Directory y Employee Directory (Entra ID): qué elemento web elegir. El origen elegido determina cuál de los dos almacenes siguientes debe preparar.
Dónde obtiene los datos cada elemento web
| Elemento web y origen de datos | Procedencia de los datos | Cuándo aparecen los cambios |
|---|---|---|
| Employee Directory (Entra ID) | Microsoft Entra ID, mediante Microsoft Graph. La lista completa se carga y conserva en el navegador. | En la siguiente actualización: la copia se renueva en segundo plano al superar las 24 horas, o de inmediato con Actualizar. |
| Employee Directory con el origen Entra ID (Azure AD) | Microsoft Entra ID, mediante Microsoft Graph, página a página en cada búsqueda. | En la siguiente solicitud una vez que el cambio esté disponible en Microsoft Graph; la replicación puede retrasar su aparición. |
| Employee Directory con el origen Perfiles de usuario | Los perfiles de SharePoint, mediante la búsqueda de personas de SharePoint. | Una vez actualizado el perfil en SharePoint y rastreado de nuevo por la búsqueda. |
| New Employees | Microsoft Entra ID, mediante Microsoft Graph. | En la siguiente solicitud una vez que el cambio esté disponible en Microsoft Graph; la replicación puede retrasar su aparición. |
Algunas funciones utilizan Microsoft Graph en todos los elementos web, independientemente del origen: la foto, la presencia, las secciones Responsable y Subordinados del panel de detalles, el filtro rápido Mi equipo y la sección Disponibilidad con la hora local y el horario laboral. Con Perfiles de usuario, el resultado se vincula a la cuenta de Entra ID mediante la propiedad administrada AADObjectID, el identificador de objeto de Entra ID guardado en el perfil.
Referencia de atributos
La tabla enumera las propiedades de usuario de Microsoft Entra ID que lee Employee Directory y su finalidad. Los nombres de columna corresponden a la configuración Columnas del elemento web.
| Propiedad de Entra ID | Columna | Finalidad |
|---|---|---|
displayName | Nombre completo | El encabezado de la tarjeta y el nombre del panel de detalles; el orden predeterminado. |
givenName, surname | Nombre, Apellido | La navegación A–Z y la agrupación Apellido (primera letra) utilizan el apellido. Con el origen Entra ID (Azure AD) de Employee Directory, se busca por el inicio del nombre para mostrar, nombre, apellido, correo, puesto, departamento, identificador de empleado, ciudad, estado o país. |
jobTitle | Puesto | La segunda línea de la tarjeta; una columna que permite búsquedas; la opción Excluir empleados con título de trabajo en blanco. |
department | Departamento | El filtro rápido Mi departamento, los refinadores, Agrupar por, las opciones Excluir empleados con Departamento vacío y Mostrar sólo los usuarios con departamento no vacío, y la búsqueda. |
companyName | Nombre de la compañía | Una columna y un campo del panel de detalles. |
officeLocation | Ubicación de oficina | Una columna y un campo del panel de detalles. |
streetAddress, city, state, postalCode, country | Dirección, Ciudad, Estado o provincia, Código postal, País o región | Columnas y campos del panel de detalles. Con Entra ID (Azure AD) también se busca por ciudad, estado y país. |
businessPhones, mobilePhone | Teléfono del trabajo, Teléfono móvil | Teléfonos con vínculos para llamar. |
mail | Correo electrónico | La acción y el vínculo de correo. Sin dirección de correo no aparecen Disponibilidad, la hora local ni el horario laboral. |
userPrincipalName | Nombre de usuario | El nombre de inicio de sesión; también la dirección de Teams para chats y llamadas cuando imAddresses está vacío. |
imAddresses | - | El primer valor es la dirección de Teams para las acciones de chat y llamada. |
employeeId | Id. de empleado | Una columna; permite búsquedas con Entra ID (Azure AD). |
employeeType | Tipo de empleado | Una columna y un campo del panel de detalles. |
manager | Responsable | El filtro rápido Mi equipo, las secciones Responsable y Subordinados del panel y la columna Responsable. |
| Foto de perfil | Imagen | La foto de la lista, las tarjetas y el panel de detalles. |
aboutMe, skills, interests, responsibilities | Acerca de mí, Aptitudes, Intereses, Responsabilidades | Las secciones Acerca de mí, Aptitudes e Intereses del panel; la búsqueda por aptitudes. |
assignedLicenses | - | La opción Excluir a los empleados sin licencia. |
accountEnabled | - | La opción Excluir usuarios bloqueados y la exclusión automática de cuentas bloqueadas descrita más abajo. |
userType | - | Los invitados (Guest) siempre se excluyen. |
createdDateTime | - | El elemento web New Employees. |
onPremisesExtensionAttributes, extensiones de directorio | Columnas personalizadas | Columnas personalizadas; consulte Atributos personalizados. |
📝 Nota
Microsoft Graph devuelve aboutMe, skills, interests y responsibilities solo para usuarios individuales, no en listas. Con orígenes de Entra ID, el panel los carga al abrirse; las columnas Aptitudes, Intereses, Responsabilidades y Acerca de mí de la lista quedan vacías, salvo las aptitudes de personas encontradas mediante la búsqueda por aptitudes. Responsable solo se rellena en Employee Directory (Entra ID). Employee Directory no muestra las propiedades de Entra ID pastProjects, schools, otherMails ni la fecha de contratación.
El origen Perfiles de usuario
Con Perfiles de usuario, Employee Directory lee propiedades administradas de búsqueda de SharePoint en lugar de propiedades de Entra ID:
| Columna | Propiedad administrada | Observaciones |
|---|---|---|
| Nombre completo | Title | Si Title está vacío, se utiliza PreferredName. |
| Nombre, Apellido | FirstName, LastName | |
| Puesto, Departamento | JobTitle, Department | Los refinadores requieren una propiedad administrada refinable. |
| Nombre de la compañía | OrgNames | |
| Ubicación | OfficeNumber | Con Perfiles de usuario, Ubicación lee OfficeNumber y Ubicación de oficina lee BaseOfficeLocation. Con orígenes de Entra ID, ambas columnas leen officeLocation. |
| Ubicación de oficina | BaseOfficeLocation | |
| Teléfono del trabajo, Teléfono móvil, Teléfono particular | WorkPhone, MobilePhone, HomePhone | Teléfono particular solo está disponible con este origen. |
| Correo electrónico, Nombre de usuario | WorkEmail, UserName | |
| Acerca de mí | Description | |
| Aptitudes, Intereses, Responsabilidades | Skills, Interests, Responsibilities | Propiedades multivalor, separadas por punto y coma. |
| Imagen | PictureUrl | Solo se utiliza si no se puede cargar la foto desde Microsoft Graph. |
| - | AADObjectID | Vincula el perfil a la cuenta de Entra ID: foto, presencia, responsable, subordinados directos y favoritos. |
Los campos de dirección, Id. de empleado, Tipo de empleado y Responsable no tienen propiedad administrada en este origen y quedan vacíos. Para mostrarlos, añada la propiedad del perfil como columna personalizada; consulte KB10049. Cómo agregar atributos personalizados de perfiles de usuario al elemento web Employee Directory.
Nombres y navegación A–Z
El Nombre para mostrar es lo primero que ven los usuarios. Utilice una convención común en todo el inquilino, por ejemplo, Nombre Apellido, sin puestos, códigos de departamento ni sufijos como "(Externo)" en el propio nombre.
Nombre y Apellido son más importantes de lo que parecen:
- La navegación A–Z de Employee Directory (Entra ID) utiliza la primera letra de Apellido. Una persona sin apellido no figura bajo ninguna letra y desaparece al seleccionar una.
- Apellido (primera letra) en Agrupar por también utiliza el apellido; si está vacío, utiliza la primera letra del nombre para mostrar.
- Con el origen Entra ID (Azure AD) de Employee Directory, se busca por el inicio del nombre para mostrar, nombre, apellido, correo, puesto, departamento, identificador de empleado, ciudad, estado o país.
Puesto, departamento y empresa
Puesto y Departamento son los campos más visibles después del nombre: ocupan la segunda y tercera línea de las tarjetas y el panel de detalles, y permiten búsquedas de forma predeterminada.
Departamento controla varias funciones. Mantenga valores coherentes: los filtros comparan texto, por lo que Ventas, Departamento de Ventas y ventas EMEA son departamentos distintos.
- Mi departamento muestra personas cuyo departamento coincide con el del perfil de Entra ID del usuario conectado, sin distinguir mayúsculas. Si el departamento propio está vacío, no aparece la pestaña. Con Perfiles de usuario, el departamento propio sigue procediendo de Entra ID, mientras que los compañeros se comparan mediante
Departmentde sus perfiles de SharePoint: ambos deben estar sincronizados. - Los refinadores enumeran los valores distintos de departamento. Las erratas aparecen como entradas independientes. Consulte KB10313. Cómo configurar el panel de refinamiento en Employee Directory.
- Excluir empleados con Departamento vacío en Employee Directory (Entra ID) y Mostrar sólo los usuarios con departamento no vacío en Employee Directory, origen Entra ID (Azure AD), activada de forma predeterminada, ocultan las cuentas sin departamento. Así puede excluir buzones compartidos, salas y cuentas de servicio, siempre que todos los empleados reales tengan departamento.
Nombre de la compañía resulta útil si el inquilino incluye varias entidades jurídicas o filiales: aparece como columna y en el panel, y se puede utilizar en Agrupar por.
Responsable y jerarquía
El atributo Responsable se lee de Microsoft Entra ID en todos los elementos web y determina:
- el filtro rápido Mi equipo: el responsable del usuario conectado, quienes comparten responsable y sus propios subordinados directos, excluidas las cuentas bloqueadas. Sin responsable ni subordinados, se oculta la pestaña;
- las secciones Responsable y Subordinados del panel. Los subordinados con cuentas bloqueadas siempre se omiten. Si están activadas Excluir a los empleados sin licencia o la exclusión por departamento, también se aplican aquí;
- la columna Responsable y la agrupación por responsable en Employee Directory (Entra ID). Solo se cargan los responsables cuando la columna Responsable se muestra en la lista o las tarjetas.
Todos los empleados, salvo la persona que dirige la organización, deberían tener responsable. Consulte KB10214. Filtros rápidos de Employee Directory: Mi departamento, Mi equipo, Personas con las que trabajo y Favoritos.
Contacto, ubicación y foto
- Teléfonos. Los números profesionales y móviles proceden de
businessPhonesymobilePhone; se muestran todos los profesionales separados por comas. Teléfono particular solo se rellena con Perfiles de usuario. - Correo electrónico. Para usuarios con licencia de Exchange Online,
mailse establece automáticamente desde la dirección SMTP principal. Es necesario para la acción de correo y Disponibilidad. - Chats y llamadas de Teams. Las acciones utilizan el primer valor de
imAddresses; si está vacío, el nombre principal de usuario y, después, el correo electrónico. - Con Perfiles de usuario, Ubicación lee
OfficeNumbery Ubicación de oficina leeBaseOfficeLocation. Con orígenes de Entra ID, ambas columnas leenofficeLocation. - Foto. Se carga desde Microsoft Graph con todos los orígenes. Los usuarios pueden subirla desde su perfil de Microsoft 365 o Teams, y los administradores desde el Centro de administración de Microsoft 365. Si Graph no devuelve ninguna, se utiliza la imagen del perfil de SharePoint.
Acerca de mí, aptitudes e intereses
Acerca de mí, Aptitudes e Intereses aparecen como secciones del panel de detalles y se activan por separado en el grupo Panel de configuración. Aptitudes también permite buscar aptitudes, por ejemplo, "¿quién conoce Power BI?". Estos campos se almacenan en el perfil de SharePoint, por ejemplo, las aptitudes en SPS-Skills, y Microsoft Graph los expone como aboutMe, skills, interests y responsibilities.
Normalmente los rellenan los propios empleados:
- en su página de perfil de SharePoint, si la organización permite editar el perfil;
- con Employee Details, que permite editar Acerca de mí, intereses, responsabilidades, proyectos anteriores y centros educativos propios; consulte KB10283. Employee Details: completar Acerca de mí, intereses, responsabilidades, proyectos anteriores y escuelas.
Los administradores pueden editar estas propiedades en el Centro de administración de SharePoint mediante Más características › Perfiles de usuario › Administrar perfiles de usuario, o de forma masiva con PnP PowerShell. Consulte KB10316. Cómo buscar empleados por aptitudes en Employee Directory.
Estado de cuenta, licencias e invitados
Employee Directory determina quién cuenta como empleado mediante tres atributos de Entra ID:
| Regla | Atributo | Dónde se aplica |
|---|---|---|
| Nunca se muestran invitados | userType es Guest | Siempre, en todos los elementos web. Con Perfiles de usuario, la búsqueda excluye los perfiles de invitados. |
| Se ocultan cuentas bloqueadas | accountEnabled es false | Employee Directory (Entra ID): Excluir usuarios bloqueados, activada de forma predeterminada. Employee Directory, origen Entra ID (Azure AD): siempre. Mi equipo y Subordinados: siempre. New Employees: no automáticamente; utilice Estado de la cuenta en el editor de filtros. |
| Se ocultan cuentas sin licencia | assignedLicenses está vacío | Employee Directory (Entra ID): Excluir a los empleados sin licencia, desactivada de forma predeterminada. |
Configure las exclusiones o filtros adecuados para buzones compartidos, salas y cuentas de servicio o pruebas. Un departamento vacío o la falta de licencia solo oculta una cuenta si está activada la exclusión correspondiente. Conserve las licencias necesarias para la finalidad de la cuenta. KB10311. Cómo configurar Employee Directory (Entra ID): filtros, exclusiones y navegación A–Z.
❗ Importante
Perfiles de usuario no ofrece opciones de licencia ni estado de cuenta. Los usuarios bloqueados conservan su perfil de SharePoint y siguen apareciendo en búsquedas hasta que se elimina. Oculte esos perfiles en las listas de direcciones, consulte Usuarios ocultos, o exclúyalos con Consulta guardada.
Nuevos empleados: fecha de creación
New Employees enumera cuentas de miembros cuyo createdDateTime pertenece al período de Mostrar usuarios creados en los últimos meses. Es la fecha de creación en Microsoft Entra ID; para cuentas sincronizadas desde Active Directory local, la fecha en que la sincronización creó la cuenta en la nube, no la fecha de contratación. Cree las cuentas cerca de la incorporación y no vuelva a crear las existentes, o empleados veteranos aparecerán como nuevas incorporaciones. Consulte KB10207. Cómo presentar a las nuevas incorporaciones con el elemento web New Employees.
Hora local y horario laboral
Las filas Hora local y Horario laboral del panel no proceden de Entra ID. Se consultan en el buzón junto con la disponibilidad: son la zona horaria y el horario que cada usuario configura en Outlook, mediante Configuración › Calendario › Horario laboral y ubicación en Outlook en la Web. Se necesitan un buzón de Exchange Online y una dirección de correo. Sin horario o zona horaria, ambas filas se ocultan. Pida a los empleados que comprueben estos ajustes, especialmente en equipos distribuidos; consulte KB10317. Employee Directory: hora local, horario laboral y disponibilidad.
Atributos personalizados
Si los atributos estándar no bastan, por ejemplo, para un centro de costes, número de credencial o edificio, Employee Directory puede mostrar atributos adicionales como Columnas personalizadas:
- Con orígenes de Entra ID:
extensionAttribute1–extensionAttribute15, leídos deonPremisesExtensionAttributes, extensiones de directorio y otras propiedades de usuario. Consulte KB10060. Cómo mostrar atributos personalizados de Entra ID en el elemento web Employee Directory. - Con Perfiles de usuario: cualquier propiedad de perfil indexada y asignada a una propiedad administrada recuperable. Consulte KB10049. Cómo agregar atributos personalizados de perfiles de usuario al elemento web Employee Directory.
Dónde editar los datos
El lugar de edición depende del sistema de origen de la identidad:
- Cuentas solo en la nube. En el Centro de administración de Microsoft Entra, abra Usuarios › Todos los usuarios, seleccione al usuario y pulse Editar propiedades. Las secciones Identidad, Información laboral, con puesto, empresa, departamento, identificador y tipo de empleado, oficina y responsable, e Información de contacto contienen los atributos indicados. El Centro de administración de Microsoft 365 ofrece los mismos campos en Usuarios › Usuarios activos › el usuario, mediante Administrar información de contacto y Administrar responsable, además de fotos y licencias.
- Cuentas sincronizadas desde Active Directory local. Con Microsoft Entra Connect o Cloud Sync, el directorio local es el origen de referencia y no se pueden modificar en la nube los atributos sincronizados. Edítelos en Active Directory; por ejemplo, la pestaña Organización de Usuarios y equipos de Active Directory incluye puesto, departamento, empresa y responsable. Los cambios llegan a Entra ID en el siguiente ciclo, según la programación del servicio de sincronización utilizado.
- Aprovisionamiento desde Recursos Humanos. Si los usuarios se aprovisionan desde un sistema de RR. HH., mantenga allí los datos y asigne sus campos a los atributos de Entra ID en la configuración del aprovisionamiento.
- Los propios empleados. Normalmente no pueden modificar su información laboral de Entra ID. Mantienen su foto, los campos descritos en Acerca de mí, aptitudes e intereses y el horario laboral de Outlook.
Cuánto tardan en aparecer los cambios
- Orígenes de Entra ID. En la siguiente solicitud una vez que el cambio esté disponible en Microsoft Graph; la replicación puede retrasar su aparición. Employee Directory (Entra ID) guarda una copia en el navegador y la actualiza en segundo plano al superar las 24 horas. Seleccione Actualizar junto a Última actualización encima de los resultados para cargar los datos actuales de inmediato.
- Perfiles de usuario. Hay dos pasos adicionales. Primero, Microsoft 365 sincroniza los atributos de Entra ID con los perfiles de SharePoint; es automático y suele tardar de varias horas a un día, más en inquilinos grandes. Después, la búsqueda de SharePoint debe volver a rastrear el perfil para que el cambio se pueda buscar. Los cambios directos de perfil, como aptitudes o Acerca de mí, solo necesitan el rastreo. Prevea un día o más tras una actualización masiva.
📝 Nota
Por estos retrasos, Employee Directory con Perfiles de usuario y el panel de detalles, que consulta parte de los datos en Microsoft Graph, pueden mostrar temporalmente valores distintos para la misma persona. Se corrige al finalizar la sincronización y el nuevo rastreo.
Usuarios ocultos
Con Perfiles de usuario, Employee Directory no muestra perfiles ocultos en las listas de direcciones: SPS-HideFromAddressLists refleja la opción de Exchange Ocultar en la lista global de direcciones del buzón. Active Mostrar usuarios ocultos en Origen de datos para incluirlos. Las cuentas de servicio, como app@sharepoint, Sync_DC_* y nt service*, siempre se excluyen.
Por tanto, ocultar un buzón en la lista de direcciones permite retirar una cuenta de este origen sin eliminarla. Los orígenes de Entra ID no utilizan esta opción; utilice sus exclusiones o el editor de filtros.
Lista de comprobación antes de la puesta en producción
- Elija el origen de datos y sepa qué almacén prepara: Entra ID, los perfiles de SharePoint o ambos.
- Nombres. Cada empleado tiene nombre para mostrar, nombre y apellido según una convención común.
- Puesto y departamento están completos para todos, con nombres de departamento escritos de forma idéntica.
- Responsable está asignado a todos salvo a quien dirige la organización.
- Contacto. Correo, teléfono profesional, móvil y oficina están completos; también ciudad y país si hay varias sedes.
- Fotos. Se han subido para tantos empleados como sea posible.
- Cuentas que no representan personas excluidas mediante filtros adecuados u opciones de exclusión activadas; compruebe cada origen por separado.
- Cuentas bloqueadas. Las de antiguos empleados están deshabilitadas en Entra ID; compruebe Excluir usuarios bloqueados.
- Campos del perfil. Se ha invitado a los empleados a completar Acerca de mí, Aptitudes e Intereses y comprobar el horario y la zona horaria de Outlook.
- Atributos personalizados. Están sincronizados y, con Perfiles de usuario, asignados a propiedades administradas.
- Espere a la sincronización y el rastreo tras cambios masivos. Después abra el directorio, seleccione Actualizar y compruebe algunos empleados, la navegación A–Z, los refinadores y los filtros rápidos Mi departamento y Mi equipo.
💡 Sugerencia
Para configurar refinadores sobre los datos preparados, consulte KB10313. Cómo configurar el panel de refinamiento en Employee Directory. Las exclusiones y la navegación A–Z se describen en KB10311. Cómo configurar Employee Directory (Entra ID): filtros, exclusiones y navegación A–Z; para New Employees, consulte KB10207. Cómo presentar a las nuevas incorporaciones con el elemento web New Employees.
Más información sobre el producto: https://vitextra.com/es/products/employee-directory
