Configuración de los argumentos para las tareas integradas del flujo de trabajo del ciclo de vida

  • Artículo

La API De flujos de trabajo de ciclo de vida de Microsoft Graph le permite automatizar procesos de ciclo de vida básicos para los usuarios en tres niveles: Joiner, Leaver y Mover. Los principales de los flujos de trabajo son tareas que representan las acciones específicas que se ejecutan automáticamente cuando se desencadena un flujo de trabajo.

Microsoft Graph admite 16 tareas integradas que puede usar para crear flujos de trabajo personalizados. Cada tarea tiene un conjunto de argumentos que se permiten para esa tarea. Por ejemplo, una tarea para generar un pase de acceso temporal (TAP) para un usuario permite configurar la duración del TAP y si el usuario puede reutilizarlo. Una tarea para agregar un usuario a un grupo requiere que especifique los grupos a los que desea agregar el usuario. Esta configuración se realiza en la propiedad arguments de una tarea y se basa en el tipo de recurso keyValuePair.

En este artículo se proporcionan instrucciones sobre la configuración permitida para la propiedad arguments de las tareas en flujos de trabajo de ciclo de vida.

Configuración de argumentos para tareas

Descripción de la tarea taskDefinitionId Argumentos
Enviar correo electrónico de bienvenida a la nueva contratación 70b29d51-b59a-4773-9280-8841dfd3f2ea Nombre: cc
value: un identificador de usuario válido (String) para el usuario que desea cc en el correo electrónico.

Nombre: customSubject
value: encabezado de asunto personalizado para el correo electrónico que se va a enviar.


Nombre: customBody
value:El cuerpo del correo electrónico personalizado.


Nombre: locale
value: valor de idioma que invalida la configuración de idioma del destinatario del correo electrónico. No personalizará el texto personalizado del correo electrónico y debe establecerse en el mismo idioma que el texto personalizado.
Generación de pase de acceso temporal y envío por correo electrónico al administrador del usuario 1b555e50-7f65-41d5-b514-5894a026d10d Nombre: tapLifetimeMinutes
value: 10 upto 43000

Nombre: tapIsUsableOnce
value: true o false

Requisitos previos:
  1. Al usuario se le debe asignar un administrador.
  2. El administrador del usuario debe tener su correo habilitado.
  3. La directiva de pase de acceso temporal (TAP) debe estar habilitada en el inquilino y el usuario habilitado para usar el método de autenticación TAP. Para obtener más información, vea temporaryAccessPassAuthenticationMethodConfiguration resource type( Tipo de recurso temporaryAccessPassAuthenticationMethodConfiguration).
Agregar usuario a grupos 22085229-5809-45e8-97fd-270d28d66910 Nombre: groupID
value: un identificador de grupo válido o una lista separada por comas de grupos a los que se agregará el usuario como miembro. Por ejemplo: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
Adición de un usuario a los equipos e440ed8d-25a1-4618-84ce-091ed5be5594 Nombre: teamID
value: un identificador de grupo válido o una lista separada por comas de los equipos a los que se agregará el usuario como miembro. Por ejemplo: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
Habilitar cuenta de usuario 6fc52c9d-398b-4305-9763-15f42c1676fc Ninguno
Ejecución de una extensión de tarea personalizada 4262b724-8dba-4fad-afc3-43fcbb497a0e Nombre: CustomTaskExtensionID
value: el identificador de la extensión de tarea personalizada
Deshabilitar la cuenta de usuario 1dfdfcc7-52fa-4c2e-bf3a-e3919cc12950 Ninguno
Eliminación del usuario del grupo seleccionado 1953a66c-751c-45e5-8bfe-01462c70da3c Nombre: groupID
value: un identificador de grupo válido o una lista separada por comas de los grupos de los que el usuario es miembro. Por ejemplo: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
Eliminación de usuarios de todos los grupos b3a31406-2a15-4c9a-b25b-a658fa5f07fc Ninguno
Eliminación del usuario de los equipos 06aa7acb-01af-4824-8899-b14e5ed788d6 Nombre: teamID
value: una lista separada por comas de los equipos de los que el usuario es miembro. Por ejemplo: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
Eliminación del usuario de todos los equipos 81f7b200-2816-4b3b-8c5d-dc556f07b024 Ninguno
Eliminación de todas las asignaciones de licencias del usuario 8fa97d28-3e52-4985-b3a9-a1126f9b8b4e Ninguno
Eliminar usuario 8d18588d-9ad3-4c0f-99d0-ec215f0e3dff Ninguno
Enviar correo electrónico al administrador antes del último día del usuario 52853a3e-f4e5-4eb8-bb24-1ac09a1da935 Nombre: cc
value: un identificador de usuario válido (String) para el usuario que desea cc en el correo electrónico.

