Mise à niveau vers Oracle Integration 3 : Phase 2

Lorsqu'elle est activée, une instance de processus est automatiquement provisionnée avec l'instance Oracle Integration. Dans ce cas, les deux services sont associés l'un à l'autre et sont répertoriés dans la page Services associés de l'autre dans la console Oracle Cloud.

Configurer des politiques IAM pour gérer l'instance de processus

Pour activer le processus avec Oracle Integration, vous devez créer des politiques Oracle Cloud Infrastructure Identity and Access Management (IAM) qui permettent aux administrateurs d'Oracle Integration appartenant à un groupe IAM spécifié de gérer l'instance de processus.

Configurer les politiques IAM suivantes pour le processus :

Voir À propos des politiques IAM pour l'automatisation des processus et Créer une politique IAM dans un domaine d'identité dans Administration d'Oracle Cloud Infrastructure Process Automation.

Pour plus d'informations sur les politiques IAM pour Oracle Integration, voir À propos des politiques IAM pour Oracle Integration et Créer une politique IAM dans un domaine d'identité pour Oracle Integration.

Activer le processus

Pour activer une instance de processus avec une instance Oracle Integration :

1. Ouvrez le menu de navigation et cliquez sur Services de développement. Sous Intégration d'applications, cliquez sur Integration.
2. Dans la liste déroulante Compartiment, sélectionnez le compartiment dans lequel vous voulez provisionner et activer une instance de processus avec une instance Oracle Integration. La page est actualisée pour afficher toutes les instances de service existantes du compartiment sélectionné.
3. Sélectionnez une instance existante ou créez une instance Oracle Integration et sélectionnez-la. La page des détails de l'instance Integration s'ouvre.
4. Cliquez sur le lien Activer pour le processus dans l'onglet Informations sur l'instance Integration.
5. Lorsque vous y êtes invité, cliquez sur Activer pour confirmer que vous voulez activer le processus. Notez ce qui suit :
   • L'icône Oracle Integration devient orange et son statut passe à Mise à jour.
   • L'activation peut prendre plusieurs minutes.
   • Une fois l'opération terminée, c'est-à-dire lorsqu'une instance de processus est activée et provisionnée avec l'instance Oracle Integration, l'icône Oracle Integration redevient verte avec le statut Actif et le statut Processus est Activé.
6. Pour naviguer jusqu'à l'instance de processus qui vient d'être créée, cliquez sur Services associés sous Ressources.
7. Sélectionnez l'instance Process et consultez ses détails.

Affecter des rôles d'application IDCS pour gérer l'accès

Après avoir activé une instance de processus, affectez des rôles d'application IDCS prédéfinis aux utilisateurs afin qu'ils puissent utiliser les fonctions de l'instance de processus.

En cours, il existe deux rôles d'application IDCS prédéfinis : ServiceDeveloper et ServiceAdministrator. Ces rôles doivent être affectés à des utilisateurs ou à des groupes dans l'application d'instance de service de processus à partir de la console d'administration d'Oracle Identity Cloud Service (IDCS).

Il est recommandé d'affecter ces rôles à des groupes plutôt qu'à des utilisateurs individuels. Par exemple, affectez le rôle d'application IDCS ServiceDeveloper à un groupe à la fois dans les applications Oracle Integration et dans les applications d'instance de service Process à partir de la console d'administration d'Oracle Identity Cloud Service. De cette façon, il sera plus facile de gérer l'accès des utilisateurs, car tout utilisateur membre du groupe peut accéder à Oracle Integration et à la conception des processus.

1. Déterminez les applications à migrer.

   Vous voudrez peut-être profiter de cette occasion pour nettoyer les applications inutiles. Déterminez si vous souhaitez migrer uniquement les applications qui se trouvent dans votre environnement de production.

   Si vous voulez migrer des applications individuelles, prenez note des applications que vous voulez migrer et de leurs dépendances.

