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:
- Campo: autocomplete com fields do nested array (no caso: ConditionType, ConditionAmount, ConditionIsActive, etc.)
- Operador: dropdown (é igual a, está em, maior que, contém, é nulo, etc.)
- 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"eConditionType 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
| Caso | Filter | Match |
|---|---|---|
| SAP gross amount | ConditionType eq "PR00" | first |
| Soma de descontos | ConditionType in ["ZD01","ZK00"] AND ConditionIsActive eq true | sum_all |
| Imposto único | ConditionType startsWith "MWS" | single |
| Lista de qualifiers | ConditionIsActive eq true | join_all |