Sincronización de atributos para Flujos de trabajo de ciclo de vida

  • Artículo

Los flujos de trabajo contienen tareas específicas, que se pueden ejecutar automáticamente para los usuarios en función de las condiciones de ejecución especificadas. La programación automática de flujos de trabajo se admite en función de los atributos de usuario employeeHireDate y employeeLeaveDateTime de Microsoft Entra ID.

Para aprovechar al máximo los Flujos de trabajo de ciclo de vida, se debe automatizar el aprovisionamiento de usuarios y se deben sincronizar los atributos pertinentes de programación.

Programación de atributos pertinentes

En la tabla siguiente se muestran los atributos pertinentes de programación (desencadenador) y los métodos de sincronización que se admiten.

Atributo Tipo Se admite en el aprovisionamiento de entrada de RR. HH. Soporte con sincronización en la nube de Microsoft Entra Connect Compatibilidad con sincronización de Microsoft Entra Connect
employeeHireDate DateTimeOffset Sí Sí Sí
employeeLeaveDateTime DateTimeOffset Sí Sí Sí

Nota

La configuración manual de employeeLeaveDateTime para los usuarios solo en la nube requiere permisos especiales. Para más información, consulte: Configuración de la propiedad employeeLeaveDateTime para un usuario

En este documento se explica cómo configurar la sincronización desde la sincronización en la nube de Microsoft Entra Connect local o Microsoft Entra Connect para los atributos necesarios.

Nota:

No hay ningún atributo EmployeeHireDate ni EmployeeLeaveDateTime correspondientes en Active Directory. Si va a sincronizar desde AD local, deberá identificar un atributo en AD que se pueda usar. Este atributo debe ser una cadena.

Descripción del formato de EmployeeHireDate y EmployeeLeaveDateTime

EmployeeHireDate y EmployeeLeaveDateTime contienen fechas y horas que tienen que tener formatos específicos. Esto significa que es posible que tenga que usar una expresión para convertir el valor del atributo de origen en un formato que EmployeeHireDate o EmployeeLeaveDateTime acepte. En la tabla siguiente se describe el formato esperado y se proporciona una expresión de ejemplo sobre cómo convertir los valores.

Escenario Expresión/formato Destino Más información
Aprovisionamiento de usuarios de Workday a Active Directory FormatDateTime([StatusHireDate], ,"yyyy-MM-ddzzz", "yyyyMMddHHmmss.fZ") Atributo de cadena de AD local Asignación de atributos para Workday
Aprovisionamiento de usuarios de SuccessFactors a Active Directory FormatDateTime([endDate], ,"M/d/aaaa hh:mm:ss tt","aaaaMMddHHmmss.fZ") Atributo de cadena de AD local Asignación de atributos para SAP SuccessFactors
Importación personalizada a Active Directory Debe tener el formato "aaaaMMddHHmmss.fZ" Atributo de cadena de AD local Asignaciones de atributos para cualquier otro sistema de registros
API de usuario de Microsoft Graph Debe tener el formato "AAAA-MM-DDThh:mm:ssZ" EmployeeHireDate y EmployeeLeaveDateTime
Aprovisionamiento de usuarios de Workday a Microsoft Entra Puede usar una asignación directa. No se necesita ninguna expresión, pero se puede usar para ajustar la parte de tiempo de EmployeeHireDate y EmployeeLeaveDateTime. EmployeeHireDate y EmployeeLeaveDateTime
Aprovisionamiento de usuarios de SuccessFactors a Microsoft Entra Puede usar una asignación directa. No se necesita ninguna expresión, pero se puede usar para ajustar la parte de tiempo de EmployeeHireDate y EmployeeLeaveDateTime. EmployeeHireDate y EmployeeLeaveDateTime

Para obtener más información sobre las expresiones, consulte Referencia para escribir expresiones para la asignación de atributos en Microsoft Entra ID.

Los ejemplos de expresiones en la tabla usan endDate para SAP y StatusHireDate para Workday. Sin embargo, puede optar por usar otros atributos.

Por ejemplo, puede usar StatusContinuousFirstDayOfWork, en lugar de StatusHireDate para Workday. En este caso, la expresión sería:

FormatDateTime([StatusContinuousFirstDayOfWork], , "yyyy-MM-ddzzz", "yyyyMMddHHmmss.fZ")

En la tabla siguiente se incluye una lista de los atributos sugeridos y sus recomendaciones de escenario.

