Correção Pré-Deploy de Branch
A Correção Pré-Deploy detecta e resolve proativamente dependências ausentes antes da implantação.
O que é Pre-Deploy Fix
Pre-Deploy Fix é um processo de validação que é executado antes de uma implantação para detectar problemas como componentes ausentes, referências quebradas ou dependências não atendidas.
Ajuda a prevenir falhas na implantação ao:
Recuperar metadados ausentes, ou
Remover ou atualizar referências a componentes problemáticos
Isso garante que sua implantação seja mais limpa e menos propensa a erros.
Como executar o Pre-Deploy Fix
Abra a ramo.
Clique os três pontos (⋮) menu no cabeçalho do branch e escolha Correção Pré-Deploy no menu suspenso.
Uma página do Pre-Deploy Fix aparece.
Selecionar conexão: escolha uma org do Salesforce (origem) contra a qual executar a correção.
Clique Execute para iniciar o processo Pre-Deploy Fix.
O sistema enfileira o trabalho e você poderá vê-lo na Jobs lista.
Verificando o Status
Após acionar, o trabalho Pre-Deploy Fix aparece na lista de Jobs com status como Enfileirado, Em Andamento, Concluído, ou Exceção.
Use filtros na lista de Jobs (por exemplo, “Status”) para isolar entradas do Pre-Deploy Fix.
Uma vez concluído, clique no job para ver resultados detalhados e logs.
Recuperando Dependências Ausentes
Se o Pre-Deploy Fix detectar dependências de metadados ausentes (por exemplo, componentes referenciados mas não presentes), as opções da interface incluem:
Recuperar Componentes Ausentes — escolha um ou mais itens ausentes e traga-os para o branch.
Remover — eliminar referências aos componentes ausentes se for seguro.
A ação de recuperação frequentemente exige inserir uma mensagem de commit e selecionar uma conexão antes de finalizar.
Como recuperar dependências ausentes usando o botão Recuperar
Na visualização do Pre-Deploy Fix Resultado navegue até a aba Dependências ausentes.
Cada componente ausente é listado com detalhes como tipo (ApexPage, ApexClass, etc.) e referência (por exemplo, Profile).
Clique Adicionar ao lado dos componentes que você deseja recuperar, ou clique Adicionar Todos para selecionar todos.
Uma vez selecionados, clique no Recuperar botão no topo.
Insira um mensagem de commit, escolha a conexão (a org de onde os componentes ausentes serão recuperados), e clique em Executar.
Os metadados selecionados serão recuperados para o seu branch e adicionados como um commit.
Como remover dependências ausentes usando o botão Remover
Na visualização do Pre-Deploy Fix Resultado visualização, abra a Dependências ausentes aba.
Clique Adicionar ao lado das dependências que você deseja remover, ou use Adicionar Todos.
Clique Remover no topo.
Insira um mensagem de commit e clique Execute.
As referências a esses componentes são removidas do seu branch, prevenindo erros de implantação.
Como visualizar resultados e logs
Após um Pre-Deploy Fix terminar, clique no job em Atividades → Trabalhos.
Você verá o resumo (status, conexão, quem criou, duração, horário de início/fim).
À direita, logs detalhados mostram o que aconteceu — hora de início, total de dependências encontradas, etapas concluídas.
Há também um Ver logs botão na tela de Erros para abrir os logs diretamente.
Melhores práticas
Sempre execute um Pre-Deploy Fix antes de Validate ou Deploy para reduzir a chance de falhas.
Prefira Recuperar quando possível, para que todas as dependências sejam incluídas corretamente. Use Remover somente quando tiver certeza de que a referência está obsoleta ou não é necessária.
Insira mensagens de commitclaras e descritivas. Estas aparecerão na aba Commits para rastreamento futuro.
Reexecute o Pre-Deploy Fix após recuperar ou remover até que a Dependências ausentes lista esteja vazia.
Use filtros (status, tipo, intervalo de datas) em Atividades para rastrear rapidamente seus trabalhos do Pre-Deploy Fix.
Revise os logs sempre que um job terminar com Exceção ou Ação Requerida para entender o que precisa ser corrigido.
Atualizado