Nombre: customSubject
value: encabezado de asunto personalizado para el correo electrónico que se va a enviar.


Nombre: customBody
value:El cuerpo del correo electrónico personalizado.


Nombre: locale
value: valor de idioma que invalida la configuración de idioma del destinatario del correo electrónico. No personalizará el texto personalizado del correo electrónico y debe establecerse en el mismo idioma que el texto personalizado.
Enviar correo electrónico a los usuarios el último día 9c0a1eaf-5bda-4392-9d9e-6e155bb57411 Nombre: cc
value: un identificador de usuario válido (String) para el usuario que desea cc en el correo electrónico.

Nombre: customSubject
value: un asunto personalizado para el correo electrónico que se va a enviar.


Nombre: customBody
value:El cuerpo del correo electrónico personalizado.


Nombre: locale
value: valor de idioma que invalida la configuración de idioma del destinatario del correo electrónico. No personalizará el texto personalizado del correo electrónico y debe establecerse en el mismo idioma que el texto personalizado.
Envío de correo electrónico fuera del panel al administrador de usuarios después de su último día 6f22ddd4-b3a5-47a4-a846-0d7c201a49ce Nombre: cc
value: un identificador de usuario válido (String) para el usuario que desea cc en el correo electrónico.

Nombre: customSubject
value: encabezado de asunto personalizado para el correo electrónico que se va a enviar.


Nombre: customBody
value:El cuerpo del correo electrónico personalizado.


Nombre: locale
value: valor de idioma que invalida la configuración de idioma del destinatario del correo electrónico. No personalizará el texto personalizado del correo electrónico y debe establecerse en el mismo idioma que el texto personalizado.

Ejemplos

Ejemplo 1: Configuración de una tarea para enviar el correo electrónico de eliminación al administrador de un usuario después del último día de trabajo del usuario

En los ejemplos siguientes se muestra una configuración de tarea para enviar el correo electrónico de eliminación al administrador de un usuario después del último día de trabajo del usuario. Esta tarea se identifica mediante taskDefinitionId6f22ddd4-b3a5-47a4-a846-0d7c201a49ce.

{
    "category": "leaver",
    "continueOnError": true,
    "displayName": "Send offboarding email to user's manager after the last day of work",
    "description": "Send email after user’s last day",
    "isEnabled": true,
    "continueOnError": true,
    "taskDefinitionId": "6f22ddd4-b3a5-47a4-a846-0d7c201a49ce",
    "arguments": []
}

Ejemplo 2: Configuración de una tarea para agregar un usuario a los equipos

En los ejemplos siguientes se muestra una configuración de tarea para agregar un usuario a un equipo de Teams. Esta tarea se identifica mediante taskDefinitionIde440ed8d-25a1-4618-84ce-091ed5be5594.

{
    "category": "leaver",
    "description": "Add user to university alumni team",
    "displayName": "AddUserToUniAlumniTeam",
    "isEnabled": true,
    "continueOnError": true,
    "taskDefinitionId": "e440ed8d-25a1-4618-84ce-091ed5be5594",
    "arguments": [
        {
            "name": "teamID",
            "value": "e3cc382a-c4b6-4a8c-b26d-a9a3855421bd"
        }
    ]
}

Pasos siguientes