Trabalhando com File Links

Este guia mostra como criar, reconhecer, listar e remover File Links — as referências simbólicas que fazem um mesmo arquivo aparecer em vários lugares sem duplicá-lo. Se ainda não leu o conceito, comece por File Links: referências simbólicas.

Quem pode: criar e remover File Links é uma ação de proprietário, administrador ou membro. Visualizadores podem abri-los, mas não criá-los.

Passo 1: Crie um File Link (interface)

Na aba Conteúdo, o fluxo é "marcar a fonte, depois criar o link no destino":

Localize o arquivo-fonte (o original) e marque-o para link no menu do item
Navegue até a pasta de destino — onde o atalho deve aparecer
Escolha Criar file link aqui
(Opcional) dê um nome próprio ao link — útil quando o mesmo arquivo cumpre papéis diferentes em cada pasta
Confirme

Pronto: o File Link aparece na pasta de destino apontando para o arquivo original. Repita para colocar o mesmo arquivo em quantas pastas precisar.

Passo 2: Reconheça e use os File Links

Na lista de conteúdo, um File Link:

exibe um ícone que indica a origem (o tipo do arquivo-fonte) e o caminho do arquivo original, para você saber de onde ele vem
ao ser aberto ou baixado, entrega o conteúdo do arquivo-fonte — sempre a versão atual do original

Assim você distingue à primeira vista o que é arquivo e o que é referência.

Passo 3: Criação em lote e listagem (via IA / MCP)

Para trabalhos maiores, um assistente de IA conectado via Sutram MCP Server cobre operações que a interface faz item a item:

Criar em lote — referenciar de uma vez todos os arquivos de uma pasta de origem em uma pasta de destino
Listar por origem — ver todos os File Links que apontam para um mesmo arquivo (onde aquele arquivo está sendo usado)
Listar por pasta — ver os File Links de uma pasta com os dados do arquivo-fonte de cada um

Exemplos do que pedir:

"Crie file links de todos os laudos desta pasta na pasta do paciente X."
"Onde este arquivo está referenciado? Liste os file links que apontam para ele."

A referência dessas ferramentas está no Guia do Sutram MCP Server.

Passo 4: Remova File Links

Excluir um File Link remove apenas o atalho — o arquivo original e os demais links continuam intactos.
Excluir o arquivo-fonte remove, em cascata, todos os File Links que apontavam para ele. Antes de apagar um arquivo muito referenciado, lembre-se de que os atalhos somem junto.

Dicas

Escolha bem o "original" — mantenha o arquivo onde ele é de fato gerido; os outros lugares recebem links.
Nomeie pelo destino — o nome próprio do link ajuda a leitura quando o mesmo arquivo aparece com contextos diferentes.
Aponte sempre para o arquivo — nunca crie um link para outro link.
Reveja antes de excluir a fonte — se muitos links dependem dela, avalie o impacto da cascata.

Perguntas Frequentes

P: Como sei se um item é um arquivo ou um File Link?

R: O File Link aparece na lista com um indicador de origem e o caminho do arquivo-fonte. Arquivos comuns não mostram essa referência.

P: Preciso de IA para usar File Links?

R: Não. Você cria e remove File Links pela interface. O assistente de IA (via MCP) é útil para operações em lote e para listar onde um arquivo está referenciado.

P: Renomear ou mover o arquivo original quebra os links?

R: Não. Internamente o File Link guarda uma referência ao próprio arquivo-fonte, não ao caminho nem ao nome dele. Renomear o original, renomear o link ou mover qualquer um dos dois de pasta não afeta a ligação. O link só deixa de existir se o próprio arquivo-fonte for excluído — aí a exclusão vai em cascata.

Próximos Passos

File Links: referências simbólicas — o conceito por trás do que você acabou de fazer
Records e Metadados — para estruturar o acervo que você vai referenciar
Guia do Sutram MCP Server — a referência das ferramentas de File Links para uso com IA

Versão do Documento: 1.0 Última Atualização: Julho de 2026 Autor: Equipe de Desenvolvimento Sutram