Fazer upgrade para Inteligência para documentos 3.0 ou posterior da versão 2.4 ou anterior

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 4 min. de leitura
  • Inteligência para documentos 3.0 ou posterior inclui um esquema de banco de dados atualizado para oferecer suporte à transição de uma aplicação com escopo para um plug-in Now Platform.

    Tarefas de upgrade

    Revise as informações neste tópico antes de fazer upgrade para Inteligência para documentos (DocIntel) 3.0 ou posterior da versão 2.4 ou anterior.

    Para obter mais informações sobre a instalação, consulte Instalar Inteligência para documentos.

    Antes do upgrade

    Tabela 1. Inteligência para documentos Check-list de pré-upgrade para 3.0 ou posterior
    Tarefa de pré-upgrade Descrição
    Escolha um horário para programar o upgrade

    Evite executar o upgrade durante o tempo de execução do trabalho de upgrade da definição de tarefa noturna (caso de uso). Atualizar a aplicação nesse momento impediria que os casos de uso fossem atualizados até o tempo de execução do dia seguinte.

    Atualizar qualquer código personalizado que aponte diretamente para tabelas de banco de dados do DocIntel

    Depois de atualizar para Inteligência para documentos 3.0 ou posterior da versão 2.4 ou anterior, DocIntel usará novas ações de fluxo. DocIntel também usará Now Platform tabelas de banco de dados (sys_di_) no lugar das tabelas de aplicações com escopo (di_). Todos os dados DocIntel serão migrados automaticamente para essas tabelas de plataforma.

    Nota:
    Os casos de uso de extração de documentos podem não estar disponíveis para uso até que a migração seja concluída.

    Se você tiver um código personalizado em sua instância que aponte diretamente para as tabelas de aplicações com escopo (di_), ele deverá ser atualizado, de preferência para o componente da plataforma usando DocIntel APIs.

    Se você tiver um código personalizado usando ações de fluxo DocIntel 2.4 ou anteriores, ele deverá ser atualizado para usar ações de fluxo 3.0 ou posteriores.

    Para obter a lista de tabelas, consulte Componentes instalados com Inteligência para documentos.

    Adicionar registros entre escopos para integrações

    Para todas as integrações com Inteligência para documentos, adicione registros entre escopos para as novas tabelas de banco de dados DocIntel.

    Nota:
    Certifique-se de que os registros entre escopos existentes das tabelas antigas não sejam removidos.

    Consulte a seção Registros entre escopos para obter a lista de registros a serem adicionados.

    Para obter mais detalhes sobre registros entre escopos, consulte Cross-scope privilege record.

    Durante o upgrade

    Tabela 2. Inteligência para documentos Check-list de upgrade para 3.0 ou posterior
    Tarefa de upgrade Descrição
    Evite usar o espaço Inteligência para documentos para extrair campos

    Aguarde até que uma tarefa de documento seja migrada para a tabela sys_di_task antes de concluí-la usando o espaço Inteligência para documentos. Concluir uma tarefa durante o upgrade pode levar à perda de dados.

    Após o upgrade

    Tabela 3. Inteligência para documentos Check-list de pós-upgrade para 3.0 ou posterior
    Tarefa de pós-upgrade Descrição
    Testar DocIntel integrações e fluxos de trabalho personalizados

    Teste suas integrações de caso de uso para garantir que elas funcionem com o novo esquema de banco de dados.

    Verificar se há perda de dados

    Alguns casos em que você pode perder dados incluem:

    • Qualquer ação que resulte na exclusão de anexo em um registro di_task antigo resultará em um anexo ausente para o novo registro sys_di_task.
    • A exclusão de todas as novas tarefas criadas durante a migração de dados (ou seja, durante ou logo após o upgrade para a versão 3.0 ou posterior) resultaria na exclusão permanente, pois esses registros podem não ter entradas nas tabelas di_task.
    • A exclusão de um fluxo "process_task" antigo (ou qualquer ação que resulte na exclusão desse fluxo) resultaria em uma referência de fluxo vazia nos novos registros de configuração de integração.
    Migração pós-upgrade de casos de uso legados importados por meio de conjuntos de atualizações

    A qualquer momento após a conclusão do upgrade e da migração de dados para Inteligência para documentos 3.0 ou posterior, você pode executar novamente o script em lote de migração que foi executado durante o upgrade.

    Você pode executar este script se precisar migrar casos de uso importados que exijam migração para as tabelas da plataforma (sys_di_).

    1. Navegar até Tudo > Definição do Sistema > Trabalhos programados.
    2. Abra o DocIntel migrate remaining data trabalho agendado.
    3. Marque a caixa de seleção Ativo.
    4. Selecione Executar agora.
    Aviso:
    Nunca use o trabalho em lote DocIntel migrate remaining data para executar novamente a migração após excluir todos os registros das tabelas sys_di. Você só deve usá-lo para migrar dados ausentes de tabelas di_ para tabelas sys_di.

    Registros entre escopos

    Tabela 4. Registros entre escopos para Inteligência para documentos 3.0 ou posterior
    Escopo de origem Escopo de destino Nome de destino Operação Tipo do destino Status
    Escopo de integração de BU global sys_di_task Leitura Tabela Permitido
    Escopo de integração de BU global sys_di_key Leitura Tabela Permitido
    Escopo de integração de BU global sys_di_key_group Leitura Tabela Permitido
    Escopo de integração de BU global sys_di_ocr_input Leitura Tabela Permitido
    Escopo de integração de BU global sys_di_pdf_input Leitura Tabela Permitido
    Escopo de integração de BU global sys_di_prediction_input Leitura Tabela Permitido
    Escopo de integração de BU global sys_di_training_input Leitura Tabela Permitido
    Escopo de integração de BU global sys_di_key_hint Leitura Tabela Permitido