Tarefa do 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.

Use tarefas de script para preparar dados para filas de esquemas, chamadas de API, Agents ou sistemas de armazenamento.

Implementação > Tipo: executar dcript em linha.

Quando usar tarefas Script

Use uma tarefa Script quando:

• Você precisa transformar ou reestruturar os dados de entrada.

• Você deseja validar campos ou rejeitar entradas inválidas.

• Você precisa combinar várias entradas em um único objeto.

• Você deseja filtrar, limpar ou reformatar os dados antes de encaminhar.

  Observação:

  Maestro Orchestrate currently supports JavaScript only inside the expression editor.

Setting up a Script task in Maestro Orchestrate

1. Adicione um nó de Tarefa de script da barra de ferramentas do processo (arraste-o para a tela ou clique duas vezes nele para inseri-lo no centro).
2. Adicione argumentos de entrada na seção Entradas no painel direito.

Os argumentos de entrada podem ser valores literais, variáveis de contexto ou saídas de nós anteriores (por exemplo, vars.inArg). 3. Escreva seu script no editor:

• Selecione o campo de entrada Script e, em seguida, expanda para a visualização completa do editor.
• As expressões JavaScript devem return um objeto ou valor, como neste exemplo:

  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.

Teste da lógica do script

Você pode testar expressões em linha selecionando o ícone fx para abrir o editor de Expressão de função JS. O editor inclui:

• Um painel de entrada de teste onde você pode colar entradas de amostra.
• Um painel de saída de Expressão em tempo real para visualizar como será o seu objeto de retorno.

Os erros de runtime (por exemplo, falhas JSON.parse) serão exibidos para ajudar você a depurar.

Ações disponíveis para tarefas Script

O menu suspenso Ação em uma tarefa Script permite definir o tipo de execução externa que o processo deve chamar. Cada opção mapeia para uma funcionalidade ou método de integração específico da UiPath. Abaixo está uma breve visão geral de cada opção:

• Nenhum

  Nenhuma implementação está configurada para a tarefa Script.

• Criar tarefa de aplicativo de ação

  Cria uma tarefa em um Action App para interação do usuário, sem esperar a conclusão da tarefa.

• Iniciar e aguardar o fluxo de trabalho de RPA

  Inicia um fluxo de trabalho RPA implantado (por exemplo, projeto do UiPath Studio) e aguarda sua conclusão antes de continuar.

• Iniciar e aguardar o agente

  Inicia um agente UiPath (um bloco lógico reutilizável) e aguarda que ele finalize a execução.

• Iniciar e aguardar o agente externo

  Aciona um agente hospedado fora da UiPath, como CrewAI, Salesforce ou ServiceNow, e aguarda o resultado.

• Iniciar e aguardar o fluxo de trabalho da API

  Executa um fluxo de trabalho baseado em API e aguarda uma resposta.

• Iniciar processo agêntico

  Inicia um processo com base no design agêntico (lógica modular), sem esperar que ele finalize.

• Iniciar e aguardar o processo agêntico

  Inicia um processo agêntico e pausa até que a execução seja concluída.

• Executar regra de negócios [Visualização]

  Avalia uma regra de negócios e usa o resultado no processo (atualmente em pré-visualização).

• Criar item da fila

  Adiciona um novo item a uma fila da UiPath para processamento assíncrono, sem esperar o resultado.

• Criar e aguardar item da fila

  Adiciona um item a uma Fila e espera até que ele seja processado antes de avançar.

• Bulk add queue items

  Adiciona até 15.000 itens a uma Fila em um único lote.

• Delete queue items

  Remove itens com status Novo de uma Fila.

• Postpone transaction item

  Adia um item de transação em andamento para uma data posterior e o retorna ao status Novo.

• Set transaction progress

  Atualiza um item de transação em andamento com uma string de status personalizada visível no Orchestrator.

• Set transaction status

  Define o estado final de um item de transação como Bem-sucedido ou Falhado.

• Executar atividade do conector

  Executa uma atividade de conector do Integration Service pré-configurada (por exemplo, Salesforce ou Slack).

• Aguardar evento do conector

  Pausa o processo até que um evento específico seja recebido de um conector (por exemplo, envio de formulário ou gatilho externo).

• Executar script

  Executa um script curto (JavaScript ou similar) durante o processo para lógica ou transformação leve.

  

O diálogo Adicionar variável permite definir uma nova variável especificando seu nome, tipo (como String, Número, Booleano etc.) e um valor padrão opcional. Após salva, a variável fica disponível para uso em entradas, saídas ou expressões dentro da tarefa Script.

Suporte ao Autopilot para tarefas 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 campos necessários e comportamento de cada ação da fila, consulte Atividades de tarefa da fila.

Para obter mais informações sobre tarefas, acesse Tarefas na modelagem BPMN.

Observação:

O acesso à integração de agentes e fluxos de trabalho de API depende da oferta de cloud que você usa. Para obter detalhes, consulte a disponibilidade de funcionalidade do Maestro Orchestrate.