> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/devops/devops-pt-br/codigo/acoes-da-branch/usando-a-protecao-contra-sobrescrita-da-branch.md). # Usando a proteção contra sobrescrita da branch A Proteção contra sobrescrita é um processo de segurança executado em uma org Salesforce para evitar sobrescritas acidentais de metadados. {% hint style="warning" %} #### Escrito para a interface antiga Este artigo foi escrito para a interface antiga. As instruções ainda podem ser usadas, mas as capturas de tela estão desatualizadas. Em alguns casos, os itens referenciados nas instruções foram movidos ou alterados. Se você não conseguir encontrar um item, consulte o [Para onde foi](/devops/devops-pt-br/transicao-para-a-nova-ui-ux/para-onde-foi.md) artigo. {% endhint %} ## ![](https://2465342021-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRpUu5iMlzMFAudyBvMOl%2Fuploads%2FG5ZbxX918xOHwbAwAJ4n%2FSummary2-Small-Icon.svg?alt=media\&token=da26a67f-ff7f-47b3-8669-06be960dc2d7) Visão geral A Proteção contra sobrescrita ajuda a evitar sobrescritas acidentais ao comparar os componentes da branch com os da sua org ativa. Ela destaca os componentes que são novos, diferentes ou iguais, garantindo que os metadados críticos permaneçam intactos durante a implantação. Este guia explica como executar um job de Proteção contra sobrescrita, revisar os resultados e lidar com quaisquer diferenças. {% hint style="info" %} #### **Melhores práticas** * Sempre executar **Proteção contra sobrescrita** antes de implantar em produção ou em ambientes críticos. * Concentre-se em **Diferentes** componentes — revise cuidadosamente antes de decidir qual versão manter. * Use **mensagens de commit** mensagens de commit significativas ao finalizar as resoluções, para que sua equipe possa acompanhar o motivo das alterações. * Resolva os conflitos na interface da Proteção contra sobrescrita em vez de ignorá-los — isso mantém sua branch e sua org sincronizadas. * Se o job falhar ou terminar com um **Exceção**, verifique os logs imediatamente e execute novamente assim que corrigido. * Combine **Proteção contra sobrescrita** com **Correção pré-implantação** para detectar tanto sobrescritas quanto dependências ausentes antes da implantação. {% endhint %} ## Executar job de Proteção contra sobrescrita {% stepper %} {% step %} ### Selecione uma Branch e Inicie a Proteção contra sobrescrita 1. Clique em **Código** no menu da barra lateral esquerda. 2. Selecione uma branch na lista.
3. Clique no **Três pontos verticais ⋮** menu suspenso ao lado de Implantar. 4. Clique em **Proteção contra sobrescrita**.
{% endstep %} {% step %} ### Selecione uma Conexão e Componentes {% hint style="info" %} Use as **Pesquisar**, **Filtrar**, e **Ordenação** opções para ajudar você a encontrar a conexão e os componentes corretos. {% endhint %} 1. Clique em **Selecione** para a Conexão da org do Salesforce para verificar se há sobrescritas. 2. Clique em **Próximo**.
3. Clique em **Adicionar** para cada componente para verificar se há sobrescritas. 4. (Opcional) Clique em **Adicionar tudo** para incluir todos os componentes. **Observação:** As opções de pesquisa, filtro e ordenação não limitam quais componentes são adicionados com o **Adicionar tudo** botão. 5. Clique em **Executar**.
6. Depois de iniciar o job de Proteção contra sobrescrita, ele será exibido na **Atividades** .
{% endstep %} {% endstepper %} ## Resultados da Proteção contra sobrescrita {% stepper %} {% step %} ### Ver resultados 1. Clique no **Atividades** . 2. Verifique se o job **Proteção contra sobrescrita** está **Concluído**. 3. Clique no **Proteção contra sobrescrita** .
4. O **Resultados da Proteção contra sobrescrita** página lista o status de cada componente. Veja a tabela abaixo para uma explicação de cada um.
{% hint style="info" %} A lista de componentes pode ser pesquisada e filtrada. Por exemplo, você poderia definir o **Status** para exibir apenas componentes marcados como **Diferentes**. {% endhint %}
StatusDescrição
NovoO componente existe na branch, mas não na org. Normalmente, eles podem ser confirmados com segurança, já que ainda não existem na org. Nenhuma ação é necessária.
DiferentesO componente existe tanto na branch quanto na org, mas seus conteúdos são diferentes. Devido a essa diferença, você precisa confirmar se as alterações estão corretas e resolver quaisquer conflitos.
IgualO componente existe tanto na branch quanto na org, e os conteúdos são idênticos. Nenhuma ação é necessária.
{% endstep %} {% step %} ### Revisar diferenças Revise cada componente marcado como **Diferentes** para identificar as diferenças e determinar como resolvê-las. 1. Clique em **Resolver**.
2. As diferenças do componente serão exibidas em editores lado a lado com os **diferenças** destacadas. 1. **Entrada**: Editor somente leitura com a versão do componente da org selecionada. 2. **Atual**: Editor editável com a versão atual do componente da branch. 3. Revise cada diferença.
{% endstep %} {% step %} ### Aceitar diferenças Depois de revisar as diferenças, você pode aceitar quaisquer diferenças da **Entrada** org substituindo os **Atual** valores da branch pelos valores da org. Há duas maneiras de aceitar diferenças; consulte as seções a seguir para ver exemplos. **Aceitar tudo** Aceitar todas as diferenças da **Entrada** org significa que todas as alterações na **Atual** branch serão substituídas pelos valores da org. Veja o exemplo a seguir: 1. Clique em **Aceitar tudo**.
2. Todas as diferenças em **Atual** são substituídas pelos **Entrada** valores.
**Linha por linha** Aceitar diferenças específicas da **Entrada** org significa que apenas as alterações selecionadas na **Atual** branch serão substituídas pelos valores da org. Veja o exemplo a seguir: 1. Clique no **Seta para a direita** para a linha em que você quer substituir a diferença em **Atual** com o **Entrada** valor.
2. O **Atual** valor é substituído pelo **Entrada** valor.
{% hint style="info" %} #### Desfazer alterações * **Redefinir todas as alterações**: permite desfazer todas as alterações feitas no **Atual** editor. * **Ctrl** + **Z**: permite desfazer a última alteração feita no **Atual** editor (o editor deve estar selecionado). {% endhint %} {% endstep %} {% step %} ### Marcar como resolvido Depois de editar a **Atual** branch para resolver quaisquer conflitos causados pelas diferenças, você pode marcar o componente como resolvido. 1. Clique em **Resolver**.
2. O componente agora está marcado como **Resolvido**. 3. Clique em **Voltar**.
4. O componente resolvido terá uma **marca de verificação verde** para indicar que ele está resolvido.
{% endstep %} {% step %} ### (Opcional) Ver log Você pode visualizar os logs do **Proteção contra sobrescrita** job para ver quaisquer mensagens de erro e obter estatísticas do job. 1. Da **Resultados da Proteção contra sobrescrita** página. 2. Clique em **Ver logs**.
3. Veja as estatísticas do job e o log de execução.
{% hint style="info" %} O **Conexão** campo indica qual org foi verificada com este **Proteção contra sobrescrita** . {% endhint %} {% endstep %} {% step %} ### Fazer commit das alterações Se algum componente tiver sido alterado ao resolver diferenças, você precisa fazer commit dessas alterações na branch. 1. Clique em **Fazer commit das alterações**.
2. Insira uma **mensagem de commit** para explicar o que mudou. 3. Clique em **Resolver** para fazer commit das alterações na branch.
{% endstep %} {% endstepper %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.flosum.com/devops/devops-pt-br/codigo/acoes-da-branch/usando-a-protecao-contra-sobrescrita-da-branch.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.