Tarefa do script

	A Tarefa Script no Maestro permite que você execute JavaScript em linha para manipular dados, enriquecer cargas, aplicar lógica condicional ou transformar a entrada antes de passá-la para o próximo componente no processo. Isso é particularmente útil quando você deseja preparar dados para filas de esquemas, chamadas de API, agentes ou sistemas de armazenamento.

Implementação > Tipo: Executar script 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.

Note: Maestro currently supports JavaScript only inside the expression editor.

Configuração de uma tarefa Script no Maestro

1. Arraste um nó de tarefa Script da barra de ferramentas do processo.
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:
   • Clique na caixa de entrada em 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. Mapeie saídas do objeto de retorno para variáveis do Maestro usando a seção Saídas.

Teste da lógica do script

Você pode testar expressões em linha clicando no í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, JSON.parse falhas) serão mostrados 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 [visualização]

  Executa um fluxo de trabalho baseado em APIs (em pré-visualização) 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.

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

  
  
  
  
  

Para adicionar uma nova saída, selecione Adicionar nova para introduzir uma nova variável diretamente dentro da tarefa Script. A saída recém-introduzida estará disponível em etapas subsequentes.

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.

Para atualizar o valor de uma variável existente, selecione Definir valor da variável.

Para mais informações sobre tarefas. acessar Tarefas na modelagem BPMN.