Documentation Oracle Cloud Infrastructure

Mise à niveau vers Oracle Integration 3 : Phase 1

Découvrez les étapes de la phase 1 de la mise à niveau progressive. Pour mettre à niveau les intégrations et les applications Visual Builder vers Oracle Integration 3, procédez comme suit :

Prérequis

Assurez-vous de remplir les prérequis avant la mise à niveau de votre instance pour éviter toute interruption.

Oracle Integration Generation 2

  • Un nom d'hôte sera créé pour votre instance Oracle Integration Generation 2. Vous devrez utiliser ce nouveau nom d'hôte pour tous les accès basés sur un navigateur au processus sur l'instance Oracle Integration Generation 2 à l'avenir.
  • Le nouveau nom d'hôte sera affiché sous Plus de détails dans la section Prévérifications de Process Automation de la page Mise à niveau.

Visual Builder

Si vous avez des applications Visual Builder qui appellent Process, procédez comme suit pour mettre à jour les applications Visual Builder.
  1. Dans la console Visual Builder, accédez à Paramètres, Services, Back-ends, Applications de processus, puis à Serveurs.
  2. Pour le serveur Oracle Integration Generation 2 Process, cliquez sur Modifier.
  3. Dans le champ URL d'instance, mettez à jour le nom d'hôte sur le nom d'hôte fourni à l'étape ci-dessus.
  4. Dans le champ Authentification, remplacez la valeur de Compte Oracle Cloud par Assertion utilisateur OAuth 2.0. Mettez à jour le champ Portée pour utiliser la portée de l'adresse REST Oracle Integration avec l'URL Audience principale. Vous pouvez obtenir la portée de l'application de confidentialité OAuth de l'instance Oracle Integration à partir de votre location. La portée sera définie dans cette application de confidentialité. Pour plus d'informations sur la création de l'application de confidentialité OAuth dans Oracle Integration Generation 2, reportez-vous à Configuration de l'authentification OAuth 2.0 à l'aide des informations d'identification client. Exemple d'URL d'audience principale : https://E213D785B536427D9E7E0BE1C5D85300.integration.ocp.oraclecloud.com:443.
  5. Pour chacune des applications Visual Builder que vous avez créées, procédez comme suit :
    Remarque

    Vous devez effectuer les étapes a à c uniquement si Visual Builder est utilisé pour traiter les tâches à l'aide d'une interface utilisateur externe. Pour plus d'informations sur la connexion d'interface utilisateur externe, reportez-vous à Création d'une connexion d'interface utilisateur externe.
    1. Ouvrez les paramètres de sécurité de l'application Visual Builder.
    2. Définissez le champ Incorporation sur Autoriser l'intégration dans des domaines spécifiés.
    3. Dans le champ URL de domaine, ajoutez la nouvelle URL de processus Oracle Integration Generation 2.
  6. Si une application Web Visual Builder contient une référence à la page des composants de processus, par exemple, VB_SERVER + "/ic/pub/components/pages/applist.html", vous pouvez éventuellement créer une variable système pour PCS car Oracle Integration Generation 2 PCS aura désormais une nouvelle URL.
  7. Redéployez les applications Visual Builder.
Pour mettre à jour les applications de processus appelant des applications Web Visual Builder en tant qu'interface utilisateur externe, procédez comme suit :
  1. Ouvrez l'application Process et accédez à Formulaires.
  2. Ouvrez le formulaire d'interface utilisateur externe et utilisez l'URL d'application Visual Builder en phase intermédiaire ou active, par exemple https://oicvb-vb-axkbv4jfb37h.builder.toronto-1.ocp.oraclecloud.com/ic/builder/rt/ExternalUI_1_0/1.0/webApps/webapp/.
  3. Publiez et activez l'application.
  4. Dans l'espace de travail, ouvrez la tâche à l'aide du formulaire d'interface utilisateur externe. La page Visual Builder est désormais disponible.
