Publicação e versões das dependências

Prepare a cadeia Mapping → Session → Workflow distinguindo rascunhos, versões publicadas e resultados de execução.

Três objetos com responsabilidades próprias

Um Mapping descreve o fluxo de dados. Uma Session referencia uma versão do Mapping e define vínculos, parâmetros e perfil de execução. Um Workflow seleciona Sessions e organiza suas tarefas. A cadeia publicada precisa ser coerente: um Workflow publicado não corrige uma Session incompleta nem concede acesso a uma Connection.

Trabalhe em uma localização de laboratório e confira separadamente permissões de edição, publicação e execução. Prepare arquivos sintéticos, Connections autorizadas e capacidade de worker antes de aceitar a cadeia.

Salvar, publicar e executar

Ação	O que conferir
`Save draft`	As alterações editáveis ficam salvas. Isso não demonstra uma nova execução.
`Validate`	A definição passa pelas verificações do objeto. Não comprova conectividade nem dados finais.
`Publish`	A versão fica disponível para consumidores autorizados. Revise as dependências selecionadas.
`Run`	Cria uma tentativa com contexto de execução. Confira depois o estado e o resultado real.

Salvar um CSV no navegador não coloca o arquivo no sistema de arquivos do worker. Da mesma forma, um rascunho preparado pelo DovaAI não é publicado nem executado nessa etapa de criação.

Publicar uma cadeia controlada

Abra o Mapping e confira origem, transformações, destino e esquema. Valide e salve o rascunho.
Publique o Mapping e registre a versão escolhida para o laboratório.
Abra a Session e confira a referência do Mapping, a versão e os vínculos de entrada e saída. Valide e publique a Session.
Abra o Workflow. Em cada tarefa Session, confira Reusable session e a versão consumida. Revise os avisos de dependência.
Valide conexões e condições, salve o rascunho e publique o Workflow.
Execute manualmente com uma saída de laboratório independente. Registre a tentativa e compare o Monitor com o arquivo ou destino obtido.

Exemplo: alterar uma regra com rastreabilidade

Suponha que m_CustomersActive v1 mantenha status=ACTIVE. A Session v1 e o Workflow v1 foram aceitos com três registros. Você altera o Mapping para descartar também amount=0. Para a amostra do laboratório, o resultado esperado da nova regra passa a ser dois registros.

Publique deliberadamente a nova versão do Mapping, confira a referência mantida pela Session e atualize os consumidores pelas ações disponíveis. Repita a revisão no Workflow e teste novamente. Preserve as duas saídas para explicar a diferença. Não deduza a versão executada pelo rascunho que ficou aberto em outra aba.

Evidência mínima de aceitação

Nome e versão de cada objeto da cadeia, além do identificador da tentativa.
Parâmetros e vínculos efetivos do teste, sem copiar segredos.
Estados das tarefas e primeiro erro relevante, quando houver.
Esquema, quantidade de registros e regras de negócio verificadas na saída.

As referências do Mapping podem incluir versão e fingerprint; uma execução fixa seu contexto autorizado. Isso identifica o que foi consumido, mas não torna imutável um arquivo externo que pode mudar. Preserve ou identifique também os dados de entrada. A validação bem-sucedida do objeto é apenas uma parte da aceitação.

Atualizar ou voltar a uma referência conhecida

Se uma dependência estiver indisponível, confira publicação, tenant, localização, permissões e versão. Se salvar funcionar, mas Run falhar, investigue worker, caminhos, Connections e dados. Republicar repetidamente não substitui a leitura do erro real.

Para comparar com uma versão aceita, use os mecanismos de versão e referência disponíveis e uma saída separada. Restaurar uma definição não desfaz gravações anteriores em bancos de dados, APIs ou armazenamento. Conclua a revisão do agendamento antes de habilitar execuções recorrentes.