Atualizar para Document Intelligence 3.0 ou posterior da versão 2.4 ou anterior

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura

    • Document Intelligence 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 atualizar para Document Intelligence (DocIntel) 3.0 ou posterior da versão 2.4 ou anterior.

    Para obter mais informações sobre a instalação, consulte Como instalar Document Intelligence.

    Antes do upgrade

    Tabela 1. Document Intelligence Check-list de pré-atualização do 3.0 ou posterior
    Tarefa de pré-atualização Descrição
    Escolha um horário para programar o upgrade

    Evite executar a atualização durante o tempo de execução do trabalho de atualização da definição de tarefa noturna (caso de uso). Atualizar a aplicação nesse momento impediria a atualização dos casos de uso até o tempo de execução do dia seguinte.
    Atualize qualquer código personalizado que aponte diretamente para tabelas de banco de dados do DocIntel

    Depois de atualizar para Document Intelligence 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 da aplicação com escopo (di_). Todos os dados de DocIntel serão migrados automaticamente para essas tabelas da 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 da aplicação 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 DocIntel 2.4 ou ações de fluxo 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 Document Intelligence.
    Adicionar registros de escopo cruzado para integrações

    Para todas as integrações com Document Intelligence, adicione registros de escopo cruzado para as novas tabelas de banco de dados DocIntel.

    Nota:
    Certifique-se de que os registros de escopo cruzado existentes para as 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 de escopo cruzado, consulte Cross-scope privilege record.

    Durante o upgrade

    Tabela 2. Document Intelligence Check-list de upgrade para 3.0 ou posterior
    Tarefa de upgrade Descrição
    Evite usar o espaço Document Intelligence 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 Document Intelligence. Concluir uma tarefa durante a atualização pode levar à perda de dados.

    Após o upgrade

    Tabela 3. Document Intelligence Check-list pós-atualização 3.0 ou posterior
    Tarefa de pós-atualização 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 do 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 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-atualização de casos de uso legados importados por meio de conjuntos para atualização

    A qualquer momento após a conclusão da atualização do Document Intelligence 3.0 ou posterior e da migração de dados, você pode executar novamente o script em lote de migração executado durante a atualização.

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

    1. Navegar até Todos > Definição do Sistema > Trabalhos programados.
    2. Abra o trabalho programado DocIntel migrate remaining data.
    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 de escopo cruzado para Document Intelligence 3.0 ou posterior
    Escopo de origem Escopo de destino Nome de destino Operação Tipo do destino Status
    Escopo de integração da BU global sys_di_task Leitura Tabela Permitido
    Escopo de integração da BU global sys_di_key Leitura Tabela Permitido
    Escopo de integração da BU global sys_di_key_group Leitura Tabela Permitido
    Escopo de integração da BU global sys_di_ocr_input Leitura Tabela Permitido
    Escopo de integração da BU global sys_di_pdf_input Leitura Tabela Permitido
    Escopo de integração da BU global sys_di_prediction_input Leitura Tabela Permitido
    Escopo de integração da BU global sys_di_training_input Leitura Tabela Permitido
    Escopo de integração da BU global sys_di_key_hint Leitura Tabela Permitido