Remarque

  • Après avoir mis à jour les applications Visual Builder en suivant les étapes ci-dessus, vérifiez que les appels de Visual Builder vers Process fonctionnent correctement.
  • La réalisation des étapes préalables à la mise à niveau pour mettre à jour les applications Visual Builder garantit les points suivants :
    • Vérification de la connectivité Visual Builder à Process avant la mise à niveau réelle, ce qui évite les temps d'arrêt après la mise à niveau.
    • Une fois que vous avez mis à jour Visual Builder pour utiliser le nouveau nom d'hôte et la nouvelle stratégie d'autorisation, vous n'avez pas besoin de la rétablir.
  • En cas d'échec de la mise à jour de Visual Builder : annulez les modifications de configuration et soumettez une demande de service sur My Oracle Support pour éviter une interruption prolongée.
  • Si vous n'effectuez aucune action avant la mise à niveau : vous devrez effectuer les étapes de mise à jour des applications Visual Builder après la mise à niveau, ce qui entraînera un temps d'inactivité. Il est fortement recommandé d'effectuer ces étapes avant la mise à niveau.
Remarque

Les appels de PCS vers des objets Visual Builder doivent utiliser des connexions REST configurées avec la stratégie de sécurité Basic Auth uniquement.

Autres applications front-end

Si vous utilisez d'autres applications front-end avec des API de processus, vous devez les mettre à jour pour utiliser le nouveau nom d'hôte. Si vous ne mettez pas à jour le nom d'hôte, vous risquez de rencontrer des erreurs de réacheminement HTTP.

Oracle Content Management