2. Migrez vos applications à l'aide de l'une des méthodes suivantes :
   • Migrer toutes les applications en masse
     1. Dans la console Oracle Cloud, créez un seau de stockage d'objets. Voir Création d'un seau de stockage d'objets.

        L'URL du seau de stockage dont vous aurez besoin à l'étape suivante est dans le format suivant :

        https://swiftobjectstorage.region.oraclecloud.com/v1/namespace/bucket

        Où :

        • region est l'identificateur de votre centre de données Oracle Cloud Infrastructure (OCI).
        • namespace est la location où vous avez créé votre seau.
        • bucket est le nom de votre seau.
     2. Faites une demande POST à votre instance Oracle Integration Génération 2 pour exporter vos applications :

        curl -X POST https://Generation2_hostname/ic/api/process/v1/exportArtifactsInternal

        Avec les données utiles suivantes :

        {
            "jobId": "enter_a_descriptive_ID",
            "storageInfo": {
                "storageUrl": "Swift_storage_bucket_URL",
                "storageUser": "OCI_Console_user",
                "storagePassword": "OCI_Console_user_password"
            }
        }

        Vous saurez que la tâche d'exportation est terminée lorsque vous verrez le fichier process_status.json dans votre seau. Ce fichier contient le statut de la tâche, son pourcentage d'achèvement et, en cas d'échec, le message d'erreur. Vous devez également voir le contenu suivant dans votre seau :

        • Process/project folder—Contient toutes vos applications de processus.
        • Process/dmn folder—Contient tous vos modèles de décision.
     3. Une fois les applications exportées dans votre seau, effectuez une demande POST vers votre instance Oracle Integration 3 pour migrer vos applications :

        curl -X POST https://Integration3_hostname/process/api/v1/oic-migration/jobs/

        Avec votre ID locataire :

        x-tenant-id: tenant_OCID

        Et vos informations de seau :

        {
            "bucketInfo": {
                "region": "region",
                "namespace": "namespace",
                "bucket": "bucket"
            }
        }

        Voir Sécurité, authentification et autorisation dans API de développement pour Oracle Cloud Infrastructure Process Automation.

     4. Attendez la fin de la tâche de migration. Pour vérifier le statut de la tâche de migration :

        curl http://localhost:8080/process/internal-api/v1/oic-migration/jobs/job_ID

   • Migrer des applications individuelles
     1. Exportez les applications de processus Oracle Integration Génération 2.

        Dans l'instance Oracle Integration Génération 2 qui inclut les applications à migrer, exportez chaque application à migrer. Voir Exporter une application dans Utilisation de processus dans Oracle Integration Génération 2.

     2. Importez les applications de processus dans le processus Oracle Integration 3.

        Dans le processus Oracle Integration 3, importez les applications de processus Oracle Integration Génération 2. Voir Importer une application dans Utilisation d'Oracle Cloud Infrastructure Process Automation.

        Le processus Oracle Integration 3 convertit les applications de processus existantes vers la dernière version du produit.

3. Vérifiez le rapport de migration.

   Une fois l'importation et la conversion terminées, vous verrez un rapport de migration indiquant ce qui a été importé avec succès, ce qui nécessite un travail supplémentaire et tous les éléments qui n'ont pas pu être migrés. Cela vous donne une idée des problèmes de migration que vous devrez gérer.

   Vous pouvez vous référer au rapport de migration initial dans le menu principal. Voir Importer une application dans Utilisation d'Oracle Cloud Infrastructure Process Automation.

Valider et activer les applications de traitement importées

Pour valider et activer vos applications de traitement, procédez comme suit :

1. Validez chaque application et corrigez les erreurs et les avertissements.

   Validez chaque application à partir du concepteur en cliquant sur et en sélectionnant Valider dans le menu.

   Pour résoudre les problèmes de validation, voir Incidence de la mise à niveau sur les fonctions du processus.

2. Activez l'application.

   Après avoir résolu toutes les erreurs de validation, vous pouvez activer votre application. Voir Activer les applications dans Utilisation d'Oracle Cloud Infrastructure Process Automation.

