Invoke Playbook

Invoke Playbook

Tipo: invoke-playbook  ·  Paquete: Core Activities v1.0.0

Ejecuta otro playbook del mismo proyecto, opcionalmente pasándole datos de entrada y recibiendo de vuelta sus resultados. Es la herramienta para dividir una automatización grande en piezas pequeñas y reutilizar lógica: en lugar de copiar y pegar el mismo grupo de actividades en varios sitios, lo pones en un sub-playbook y lo invocas.

Cómo funciona

1. Ejecuta el playbook indicado en path, pasándole los valores de input.
2. El sub-playbook se ejecuta de principio a fin con su propio espacio de variables (no ve ni modifica las del playbook que lo llamó).
3. Al terminar, sus salidas se mapean a variables del playbook actual según outputs.
4. Si el sub-playbook falla, la invocación falla (capturable con Try / Catch).

Parámetros requeridos

Parámetro	Editor	Descripción
path	selector de playbook	El playbook hijo a ejecutar. Ruta relativa dentro del proyecto.

Parámetros opcionales

Parámetro	Editor	Descripción
input	entradas	Valores que recibe el sub-playbook, como pares nombre: valor.
outputs	salidas	Mapeo de las salidas del hijo a variables del playbook actual.

Ejemplo

Por cada factura, invocar un sub-playbook que la procesa y devuelve un estado:

For Each   items = = facturas   itemVariable = factura
 └─ activities:
      Invoke Playbook
        path    = "procesar-factura.json"
        input   = = { factura: factura, reintentos: 3 }
        outputs = = { estado: estadoProcesamiento }
      Log   level = info   message = = "Factura procesada: " + estadoProcesamiento

• input: el hijo recibe factura y reintentos como variables de entrada.
• outputs: la salida estado del hijo se guarda en la variable estadoProcesamiento del padre.

Cada playbook tiene sus propias variables

El sub-playbook no comparte variables con el que lo llama. La comunicación es solo por input (hacia el hijo) y outputs (de vuelta al padre). Esto mantiene cada pieza aislada y reutilizable. Ver Alcance de variables.

La variable del padre que recibe una salida (estadoProcesamiento en el ejemplo) debe estar declarada en el padre para poder recibir el valor.

Solo rutas relativas dentro del proyecto

path debe ser una ruta relativa al proyecto; no se permiten rutas absolutas ni segmentos ... Esto evita que un playbook ejecute archivos fuera de su proyecto. Para exponer una salida desde el sub-playbook, este la declara con la actividad Set Output.

Actividades relacionadas

• Variables — cómo se pasan entradas y se reciben salidas.
• Try / Catch — manejar el fallo de un sub-playbook.
• Vista general del Designer — proyectos con varios playbooks.