Tarea de script

Execute inline JavaScript in Maestro Orchestrate Script tasks to manipulate data, enrich payloads, apply conditional logic, or transform input before passing it to the next process component.

The Script Task in Maestro Orchestrate allows you to execute inline JavaScript to manipulate data, enrich payloads, apply conditional logic, or transform input before passing it to the next component in the process.

Usa tareas de script para preparar datos para colas de esquemas, llamadas a la API, agentes o sistemas de almacenamiento.

Implementación > Tipo: ejecutar Script en línea.

Cuándo utilizar tareas de script

Usa una tarea de Script cuando:

• Debes transformar o reestructurar los datos entrantes.

• Deseas validar los campos o rechazar las entradas no válidas.

• Debes combinar varias entradas en un solo objeto.

• Deseas filtrar, limpiar o reformatear los datos antes de reenviar.

  Nota:

  Maestro Orchestrate currently supports JavaScript only inside the expression editor.

Setting up a Script task in Maestro Orchestrate

1. Añade un nodo de tarea de script de la barra de herramientas del proceso (arrástralo al lienzo o selecciónalo dos veces para insertarlo en el centro).
2. Añade argumentos de entrada en la sección Entradas en el panel de la derecha.

Los argumentos de entrada pueden ser valores literales, variables de contexto o salidas de nodo anteriores (por ejemplo, vars.inArg). 3. Escribe tu script en el editor:

• Selecciona el campo de entrada del script y, luego, expándelo en la vista completa del editor.
• Las expresiones JavaScript deben return un objeto o valor, como en este ejemplo:

  return {
    param1: inputString,
    param2: "staticValue"
  };
  

4. Map outputs from the return object into Maestro Orchestrate variables using the Outputs section.

Resultado

The script task is configured with its inputs, logic, and output mappings. The return object's values are available as Maestro Orchestrate variables for use in subsequent process nodes.

Pruebas de lógica de script

Puedes probar expresiones en línea seleccionando el icono fx, que abre el editor de expresiones de función JS. El editor incluye:

• Un panel de entrada de prueba donde puedes pegar entradas de muestra.
• Un panel de salida de expresión en tiempo real para obtener una vista previa de cómo será tu objeto de devolución.

Se mostrarán errores de runtime (por ejemplo, fallos JSON.parse) para ayudarte a depurar.

Acciones disponibles para tareas de script

El menú desplegable Acción en una tarea de Script te permite definir el tipo de ejecución externa que debe llamar el proceso. Cada opción se asigna a una capacidad o método de integración específico de UiPath. A continuación se muestra un breve resumen de cada opción:

• Ninguno

  No hay ninguna implementación configurada para la tarea de Script.

• Crear tarea de aplicación de acción

  Crea una tarea en una Aplicación de Acción para la interacción del usuario, sin esperar a que se complete la tarea.

• Iniciar y esperar el flujo de trabajo de RPA

  Inicia un flujo de trabajo de RPA implementado (por ejemplo, proyecto de UiPath Studio) y espera a que se complete antes de continuar.

• Iniciar y esperar al agente

  Inicia un agente de UiPath (un bloque lógico reutilizable) y espera a que finalice la ejecución.

• Iniciar y esperar al agente externo

  Desencadena un agente alojado fuera de UiPath, como CrewAI, Salesforce o ServiceNow, y espera el resultado.

• Iniciar y esperar el flujo de trabajo de la API

  Ejecuta un flujo de trabajo basado en la API y espera una respuesta.

• Iniciar proceso de agente

  Inicia un proceso basado en el diseño de agente (lógica modular), sin esperar a que termine.

• Iniciar y esperar el proceso de agente

  Inicia un proceso de agente y se detiene hasta que completa la ejecución.

• Ejecutar regla empresarial [Vista previa]

  Evalúa una regla empresarial y utiliza el resultado en el proceso (actualmente en vista previa).

• Crear elemento de la cola

  Añade un nuevo elemento a una cola de UiPath para el procesamiento asíncrono, sin esperar el resultado.

• Crear y esperar el artículo en cola

  Añade un elemento a una cola y espera hasta que se procese antes de avanzar.

• Añadir elementos de la cola de forma masiva

  Añade hasta 15 000 elementos a una cola en un solo lote.

• Eliminar elementos de la cola

  Elimina elementos con el estado Nuevo de una cola.

• Posponer elemento de la transacción

  Aplaza un elemento de transacción en curso a una fecha posterior y lo devuelve al estado Nuevo.

• Establecer progreso de la transacción

  Actualiza un elemento de transacción en curso con una cadena de estado personalizada visible en Orchestrator.

• Establecer estado de la transacción

  Establece el estado final de un elemento de transacción en Correcto o Erróneo.

• Ejecutar actividad del conector

  Ejecuta una actividad de conector de Integration Service preconfigurada (por ejemplo, Salesforce o Slack).

• Esperar el evento del conector

  Pausa el proceso hasta que se recibe un evento específico de un conector (por ejemplo, envío de formulario o desencadenador externo).

• Ejecutar script

  Ejecuta un script corto (JavaScript o similar) durante el proceso para una lógica o transformación ligera.

  

El cuadro de diálogo Añadir variable te permite definir una nueva variable especificando su nombre, tipo (como Cadena, Número, Booleano, etc.) y un valor predeterminado opcional. Una vez guardada, la variable queda disponible para usarla en entradas, salidas o expresiones dentro de la tarea de Script.

Soporte de Autopilot para tareas de script

The JS Function Expression editor includes Autopilot for Maestro Orchestrate assistance that helps you write and refine JavaScript expressions directly in Script tasks. You can describe the logic you need in plain language, and Autopilot generates a function that you can review, edit, and test in place. The editor shows a live preview of the expression output and lets you insert variables from your workflow, so you can build and validate custom logic without leaving the canvas.

Para los campos obligatorios y el comportamiento de cada acción de cola, consulta Actividades de tareas de cola.

Para obtener más información sobre las tareas, consulta Tareas en el modelado BPMN.

Nota:

El acceso a la integración de agentes y a los flujos de trabajo de la API depende de la oferta de cloud que utilices. Para obtener más información, consulta Disponibilidad de la característica de Maestro Orchestrate.