Tarea de script

	La tarea de script de Maestro te permite ejecutar JavaScript en línea para manipular datos, enriquecer cargas útiles, aplicar lógica condicional o transformar la entrada antes de pasarla al siguiente componente del proceso. Esto es particularmente útil cuando deseas 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 solo admite JavaScript dentro del editor de expresiones.

Configurar una tarea de Script en Maestro

1. Arrastra un nodo de tarea de Script desde la barra de herramientas del proceso.
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:
   • Haz clic en el cuadro de entrada bajo 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. Asigna las salidas del objeto de retorno en variables de Maestro mediante la sección Salidas.

Pruebas de lógica de script

Puedes probar expresiones en línea haciendo clic en el fxicono para abrir 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 [Vista previa]

  Ejecuta un flujo de trabajo basado en la API (en vista previa) 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.

• 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.

  
  
  
  
  

Para añadir una salida adicional, selecciona Añadir nuevo para introducir una variable nueva directamente dentro de la tarea de Script. La salida recién introducida estará disponible en pasos posteriores.

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.

Para actualizar el valor de una variable existente, selecciona Establecer valor de variable.

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