Proteção contra Sobrescrita de Branch

A Proteção contra Sobrescrita é um processo de salvaguarda que é executado contra uma org Salesforce para evitar sobrescritas acidentais de metadados.

A Proteção contra Sobrescrita compara os componentes do seu branch com os componentes da org ao vivo e destaca o que é novo, diferente ou igual.

Isso garante que você não sobrescreva involuntariamente metadados críticos na sua org durante uma implantação.

Como Executar a Proteção contra Sobrescrita

1. Abra o branch onde você deseja executar a verificação.

2. Clique os três pontos (⋮) menu no cabeçalho do branch e escolha Proteção contra sobrescrita no menu suspenso.

3. A página de Proteção contra Sobrescrita é aberta.

Passo 1: Selecionar conexão

• Escolha uma org do Salesforce (conexão) onde você deseja verificar por sobrescritas.

• Você pode pesquisar por nome, filtrar por Tipo de org, Criado por, ou classificar por Última atividade.

• Uma vez selecionada, clique Avançar.

Passo 2: Selecionar componentes

• Uma lista de componentes do branch aparece.

• Use filtros para restringir: tipo de componente, atividade mais recente, SF atualizado por, ou SF data de atualização.

• Clique Adicionar para componentes específicos, ou use Adicionar tudo no topo para incluir tudo.

• Quando estiver pronto, clique em Executar.

Você verá uma mensagem de confirmação: “Proteção contra sobrescrita executada com sucesso.”

Verificando o Status

• Vá para a Atividades guia no seu branch.

• Jobs de Proteção contra Sobrescrita aparecem em Jobs com status como:

  • Enfileirado

  • Em Progresso

  • Concluído

  • Exceção

• Você pode filtrar jobs por tipo, status ou intervalo de datas.

• Clique na entrada do job para ver logs detalhados.

Como Visualizar Resultados

Uma vez que a verificação seja concluída, você será direcionado para a resultado da Proteção contra Sobrescrita página. Aqui você verá:

• Novo componentes → existem no branch, mas não na org.

• Diferente componentes → existem em ambos, mas o conteúdo difere.

• Igual componentes → nenhuma alteração detectada.

Cada componente é marcado com seu status (Novo, Diferente, Igual).

Resolvendo Diferenças

• Para itens marcados como Diferente, clique em Resolver.

• Uma visualização de diff lado a lado é aberta:

  • Entrada → versão do branch.

  • Atual → versão da org.

• Você pode:

  • Aceitar tudo → aceitar todas as alterações de entrada.

  • Reverter todas as alterações → manter a versão atual da org.

  • Ou revise linha a linha e escolha o que manter.

• Uma vez resolvido, clique em Confirmar alterações.

• O status é atualizado, e o componente resolvido entra no histórico do branch.

Lidando com Componentes Novos e Iguais

• Componentes novos: estes geralmente podem ser confirmados com segurança, pois ainda não existem na org. Simplesmente inclua-os no seu commit.

• Componentes iguais: nenhuma ação é necessária — eles já estão idênticos entre o branch e a org.

Como Visualizar Logs

1. Abra o branch → Atividades → Jobs

2. Clique no Overwrite Protection job que mostra Concluído

3. Você será direcionado para a página de resultado da Proteção contra Sobrescrita

4. Clique Ver logs (canto superior direito) para abrir os logs de execução

Melhores práticas

• Sempre execute a Proteção contra Sobrescrita antes de implantar em produção ou ambientes críticos.

• Concentre-se em Diferente componentes — revise cuidadosamente antes de decidir qual versão manter.

• Use mensagens de commit significativas ao finalizar as resoluções, para que sua equipe possa rastrear o motivo das alterações.

• Resolva conflitos na interface da Proteção contra Sobrescrita em vez de pular — isso mantém seu branch e a org sincronizados.

• Se o job falhar ou terminar com um Exceção, verifique os logs imediatamente e execute novamente depois de corrigir.

• Combine Overwrite Protection com Correção Pré-Implantação para detectar tanto sobrescritas quanto dependências ausentes antes da implantação.