> 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-o-predeploy-fix-da-branch.md).
# Usando o PreDeploy Fix da branch
O PreDeploy Fix detecta e resolve proativamente dependências ausentes antes da implantação.
{% 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 %}
##  Visão geral
O PreDeploy Fix é um processo de validação que inspeciona sua branch em busca de possíveis problemas antes da implantação, como:
* Incompatibilidades de versão da API
* Componentes ausentes
* Referências quebradas
* Dependências não atendidas
Se forem detectados problemas, eles são listados com opções de resolução. Esse processo ajuda a evitar falhas de implantação ao:
* Verificar e atualizar as versões da API dos componentes
* Recuperar metadados ausentes
* Remover ou atualizar referências a componentes problemáticos
Ao tratar desses aspectos, sua implantação fica mais limpa e menos propensa a erros.
{% hint style="info" %}
#### Melhores práticas
* Sempre execute um PreDeploy Fix antes de **Validar** ou **Implantar** para reduzir a chance de falhas.
* Para Dependências ausentes, use **Recuperar** sempre que possível para garantir 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 **commit**claras e descritivas. Elas aparecerão na aba Commits para rastreamento futuro.
* Execute novamente o PreDeploy Fix após resolver os problemas até que as listas estejam vazias.
* Use filtros (status, tipo, intervalo de datas) em **Atividades** para acompanhar rapidamente seus jobs do PreDeploy Fix.
* Revise os logs sempre que um job terminar com **Exceção** ou **Ação necessária** para entender o que precisa ser corrigido.
{% endhint %}
## Executar PreDeploy Fix da Branch
{% stepper %}
{% step %}
### Selecione a Branch e execute o PreDeploy Fix
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 **predeploy fix**.
{% endstep %}
{% step %}
### Selecionar conexão
1. Clique em **Selecione** para a conexão da organização Salesforce na qual executar o PreDeploy Fix.
2. Clique em **Executar**.
3. Após iniciar o job do PreDeploy Fix, ele será exibido na aba **Atividades** .
{% endstep %}
{% endstepper %}
## Resultados do PreDeploy Fix
{% stepper %}
{% step %}
### Ver resultados
1. Clique no **Atividades** .
2. Verifique se o **Pesquisa de Pre Deploy Fix** status do job é **Concluído**.
3. Clique no **Pesquisa de Pre Deploy Fix** job.
{% hint style="info" %}
Para ajudar a encontrar um job do PreDeploy Fix, você pode clicar no **Todos os tipos** menu suspenso de filtro e selecionar **Pesquisa de Pre Deploy Fix**. Isso filtrará os jobs para mostrar apenas jobs do PreDeploy Fix.
{% endhint %}
{% endstep %}
{% step %}
### Erros de versão da API
Se o PreDeploy Fix detectar erros de versão da API, eles aparecerão na **Erros de versão da API** tabela. Esta tabela mostra cada componente com um erro de versão da API. À direita de cada componente há duas versões da API: a **versão da API do componente** e a **versão da API da organização**. A versão da API do componente é a que o componente usa na branch, e a versão da API da organização é a que ele usa na organização Salesforce usada como conexão para este PreDeploy Fix.
{% hint style="info" %}
Veja a [#fixing-api-version-errors](#fixing-api-version-errors "mention") seção abaixo para aprender como resolver esses erros.
{% endhint %}
1. Clique no **erros de versão da API** .
{% endstep %}
{% step %}
### Dependências ausentes
Se o PreDeploy Fix identificar quaisquer dependências ausentes, elas serão mostradas na **Componentes ausentes** tabela. Esta tabela exibe cada dependência de metadados ausente juntamente com o componente que a referencia. Para corrigir componentes ausentes, você pode escolher entre duas opções e aplicá-las a cada componente conforme necessário.
* **Recuperar**: Esta opção recupera o componente ausente e o envia como commit para a branch.
* **Remover**: Esta opção remove a referência ao componente ausente e só deve ser usada se for confirmado que implantar sem o componente na branch é seguro.
{% hint style="info" %}
Veja a [#fixing-missing-dependencies](#fixing-missing-dependencies "mention") seção abaixo para aprender como resolver esses erros.
{% endhint %}
1. Clique no **dependências ausentes** .
{% hint style="info" %}
Se a **dependências ausentes** aba não estiver visível, isso significa que não há dependências ausentes.
{% endhint %}
{% endstep %}
{% step %}
### Ver logs do job
Você pode visualizar os logs do job do PreDeploy Fix para verificar quaisquer problemas de processamento do job e confirmar com qual organização Salesforce o job foi executado.
1. Clique em **Ver logs**.
2. Veja o status e o log do job.
{% endstep %}
{% step %}
### Executar novamente o PreDeploy Fix
Depois de corrigir todos os erros de versão da API e resolver as dependências ausentes, execute novamente o job do PreDeploy Fix para garantir que nenhum problema permaneça. As capturas de tela a seguir mostram um job do PreDeploy Fix que foi concluído sem encontrar nenhum problema.
{% hint style="info" %}
Ambas as **erros de versão da API** e a **dependências ausentes** tabelas exibem **Nenhum componente**.
{% endhint %}
{% endstep %}
{% endstepper %}
## Corrigindo erros de versão da API
Se a **PreDeploy Fix** encontrou erros de versão da API, você pode corrigi-los atualizando para a versão correta.
{% stepper %}
{% step %}
### Atualizar versões
1. Clique em **Atualizar versões**.
2. Clique em **Adicionar** para cada componente para atualizar a versão da API.
3. Clique em **Atualizar**.
4. Insira uma **mensagem de commit** para as alterações na branch.
5. Clique em **Resolver**.
6. Após iniciar o job de atualização da API, ele será exibido na aba **Atividades** como um **Atualização do Pre Deploy Fix** job.
{% endstep %}
{% step %}
### Ver resultados
1. Clique no **Atualização do Pre Deploy Fix** job.
2. Veja o status e o log do job.
{% endstep %}
{% endstepper %}
## Corrigindo dependências ausentes
{% stepper %}
{% step %}
### Recuperar componentes ausentes
Os metadados selecionados serão recuperados para sua branch e adicionados como um commit.
{% hint style="info" %}
Se você já removeu componentes dependentes, não os selecione para recuperar. Se não tiver certeza, você pode executar novamente o job do PreDeploy Fix.
{% endhint %}
1. Clique em **Recuperar**.
2. Clique em **Adicionar** para cada componente de dependência a ser recuperado.
3. Clique em **Recuperar**.
4. Insira uma **mensagem de commit** para as alterações na branch.
5. Clique no **Conexão** menu suspenso.
6. Selecione a organização Salesforce da qual recuperar os componentes dependentes.
7. Clique em **Executar**.
8. Após iniciar o job de Recuperar dependências ausentes, ele será exibido na aba **Atividades** como um **Atualização do Pre Deploy Fix** job.
{% endstep %}
{% step %}
### Remover componentes ausentes
As referências a esses componentes são removidas da sua branch, evitando erros de implantação.
{% hint style="info" %}
Se você já recuperou componentes dependentes, não os selecione para remover. Se não tiver certeza, você pode executar novamente o job do PreDeploy Fix.
{% endhint %}
1. Clique em **Remover**.
2. Clique em **Adicionar** para cada componente de dependência a ser recuperado.
3. Clique em **Remover**.
4. Insira uma **mensagem de commit** para as alterações na branch.
5. Clique em **Executar**.
6. Após iniciar o job de Remover dependências ausentes, ele será exibido na aba **Atividades** como um **Remoção do Pre Deploy Fix** job.
{% endstep %}
{% step %}
### Ver resultados
1. Clique no **Recuperação do Pre Deploy Fix** job para recuperar componentes ou **Remoção do Pre Deploy Fix** job para remover componentes.
2. Veja o status e o log do job.
{% 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-o-predeploy-fix-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.
