Caso de uso: instalação sobre um acervo legado
Passo a passo de colocar um acervo já existente (legado) sob o GCVD: migrar a temporalidade que vive em campos próprios do cliente, consolidar dossiês, dar fé ao acervo (preservação) e deixar a captura nova alimentando os dados certos.
Depende do módulo GCVD licenciado e do interruptor Guarda documental (master) ligado.
Leitura recomendada antes: Conceito e Guia do implantador. A operação do dia a dia está no Caso operação.
O legado tem apenas o que a captura da época gravou. Hash e assinatura do acervo existente são gerados pela preservação, sem refazer a assinatura do que já está assinado (ver Preservação de longo prazo).
Cenário
O cliente digitalizou cerca de 200 mil documentos anos atrás. Eles já estão no Alfresco, em um tipo do cliente (neste exemplo, D10278:PJDPI), com o prazo em campos próprios: D10278:Prazo_de_Guarda, D10278:Data_Expiracao e D10278:Destinacao_Prevista (valores como GUARDA PERMANENTE, TRANSFERENCIA e ELIMINACAO). Não têm as informações da guarda. Objetivos:
- Migrar a temporalidade para o formato da guarda, sem apagar os campos do cliente.
- Consolidar dossiês, se o acervo formar conjuntos.
- Preservar (dar fé e integridade), por último.
- Tratar o que ficou incompleto (sem prazo, sem base, destinação não mapeada).
- Configurar a captura nova para já nascer certa.
Ordem recomendada: levantamento, papéis, migração, dossiê, preservação (por último), ajuste do que sobrou sem temporalidade ou corte, captura nova.
A preservação vem por último porque assina e gera o hash do documento. Se rodasse antes da migração e do dossiê, esses passos gravariam metadados depois e o documento seria reversionado e reassinado. Deixando a preservação por último, a assinatura ocorre uma vez, sobre o estado final dos metadados.
Passo 0: levantamento
Antes de tocar no sistema, mapeie em uma planilha:
- Os tipos legados e o identificador de cada um (por exemplo,
D10278:PJDPI). O modelo do cliente precisa estar publicado no sistema; caso contrário, o perfil simplesmente não encontra os documentos. - Onde estão o prazo, a base e a destinação em cada tipo.
- Os valores de destinação do legado, para o de-para (
GUARDA PERMANENTEpara PERMANENT etc.). - As datas-sentinela, que significam "vazio" (por exemplo,
2000-01-01). - Se o acervo forma dossiês (por exemplo, prontuário por CPF) e qual propriedade identifica cada um.
Passo 1: funções e capacidades
No Console, tela Funções (capacidade RolesAdmin), crie as funções e atribua às pessoas:
- Gestor de retenção (
RetentionAdmin): executa a migração, o corte por evento e os perfis de dossiê. - Administrador da guarda (
PreservationAdmin): executa a preservação (lote e diária) e a estimativa. - Visão do acervo (
DossierView): acompanha o inventário e os relatórios. - As funções de descarte, bloqueio e reclassificação entram na operação (ver Caso operação).
As capacidades já vêm prontas; aqui se define apenas quem ocupa cada função.
Passo 2: migração de metadados
Os documentos legados têm prazo e classificação em campos do cliente; a guarda trabalha com informações padronizadas. A migração é aditiva (não apaga os campos do cliente) e usa perfis de-para, um por subtipo, em Console, Migração de metadados. O perfil migra a temporalidade e, opcionalmente, a classificação (digitalização, incluindo o tipo documental) e a conferência; o modal do perfil tem uma aba por item. A aba Digitalização permite unificar o legado com a captura nova no mesmo dossiê (passo 3).
2.1 Criar o perfil de-para (exemplo)
Na tela Perfis (de-para) (capacidade RetentionAdmin), com listas do dicionário (escolhe-se o tipo e as propriedades da lista, não em campo livre):
| Campo do perfil | Valor (exemplo) |
|---|---|
| Seletor | Tipo D10278:PJDPI |
| Prazo / unidade | D10278:Prazo_de_Guarda / meses |
| Expiração já calculada | D10278:Data_Expiracao (o documento segue o caminho Copiar) |
| Destinação | D10278:Destinacao_Prevista |
| De-para de valores | GUARDA PERMANENTE para PERMANENT, TRANSFERENCIA para TRANSFER, ELIMINACAO para DESTROY |
| Fallback de base | Nenhum (sem base, o documento aguarda evento) |
| Sentinelas | Por exemplo, 2000-01-01 (tratada como vazio) |
2.2 O que a migração decide por documento
| Resultado | Situação |
|---|---|
| Já migrado | O documento já tem temporalidade; não é tocado (idempotente) |
| Copiar | O legado já tem a expiração calculada; ela é copiada, respeitando o prazo original |
| Calcular | Tem base e prazo; a expiração é base mais prazo |
| Evento | Tem prazo, mas sem base; nasce sem vencimento, aguardando o corte por evento (passo 5) |
| Revisar | Sem prazo ou destinação não mapeada; fica sem temporalidade (passo 5) |
2.3 Simular e aplicar
Na tela Aplicar migração, escolha o escopo (site inteiro ou pasta), execute a simulação (dry-run), obrigatória antes de aplicar, que informa a quantidade por resultado em toda a varredura e uma amostra com limite. Confira os números e aplique. A aplicação grava o que o perfil configura, de forma aditiva e idempotente por propriedade (não sobrescreve o que o documento já tem), com histórico e exportação (CSV, HTML e PDF) da execução. Ela roda em exclusão mútua com a preservação.
2.4 Sigilo (opcional)
Se parte do acervo exige acesso restrito (prontuários, processos com dados sensíveis), o sigilo cuida disso. É opt-in e trata de quem vê, separado da temporalidade. Dois eixos, combináveis:
- Nível hierárquico: o nível N (ou acima) vê; a escada é configurável.
- Marcas need-to-know: não hierárquicas; é preciso ter todas as marcas do documento.
Quem não pode ver não recebe o documento: ele some da busca e das listagens. Definir, reclassificar e desclassificar são ações auditadas. A desclassificação automática ao vencer o prazo roda diariamente; a manual está sempre disponível. O sigilo é independente da temporalidade: um documento pode estar em guarda e sigiloso ao mesmo tempo. Ver Sigilo.
Passo 3: dossiês do legado (se houver)
Se o acervo forma dossiês (por exemplo, prontuário por número ou CPF), crie um perfil de dossiê em Console, grupo Dossiê, Retenção (perfis) (capacidade RetentionAdmin). O perfil é uma lista de mapeamentos, no editor em abas Mapeamentos e Retenção, com tudo selecionável do dicionário. Cada mapeamento aponta:
- Documentos: um tipo ou aspecto do modelo.
- Identificador: a propriedade cujo valor identifica o dossiê (por exemplo, o campo de CPF do tipo do cliente). Documentos com o mesmo valor formam um dossiê.
- Filtro (opcional):
propriedade = valor; vazio inclui todos.
Como documentos de mapeamentos diferentes com o mesmo valor de identificador caem no mesmo dossiê, o perfil unifica tipos: um mapeamento aponta o tipo do cliente (D10278:PJDPI) com o identificador no campo legado, e outro aponta o tipo da captura nova com o identificador equivalente. Se os valores coincidirem, é um só dossiê, sem precisar migrar o tipo documental para o legado. Se dois perfis casarem o mesmo documento, vale o de maior prioridade.
Em seguida, abra Reconciliação de dossiês (tela própria, RetentionAdmin) e execute a simulação (a opção Detalhado lista cada documento, com exportação em CSV). Confira a quantidade de dossiês e documentos e clique em Reconciliar agora para consolidar o acervo antigo sob a retenção rolante antes da preservação. Acompanhe no Inventário de dossiês; um dossiê montado por engano pode ser dissolvido por lá, preservando a retenção.
Passo 4: preservação do legado (por último)
Com os metadados no lugar, execute a preservação uma vez sobre o estado final. No Console, Preservação (capacidade PreservationAdmin):
- Estimativa de custo primeiro: quantos carimbos do tempo serão gerados. Como o carimbo cai no resumo diário AD-RA (e não em cada documento), o custo é baixo, mas estime antes.
- Preservação em lote: gera o resumo de propriedades assinado por pasta (com o hash de todos os documentos) e o resumo diário AD-RA.
- Política recomendada: documento em AD-RB (sem carimbo) e resumo diário em AD-RA (carimba o lote).
- Ligue a preservação diária (agendada) para o dia a dia.
O resultado é um acervo com fé: qualquer alteração ou ausência é detectável, com assinatura feita uma vez sobre os metadados já migrados. A re-checagem periódica do hash contra o arquivo, com alerta automático de divergência, não é automática e permanece como verificação periódica do administrador.
Passo 5: validade a confirmar
Da migração sobram dois grupos:
- Evento (aguardando evento): prazo definido, mas a data-base depende de um evento (por exemplo, fim de contrato). Nascem sem vencimento e nunca entram no corte até que o corte por evento (capacidade
RetentionAdmin) preencha a base, por documento, pasta ou dossiê, quando o evento ocorre. Isso precisa estar previsto no levantamento (passo 0). - Revisar (sem temporalidade): sem prazo, ou com destinação que o de-para não cobriu. Aparecem no Inventário de dossiês (filtro sem temporalidade) e na exportação da execução da migração. Ajuste o perfil (cubra o valor que faltou) e execute a migração de novo (idempotente, não mexe no que já migrou), ou classifique manualmente.
Nenhum documento deve ficar solto: todo documento do acervo deve terminar com temporalidade definida, PERMANENT, ou aguardando um evento conhecido. A página Validade a confirmar (menu Guarda documental) lista esses documentos e resolve em lote, por corte por evento ou definindo a temporalidade.
O corte por evento e o rolar do dossiê acontecem ao longo do tempo e alteram metadados depois da preservação inicial; a preservação diária reassina o que mudou. É inerente à retenção por evento e rolante.
Onde acompanhar: Inventário de dossiês (filtros e exportação), histórico da execução da migração (CSV, HTML e PDF, com prazo, base, vencimento e destino por documento) e a auditoria (evento "Temporalidade migrada do legado").
Passo 6: captura nova
Para os documentos que passam a entrar pela captura, configure no ScanDesigner os campos que alimentam a guarda:
| Chave (metadado) | Formato e valores | Papel |
|---|---|---|
htf:documentType | Texto (valor do tipo, por exemplo Prontuário) | Classifica o documento; pode servir de filtro de um mapeamento de dossiê |
htf:subject | Texto | Assunto; pode ser o identificador do dossiê em um mapeamento |
htf:retentionPeriodMonths | Inteiro (meses) | Prazo |
htf:retentionBaseDate | Data; vazia significa evento (aguarda o corte) | Data-base |
htf:disposition | DESTROY, TRANSFER ou PERMANENT (maiúsculas) | Destinação |
htf:digitizationDate, htf:digitizedBy, htf:digitizationPlace | Data, texto, texto | Metadados do Anexo II |
Envie as propriedades de retenção na captura, e o sistema aplica a temporalidade sozinho. O vencimento é calculado pelo sistema (base mais prazo); não o envie. No fluxo novo, a preservação diária assina depois que a captura já gravou os metadados, uma vez por documento. 300 dpi e PDF/A são opções por fluxo de captura, não um mínimo imposto.
Checklist do legado
- Levantamento: tipos, campos de prazo, base e destinação, valores, sentinelas e chave do dossiê (passo 0).
- Funções criadas (
RetentionAdmin,PreservationAdmin,DossierView) (passo 1). - Perfis de-para criados, simulação conferida e migração aplicada (passo 2).
- Perfis de dossiê e reconciliação inicial, se o acervo forma dossiês (passo 3).
- Estimativa de custo, preservação em lote (por último) e preservação diária ligada (passo 4).
- Itens a revisar ajustados e eventos previstos para o corte (passo 5).
- Captura nova configurada com as chaves e padrões (passo 6).