FT-MAPPING-PREVIEW-V1· 1.1.0help.categories.mapping
Preview do mapping convertido
Aplica os campos do mapping num payload de exemplo e mostra o resultado convertido + erros/warnings, sem persistir nada.
Atualizado em 5/8/2026
Preview do mapping convertido
Onde: botão Preview no editor de mapping (toolbar topo).
O que faz: aplica os field mappings atuais (mesmo sem salvar) num payload de exemplo e mostra:
- O payload de entrada (input)
- O resultado convertido (output)
- Lista de erros e warnings
Origens de sample:
- Manual (JSON) — cole um JSON e clique em Executar.
- Última mensagem real — usa a última mensagem recebida deste message_type. Útil pra validar contra dado real sem precisar copiar JSON.
Erros vs warnings:
- Erros bloqueiam a ativação do mapping (use Validar e ativar).
- Warnings são informativos: campo opcional ausente, navigation property OData não expandida, smart fallback aplicado.
Fluxo recomendado:
- Editar campos do mapping no editor.
- Clicar em Preview com a última mensagem real.
- Conferir que o output bate com o esperado pela ponta destino.
- Salvar e ativar.
O preview não modifica nada no banco — é puro dry-run.
Atualizações 2026-05-08
- Sample manual default não é mais payload de SalesOrder hardcoded — agora exibe placeholder dinâmico mencionando o
source_formatreal do mapping aberto. - Tab "Última mensagem real" ganhou filtro defensivo por
environment_id, evita pegar mensagem de outro ambiente em casos de FK inconsistente. - Mensagens de erro mais específicas (ex: "neste ambiente", "mapping sem message_type associado").
Histórico de versões
- 1.1.0
Sample default deixa de ser SalesOrder hardcoded — agora é placeholder dinâmico mostrando source_format real do mapping. Endpoint /preview-mapping ganha filter por environment_id (defensivo) + guard para message_type_id null. Mensagens de erro mais específicas.
5/8/2026 · updated
- 1.0.0
Preview de payload convertido: endpoint POST /api/edi-hub/preview-mapping aplica field_mappings em sample (manual JSON ou last_message do message_type) e retorna data + errors + warnings. Modal no editor com 2 panes input/output, lista de erros/warnings, escolha de origem.
5/7/2026 · new