Upgrade auf Document Intelligence3,0 oder höher ab Version 2,4 oder früher

  • Freigeben Version: Zurich
  • Aktualisiert 31. Juli 2025
  • 3 Minuten Lesedauer
  • Document Intelligence3,0 oder höher enthält ein aktualisiertes Datenbankschema, um den Übergang von einer bereichsbezogenen Anwendung zu einem zu unterstützen ServiceNow AI Platform Plugin.

    Upgradeaufgaben

    Überprüfen Sie die Informationen in diesem Thema, bevor Sie ein Upgrade auf durchführen Document Intelligence( DocIntel) 3,0 oder höher ab Version 2,4 oder früher.

    Weitere Informationen zur Installation finden Sie unter Document Intelligence installieren.

    Vor dem Upgrade

    Tabelle : 1. Document Intelligence Prüfliste vor dem Upgrade 3,0 oder höher
    Aufgabe vor dem Upgrade Beschreibung
    Wählen Sie einen Zeitpunkt für die Planung des Upgrades aus

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

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

    Nach dem Upgrade auf Document Intelligence3,0 oder höher ab Version 2,4 oder früher, DocIntel Verwendet neue Flow-Aktionen. DocIntel Wird auch verwendet ServiceNow AI Platform Datenbanktabellen (sys_di_) anstelle der bereichsbezogenen Anwendungstabellen (di_). Alle DocIntel Daten werden automatisch zu diesen Plattformtabellen migriert.

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

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

    Wenn Sie anwenderdefinierten Code mit haben DocIntel2,4 oder frühere Flow-Aktionen; es sollte aktualisiert werden, um Flow-Aktionen von 3,0 oder höher zu verwenden.

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

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

    Für alle Integrationen mit Document Intelligence, Fügen Sie bereichsübergreifende Datensätze für den neuen hinzu DocIntel Datenbanktabellen.

    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 Upgrade-Prüfliste 3,0 oder höher
    Upgrade-Aufgabe Beschreibung
    Vermeiden Sie die Verwendung von Document Intelligence Arbeitsbereich zum Extrahieren von Feldern

    Warten Sie, bis eine Dokumentaufgabe in die Tabelle „sys_di_Task“ migriert wurde, bevor Sie sie mit abschließen Document Intelligence Arbeitsbereich. 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 3,0 oder höher
    Aufgabe nach dem Upgrade Beschreibung
    Testen DocIntel Integrationen und anwenderdefinierte Workflows

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

    Überprüfen Sie auf Datenverlust

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

    • Jede Aktion, die zum Löschen des Anhangs in einem alten di_Task-Datensatz führt, würde dazu führen, dass der 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 von 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 di_Task-Tabellen enthalten.
    • Das Löschen eines alten „Process_Task“-Flows (oder einer beliebigen Aktion, die zum Löschen dieses Flows führt) würde zu einer leeren Flow-Referenz in den neuen Integrations-Setup-Datensätzen führen.
    Migration von Legacy-Anwendungsfällen, die über Update-Sätze importiert wurden, nach dem Upgrade

    Jederzeit nach Abschluss von Document Intelligence Upgrade und Datenmigration ab 3,0 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 in die Plattformtabellen (sys_di_) erfordern.

    1. Navigieren zu Alle > Systemdefinition > Geplante Aufgabenan.
    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 DocIntel migrate remaining dataBatch-Auftrag zum erneuten Ausführen der Migration nach dem Löschen aller Datensätze aus sys_di-Tabellen. 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 Intelligence3,0 oder höher
    Quellbereich Zielbereich Zielname Vorgang Zieltyp Status
    Umfang der Integration des BU global sys_di_Task Lesen Tabelle Zulässig
    Umfang der Integration des BU global sys_di_key Lesen Tabelle Zulässig
    Umfang der Integration des BU global sys_di_key_Group Lesen Tabelle Zulässig
    Umfang der Integration des BU global sys_di_ocr_input Lesen Tabelle Zulässig
    Umfang der Integration des BU global sys_di_pdf_input Lesen Tabelle Zulässig
    Umfang der Integration des BU global sys_di_Prediction_input Lesen Tabelle Zulässig
    Umfang der Integration des BU global sys_di_Training_input Lesen Tabelle Zulässig
    Umfang der Integration des BU global sys_di_key_Tipp Lesen Tabelle Zulässig