Antes de começar
Um Mapping define o algoritmo de transformação. A Session fornece o contexto de execução e o Workflow coordena tarefas. Selecione o tenant correto e uma localização autorizada no Repository. É necessário poder editar; publicar e executar são ações adicionais. Prepare entrada sintética e resultado esperado sem credenciais nem dados de clientes.
Um componente na paleta não garante compatibilidade com qualquer worker. Confira o runtime, especialmente em conexões externas e grafos com Join.
Procedimento
- Abra Mappings e crie um rascunho no Domain e Folder adequados. Use um nome descritivo.
- Adicione componentes pelas categorias e conecte cada saída à entrada seguinte. Selecione o componente para configurar seu inspetor.
- Ajuste cabeçalho, nomes e tipos da origem antes das transformações. Confira as chaves de Join e as colunas que chegarão ao destino.
- Use Validate para resolver problemas do grafo. Save persiste o rascunho. O indicador de salvamento local não substitui essa ação.
- Publique somente depois de salvar todas as alterações. Publish exige rascunho salvo sem edições pendentes; não executa o Mapping.
Field selector: manter somente campos escolhidos
Para manter apenas duas colunas de um CSV, conecte Flat File input → Field selector → Flat File output. Configure hasHeader=true, delimiter=, e fields=["name","amount"]. O seletor preserva valores e linhas, mas remove as demais colunas do esquema. O destino usa esse esquema; fileName não seleciona campos.
Conferir o resultado
Reabra o rascunho para confirmar a persistência. Confira a versão publicada antes de vinculá-la à Session. Execute uma amostra na capacidade autorizada e compare cabeçalho, linhas e valores com o esperado. A validação estrutural não comprova que o arquivo exista no worker nem que a saída atenda à regra de negócio.
Peça ao DovaAI os componentes, conexões e valores adequados ao objetivo. O assistente fornece instruções breves; você configura, salva, publica e executa pelos controles normais do Dova.
Resolver problemas
Se Publish estiver desativado, confira salvamento, alterações pendentes, localização, permissões e bloqueios de edição. Se surgirem colunas extras, confira a configuração salva de Field selector, o ramo conectado e a versão usada pela Session. Para arquivos ausentes, corrija os bindings do runtime. Em incompatibilidade de streaming, confira o adaptador: o genérico exige um caminho linear compatível. Não remova etapas necessárias apenas para passar na validação.
Aplicar operações diferentes a campos diferentes
Conecte dois componentes Clean text em sequência:
Raw file → Clean text 1 → Clean text 2 → Destino
- Clean text 1: Fields =
first_name; Operations =trim. - Clean text 2: Fields =
last_name; Operations =upper.
Os dois campos seguem juntos. Cada componente altera somente o campo indicado e preserva os demais. Essas duas operações não precisam dividir o fluxo nem usar Field mapper.
Excluir uma seleção do canvas
Selecione o elemento e pressione Delete com o foco dentro do canvas. O atalho não deve remover componentes durante a digitação em input, textarea ou outro editor. Confira as conexões afetadas e valide o grafo após excluir; a alteração fica no rascunho até salvar e publicar.
Colunas para dependências e publicação
Em Columns, escolha Used by (Sessions), Location, Last published e Description. Used by (Sessions) conta as Sessions que usam o Mapping; selecione o número para consultar seus nomes e as versões do Mapping referenciadas. Location combina Domain e Folder. Last published mostra data e responsável pela última publicação, separadamente de Updated, que pode refletir alterações do rascunho. Description resume a finalidade do Mapping. Quando falta evidência histórica, a tabela informa isso em vez de inventar uma data ou um usuário.
Uma configuração nova mostra Mapping, Version, Status, Used by (Sessions), Location e Updated. As escolhas de colunas existentes são preservadas; ative as adicionais em Columns. O filtro Status oferece Draft e Published, conforme o ciclo de edição e publicação.
Tela cheia sem perder o trabalho
Full Screen amplia o canvas de Mappings ou Workflows no mesmo editor. A entrada e a saída atualizam o layout imediatamente e preservam seleção, zoom e posição. Use o mesmo botão ou Escape para voltar. O DovaAI continua disponível nessa visualização; ampliar o canvas não salva nem publica o rascunho.
Ações da tabela
Ao iniciar uma opção de Actions, um indicador de progresso aparece no controle e bloqueia as demais ações da mesma tabela enquanto a solicitação está pendente. Espere o resultado antes de repetir. Uma solicitação iniciada não comprova que o salvamento, a publicação ou outra operação terminou.
Contexto de ambiente
Antes de usar este módulo, confirme Tenant, Domain e Environment no menu do usuário. O ambiente inicial é Development. As capacidades do módulo, Domain e ambiente se aplicam juntas; Production fica somente leitura sem autorização explícita. Mudar o seletor não transfere artefatos nem publica ou executa seus dados. Consulte ambientes e recuperação e promoção entre ambientes.
Lista compacta e botões com ícones
A lista reúne Search, Status e ações em uma barra compacta. Refresh, Columns, Export CSV, Delete selected, New Mapping e Clear filters usam ícones; passe o ponteiro sobre um botão ou dê foco com Tab para identificar a ação. As ações continuam respeitando seleção, permissões e estados desabilitados.
A lista de Mappings não contém filtros Environment nem Runtime. O ambiente vem do contexto ativo da barra inferior; o worker e sua capacidade são configurados na Session. Use Search, Status e os filtros de colunas para consultar os objetos desse contexto.
Projetar, salvar e publicar no editor
Advanced, Validate, Save draft e Publish aparecem como botões com ícones e nomes acessíveis. A ajuda do botão identifica a ação e, quando aplicável, o ambiente de salvamento ou publicação. O cabeçalho não repete o distintivo DEV: confirme Tenant, Domain e Environment na barra inferior.
Mappings não oferece um botão Run. Um Mapping define a transformação; para executá-la, salve e publique a versão revisada, selecione-a em uma Session e configure suas entradas, destinos e worker compatível. Execute a Session diretamente ou por um Workflow autorizado. Publicar o Mapping não inicia uma execução nem atribui capacidade.
Configuration do componente
Selecione um componente para examinar suas seções e campos em Configuration. Rótulos, controles e ajuda são distribuídos na largura disponível. Nas origens com Header mapping, os botões de carregar amostra, adicionar campo e excluir mantêm seu próprio espaço junto ao título. Examine Source, Output e Type na tabela; role horizontalmente se as colunas não couberem no painel. Uma amostra de cabeçalhos configura o esquema e não substitui o arquivo que a Session lerá no worker.