Em Desenvolvimento
Esta documentação ainda está em desenvolvimento. Agradecemos sua paciência!
Pular para o conteúdo principal
Versão: 03.008.000 🚧 (em desenvolvimento)

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.

Licença

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:

  1. Migrar a temporalidade para o formato da guarda, sem apagar os campos do cliente.
  2. Consolidar dossiês, se o acervo formar conjuntos.
  3. Preservar (dar fé e integridade), por último.
  4. Tratar o que ficou incompleto (sem prazo, sem base, destinação não mapeada).
  5. 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 PERMANENTE para 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 perfilValor (exemplo)
SeletorTipo D10278:PJDPI
Prazo / unidadeD10278:Prazo_de_Guarda / meses
Expiração já calculadaD10278:Data_Expiracao (o documento segue o caminho Copiar)
DestinaçãoD10278:Destinacao_Prevista
De-para de valoresGUARDA PERMANENTE para PERMANENT, TRANSFERENCIA para TRANSFER, ELIMINACAO para DESTROY
Fallback de baseNenhum (sem base, o documento aguarda evento)
SentinelasPor exemplo, 2000-01-01 (tratada como vazio)

2.2 O que a migração decide por documento​

ResultadoSituação
Já migradoO documento já tem temporalidade; não é tocado (idempotente)
CopiarO legado já tem a expiração calculada; ela é copiada, respeitando o prazo original
CalcularTem base e prazo; a expiração é base mais prazo
EventoTem prazo, mas sem base; nasce sem vencimento, aguardando o corte por evento (passo 5)
RevisarSem 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):

  1. 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.
  2. 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.
  3. Política recomendada: documento em AD-RB (sem carimbo) e resumo diário em AD-RA (carimba o lote).
  4. 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 valoresPapel
htf:documentTypeTexto (valor do tipo, por exemplo Prontuário)Classifica o documento; pode servir de filtro de um mapeamento de dossiê
htf:subjectTextoAssunto; pode ser o identificador do dossiê em um mapeamento
htf:retentionPeriodMonthsInteiro (meses)Prazo
htf:retentionBaseDateData; vazia significa evento (aguarda o corte)Data-base
htf:dispositionDESTROY, TRANSFER ou PERMANENT (maiúsculas)Destinação
htf:digitizationDate, htf:digitizedBy, htf:digitizationPlaceData, texto, textoMetadados 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​

  1. Levantamento: tipos, campos de prazo, base e destinação, valores, sentinelas e chave do dossiê (passo 0).
  2. Funções criadas (RetentionAdmin, PreservationAdmin, DossierView) (passo 1).
  3. Perfis de-para criados, simulação conferida e migração aplicada (passo 2).
  4. Perfis de dossiê e reconciliação inicial, se o acervo forma dossiês (passo 3).
  5. Estimativa de custo, preservação em lote (por último) e preservação diária ligada (passo 4).
  6. Itens a revisar ajustados e eventos previstos para o corte (passo 5).
  7. Captura nova configurada com as chaves e padrões (passo 6).