Mettre à niveau vers la Intelligence documentaire version 3.0 ou ultérieure à partir de la version 2.4 ou antérieure

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 4 minutes de lecture

    • Intelligence documentaire La version 3.0 ou ultérieure inclut un schéma de base de données mis à jour pour prendre en charge sa transition d’une application incluse dans le périmètre à un module d’extension ServiceNow AI Platform .

    Mettre à niveau les tâches

    Passez en revue les informations de cette rubrique avant d’effectuer une mise à niveau vers Intelligence documentaire (IntelDoc) 3.0 ou ultérieure à partir de la version 2.4 ou antérieure.

    Pour plus d’informations sur l’installation, reportez-vous à la section Installer Intelligence documentaire.

    Avant la mise à niveau

    Tableau 1. Intelligence documentaire Liste de vérification préalable à la mise à niveau 3.0 ou ultérieure
    Tâche de pré-mise à niveau Description
    Choisissez une heure pour planifier la mise à niveau

    Évitez d’effectuer la mise à niveau pendant l’exécution de la tâche de mise à niveau nocturne de définition de tâche (cas d’utilisation). La mise à niveau de l’application à ce moment-là empêcherait la mise à niveau des cas d’utilisation jusqu’à l’heure d’exécution du lendemain.
    Mettre à jour tout code personnalisé qui pointe directement vers des tables de base de données IntelDoc

    Après la mise à niveau vers Intelligence documentaire la version 3.0 ou ultérieure à partir de la version 2.4 ou antérieure, IntelDoc de nouvelles actions de flux seront utilisées. IntelDoc utilisera également des ServiceNow AI Platform tables de base de données (sys_di_) à la place des tables d’application incluses dans le périmètre (di_). Toutes les IntelDoc données seront migrées automatiquement vers ces tables de plateforme.

    Remarque :
    Les cas d’utilisation d’extraction de documents peuvent ne pas être disponibles tant que la migration n’est pas terminée.

    Si vous avez du code personnalisé dans votre instance qui pointe directement vers les tables d’applications incluses dans le périmètre (di_), il doit être mis à jour, de préférence vers le composant de plateforme à l’aide IntelDoc d’API.

    Si vous avez du code personnalisé utilisant IntelDoc des actions de flux 2.4 ou antérieures, il doit être mis à jour pour utiliser des actions de flux 3.0 ou ultérieures.

    Pour la liste des tables, reportez-vous à la section Composants installés avec Intelligence documentaire.
    Ajouter des enregistrements entre périmètres pour les intégrations

    Pour toutes les intégrations avec Intelligence documentaire, ajoutez des enregistrements entre périmètres pour les nouvelles IntelDoc tables de base de données.

    Remarque :
    Assurez-vous que les enregistrements entre périmètres existants pour les anciennes tables ne sont pas supprimés.

    Consultez la section Enregistrements entre périmètres pour la liste des enregistrements à ajouter.

    Pour en savoir plus sur les enregistrements entre périmètres, reportez-vous à la section Cross-scope privilege record.

    Pendant la mise à niveau

    Tableau 2. Intelligence documentaire Liste de vérification des mises à niveau 3.0 ou ultérieures
    Mettre à niveau la tâche Description
    Évitez d’utiliser l’espace de Intelligence documentaire travail pour extraire des champs

    Attendez qu’une tâche de document soit migrée vers la table sys_di_task avant de la terminer à l’aide de l’espace de Intelligence documentaire travail. L’exécution d’une tâche pendant la mise à niveau peut entraîner une perte de données.

    Après la mise à niveau

    Tableau 3. Intelligence documentaire 3.0 ou version ultérieure après la mise à niveau
    Tâche post-mise à niveau Description
    Intégrations de tests IntelDoc et workflows personnalisés

    Testez vos intégrations de cas d’utilisation pour vous assurer qu’elles fonctionnent avec le nouveau schéma de base de données.
    Vérifier la perte de données

    Voici quelques cas où vous pouvez perdre des données :

    • Toute action entraînant la suppression de la pièce jointe d’un ancien enregistrement de di_task entraînera une pièce jointe manquante pour le nouvel enregistrement de sys_di_task.
    • La suppression de toutes les nouvelles tâches créées pendant la migration des données (c’est-à-dire pendant ou juste après la mise à niveau 3.0 ou ultérieure) entraînerait une suppression définitive, car ces enregistrements peuvent ne pas avoir d’entrées dans di_task tables.
    • La suppression d’un ancien flux « process_task » (ou toute action entraînant la suppression de ce flux) entraînerait une référence de flux vide dans les nouveaux enregistrements de configuration d’intégration.
    Migration post-mise à niveau des cas d’utilisation hérités importés via des ensembles de mises à jour

    À tout moment après la fin de la Intelligence documentaire mise à niveau 3.0 ou ultérieure et de la migration des données, vous pouvez réexécuter le script par lots de migration qui s’est exécuté pendant la mise à niveau.

    Vous pouvez exécuter ce script si vous devez migrer des cas d’utilisation importés nécessitant une migration vers les tables de plateforme (sys_di_).

    1. Accédez à la Tous > Définition du système > Travaux planifiés.
    2. Ouvrez les tâches planifiées de DocIntel migrate remaining data
    3. Sélectionnez la case à cocher Activé.
    4. Sélectionnez Exécuter maintenant.
    Avertissement :
    N’utilisez jamais la tâche par lots pour réexécuter la DocIntel migrate remaining data migration après avoir supprimé tous les enregistrements des tables sys_di. Vous ne devez l’utiliser que pour migrer les données manquantes des tables di_ vers les tables sys_di.

    Enregistrements entre périmètres

    Tableau 4. Enregistrements entre périmètres pour Intelligence documentaire 3.0 ou version ultérieure
    Périmètre source Périmètre cible Nom de cible Opération Type cible Statut
    Périmètre de l’intégration de la BU global sys_di_task Lire Table Autorisé
    Périmètre de l’intégration de la BU global sys_di_key Lire Table Autorisé
    Périmètre de l’intégration de la BU global sys_di_key_group Lire Table Autorisé
    Périmètre de l’intégration de la BU global sys_di_ocr_input Lire Table Autorisé
    Périmètre de l’intégration de la BU global sys_di_pdf_input Lire Table Autorisé
    Périmètre de l’intégration de la BU global sys_di_prediction_input Lire Table Autorisé
    Périmètre de l’intégration de la BU global sys_di_training_input Lire Table Autorisé
    Périmètre de l’intégration de la BU global sys_di_key_hint Lire Table Autorisé