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)

Exportar e importar configuração

A tela Pacote de configuração, no console da guarda documental, leva a configuração da guarda de uma instalação para outra (por exemplo, de homologação para produção) sem refazer tela por tela. O operador escolhe exatamente o que exportar ou importar; não é uma operação tudo-ou-nada, e cada item aplicado em uma importação fica registrado individualmente na auditoria.

Licença

Faz parte do GCVD e depende da licença do módulo. Só enxerga e usa esta tela quem tem a capacidade Configurar a guarda documental (tela de configuração do GCVD) (GcvdAdmin).

Operação de risco

Importar um arquivo de configuração pode sobrescrever valores já em uso em uma instalação de produção. Siga o passo a passo com atenção, especialmente a etapa de conferência antes de aplicar.

O que entra no pacote​

O pacote é organizado em seções, cada uma exibida como um bloco, com um checkbox "selecionar tudo" no topo e um checkbox por item:

  • Configuração central: parâmetros e interruptores gerais da guarda (guarda documental, bloqueio, retenção de pacotes de exportação, entre outros), cada um exibido pelo rótulo em português.
  • Perfis de retenção: os perfis de tempo de guarda cadastrados.
  • Perfis de migração de temporalidade: os perfis que definem a passagem entre fases de temporalidade (corrente, intermediária, permanente).
  • Árvore de classificação: a árvore de classes documentais, com indentação por nível. Marcar um item pai marca em cascata os filhos.
  • Preservação (agendas): os dois itens fixos "Preservação diária" e "Reassinatura de resumos".
  • Templates de certificado: os modelos de certificado cadastrados.

Segredos, como senhas de certificado, nunca saem no arquivo: ficam marcados como tal e não são exportados nem importados.

Exportar​

  1. Abra Pacote de configuração no console da guarda.
  2. Em cada seção, marque os itens que deseja levar. Use "selecionar tudo" na seção ou marque item a item, inclusive na árvore de classificação, onde marcar uma classe pai também marca os filhos.
  3. Clique no botão de exportar. O navegador baixa o arquivo gcvd-config-bundle.json com os itens selecionados.
  4. Guarde o arquivo em local seguro até importar no ambiente de destino. Trate-o como dado sensível: mesmo sem segredos, ele descreve toda a estrutura de guarda da origem.

A exportação não é registrada na auditoria, pois é somente leitura. O que fica auditado é a importação, item a item.

Importar​

  1. Na tela Pacote de configuração do ambiente de destino, use Escolher arquivo e selecione o gcvd-config-bundle.json.

  2. Ao carregar o arquivo, a tela monta uma prévia com as mesmas seções, em que cada item mostra um selo com o que acontecerá se for aplicado:

    SeloSignificado
    NovoO item não existe no destino; será criado
    SubstituiJá existe um item equivalente no destino; será sobrescrito
    IgualO item já existe e é idêntico; não precisa aplicar
    Segredo (não importa)O item carrega um segredo que não veio no arquivo; deve ser configurado manualmente no destino
    PuladoO arquivo não seleciona o item para importação
    Falta aquiReferência esperada que não foi encontrada no destino
    Existe aquiInformativo: já há uma versão no destino (usado principalmente nos templates de certificado)
  3. Apenas os itens Novo ou Substitui ficam com o checkbox habilitado; os demais aparecem desabilitados. Os templates de certificado são sempre apenas informativos: quando um certificado precisa ser reconduzido no destino, a prévia mostra um aviso de "re-provisionar" e o certificado deve ser tratado na tela de certificados (ver Certificados).

  4. Revise a prévia com cuidado, em especial os itens Substitui, que sobrescrevem configuração já em uso. Marque somente o que pretende trazer.

  5. Marque os itens desejados (ou "selecionar tudo" por seção, respeitando os itens desabilitados) e clique em Aplicar selecionados.

  6. Um segundo passo de confirmação avisa que a operação cria ou atualiza, por nome ou código, os itens marcados, e que os segredos existentes no destino são preservados (não são apagados por um pacote sem segredos). Somente depois de confirmar a importação é aplicada.

Validar depois de importar​

  • Nas telas correspondentes (perfis de retenção, perfis de migração, árvore de classificação, templates de certificado e Configuração da guarda), confira que os itens aparecem com os valores esperados.
  • Na auditoria da guarda, confira que cada item aplicado gerou um evento próprio, identificando o tipo (configuração, perfil de retenção, perfil de migração, classe, agenda de preservação) e o nome ou código do item.

Se algo não aparecer como esperado, repita a importação apenas para os itens que faltaram: a operação é sempre seletiva.

O que fica fora do pacote​

Funções e capacidades não fazem parte do pacote. As funções por persona (Gerente da guarda, Conferente, Classificador, Aprovador etc.) são criadas pelo botão Popular com roles da guarda na tela Funções (ver Capacidades e funções), que pode ser usado a qualquer momento e quantas vezes for preciso, sem risco.

Disponibilidade​

A tela existe apenas no Share; não há tela equivalente no Portal de Clientes.