Mapper des utilisateurs et des groupes aux nouveaux rôles d'application

Les rôles d'application ont considérablement changé dans Oracle Integration 3. Les rôles ProcessOwner, AnalyticsViewer et ProcessReviewer sont désormais définis explicitement pour chaque application, ce qui vous permet de contrôler leurs membres et leurs autorisations.

Le tableau suivant montre comment les rôles Oracle Integration Génération 2 sont mappés aux rôles de processus Oracle Integration 3.

Les nouveaux rôles sont disponibles après la migration, mais vous devez leur ajouter des membres (utilisateurs et groupes). Vous devrez probablement référencer votre environnement Oracle Integration Génération 2 pour voir quels membres doivent être affectés à chaque rôle.

Si le processus Oracle Integration 3 partage le même domaine d'identité que votre instance Oracle Integration Génération 2 existante, les utilisateurs et les groupes existants doivent être disponibles pour sélection.

Vous pouvez ajouter des membres avant l'activation dans le concepteur ou après l'activation dans l'espace de travail.

• Utiliser des rôles dans Designer
• Gérer les rôles dans l'espace de travail

Pour plus d'informations sur le processus Oracle Integration 3, voir Configurer des rôles pour les applications de traitement dans Utilisation d'Oracle Cloud Infrastructure Process Automation.

Effectuez les étapes qui s'appliquent à votre mise en oeuvre :

• Processus d'appel des intégrations
• Intégrations appelées par processus
• Applications Visual Builder
• Clients non intégrés à Oracle
• Vérification

Processus d'appel des intégrations

Les intégrations appelant des processus dans Oracle Integration 3 devront être mises à jour pour utiliser la nouvelle action Processus. Pour ce faire, créez une nouvelle version majeure de votre intégration, ajoutez la nouvelle action de processus et référencez le processus à démarrer à partir d'Oracle Integration 3. Supprimez l'action de traitement existante et activez votre intégration.

Intégrations appelées par processus

Le processus Oracle Integration 3 prend en charge la communication basée sur REST uniquement au moyen de l'inscription au service. Cela signifie que la connectivité aux intégrations basées sur SOAP ne sera plus possible.

Si vous avez des intégrations qui utilisent un déclencheur SOAP et que celles-ci sont appelées par des processus dans Oracle Integration Génération 2, vous devrez effectuer des étapes supplémentaires pour présenter une interface REST au processus Oracle Integration 3. Cela peut signifier que vous devez effectuer une des opérations suivantes :

• Créer des intégrations d'encapsuleur basées sur REST.

  ou

• Remplacez le déclencheur existant de SOAP par REST.

Vérifiez toutes les connexions d'intégration dans les applications de processus migrées. Actualisez les métadonnées de connexion, en vous assurant que la dernière définition est ajoutée à votre application de traitement. Mettez à jour tous les mappages de données non valides et redéployez votre processus au moyen d'une nouvelle version.

Applications Visual Builder

Les API de développement pour les applications de processus et de décision changent après la mise à niveau. Par conséquent, vous devez mettre à jour toutes les applications Visual Builder qui interagissent avec elles, en remplaçant tous les modèles d'intégration obsolètes. Voir Utiliser les processus d'affaires dans Création d'applications réactives à l'aide de Visual Builder Studio.

Pour ce faire, vous devrez peut-être évaluer l'utilisation courante du traitement. Examinez chacune de vos applications Visual Builder et déterminez si elles effectuent des appels vers des API de développement pour le traitement au moyen de chaînes d'action, d'appels directs ou de composants de processus intégrables (également appelés CCA).

Si vos applications appellent des points d'extrémité de processus, procédez comme suit :

1. Processus de connexion au service Oracle Integration 3.

   Créez une connexion dorsale au processus Oracle Integration 3. Ce serveur dorsal sera utilisé pour établir une connexion à la nouvelle instance de processus Oracle Integration 3. Voir Se connecter aux API de développement pour l'automatisation des processus dans Création d'applications réactives à l'aide de Visual Builder Studio.

