Mappings: projetar, validar, publicar e executar

Projete e publique um Mapping, execute um CSV diretamente e confira um exemplo reproduzível com 18 entradas e dez saídas.

Objetivo e modelo

Um Mapping descreve como os registros são lidos, transformados e entregues por componentes conectados de origem, transformação e destino. Uma Session fornece o contexto reutilizável de execução; um Workflow coordena Sessions. Em um teste compatível somente com arquivos, Run executa o Mapping diretamente com o arquivo selecionado no navegador; não é obrigatório criar Session e Workflow.

Diferencie editar um rascunho, Save draft, Publish e Run. Salvar conserva o projeto. Publicar estabelece uma versão para consumidores autorizados. Executar processa dados. Os consumidores existentes podem manter uma referência publicada anterior.

Pré-requisitos e controles do editor

Confirme tenant, função e Domain/Folder de laboratório. Consulta, edição, publicação e execução têm permissões distintas. É necessário um worker elegível e compatível; componentes remotos também exigem Connections e acesso de rede no ambiente de execução. Siga a validação de nomes do editor e use um nome técnico como m_ClientesDemo.

Components pesquisa o catálogo; Configuration configura o componente selecionado. Domain, Folder e Shared within tenant definem localização e compartilhamento autorizado. Validate verifica o projeto; Auto arrange mapping, Zoom e Fit ajustam apenas a apresentação.

Arrange posiciona as dependências da esquerda para a direita. Requer pelo menos dois componentes e um grafo sem ciclos; um fluxo extenso pode continuar com rolagem horizontal. Modifica posições do rascunho, não registros nem a versão publicada. Se nada mudar, confira a organização atual, possíveis ciclos e a permissão de edição.

Exemplo: preparar um CSV de clientes

Baixe customers-demo.csvCSV · 2,2 kBAbrir arquivo: 18 registros sintéticos e oito colunas. A demonstração preservada produziu dez registros e seis colunas · clientes-demo-excel.csvCSV · 773 BAbrir arquivo. O resultado é um CSV que pode ser aberto no Excel, não uma pasta de trabalho XLSX.

Selecione Mappings → New Mapping. Informe nome e localização autorizada de laboratório.
Adicione Flat File input em Components. Em Configuration, selecione CSV, delimitador vírgula, cabeçalho na linha 1 e UTF-8. Confira os oito nomes de coluna.
Adicione as transformações da tabela e conecte portas compatíveis na ordem indicada. Selecione cada componente para configurar seus campos.
Adicione Flat File output: CSV, clientes-demo-excel.csv, vírgula, cabeçalho incluído, aspas duplas, modo minimal, finais CRLF e UTF-8 with BOM.
Use Validate, corrija os problemas e selecione Save draft. Depois use Publish, confirme Publish mapping e confira a versão publicada.
Selecione Run e escolha o CSV sintético no seletor de arquivos. Essa execução compatível de um único arquivo não exige uma Session ou um Workflow separado.
No Monitor, identifique a tentativa e aguarde seu estado final. Após o sucesso, use Download output quando houver saída armazenada.

Componente	Configuração da demonstração
`Clean text`	Campos de negócio `customer_id`, `full_name`, city, segment, status e `credit_limit`; operações trim, `collapse_whitespace` e upper, nessa ordem.
`Replace values`	No campo status, substituir HABILITADO por ACTIVO; correspondência exata e sensível a maiúsculas.
`Row filter` × 4	status equals ACTIVO; `customer_id` `not_empty`; `full_name` `not_empty`; `credit_limit` `not_empty`. Os quatro filtros ficam antes da conversão.
`Convert type`	`credit_limit` para number; Output field vazio substitui o campo; On conversion error = Fail execution.
`Field mapper`	`customer_id`→`cliente_id`, `full_name`→`cliente_nombre`, city→ciudad, segment→segmento, status→estado, `credit_limit`→`limite_credito`.
`Field selector`	Manter apenas essas seis colunas renomeadas, nessa ordem; excluir `demo_row_ref` e `internal_note`.
`Row sort`	`cliente_id`, asc.

Conferir o resultado

Compare contagem, cabeçalho exato, identificadores únicos, valores e ordem física com a referência. Espere dez registros, seis colunas e cliente_id crescente. DEMO-C002 resulta em CLIENTE DEMO BETA, ACTIVO e valor numérico 2500. A linha inativa com NO_NUMERICO deve ser filtrada antes da conversão. Zero é permitido neste exemplo; exigir valor positivo mudaria o contrato.

Compare números pelo valor: 2500.0 não precisa ser serializado como 2500.00. A demonstração preservada comprova esses resultados sintéticos, sem garantir desempenho. O laboratório de normalização de clientes é outro exemplo, com uma cadeia histórica de oito transformações, 1.000 entradas e 667 saídas esperadas.

Projeção e assistência

Field selector preserva linhas e valores dos campos selecionados e remove as outras colunas também do esquema de saída. fileName define o nome do arquivo, não suas colunas. Para campos extras inesperados, confira configuração salva, ramificação conectada, componentes posteriores e a versão realmente executada.

Você pode pedir um projeto configurado ao DovaAI, revisar a proposta e confirmar um rascunho. Criar o rascunho não publica, agenda nem executa o fluxo. Nomes atuais de Mapping têm 2–79 caracteres, começam por letra e usam apenas letras, números ou sublinhados.

Validação, falhas e recuperação

Uma porta conectada não comprova a existência de uma coluna obrigatória. Confira esquema de origem, renomeações anteriores, nulos e compatibilidade do conector. Falhas de conversão podem indicar filtros fora de ordem. Em Sessions com arquivos, revise os vínculos e o acesso do worker; um caminho local do navegador não é um caminho do worker. Mantenha credenciais em Connections.

Após alterar um Mapping usado por Sessions, confira seus avisos de versão e atualize as dependências deliberadamente. Publicar o Mapping não republica todos os consumidores. Preserve uma saída anterior para comparação; o estado de sucesso sozinho não comprova correção funcional.

Referências relacionadas

Consulte a referência de transformações para o catálogo mais amplo, incluindo Unpivot, Run sequence, Field fingerprint e Partition rank. A compatibilidade depende do motor e do worker. Use Monitor para evidências e Open items para navegar sem confundir rascunhos com versões publicadas.