File Links: referências simbólicas
Introdução
Às vezes o mesmo arquivo de referência (não versionado) precisa aparecer em mais de um lugar. Um laudo faz sentido tanto na pasta do paciente quanto na pasta de uma especialidade; um manual da marca serve a várias campanhas; uma especificação é referência para vários pacotes de projeto. A saída óbvia — copiar o arquivo para cada pasta — cria problemas: ocupa espaço à toa e, pior, gera versões que divergem com o tempo.
O File Link resolve isso. Ele é uma referência simbólica a um arquivo existente: aparece como um item na pasta, mas aponta para o arquivo original em vez de duplicá-lo. Um único arquivo, visível em quantos lugares você precisar — sempre o mesmo conteúdo, sem cópias para manter em sincronia.
Quando usar File Links
Use um File Link quando o mesmo arquivo deve ser encontrado por caminhos diferentes:
- Múltiplas organizações do mesmo acervo — um laudo acessível por data e por paciente
- Material compartilhado — um documento de referência usado por vários projetos ou pastas
- Curadoria — reunir numa pasta atalhos para arquivos espalhados, sem movê-los do lugar de origem
Se você precisa de uma cópia independente (que vai evoluir por conta própria), aí sim faça uma cópia de verdade — o File Link é para quando o conteúdo deve permanecer o mesmo.
Conceitos Principais
O que é um File Link
Um File Link é um item de conteúdo do tipo referência que guarda um ponteiro para um arquivo-fonte. Ele não contém bytes próprios: ao abrir ou baixar o link, você obtém o conteúdo do arquivo original.
Regras
- A fonte precisa ser um arquivo — você cria um File Link apontando para um arquivo real, não para outro File Link nem para um link web/vídeo/áudio.
- Mesmo projeto — a fonte e o link vivem no mesmo projeto.
- O arquivo-fonte não tem versionamento habilitado — o File Link é para material de referência, que se mantém estável. Um arquivo sob versionamento tem rascunho, check-out e versões publicadas; referenciá-lo em várias pastas tornaria ambíguo o que cada link entrega. Por isso a fonte de um File Link é sempre um arquivo de referência.
- Um arquivo, muitos links — o mesmo arquivo-fonte pode ser referenciado por quantos File Links você quiser, em pastas diferentes.
- Exclusão em cascata — se o arquivo-fonte for excluído, seus File Links deixam de existir (eles apontariam para o nada). Já excluir um File Link não afeta o arquivo original nem os outros links.
File Link × Cópia
| File Link | Cópia | |
|---|---|---|
| Conteúdo | O mesmo arquivo, referenciado | Um novo arquivo independente |
| Espaço | Não consome armazenamento extra | Consome (duplica os bytes) |
| Sincronia | Sempre reflete o original | Diverge assim que um dos dois muda |
| Use quando | O conteúdo deve permanecer o mesmo em todo lugar | Você quer uma versão que evolui separadamente |
Papéis e Permissões
| Ação | Proprietário / Admin | Membro | Visualizador |
|---|---|---|---|
| Ver e abrir File Links | Sim | Sim | Sim |
| Criar e excluir File Links | Sim | Sim | Não |
Criar e remover File Links é uma operação de edição de conteúdo (proprietário, administrador ou membro). Visualizadores podem abrir e seguir os links, mas não criá-los.
Boas Práticas
- Aponte para a fonte certa — escolha como "original" o local onde o arquivo é de fato mantido; os demais lugares recebem links.
- Nomeie o link pelo contexto de destino — um File Link pode ter um nome próprio, útil quando o mesmo arquivo aparece com papéis diferentes em cada pasta.
- Lembre da cascata — antes de excluir um arquivo muito referenciado, considere que todos os seus links somem junto.
- Não encadeie links — aponte sempre para o arquivo-fonte, nunca para outro File Link.
Perguntas Frequentes
P: Um File Link ocupa espaço de armazenamento?
R: Não. Ele guarda apenas um ponteiro para o arquivo-fonte; os bytes existem uma única vez, no original.
P: Se eu editar o arquivo original, os links refletem a mudança?
R: Sim. Como o File Link aponta para o arquivo-fonte, ele sempre mostra o conteúdo atual do original.
P: O que acontece se eu excluir o arquivo original?
R: Todos os File Links que apontavam para ele são removidos automaticamente (exclusão em cascata), pois passariam a apontar para o nada. Excluir apenas um link não afeta o original.
P: Posso criar um link para um link?
R: Não. A fonte de um File Link precisa ser um arquivo real — não outro File Link nem um link web/vídeo/áudio.
Versão do Documento: 1.0 Última Atualização: Julho de 2026 Autor: Equipe de Desenvolvimento Sutram