Atributo de RR. HH. Sistema de RR. HH. Escenario Atributo de Microsoft Entra
StatusHireDate Workday Usuario que se une EmployeeHireDate
StatusContinuousFirstDayOfWork Workday Usuario que se une EmployeeHireDate
StatusDateEnteredWorkforce Workday Usuario que se une EmployeeHireDate
StatusOriginalHireDate Workday Usuario que se une EmployeeHireDate
StatusEndEmploymentDate Workday Usuario que abandona EmployeeLeaveDateTime
StatusResignationDate Workday Usuario que abandona EmployeeLeaveDateTime
StatusRetirementDate Workday Usuario que abandona EmployeeLeaveDateTime
StatusTerminationDate Workday Usuario que abandona EmployeeLeaveDateTime
startDate SAP SF Usuario que se une EmployeeHireDate
firstDateWorked SAP SF Usuario que se une EmployeeHireDate
lastDateWorked SAP SF Usuario que abandona EmployeeLeaveDateTime
endDate SAP SF Usuario que abandona EmployeeLeaveDateTime

Para ver más atributos, consulte la referencia de atributos de Workday y la referencia de atributos de SAP SuccessFactors.

Importancia de la hora

Para garantizar la precisión de la hora de los flujos de trabajo programados, es fundamental tener en cuenta lo siguiente:

  • La parte de hora del atributo debe establecerse en consecuencia, por ejemplo, employeeHireDate debe tener una hora al principio del día, como la 1:00 o las 5:00, y employeeLeaveDateTime debe tener la hora al final del día, como las 21:00 o 23:00.
  • Los flujos de trabajo no se ejecutarán antes de la hora especificada en el atributo, pero la programación del inquilino (valor predeterminado de 3 h) puede retrasar la ejecución del flujo de trabajo. Por ejemplo, si establece employeeHireDate en las 8:00, pero la programación del inquilino no se ejecuta hasta las 9:00, el flujo de trabajo no se procesará hasta entonces. Si una persona recién contratada comienza a trabajar a las 8:00, es recomendable establecer la hora de esta forma (hora de inicio - programación del inquilino) para asegurarse de que se haya ejecutado antes de que llegue el empleado.
  • Se recomienda que, si usa el pase de acceso temporal (TAP), establezca la duración máxima en 24 horas. Esto ayudará a garantizar que el TAP no haya expirado después de enviarse a un empleado que pueda estar en otra zona horaria. Para obtener más información, consulte Configuración de un pase de acceso temporal en Microsoft Entra ID para registrar métodos de autenticación sin contraseña.
  • Al importar los datos, debe comprender si y cómo el origen proporciona la información de la zona horaria para que los usuarios puedan realizar ajustes para garantizar la precisión de la hora.

Creación de una regla de sincronización personalizada en la sincronización en la nube de Microsoft Entra Connect para EmployeeHireDate

Los pasos siguientes le guiarán por la creación de una regla de sincronización mediante la sincronización en la nube.

  1. En el centro de administración de Microsoft Entra, vaya a >Administración híbrida>Microsoft Entra Connect.
  2. Seleccione Administrar sincronización en la nube de Microsoft Entra Connect.
  3. En Configuración, seleccione su configuración.
  4. Seleccione Click to edit mappings (Haga clic para editar las asignaciones). Este vínculo abre la pantalla Asignaciones de atributos.
  5. Seleccione Agregar atributo.
  6. Rellene la información siguiente:
    • Tipo de asignación: Directo
    • Atributo de origen: msDS-cloudExtensionAttribute1
    • Valor predeterminado: Deje en blanco
    • Atributo de destino: employeeHireDate
    • Aplique esta asignación: Siempre Screenshot of the cloud attribute mapping.
  7. Seleccione Aplicar.
  8. En la pantalla Asignación de atributos, debería ver la nueva asignación de atributos.
  9. Seleccione Guardar esquema.

Para obtener más información sobre los atributos, consulte Asignación de atributos en la sincronización en la nube de Microsoft Entra Connect.

Cómo crear una regla de sincronización personalizada en Microsoft Entra Connect para EmployeeHireDate