2. Créez une nouvelle version de vos applications.

   Oracle recommande de créer une nouvelle version de vos applications Visual Builder pour mettre en oeuvre les modifications requises. Voir Comment créer des versions d'une application dans Développement d'applications avec Oracle Visual Builder.

3. Chaînes d'actions

   Si votre application utilise des chaînes d'actions pour démarrer un processus ou effectuer une action sur une tâche, vous devez remplacer chacune d'entre elles par une connexion de service basée sur REST. Répétez ces étapes pour chaque tâche de chaîne d'actions de processus.

   Déclenchement d'un processus

   Remplacez la chaîne d'actions Démarrer le processus par une connexion de service basée sur le catalogue.

   1. Accédez à Oracle Integration Génération 2 et prenez note du processus que vous appelez. Vous pouvez le déterminer à partir de l'étape de traitement de la chaîne d'actions ou de l'onglet Processus dans le menu de l'application à gauche.
   2. Créez une connexion de service basée sur un catalogue à votre processus dans la nouvelle version de votre application Visual Builder. Voir Créer une connexion au service à partir d'un catalogue d'automatisation de processus OCI dans Création d'applications réactives avec Visual Builder Studio. Assurez-vous de sélectionner le même processus que celui auquel vous faisiez référence auparavant.
      Note
      
      Votre processus doit déjà être activé.
   3. Créez un type basé sur le point d'extrémité du processus ci-dessus. Voir Créer un type à partir d'un point d'extrémité dans Développement d'applications avec Oracle Visual Builder.
   4. Créez une variable basée sur le type ci-dessus. Voir Créer des variables dans Développement d'applications avec Oracle Visual Builder.
   5. Accédez à vos chaînes d'actions et effectuez les actions suivantes :
      1. Faites glisser une action Assign Variable au-dessus de l'action Start Process courante.
      2. Mappez les champs de données et les paramètres d'entrée requis pour appeler votre traitement. Par exemple, voir Intégrer Oracle Process Automation à Visual Builder.
      3. Faites glisser l'action REST Appeler au-dessus de l'action Démarrer le processus courante.
      4. Configurez l'action REST Appeler en sélectionnant le point d'extrémité POST/Instances.
      5. Mappez la variable ci-dessus au corps de la demande de l'action REST.
      6. Supprimez le Start Process Acton existant.
   6. Testez l'appel et assurez-vous que votre processus est appelé avec succès dans le processus Oracle Integration 3.

   Instance de processus GET

   Remplacez la chaîne d'actions Get Process Instance par une connexion de service basée sur le catalogue.

   Si vous avez créé une connexion de service basée sur un catalogue à votre processus en suivant les étapes ci-dessus, vous remarquerez que le point d'extrémité Obtenir l'instance de processus est maintenant disponible dans votre connexion de service.

   Remplacez l'action de processus Obtenir une instance de processus existante par une action REST d'appel configurée avec le point d'extrémité ci-dessus, puis remappez le champ instanceID.

   Note
   
   Les valeurs des données utiles de la réponse ici ont été modifiées.

   Autres actions de processus

   Effectuez les étapes suivantes pour toutes les autres actions de processus telles que Perform Task et Get Task :

   1. Naviguez jusqu'à Oracle Integration Génération 2 et prenez note des actions de processus que vous utilisez.
   2. Remplacez ces actions par des connexions de service basées sur un point d'extrémité.

      Le tableau suivant mappe chacune de ces actions à l'API Developer correspondante pour le processus.

      Action du générateur visuel	API de développeur pour le processus	Description
      Exécuter la tâche	POST /process/api/v1/tasks/{id}/complete	Actions d'approbation telles que Approuver, Rejeter, etc.
      Exécuter la tâche	PUT /process/api/v1/tasks/{id}	Mettez à jour la priorité de la tâche, les données utiles, le titre, etc.
      Exécuter la tâche	PUT /process/api/v1/tasks/{id}/payload	Mettez à jour les données utiles de la tâche.
      Exécuter la tâche	POST /process/api/v1/tasks/{id}/claim	Réclamer une tâche.
      Exécuter la tâche	POST /process/api/v1/tasks/{id}/release	Lancer une tâche.
      Exécuter la tâche	POST /process/api/v1/tasks/{id}/request-for-info	Demande d'informations sur une tâche.
      Exécuter la tâche	POST /process/api/v1/tasks/{id}/submit-info	Soumettez les informations demandées pour une tâche.
      Exécuter la tâche	POST /process/api/v1/tasks/{id}/reassign	réaffecter une tâche.
      Obtenir la collecte de tâches	OBTENEZ /process/api/v1/tasks
      Obtenir une tâche	OBTENIR /process/api/v1/tasks/{id}
      Obtenir la collection de processus déployée	OBTENEZ /process/api/v1/instances
      Obtenir la collection d'instances de processus	POST /process/api/v1/instances

