Guia de Migração

Em março de 2023 lançamos a primeira versão de produção da geração atual do eDok. Esta nova geração é o resultado de quase 20 anos de experiência com Gestão Eletrônica de Documentos (GED), três anos de desenvolvimento, testes e milhares de horas de esforço para trazer a você, cliente eDok, uma verdadeira revolução.

O momento de embarcarmos seu negócio na revolução eDok chegou!

Este guia detalha o processo de migração da geração anterior para a geração atual do eDok. Ele se destina a administradores, gestores e usuários dos clientes eDok.

Motivação

A geração atual do eDok é um produto inteiramente novo, feito do zero. Apesar de possuir, a rigor, as mesmas funcionalidades, nenhum código ou modelo de dados foi aproveitado da geração anterior. Optamos por este caminho para possibilitar que o novo eDok possa tirar proveito das tecnologias e práticas mais avançadas e seguras atualmente, sem perder de vista sua evolução nas próximas décadas.

Como os novos modelos de dados não são retrocompatíveis com os da geração anterior, uma migração torna-se obrigatória para compatibilizá-los.

Processo

A migração ocorrerá mediante um processo padronizado para todos os clientes, seja para os que estão na nuvem ou on-premises. A única diferença que poderá haver é nos prazos de desativação da geração anterior, que para clientes on-premises poderá ser maior.

O processo de migração consiste das seguintes etapas:

  1. Equipe eDok entra em contato com os clientes informando da necessidade de migração;
  2. Cliente agenda a data quando poderá ser iniciada sua migração;
  3. Na data acordada entre cliente e eDok:
    1. Um ambiente eDok da geração atual inteiramente novo é provisionado, mas o da geração anterior continuará ativo;
    2. A rotina de migração é executada. A depender do tamanho do repositório, este processo poderá levar dias;
    3. Ao final da rotina de migração, o cliente inicia a validação do repositório no novo ambiente;
    4. Enquanto o cliente efetua a validação, a rotina de migração rodará uma vez ao dia, por até 30 dias, para migrar novos documentos eventualmente criados no ambiente antigo.
  4. Cliente altera eventuais URLs e chaves de acesso nos dispositivos e aplicações que se integram ao eDok para o novo ambiente;
  5. 30 dias após o término da migração inicial, o eDok da geração anterior será desativado em definitivo;
  6. Migração concluída.

Nos clientes on-premises, ou seja, com o eDok instalado em infraestrutura própria, o procedimento é idêntico, mas o prazo para a desativação do ambiente da geração anterior é estendido para até 90 dias.

Custo Zero

A migração para a nova geração não acarretará custos adicionais ao cliente eDok. Todo o processo é gratuito e será fornecido como parte do nosso empenho em prover um serviço de excelência aos nossos clientes.

Migração

A migração é uma tarefa composta de várias etapas concebidas para reduzir o impacto aos usuários internos ou externos do eDok em sua organização. Essas etapas são descritas detalhadamente abaixo.

Preparação

Antes de iniciar a migração, RECOMENDAMOS VEEMENTEMENTE que administradores, gestores e usuários do eDok leiam em sua totalidade os Manuais da Geração Atual do eDok. Encorajamos utilizar estes manuais para compor e ministrar treinamentos aos colaboradores utilizando nosso ambiente de demonstração. Também recomendamos verificar a compatibilidade dos sistemas operacionais e navegadores suportados pela geração atual do eDok.

Não fornecemos serviços de treinamento, projeto e implantação.

Informações Migradas

As informações migradas da geração anterior para atual são:

  • Configurações: apenas as configurações requeridas pela geração atual;
  • Grupos: os grupos da geração anterior serão migrados para funções com permissões associadas de modo conservador, ou seja, o menor conjunto de permissões possíveis para fornecer as funcionalidades requeridas;
  • Usuários: os usuários migrados terão o email e o nome completo dos usuários existentes, e será gerada uma senha aleatória para acesso seguindo os novos requisitos da geração atual;
  • Tipos de Documentos: tipos de documentos com seus respectivos identificadores;
  • Repositório: pastas e documentos com todos os seus identificadores, metadados e assinaturas preservados.

Para preservar metadados e assinaturas do documento original, a migração dos documentos ocorre obrigatoriamente com a opção Arquivar Original habilitada. Isto pode fazer com que a conformidade do documento migrado seja Nível 0, uma vez que a estrutura de metadados difere de uma geração para outra. A compatibilização deste aspecto modificaria o documento original, invalidando eventuais assinaturas digitais existentes. Esta característica da migração não implica na conformidade ou não do documento migrado.

Regras e Exclusões

