Detail Library
Visão Geral
O Detail Library (também chamado Detail Sync) mantém vistas de detalhe e legendas padronizadas entre projetos. A partir de um projeto mestre você Publica detalhes, carimbando cada um com uma identidade estável e uma versão publicada. No lado do projeto a ferramenta classifica cada detalhe gerenciado contra as mestres abertas em cinco estados, e então Sincronizar atualiza os desatualizados in-place — a vista mantém o Element Id, então o viewport, o número do detalhe e cada referência "5/A-501" permanecem — e Promover envia um detalhe corrigido do projeto de volta para a mestre. Os detalhes são rastreados por GUID mais um hash de conteúdo SHA-256, não pelo nome, então renomear nunca quebra o vínculo.
Publicar
O lado autoral. A partir do projeto mestre aberto você carimba vistas de detalhe e legendas com um GUID por biblioteca, um GUID por detalhe, um hash de conteúdo e uma versão. O Auto só incrementa a versão quando o hash de conteúdo realmente mudou, então projetos com um detalhe idêntico nunca viram Desatualizado; o Manual leva um detalhe a um número de versão que você digita.
Verificar Detalhes e os cinco estados
Classificação read-first contra as mestres abertas, avaliada em ordem: Local (nunca gerenciado), Órfão (carimbado, mas seu GUID sumiu de todas as mestres), Modificado localmente (drift — o conteúdo vivo não bate mais com o carimbo, verificado antes da versão, então é pego como violação de padrão), Desatualizado (atrás da mestre — o alvo do swap) e Atualizado. Só o Desatualizado é escrito automaticamente; os demais são reportados.
Sincronizar
Write-first, in-place. Os detalhes Desatualizados marcados são trocados limpando o conteúdo da vista do projeto e copiando o da mestre para a mesma vista, com re-carimbo na nova versão. Um swap que não traria nada dá rollback, então uma vista nunca é esvaziada, e um detalhe ruim nunca aborta o lote — a execução inteira é um único passo de desfazer.
Promover
O inverso do Sincronizar. Quando o projeto tem a versão corrigida, o Promover copia o conteúdo dele para a mestre in-place, incrementa a versão da mestre e re-carimba o projeto como Atualizado. A correção feita em um projeto vira o novo padrão da biblioteca que todos os outros projetos passam a puxar no próximo Sincronizar.
Como usar
- Abra o painel do Library e use os botões da barra lateral — Publicar, Verificar Detalhes, Sincronizar Detalhes — com o documento mestre relevante aberto.
- Publicar (a partir da mestre): escolha as vistas de detalhe ou legendas e, por linha, defina Auto (incrementa a versão só quando o conteúdo mudou) ou Manual (define um número de versão).
- Verificar Detalhes (em um projeto): classifique os detalhes locais contra cada mestre aberta para ver quais estão Atualizados, Desatualizados, Modificados localmente, Órfãos ou Locais — e exporte o relatório.
- Sincronizar: atualize os detalhes Desatualizados marcados para a versão mais recente da mestre, in-place.
- Promover: envie um detalhe corrigido e modificado localmente de volta para a mestre, incremente a versão e re-carimbe o projeto para que ele volte a ler Atualizado.
Dicas & Notas
- As mestres são descobertas a partir dos documentos mestre que você tem abertos — e, onde configurado, dos caminhos de biblioteca do Library.
- Como a identidade é por GUID e por hash, a equipe pode renomear detalhes livremente sem quebrar a sincronização.
- Cada face tem duas abas — vistas de detalhe e legendas — então as legendas passam pelo mesmo pipeline de publicar/verificar/sincronizar.
Limitações
- Funciona com vistas de detalhe e legendas — vistas de modelo estão fora do escopo.
- Para classificar um projeto, a mestre relevante precisa estar aberta (ou configurada como um caminho de biblioteca).