4. Appels directs

   Les API de développement pour les applications de processus et de décision changent après la mise à niveau. Par conséquent, vous devez mettre à jour toutes les connexions directes au service. Voir API de développement pour Oracle Cloud Infrastructure Process Automation.

5. Composants de DPA

   Si vous utilisez des composants CCA de processus Oracle Integration Génération 2, vous devez les remplacer par leur composant de processus Oracle Integration 3 équivalent.

   Nom du composant	CCA d'Oracle Integration Génération 2	Équivalent de processus Oracle Integration 3
   Liste des tâches	oj-pcs-task-list	oj-opac-tâche-liste
   Détails de la tâche	oj-pcs-task-detail	oj-opac-tâche-détail
   Liste d'applications	oj-pcs-app-liste	oj-opac-applis
   Formulaire de départ	oj-pcs-start-forme	oj-opac-formulaire de démarrage
   Liste DP	oj-pcs-dplist	oj-opac-instance-list (Affiche à la fois le processus structuré et le processus dynamique)
   Visualisation	oj-pcs-visualisation	oj-opac-analytics (Impossible d'enregistrer les visualisations)

Clients non intégrés à Oracle

Si vous appelez des applications de processus en dehors d'Oracle Integration (par exemple, votre propre application personnalisée), vous devez mettre à jour les points d'extrémité REST et les politiques d'autorisation utilisées pour appeler la nouvelle instance de processus Oracle Integration 3 configurée. Pour plus d'informations sur les nouveaux points d'extrémité d'API et les politiques d'autorisation prises en charge, voir API de développement pour Oracle Cloud Infrastructure Process Automation.

Vérification

Effectuez un test d'intégration du système pour valider votre travail.

Testez la connectivité au nouvel environnement de processus. Ce test doit se concentrer sur la validation des modèles d'interaction suivants en fonction de votre utilisation :

• Processus Oracle Integration 3 - Oracle Integration 3 - Intégrations
• Oracle Integration 3 - Intégrations à Oracle Integration 3 - Processus
• Visual Builder - Applications au processus Oracle Integration 3 - Processus

Vous devez déployer la nouvelle version de toutes les ressources Oracle Integration 3, telles que les applications de processus, les applications Visual Builder et les intégrations dans l'environnement supérieur pour validation.

Effectuez les étapes suivantes :

1. Activez et déployez les modifications du client pour vous assurer que toutes les nouvelles demandes basées sur le système sont envoyées au processus Oracle Integration 3, comme décrit précédemment.
2. Communiquez la nouvelle URL de l'espace de travail de processus Oracle Integration 3 avec les utilisateurs et assurez-vous que les utilisateurs :
   • Ajoutez un signet à l'espace de travail de processus Oracle Integration 3.
   • Créez de nouveaux processus uniquement dans le processus Oracle Integration 3.
   • Effectuez les nouvelles tâches dans le processus Oracle Integration 3.
3. Mettez hors service les applications Oracle Integration Génération 2 afin qu'aucun nouveau processus ne puisse être créé, mais que les processus existants puissent être terminés. Voir Gérer les applications actives dans Utilisation de processus dans Oracle Integration 2.

Pendant ce temps :

• Les nouvelles instances de processus seront desservies par le processus Oracle Integration 3.
• Les instances de processus existantes continueront de s'exécuter sur le processus Oracle Integration Génération 2 jusqu'à ce qu'elles soient terminées.

Pendant cette période, les utilisateurs Process doivent :

• Travaillez principalement à partir de l'espace de travail de processus Oracle Integration 3.
• Consultez occasionnellement la liste Mes tâches d'Oracle Integration Génération 2.
• Faites confiance aux approbations par courriel autant que possible, car les liens dans les courriels les mèneront au bon endroit pour effectuer la tâche.

La période de coexistence dure jusqu'à ce que toutes les transactions créées dans Oracle Integration Génération 2 soient terminées. Vous devriez chercher activement à raccourcir la durée de cette période autant que possible. Voici quelques directives :

• Empêchez la création de nouvelles transactions dans Oracle Integration Génération 2 à l'aide de la fonctionnalité de mise hors service. Cela s'applique à tous les processus structurés qui ne contiennent pas d'activités de réception. La fonctionnalité de mise hors service empêche la création de nouvelles instances, mais permet également la fin des transactions existantes. Voir Gérer les applications actives dans Utilisation de processus dans Oracle Integration 2.
• Veillez à accélérer activement la réalisation des instances Oracle Integration Génération 2, autant que possible, en faisant un suivi auprès des utilisateurs afin qu'ils prennent les mesures qui s'imposent jusqu'à leur achèvement. Vous pouvez voir le nombre de transactions ouvertes par processus et l'exécutant pour les tâches associées à l'aide d'un nouveau rapport disponible si vous naviguez jusqu'à Processus, Administration, puis Rapport de migration.
• Pour les processus de très longue durée, les instances qui ne peuvent pas être terminées dans plusieurs mois explorent les options suivantes :
  • Recréez l'instance dans le processus Oracle Integration 3 et utilisez la fonctionnalité Modifier le flux pour mettre à jour les données utiles et déplacer l'instance de processus vers l'action courante (où elle se trouve actuellement dans le processus Oracle Integration Génération 2). Une fois cela fait, l'instance Oracle Integration Génération 2 existante peut être arrêtée. Voir Modifier le flux d'un processus dans Utilisation d'Oracle Cloud Infrastructure Process Automation.
  • Modifiez l'application migrée afin qu'elle puisse être lancée à l'aide de l'état le plus récent de l'instance de processus Oracle Integration Génération 2 existante.

Vous pouvez suivre les transactions de traitement restantes d'Oracle Integration Génération 2 en cliquant sur Mes tâches, puis en sélectionnant Processus dans votre instance Oracle Integration Génération 2. Vous devez vous connecter avec un utilisateur doté du rôle d'administrateur de service.

Vous pouvez déplacer vos applications de processus vers Oracle Integration 3 avant le 31 décembre 2026 en activant Process dans Oracle Integration 3. Voir Activer le processus avec Oracle Integration 3. Pour plus d'informations sur l'exportation ou l'importation des artefacts de conception d'application de processus, voir Migrer tous les points d'extrémité REST des applications.

Enregistrez les données d'exécution du processus Oracle Integration Génération 2. Cette étape est importante pour vous assurer de ne pas perdre l'historique des transactions terminées. Vous devez effectuer cette mise à niveau avant. Voir Archivage et épuration des données d'automatisation de processus dans Oracle Integration.

Dans le cadre de ces étapes, vous allez configurer le service Oracle Storage et programmer les instances pour archiver et épurer. Prenez note des points suivants :

• Les informations archivées seront disponibles dans le seau de stockage d'objets configuré.
• Les fichiers joints ne sont pas inclus dans les fichiers d'archive. Vous devez les exporter manuellement. Voir Extraire un attachement de processus en tant que flux dans API REST pour Oracle Integration 2.