Procedimentos relativos a processos e parâmetros internos dos clientes não são cobertos pela migração. Por exemplo: parametrização de impressoras e/ou scanners (incluindo multifuncionais), scripts de FTP, fluxos operacionais e tudo o mais que envolva a operação interna do cliente.

As seguintes regras e exclusões se aplicam à migração:

  • Grupos e permissões: alguns grupos e permissões anteriores seguem um mapeamento fixo para o novo modelo de funções e permissões;
  • Usuários Ignorados: os antigos usuários admin, guest, sysint e tasy são ignorados;
  • Funções Permitidas: as antigas listas de permissões (ACLs) serão migradas como funções permitidas nas pastas da raiz do repositório. Nas pastas e documentos mais profundos, as funções permitidas serão herdadas;
  • Tipos de Documentos Ignorados: o antigo tipo de documento default é ignorado;
  • Código do Tipo: caso exista um tipo de documento antigo com código repetido, o novo código do tipo será criado com o sufixo M, por exemplo: RG antigo será gerado como RGM se já existir um tipo cadastrado como RG no novo ambiente;
  • Arquivos Órfãos: itens de documentos do repositório antigo cujas pastas ou arquivos PDF foram apagados serão ignorados;
  • Propriedade de Migração: pastas que não sejam da raiz e documentos migrados recebem uma propriedade com o ID do respectivo item antigo. Esta propriedade pode ser utilizada para conciliar a migração, mas será removida quando todos os clientes forem migrados;
  • Outros Itens Ignorados: ACLs, logs de auditoria e certificados digitais dos usuários no ambiente antigo são ignorados.

Registros

Registros de sistema e atividades são produzidos pela migração para evidenciar todas as operações. Além disso, logs completos da rotina de migração são gerados e salvos para envio aos clientes. Veja um exemplo:

