Primeiro fluxo completo: do arquivo à execução verificada

Entenda quando executar o Mapping diretamente e quando usar Session e Workflow; prepare o laboratório e confira os resultados.

Escolha o primeiro teste

Para aprender a usar o editor com um arquivo local, comece por Mapping → Run: publique o Mapping, anexe o CSV sintético e confira o resultado no Monitor. Esse caminho não exige uma Session nem um Workflow separados. A demonstração de 18 para 10 linhas detalha cada componente.

Quando precisar reutilizar caminhos e parâmetros de execução ou coordenar tarefas, siga o percurso completo desta guia: Mapping → Session → Workflow → Monitor. A Session fornece o contexto; o Workflow coordena as dependências. São dois caminhos de execução, e não etapas obrigatórias por trás do mesmo botão Run.

Arquivos do primeiro Workflow

Para o percurso completo, use a pequena amostra desta edição: quatro clientes sintéticos, três com status=ACTIVE. Baixe a entrada e mantenha o resultado esperado separado.

Configure Flat File input → Row filter (field=status, operator=equals, value=ACTIVE) → Field selector (fields=customer_id, name, amount) → Flat File output. Publique o Mapping e continue com a Session e o Workflow desta guia. A saída deve conter somente customer_id, name e amount, com D001/Demo Alfa/125.50, D003/Demo Gamma/80.00 e D004/Demo Delta/0.00. Sem Row sort explícito, compare por identificador; não transforme a ordem de leitura em garantia universal. A representação decimal e os fins de linha podem variar: a aceitação confere esquema e valores, não identidade byte a byte. O percurso no navegador não exige um checkout privado do código.

Esta guia apresenta um laboratório que conecta organização, transformação, execução e verificação. O objetivo é gerar um CSV cujo conteúdo possa ser conferido, identificando as versões e as condições de execução. Use dados sintéticos e destinos separados de qualquer processo operacional.

Preparar o espaço de trabalho

Entre com uma identidade autorizada e confira o tenant e o papel ativos no menu da conta. Uma pessoa pode ter acesso a contextos diferentes; apenas o nome do objeto não identifica seu escopo. Abra Repository e localize um Domain e uma Folder destinados ao laboratório. Se seu papel não permitir criá-los, peça ao administrador que prepare esse espaço.

Adote nomes reconhecíveis, por exemplo com o prefixo lab_, e registre a relação entre Mapping, Session e Workflow. Não reutilize identificadores de objetos de produção. Prepare diretórios de entrada e saída acessíveis ao worker escolhido. Um caminho no computador do navegador pode não existir no worker remoto. Configure credenciais em Connections, nunca nos dados de exemplo nem no nome do arquivo.

Desenhar e validar o Mapping

O Mapping define as operações sobre os dados. Comece com Flat File input, uma transformação simples e Flat File output. Confira delimitador, codificação, nomes de colunas e valores vazios. Para estudar uma cadeia maior, siga a demonstração de normalização.

Em Mappings, escolha New Mapping e informe nome, Domain e Folder do laboratório.
Adicione os componentes pela paleta e configure cada um no painel do componente selecionado.
Conecte as portas de origem, transformação e destino na ordem da regra de negócio.
Use Validate e corrija os erros apresentados. Arrange e Fit organizam a visualização; não alteram a regra.
Escolha Save draft e depois Publish. Confirme a publicação e confira a versão persistida.

Um filtro antes da conversão pode produzir um resultado diferente do mesmo filtro após a conversão. Salvar um rascunho não o publica; publicar não inicia uma execução. Se escolher Run diretamente no Mapping, siga o caminho de upload de arquivo, sem criar os objetos das seções seguintes.

Associar a Session

A Session associa o Mapping ao contexto de execução. Crie uma Session de laboratório, selecione o Mapping publicado e confira sua versão. Defina o ambiente de teste, o perfil de execução e a política de worker. Mantenha o padrão do tenant quando não houver motivo para um override autorizado.

Em File paths, associe cada identificador de origem e destino ao caminho que o worker pode acessar. No exemplo simples, source_csv lê clientes e target_csv grava a saída. Use um destino exclusivo do laboratório. Um arquivo correto associado ao nó errado continua sendo um binding incorreto.

O worker precisa estar habilitado, elegível, compatível e com capacidade disponível. Confira heartbeat e slots em Workers; uma VM ligada não comprova que o agente consegue executar a tarefa. Revise os parâmetros tipados e a prévia de resolução. Salve, valide e publique a Session.

Orquestrar e executar manualmente

Crie um Workflow com Start → Session → End. Selecione sua Session publicada na tarefa, confira a versão e conecte as dependências de sucesso. Um Workflow precisa de exatamente um Start, pelo menos um End e caminhos válidos, sem ciclos, entre eles. Os nomes das tarefas devem ser únicos no desenho.

Valide, salve o rascunho e publique o Workflow. Execute manualmente no laboratório e registre o identificador do novo intento. Overrides informados para esse intento não são edições permanentes da Session ou do Workflow. Adicione Decision ou Timer somente após o caso simples produzir o resultado esperado; Timer aguarda um número de segundos, não cria uma agenda recorrente.

Ainda não habilite uma programação. Primeiro confira o comportamento manual, o destino efetivo e a evidência produzida. Ao atualizar um Mapping ou uma Session depois, revise e publique as dependências consumidoras; o rascunho aberto não substitui silenciosamente a versão fixada em uma execução.

Conferir o resultado e encerrar o teste

Abra Monitor e acompanhe o intento até um estado terminal. Uma solicitação aceita ou em fila não comprova a saída. Expanda as tarefas, consulte o primeiro erro relevante e os registros disponíveis. Quando houver uma saída armazenada e bem-sucedida, use Download output; se o destino for um arquivo no worker ou uma tabela, confira esse recurso autorizado.

Compare cabeçalho, valores, quantidade e ordem das linhas com um resultado esperado independente. Registre tenant, Domain, Folder, versões, identificador do intento, contagem e destino, sem segredos. Se houver diferença, investigue parsing, bindings e ordem das transformações antes de repetir a gravação em um destino compartilhado.

Depois de estabilizar o teste, prepare uma programação em Configuration → Workflow Scheduler com fuso horário explícito. Confira a próxima execução planejada e um intento real separadamente. Ao mover o fluxo para outro ambiente, revise permissões, caminhos, conexões e capacidade. Um teste local das regras não certifica a infraestrutura de destino.