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ções individuais (Filtrar, Mapear, Agrupar por) estão disponíveis como nós selecionáveis separados na paleta de nós.

Quando usar Transformação de dados versus 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 abrangem:

• 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 abranger o caso. Ambos podem ser combinados: uma operação Data Transform pode filtrar ou remodelar uma coleção e, em seguida, passar o resultado para um nó de Script.

Saída

Todos os nós da operação Transformação de dados geram seu resultado como output, acessível posteriormente como $vars.<nodeName>.output.

Filtro

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

Configuração

Campo	Required	Description
Entrada	Sim	A coleção (array) a ser filtrada. Referência como $vars.<nodeName>.output.
Condições	Sim	Uma ou mais condições. Uma entrada é mantida apenas se todas as condições forem atendidas.

Exemplo

Mantenha apenas os pedidos com um status de "completed":

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

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

Mapa

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

Configuração

Campo	Required	Description
Entrada	Sim	A coleção (array) a ser transformada.
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 para 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 um campo compartilhado e agrega valores como totais, médias ou contagens.

Configuração

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

Exemplo

Agrupe uma lista de pedidos por region e conte 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 depois do Filtro	As condições não correspondem a nenhuma entrada. Inspecione a coleção de entradas no trace de execução para verificar os nomes e valores de campos.
A saída do mapa tem undefined campos	O caminho do campo de origem não existe nas entradas de entrada. Use o trace de execução para confirmar a estrutura de entrada.