Tarefa do script

Execute JavaScript em linha em tarefas do Maestro Script para manipular dados, enriquecer cargas, aplicar lógica condicional ou transformar a entrada antes de passá-la para o próximo componente do processo.

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.

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:

  O Maestro atualmente é compatível com JavaScript apenas dentro do editor de expressão.

Configuração de uma tarefa Script no Maestro

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. Mapeie saídas do objeto de retorno para variáveis do Maestro usando a seção Saídas.

Resultado

Você configura a tarefa de script com suas entradas, lógica e mapeamentos de saída.Os valores do objeto de retorno ficam disponíveis como variáveis do Maestro para uso em nós de processo subsequentes.

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

  Adds up to 15,000 items to a Queue in a single batch.

• Delete queue items

  Removes items with New status from a Queue.

• Postpone transaction item

  Defers an in-progress transaction item to a later date and returns it to New status.

• Set transaction progress

  Updates an in-progress transaction item with a custom status string visible in Orchestrator.

• Set transaction status

  Sets the final state of a transaction item to Successful or Failed.

• 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

O Editor de expressão de função JS inclui assistência do Autopilot para Maestro que ajuda você a escrever e refinar expressões JavaScript diretamente nas tarefas de script. Você pode descrever a lógica de que precisa em linguagem simples e o Autopilot gera uma função que você pode revisar, editar e testar no local. O editor mostra uma prévia em tempo real da saída da expressão e permite inserir variáveis do seu fluxo de trabalho para que você possa criar e validar lógica personalizada sem sair da tela.

For required fields and behavior of each queue action, refer to Queue task activities.

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.