Führen Sie ein Upgrade von Version 2.4 oder früher auf Document Intelligence 3.0 oder höher durch

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 3 Minuten Lesedauer
  • Document Intelligence 3.0 oder höher enthält ein aktualisiertes Datenbankschema, um den Übergang von einer bereichsbezogenen Anwendung zu einem Now Platform -Plugin zu unterstützen.

    Upgrade-Aufgaben

    Überprüfen Sie die Informationen in diesem Thema, bevor Sie ein Upgrade von Version 2.4 oder früher auf Document Intelligence (DocIntel) 3.0 oder höher durchführen.

    Weitere Informationen zur Installation finden Sie unter Document Intelligence installieren.

    Vor dem Upgrade

    Tabelle : 1. Document Intelligence Prüfliste vor dem Upgrade für 3.0 oder höher
    Aufgabe vor dem Upgrade Beschreibung
    Wählen Sie eine Zeit für die Planung des Upgrades aus

    Vermeiden Sie es, das Upgrade während der Laufzeit des Upgrade-Auftrags für die nächtliche Aufgabendefinition (Anwendungsfall) durchzuführen. Ein Upgrade der Anwendung zu diesem Zeitpunkt würde verhindern, dass Anwendungsfälle bis zur Laufzeit des nächsten Tages aktualisiert werden.

    Aktualisieren Sie beliebigen anwenderdefinierten Code, der direkt auf DocIntel-Datenbanktabellen verweist

    Nach dem Upgrade von Version 2.4 oder früher auf Document Intelligence 3.0 oder höher verwendet DocIntel neue Flow-Aktionen. DocIntel verwendet anstelle der bereichsbezogenen Anwendungstabellen (di_) auch die Datenbanktabellen Now Platform (sys_di_). Alle DocIntel -Daten werden automatisch in diese Plattformtabellen migriert.

    Hinweis:
    Anwendungsfälle für die Dokumentextraktion sind möglicherweise erst verfügbar, wenn die Migration abgeschlossen ist.

    Wenn Sie in Ihrer Instanz anwenderdefinierten Code haben, der direkt auf die Tabellen für bereichsbezogene Anwendungen (di_) verweist, sollte er aktualisiert werden, vorzugsweise auf die Plattformkomponente, die DocIntel APIs verwendet.

    Wenn Sie anwenderdefinierten Code haben, für den Flow-Aktionen der DocIntel Version 2.4 oder früher verwendet werden, muss er aktualisiert werden, um Flow-Aktionen der Version 3.0 oder höher zu verwenden.

    Die Liste der Tabellen finden Sie unter Mit Document Intelligence installierte Komponenten.

    Fügen Sie bereichsübergreifende Datensätze für Integrationen hinzu

    Fügen Sie für Integrationen mit Document Intelligencebereichsübergreifende Datensätze für die neuen Datenbanktabellen DocIntel hinzu.

    Hinweis:
    Stellen Sie sicher, dass die vorhandenen bereichsübergreifenden Datensätze für die alten Tabellen nicht entfernt werden.

    Die Liste der hinzuzufügenden Datensätze finden Sie im Abschnitt Bereichsübergreifende Datensätze.

    Weitere Informationen zu bereichsübergreifenden Datensätzen finden Sie unter Cross-scope privilege record.

    Während des Upgrades

    Tabelle : 2. Document Intelligence Prüfliste für Upgrades auf 3.0 oder höher
    Upgrade-Aufgabe Beschreibung
    Vermeiden Sie es, den Arbeitsbereich Document Intelligence zum Extrahieren von Feldern zu verwenden

    Warten Sie, bis eine Dokumentaufgabe in die Tabelle „sys_di_task“ migriert wurde, bevor Sie sie mit dem Arbeitsbereich Document Intelligence abschließen. Das Abschließen einer Aufgabe während des Upgrades kann zu Datenverlust führen.

    Nach dem Upgrade

    Tabelle : 3. Document Intelligence Prüfliste nach dem Upgrade für 3.0 oder höher
    Aufgabe nach dem Upgrade Beschreibung
    Testen Sie DocIntel Integrationen und anwenderdefinierte Workflows

    Testen Sie Ihre Anwendungsfallintegrationen, um sicherzustellen, dass sie mit dem neuen Datenbankschema funktionieren.

    Auf Datenverlust prüfen

    Einige Fälle, in denen Daten verloren gehen können, sind:

    • Jede Aktion, die zum Löschen eines Anhangs in einem alten di_task-Datensatz führt, führt dazu, dass ein Anhang für den neuen sys_di_task-Datensatz fehlt.
    • Das Löschen neuer Aufgaben, die während der Datenmigration erstellt wurden (d. h. während oder direkt nach dem Upgrade auf 3.0 oder höher), würde zu einer dauerhaften Löschung führen, da diese Datensätze möglicherweise keine Einträge in den Tabellen „di_task“ enthalten.
    • Das Löschen eines alten Flows „process_task“ (oder einer Aktion, die zur Löschung dieses Flows führt) würde zu einer leeren Flow-Referenz in den neuen Integrationssetup-Datensätzen führen.
    Migration nach dem Upgrade von veralteten Anwendungsfällen, die über Update-Sätze importiert wurden

    Jederzeit nach Abschluss des Upgrades und der Datenmigration auf Document Intelligence  3.0 oder höher können Sie das Migrations-Batch-Skript, das während des Upgrades ausgeführt wurde, erneut ausführen.

    Sie können dieses Skript ausführen, wenn Sie importierte Anwendungsfälle migrieren müssen, die eine Migration zu den Plattformtabellen (sys_di_) erfordern.

    1. Navigieren zu Alle > Systemdefinition > Geplante Aufgaben.
    2. Öffnen Sie die regelmäßige Aufgabe DocIntel migrate remaining data.
    3. Aktivieren Sie die Checkbox Aktiv.
    4. Wählen Sie Jetzt ausführen.
    Warnung:
    Verwenden Sie niemals den Batch-Auftrag DocIntel migrate remaining data, um die Migration erneut auszuführen, nachdem Sie alle Datensätze aus sys_di-Tabellen gelöscht haben. Sie sollten es nur verwenden, um fehlende Daten aus di_-Tabellen in sys_di-Tabellen zu migrieren.

    Bereichsübergreifende Datensätze

    Tabelle : 4. Bereichsübergreifende Datensätze für Document Intelligence  3.0 oder höher
    Quellbereich Zielbereich Zielname Vorgang Zieltyp Status
    Umfang des integrierenden BU global sys_di_task Lesen Tabelle Zulässig
    Umfang des integrierenden BU global sys_di_key Lesen Tabelle Zulässig
    Umfang des integrierenden BU global sys_di_key_group Lesen Tabelle Zulässig
    Umfang des integrierenden BU global sys_di_ocr_input Lesen Tabelle Zulässig
    Umfang des integrierenden BU global sys_di_pdf_input Lesen Tabelle Zulässig
    Umfang des integrierenden BU global sys_di_prediction_input Lesen Tabelle Zulässig
    Umfang des integrierenden BU global sys_di_training_input Lesen Tabelle Zulässig
    Umfang des integrierenden BU global sys_di_key_hint Lesen Tabelle Zulässig