Transformar

Aplique várias operações a uma lista em um nó: filtre-a, renomeie cada item, agrupe os itens ou execute seu próprio JavaScript.

A transformação aplica uma cadeia de operações a uma lista em um nó. Cada operação recebe o resultado da anterior, para que você possa, por exemplo, manter apenas os pedidos abertos, remodelar cada um e depois agrupá-los por cliente. Ela está na categoria Dados do painel Adicionar nó .

Quando você precisar de apenas uma operação, use seu próprio nó: Filtrar, Mapear ou Agrupar por.

Configure o nó

1. Selecione + no identificador do nó que segue e, em seguida, selecione Dados > Transformar.

2. No painel de propriedades, selecione Editar transformação.

3. Em Coleção, insira a lista a ser transformada, por exemplo, $vars.scriptTask1.output. O campo espera um array.

4. Adicione as operações, na ordem que elas devem ser executadas:

   Operação	O que faz
   Adicionar Filtro	Retorna apenas os itens que correspondem às condições que você definiu.
   Adicionar mapa	Transforma cada item em uma nova forma, com os mapeamentos de campo que você define.
   Adicionar Grupo por	Agrupa os itens por um campo e calcula uma contagem, soma ou média para cada grupo.
   Adicionar Script Personalizado	Executa sua própria lógica de transformação em JavaScript.

5. Selecione Executar para testar o nó e verifique o resultado na coluna Saída .

Saída

O nó retorna o resultado da última operação output. Os nós posteriores o leem como $vars.<nodeId>.output, por exemplo, $vars.transform1.output.

Transformação ou Script

Use Transformar quando o trabalho estiver filtrando, reformulando ou agrupando uma lista. Use o Script quando a lógica não se adequar a essas operações. Dentro da Transformação, Adicionar Script personalizado abrange uma única etapa que precisa de código.

Problemas comuns

Issue	Resolution
A coleção mostra um erro	O campo é obrigatório e espera um array. Verifique o valor no trace de execução do nó que o produz.
A saída fica vazia depois que um filtro	As condições não correspondem a nenhum item. Verifique os nomes de campos e valores da entrada no trace de execução.
A saída tem undefined campos depois de um mapa	O campo de origem não existe nos itens de entrada. Verifique a estrutura de entrada no trace de execução.

Próximas Etapas

• Filtrar, Mapear e Agrupar por: uma operação por nó.
• Variáveis e fluxo de dados: como as referências $vars funcionam.