[2023-07-17T18:36:40.337266-0300] [II] eDok Migrate started
[2023-07-17T18:36:40.338810-0300] [II] Migration origin: exemplo.edok.com.br
[2023-07-17T18:36:40.339313-0300] [WW] Requested migration up to 10 documents (for testing purposes)
[2023-07-17T18:36:40.339780-0300] [II] FULL MIGRATION: settings, groups, users, root folders, document types and documents
[2023-07-17T18:36:44.859297-0300] [II] Legacy database connected and replied properly
[2023-07-17T18:36:44.860096-0300] [II] Charset conversion check
[2023-07-17T18:36:44.860529-0300] [II] - Source string in ISO-8859-1: Usuário
[2023-07-17T18:36:44.860982-0300] [II] - Converted string to UTF-8  : Usuário
[2023-07-17T18:36:44.861422-0300] [II] Migrating settings
[2023-07-17T18:36:45.491994-0300] [II] - API settings migrated
[2023-07-17T18:36:45.492502-0300] [II] Migrating groups into roles
[2023-07-17T18:36:46.131929-0300] [II] 1/2 - Group migrated to role: Usuário (group ID 3, role ID 2, slug 'user', level 1)
[2023-07-17T18:36:46.181100-0300] [II] 2/2 - Group migrated to role: Gerente (group ID 4, role ID 3, slug 'manager', level 2)
[2023-07-17T18:36:46.181621-0300] [II] Migrating users
[2023-07-17T18:36:47.162331-0300] [II] 1/3 - User migrated: user1@edok.com.br/vihydse&7AjfeCX (ID 1, role 'admin', level 3)
[2023-07-17T18:36:47.272801-0300] [II] 2/3 - User migrated: user2@edok.com.br/FuUHONP@gyevVxy (ID 2, role 'manager', level 2, perm IDs 5-6-7-8-9)
[2023-07-17T18:36:48.445931-0300] [II] 3/3 - User migrated: user3@edok.com.br/8cqzGfM%gunClXQ (ID 3, role 'user', level 1)
[2023-07-17T18:36:49.698802-0300] [II] Migrating root folders
[2023-07-17T18:36:50.337381-0300] [II] 1/2 - Root folder migrated: Assistencial (legacy ID 4, new ID 1, parent ID 1, role 'manager)
[2023-07-17T18:36:50.372423-0300] [II] 2/2 - Root folder migrated: Educacional (legacy ID 44294, new ID 2, parent ID 1, role 'user)
[2023-07-17T18:36:50.553953-0300] [II] Migrating document types
[2023-07-17T18:36:55.969722-0300] [II] 1/4 - Document type 'Ficha de Internação' already exists with ID 1, skipping
[2023-07-17T18:37:30.598484-0300] [II] 2/4 - Document type 'Legado' already exists with ID 2, skipping
[2023-07-17T18:37:31.240857-0300] [II] 3/4 - Document type migrated: Provas (ID 3, code PR)
[2023-07-17T18:37:31.882426-0300] [II] 4/4 - Document type migrated: Secretaria (ID 4, code SE)
[2023-07-17T18:37:31.893337-0300] [II] - Migrated document type ID sort order: 1,2,3,4
[2023-07-17T18:37:32.488823-0300] [II] Migrating 1631248 documents in chunks of 100 each
[2023-07-17T18:37:33.389056-0300] [II] - Processing chunk 00001/16313
[2023-07-17T18:37:45.861853-0300] [II] 0000001/1631248 - Document FI00001 migrated (legacy ID 3, new ID 32, parent ID 3, took 12.47s)
[2023-07-17T18:38:11.182552-0300] [II] 0000002/1631248 - Document FI00002 migrated (legacy ID 4, new ID 34, parent ID 4, took 25.32s)
[2023-07-17T18:38:31.966340-0300] [II] 0000003/1631248 - Document FI00003 migrated (legacy ID 5, new ID 36, parent ID 5, took 20.78s)
[2023-07-17T18:38:38.779230-0300] [II] 0000004/1631248 - Document FI00004 migrated (legacy ID 6, new ID 38, parent ID 6, took 6.81s)
[2023-07-17T18:39:09.039031-0300] [II] 0000005/1631248 - Document ZZ00001 migrated (legacy ID 7, new ID 40, parent ID 7, took 30.26s)
[2023-07-17T18:39:15.531711-0300] [II] 0000006/1631248 - Document ZZ00002 migrated (legacy ID 8, new ID 42, parent ID 8, took 6.49s)
[2023-07-17T18:39:25.650008-0300] [II] 0000007/1631248 - Document PR00001 migrated (legacy ID 9, new ID 44, parent ID 9, took 10.11s)
[2023-07-17T18:40:11.697123-0300] [II] 0000008/1631248 - Document PR00002 migrated (legacy ID 10, new ID 46, parent ID 10, took 46.04s)
[2023-07-17T18:40:18.853013-0300] [II] 0000009/1631248 - Document SE00001 migrated (legacy ID 11, new ID 48, parent ID 11, took 7.15s)
[2023-07-17T18:41:24.658894-0300] [II] 0000010/1631248 - Document SE00002 migrated (legacy ID 12, new ID 50, parent ID 12, took 65.80s)
[2023-07-17T18:41:24.659828-0300] [WW] Migrated the requested 10 documents (for testing purposes), finishing up
[2023-07-17T18:41:24.660852-0300] [II] Documents migration stats: 10 migrated, 0 already exist, 0 orphan, 0 not found, 0 processing error, total 10
[2023-07-17T18:41:24.662520-0300] [II] eDok Migrate finished

Validação

Após a conclusão da migração inicial, encorajamos os clientes a validarem as seguintes informações, comparando com o ambiente antigo:

  1. Funções e permissões;
  2. Funções Permitidas nas pastas da raiz do repositório;
  3. Usuários e detalhes das contas;
  4. Tipos de Documentos;
  5. Pastas e Documentos migrados.

Utilize os registros fornecidos para validar a migração.

Conclusão

Após validar os dados migrados, a conclusão da migração requer a alteração de configurações em dispositivos e sistemas. São elas:

  1. Nos scanners e servidores de digitalização, alterar o endereço FTP. O novo endereço é informado diretamente ao cliente;
  2. Nos sistemas que se integram ao eDok, atualizar as requisições de API com eventuais novos parâmetros configurados;
  3. Distribuir detalhes de acesso (email/senha) aos usuários. Recomendamos que eles troquem as senhas geradas pro novas senhas;
  4. Usuários que assinam documentos devem instalar seus certificados digitais;
  5. Informar ao nosso suporte técnico a conclusão da migração até 30 dias depois do seu início.

Passados 30 dias do início da migração, o ambiente antigo será destruído. Para clientes on-premises, esse prazo é 90 dias.

Suporte

Durante todo o processo de migração, nosso suporte técnico estará de prontidão para auxiliá-lo quando necessário. Conte conosco para uma transição tranquila.

Fim da Geração Anterior

A geração anterior será descontinuada em 1º de julho de 2024.

Após 1º de julho de 2024, a geração anterior do eDok não receberá mais suporte técnico e manutenções. Até lá, a documentação obsoleta estará disponível no endereço https://old.edok.com.br para referência dos clientes que ainda utilizarem a geração anterior do eDok.

Continuando...

Parabéns! Você concluiu o Guia de Migração. Para conhecer os detalhes da evolução do eDok, consulte o Registro de Versões.

Usamos cookies para armazenar informações funcionais. Ao utilizar nossos serviços, você se declara ciente dessa característica e consente com nossa Política de Privacidade.