El ejemplo siguiente le guía por la configuración de una regla de sincronización personalizada que sincroniza el atributo de Active Directory con el atributo employeeHireDate en Microsoft Entra ID.

  1. Abra una ventana de PowerShell como administrador y ejecute Set-ADSyncScheduler -SyncCycleEnabled $false para deshabilitar el programador.
  2. Vaya a Start\Microsoft Entra Connect\ y abra el editor de reglas de sincronización
  3. Asegúrese de que la dirección de la parte superior esté establecida en Entrante.
  4. Seleccione Agregar regla.
  5. En la pantalla Crear regla de sincronización de entrada, escriba la siguiente información y seleccione Siguiente.
    • Nombre: In from AD - EmployeeHireDate
    • Sistema conectado: contoso.com
    • Tipo de objeto de sistema conectado: usuario
    • Tipo de objeto de metaverso: persona
    • Precedencia: 20 Screenshot of creating an inbound synchronization rule basics.
  6. En la pantalla Filtro de ámbito, seleccione Siguiente.
  7. En la pantalla Reglas de unión, seleccione Siguiente.
  8. En la pantalla Transformaciones, en Agregar transformaciones, escriba la siguiente información.
    • FlowType: Directo
    • Atributo de destino: employeeHireDate
    • Origen: msDS-cloudExtensionAttribute1 Screenshot of creating inbound synchronization rule transformations.
  9. Seleccione Agregar.
  10. En el Editor de reglas de sincronización, asegúrese de que la dirección de la parte superior esté establecida en Saliente.
  11. Seleccione Agregar regla.
  12. En la pantalla Crear regla de sincronización de salida, escriba la siguiente información y seleccione Siguiente.
    • Nombre: Out to Microsoft Entra ID - EmployeeHireDate
    • Sistema conectado: <el inquilino>
    • Tipo de objeto de sistema conectado: usuario
    • Tipo de objeto de metaverso: persona
    • Precedencia: 21
  13. En la pantalla Filtro de ámbito, seleccione Siguiente.
  14. En la pantalla Reglas de unión, seleccione Siguiente.
  15. En la pantalla Transformaciones, en Agregar transformaciones, escriba la siguiente información.
    • FlowType: Directo
    • Atributo de destino: employeeHireDate
    • Origen: employeeHireDate Screenshot of create outbound synchronization rule transformations.
  16. Seleccione Agregar.
  17. Cierre el Editor de reglas de sincronización.
  18. Ejecute Set-ADSyncScheduler -SyncCycleEnabled $true para volver a habilitar el programador.

Nota

  • msDS-cloudExtensionAttribute1 es un origen de ejemplo.
  • A partir de Microsoft Entra Connect 2.0.3.0, employeeHireDate se agrega a la regla predeterminada "Fuera de Microsoft Entra ID", por lo que no se requieren los pasos 10-16.
  • A partir de Microsoft Entra Connect 2.1.19.0, employeeLeaveDateTime se agrega a la regla predeterminada "Fuera de Microsoft Entra ID", por lo que no se requieren los pasos 10-16.

Para obtener más información, consulte Personalización de una regla de sincronización y Cambio en la configuración predeterminada.

Edición de la asignación de atributos en la aplicación de aprovisionamiento

Una vez que haya configurado la aplicación de aprovisionamiento, podrá editar su asignación de atributos. Cuando se crea la aplicación, obtendrá una lista de asignaciones predeterminadas entre HRM y Active Directory. Desde allí puede editar la asignación existente o agregar una nueva asignación.

Para actualizar esta asignación, haga lo siguiente:

  1. Inicie sesión en el centro de administración de Microsoft Entra por lo menos como administrador global.

  2. Vaya a Aplicaciones de identidad>Aplicaciones>Empresariales.

  3. Abra la aplicación aprovisionada.

  4. Seleccione Aprovisionamiento y, después, Editar asignación de atributos.

  5. Seleccione Mostrar opciones avanzadas y, a continuación, seleccione Editar lista de atributos para On Premise Active Directory. Screenshot of editing on-premises attribute.

  6. Agregue el atributo de origen o los atributos creados como tipo String y seleccione la casilla de verificación para obligatorio. Screenshot of source API list.

    Nota:

    El número y el nombre de los atributos de origen agregados dependerán de los atributos que se están sincronizando desde Active Directory.

  7. Seleccione Guardar.

  8. Desde allí debe asignar los atributos HRM a los atributos de Active Directory agregados. Para ello, agregue una nueva asignación mediante una expresión.

  9. La expresión debe coincidir con el formato que se encuentra en la sección Descripción del formato de EmployeeHireDate y EmployeeLeaveDateTime. Screenshot of setting attribute format.

  10. Seleccione Aceptar.

Comprobación de estos valores de atributo en Microsoft Entra ID

Para revisar los valores establecidos en estas propiedades en objetos de usuario en Microsoft Entra ID, puede usar el SDK de PowerShell de Microsoft Graph. Por ejemplo:

# Import Module
Import-Module Microsoft.Graph.Users

# Define the necessary scopes
$Scopes =@("User.Read.All", "User-LifeCycleInfo.Read.All")

# Connect using the scopes defined and select the Beta API Version
Connect-MgGraph -Scopes $Scopes


# Query a user, using its user ID, and return the desired properties
$user = Get-MgUser -UserID "9093a415-2968-48b5-808b-a1a6f006f7a3" -Property EmployeeLeaveDateTime
$User.EmployeeLeaveDateTime

Screenshot of the result.

Pasos siguientes