Script

A atividade Script usa JavaScript para habilitar a manipulação de dados personalizada dentro do seu fluxo de trabalho. Ele integra-se aos fluxos de trabalho de APIs, permitindo que você:

• Extraia, formate e reestruturar respostas de API.
• Agregar e consolidar dados.
• Executar cálculos e transformações de dados.
• Padronize formatos de dados para etapas posteriores.
• Execute dentro do contexto de execução do fluxo de trabalho, acessando apenas dados de fluxo de trabalho existentes e saídas de etapas.

Use a atividade Script para refinar respostas de API aninhadas ou fragmentadas antes de passá-las para atividades de fluxo de trabalho subsequentes.

Restrições conhecidas

• Você não pode fazer chamadas de API usando a atividade Script . Use a atividade HTTP Request em vez disso.
• A execução do código JavaScript tem um tempo limite de 30 segundos.

Como usar a atividade Script

Para adicionar uma atividade Script ao seu fluxo de trabalho:

1. Em sua tela de designer de fluxo de trabalho de API, selecione o ícone de mais (+). O menu Adicionar atividade aparece.
2. Selecione Script.
3. No painel Propriedades , expanda o Editor de expressão e, em seguida, escreva sua lógica JavaScript no painel Código .
4. Depure o fluxo de trabalho para executar a atividade e gerar campos de saída para uso posterior.

Para um uso ideal, use as seguintes recomendações:

• Use a instrução return para estruturar com eficiência as saídas JSON.
• Use .map() para transformar arrays em objetos estruturados.
• Use o gerador de expressão do Autopilot para gerar automaticamente JavaScript com base no contexto do fluxo de trabalho, minimizando o esforço de codificação manual. Por exemplo: " Eu busquei respostas de 3 chamadas HTTP, mescle-as em um objeto JavaScript".

Exemplo de atividade de script

O exemplo a seguir consolida dados de várias etapas do fluxo de trabalho em um objeto JSON estruturado usando a atividade Script . Essa abordagem é especialmente útil com APIs do Workday, que geralmente exigem várias chamadas de endpoint para recuperar conjuntos de dados completos, como detalhes de funcionários, gerentes e relatórios diretos.

A imagem a seguir mostra o fluxo de trabalho original, que será consolidado em um objeto JSON com a atividade Script.

Abra a janela Configuração de depuração , cole e salve a seguinte sintaxe JSON:

{
  "first_name": "Betty",
  "last_name": "Liu"
}

1. Na tela do designer do fluxo de trabalho da API, adicione uma atividade Script .
2. Abra o Editor de expressão e cole a seguinte implementação:

   return {
   
       // Details on the worker
       worker: {
           name: $currentItem.descriptor,
           email: $currentItem.person.email
       },
   
       // Details of their manager
       manager: {
           name: $context.outputs.Workers_3.content.descriptor,
           email: $context.outputs.Workers_3.content.person.email
       },
   
           // Details for their direct reports
       reports: $context.outputs.Workday_REST_HTTP_Request_4.content.data.map(report => ({
           name: report.descriptor,
           email: report.primaryWorkEmail
       }))
   }
   

Preste atenção às seguintes áreas neste exemplo:

• Usando $context.outputs para recuperar dados de chamadas de API anteriores.
• Usando .map()para transformar matrizes em listas estruturadas de relatórios.
• Combinando várias respostas de API em um único objeto JSON.