Transformação de dados

Operações de transformação de dados para filtrar, mapear e agrupar coleções.

Transforma dados usando uma variedade de operações. O nó Transformação de dados e seus nós de operação individuais (Filter, Map, Group By) estão disponíveis como nós selecionáveis separados na paleta de nós.

Quando usar a Transformação de dados em vez do Script

Use operações de Transformação de Dados quando a transformação for uma operação no nível de campo em uma coleção. As operações disponíveis cobrem:

• Filtragem
• Mapeamento
• Agrupamento

Use o Script quando a transformação exigir lógica condicional, aritmética ou manipulação de string, ou quando nenhuma operação dedicada cobrir o caso. Você pode combinar os dois: uma operação de Transformação de dados pode filtrar ou reformular uma coleção e, em seguida, passar o resultado para um nó de Script.

Saída

Todos os nós de operação de Transformação de Dados emitem seu resultado como output, acessível downstream como $vars.<nodeName>.output.

Filtro

Mantém apenas as entradas em uma coleção que corresponde às suas condições.

Configuração

Campo	Required	Description
Entrada	Sim	A coleção (array) para filtrar. Referenciar como $vars.<nodeName>.output.
Condições	Sim	Uma ou mais condições. Mantemos uma entrada apenas se todas as condições forem atendidas.

Exemplo

Mantenha apenas pedidos com um status de "completed":

• Entrada: $vars.fetchOrders1.output.body
• Condição: status é igual a completed

Saída disponível como $vars.filter1.output.

Mapa

Transforma cada entrada em uma coleção modificando ou reformatando seus campos.

Configuração

Campo	Required	Description
Entrada	Sim	A coleção (array) a transformar.
Mapeamentos de campo	Sim	Para cada campo de destino, defina o nome e o campo ou expressão de origem.

Exemplo

Renomeie os campos firstName e lastName como first e last:

Campo de destino	Mapeamento de origem
first	firstName
last	lastName

Saída disponível como $vars.map1.output.

Agrupar por

Agrupa uma coleção por meio de um campo compartilhado e agrega valores como totais, médias ou contagens.

Configuração

Campo	Required	Description
Entrada	Sim	A coleção (array) para agrupar.
Agrupar por campo	Sim	O campo cujo valor determina o grupo.
Agregações	Não	Campos adicionais calculados por Grupo (contagem, soma, média, mín., máx., primeiro, último, coletar).

Exemplo

Agrupar uma lista de pedidos por region e contar o número de pedidos por região:

• Entrada: $vars.fetchOrders1.output.body
• Agrupar por: region
• Agregação: orderCount = contagem

Saída disponível como $vars.groupBy1.output.

Problemas comuns

Issue	Resolution
A saída está vazia após filtrar	As condições não correspondem a nenhuma entrada. Inspecione a coleção de entrada no trace de execução para verificar os nomes e valores dos campos.
A saída do mapa tem undefined campos	O caminho do campo de origem não existe nas entradas. Use o trace de execução para confirmar a estrutura de entrada.