Atualização manual
Ao atualizar itens em um workspace ou desfazerum commit, há sempre uma chance de que um ou mais itens falhem. O espaço de trabalho não será atualizado se a atualização de entrada do GIT branch causar inconsistências ou outros problemas no espaço de trabalho que são difíceis de determinar com antecedência. Quando um item falha ao atualizar, o processo de atualização é interrompido. Se o item que falhou for o primeiro (ou único) item que estava sendo atualizado, a atualização falhará, mas o workspace ainda será sincronizado com o branch original. Se um item falhar após a atualização bem-sucedida de um ou mais itens, você terá uma situação em que alguns itens serão sincronizados e outros não. Nesse caso, seu workspace não é sincronizado com nenhum branch do Git.
Uma atualização pode falhar por muitos motivos. Os possíveis motivos incluem, mas não se limitam, aos seguintes problemas:
- Os itens dependentes foram alterados ou excluídos
- Dependências circulares foram criadas
- Item renomeado
- Dados de item inválidos
Observação
Isso não é o mesmo que a resolução de conflitos. Se forem feitas alterações no mesmo item no espaço de trabalho e no GIT branch, isso causará um conflito e as atualizações serão desabilitadas. Esse artigo discute o que faz um workspace falhar ao atualizar, mesmo que não haja conflitos diretos.
Uma mensagem de erro informa qual item falhou e por quê.
Esta mensagem de erro é exibida quando a atualização falha. Qualquer usuário que tentar acessar o workspace depois disso verá o erro a seguir até que a atualização seja concluída com êxito.
Selecione Exibir detalhes para ver a mensagem de erro anterior.
Status do Git após falha de um item
Seu workspace agora contém os itens a seguir:
- O item ou os itens atualizados antes da falha. Esses itens são idênticos aos itens no git, mas os metadados não são atualizados. Eles têm um status do Git de sincronizado, mas com um sinal de aviso de triângulo.
- O item que falhou. Este item tem uma status do Git de Atualização necessária.
- Possivelmente, itens que ainda não foram atualizados quando o item falhou. Esses itens ainda não foram atualizados e têm um status do Git de Atualização necessária.
A barra de status na parte inferior da tela que mostra o status de sincronização mais recente é vermelha e indicou o status parcialmente sincronizado.
Atualizar o item com falha
Para atualizar o workspace manualmente depois que ele não foi atualizado automaticamente:
- Descubra qual item está fazendo com que a atualização falhe e qual é o problema usando a caixa de diálogo de erro que diz qual item falhou e a mensagem de erro.
- Corrigir o problema no Git. Isso pode significar fazer um ou mais dos seguintes procedimentos, dependendo de qual é o problema:
- Reverter o item para uma versão anterior que não falha
- Editar o item resolve o problema
- Restaurar um item dependente que foi excluído
- Excluir item sem suporte que depende do item excluído
- Retorne ao workspace e Atualize todo o workspace novamente
Considerações e limitações
O processo de atualização falha assim que um item falha. Portanto, não há como saber se outros itens no GIT branch também são problemáticos. Se você estiver atualizando muitos itens e mais de um item for problemático, será necessário repetir esse processo uma vez para cada item com falha.