Todos os artigos
help.categories.mapping

Tutorial: criar regra Filter Lookup pelo editor visual

Passo a passo pra criar filter_lookup rule no drawer — útil pra SAP pricing, X12 qualifier-driven amounts, EDIFACT MOA com qualifier.

Atualizado em 5/25/2026

Passo 1 — Abra o drawer da rule



Clique no nome do destino no grid. O drawer lateral abre com formulário completo.

Passo 2 — Configure source/destino



  • Origem: path do array com [], terminando no campo de VALOR. Ex: to_Item[].to_PricingElement[*].ConditionAmount
  • Destino: campo EDIFACT/X12. Ex: LIN[*].MOA.C516.C51602


Passo 3 — Escolha transform "Filter Lookup"



No grid de transforms, clique no botão "Filter Lookup" (último, com banner azul explicativo).

Passo 4 — Configure a condição



Drawer mostra editor com grupo raiz "ATENDE TUDO (AND)". Cada cláusula tem 3 partes:
  1. Campo: autocomplete com fields do nested array (no caso: ConditionType, ConditionAmount, ConditionIsActive, etc.)
  2. Operador: dropdown (é igual a, está em, maior que, contém, é nulo, etc.)
  3. Valor: input que se adapta ao tipo do field (texto, número, checkbox, lista)


Ex: ConditionType é igual a "PR00"

Passo 5 — Adicione mais cláusulas (opcional)



Clique em "+ Cláusula" pra adicionar irmã no grupo atual.

Pra lógica composta (PR00 OU ZINV E ativo):
  • Clique em "+ Grupo OR aninhado" dentro do AND raiz
  • Dentro do OR, adicione 2 cláusulas: ConditionType eq "PR00" e ConditionType eq "ZINV"
  • De volta no AND raiz, adicione ConditionIsActive eq true


Cada grupo tem cor distinta (verde/azul/âmbar) pra visualizar nível.

Passo 6 — Match strategy



Escolha o que fazer com os matches:
  • Primeiro match: pega o primeiro (default)
  • Último match: o último na ordem do array
  • Único: erro se 2+ matches (garante unicidade)
  • Somar todos: soma valores numéricos
  • Juntar como texto: concatena com separador


Passo 7 — Teste no "Ver saída"



Feche o drawer, abra "Ver saída do mapping". Confirme que o campo destino aparece com o valor correto da última mensagem real.

Casos comuns



CasoFilterMatch
SAP gross amountConditionType eq "PR00"first
Soma de descontosConditionType in ["ZD01","ZK00"] AND ConditionIsActive eq truesum_all
Imposto únicoConditionType startsWith "MWS"single
Lista de qualifiersConditionIsActive eq truejoin_all