Si vous utilisez Process intégré à Oracle Content Management (OCM), vous devez mettre à jour le nom d'hôte de Process Automation dans les paramètres d'intégration d'OCM. Avec la modification ci-dessous, l'intégration entre OCM et Process fonctionnera jusqu'à ce qu'OCM atteigne sa fin de vie.

  • Si le processus est utilisé uniquement pour prendre en charge OCM : contactez l'équipe chargée de votre compte pour reprogrammer votre mise à niveau jusqu'à ce que vous ayez quitté OCM (doit être effectué d'ici décembre 2025).
  • Sinon : votre instance sera mise à niveau à l'aide de la mise à niveau progressive pour Process. L'intégration entre OCM et Process fonctionnera jusqu'à ce que OCM atteigne sa fin de vie.

Processus

  • Il est recommandé de mettre en pause ou de limiter le nouveau travail de développement jusqu'à ce qu'il soit mis à niveau.
  • Pour que l'enregistrement de service fonctionne comme prévu, assurez-vous que le déclencheur REST utilise la stratégie de sécurité OAuth 2.0 et Authentification de base.
  • Si des intégrations sont appelées par des processus, procédez comme suit :
    • Avant la mise à niveau : activez OAuth et l'authentification de base pour ces intégrations. La stratégie de sécurité OAuth et Authentification de base doit être activée pour le déclencheur REST de ces intégrations. S'il utilise uniquement OAuth ou uniquement l'authentification de base, mettez-le à jour pour utiliser OAuth et l'authentification de base afin d'éviter les échecs après la mise à niveau.
      Remarque

      Vous devez utiliser une connexion de déclencheur REST de type déclencheur uniquement.
    • Après la mise à niveau : vérifiez que les intégrations appelées par les processus utilisent OAuth et l'authentification de base comme stratégie de sécurité.
  • Si des processus dynamiques sur Oracle Integration Generation 2 appellent des intégrations, utilisez des connecteurs REST pour déployer ces processus sur Oracle Integration 3. Si vous utilisez des adaptateurs natifs au lieu de connecteurs REST pour déployer de tels processus sur Oracle Integration 3, cela peut entraîner des échecs.

Tâches postérieures à la mise à niveau

Découvrez ce qui se passe une fois la mise à niveau de la phase 1 terminée et assurez-vous d'effectuer les tâches postérieures à la mise à niveau.

Remarque

Les informations suivantes s'appliquent uniquement aux clients qui ont été migrés à l'aide de la mise à niveau progressive pour Process.

Une fois la mise à niveau de la phase 1 terminée, voici ce qui se passe et ce que vous devez faire :

Oracle Integration Generation 2

Remarque

Vous pouvez toujours accéder à votre environnement Oracle Integration Generation 2 après la mise à niveau.

Par exemple : https://<original instance ID>-process.integration.ocp.oraclecloud.com/ic/home/.

Toutes les transactions existantes (en cours de traitement et terminées) seront disponibles.

  • Sur votre instance Oracle Integration Generation 2, seule la fonctionnalité Process est disponible ; tous les autres composants ont été mis à niveau.
  • A partir de ce stade, aucun nouveau travail de développement ne doit être effectué dans Oracle Integration Generation 2.
  • L'instance Oracle Integration Generation 2 ne sera plus disponible dans la console Oracle Cloud. Par conséquent, les actions de gestion (telles que le démarrage/l'arrêt) pour votre instance Oracle Integration Generation 2 ne sont plus possibles.
  • Vous pouvez repérer les intégrations dans Oracle Integration 3 si vous devez appliquer des correctifs dans vos processus existants.
  • Les appels de processus dynamique utilisant l'activité d'intégration ne fonctionneront pas après la mise à niveau. Vous devrez donc mettre à jour vos processus dynamiques afin d'utiliser une connexion d'activité de service pour appeler vos intégrations. Si vous ne le faites pas avant la mise à niveau, vous risquez de subir une interruption de service après la mise à niveau.
  • Si vous appelez des processus à l'aide de leurs adresses SOAP, vous devez noter que les adresses de service Web n'afficheront pas l'adresse correcte dans le concepteur. Toutefois, au cours de l'exécution, les appels sont redirigés correctement par l'instance Oracle Integration 3. Pour mettre à jour manuellement les clients afin d'utiliser l'adresse WSDL appropriée, procédez comme suit :
    1. Dans l'instance Oracle Integration Generation 2, dans le panneau de navigation, cliquez sur Processus, puis sur Traiter les applications.

      La page Process Applications s'affiche.

    2. Sur la page Traiter les applications, cliquez sur Activer.

      La page Activer apparaît et répertorie les applications que vous pouvez gérer.

    3. Cliquez sur Actions Icône Actions, puis sélectionnez Services Web.

      La boîte de dialogue Gérer les services Web apparaît.

    4. Dans la boîte de dialogue Gérer les services Web, l'onglet Exposé affiche l'URL des services Web que l'application active présente. Mettez à jour le nom d'hôte dans cette URL de service Web manuellement pour utiliser le nouveau nom d'hôte.

Oracle Integration 3

  • Le processus ne sera pas activé dans Oracle Integration 3 après la mise à niveau.
  • Les intégrations qui appellent Process ont été migrées et activées.
  • Vous pourrez repérer de nouveaux processus sur Oracle Integration Generation 2 si vous devez appliquer des correctifs aux solutions existantes.
  • Les intégrations programmées avec un processus appelant une action de processus ne sont pas démarrées automatiquement après la mise à niveau progressive. Vous devez démarrer ces intégrations de programmation après la mise à niveau progressive.

Visual Builder et autres applications frontales

  • Si vous avez des applications Visual Builder qui appellent Process et que vous n'avez pas effectué les étapes préalables à la mise à niveau, vous devez les terminer maintenant.
  • Les processus Oracle Integration Generation 2 ne seront plus repérables ni disponibles pour les appels dans des chaînes d'actions. Vous devez utiliser le processus Oracle Integration 3 pour toutes les nouvelles initiatives de développement Visual Builder.

Validation

  • Effectuez des contrôles de validité pour valider la connectivité entre les intégrations, les applications frontales et les processus.
  • Effectuer des tests fonctionnels sur votre environnement Process.

Reprendre les opérations

  • Une fois la validation terminée, les utilisateurs professionnels peuvent reprendre la création d'instances de processus et l'exécution de tâches.