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 sur la page des services associés de l'autre dans la console Oracle Cloud.

Configuration de stratégies IAM pour gérer une instance de processus

Pour activer Process avec Oracle Integration, vous devez créer des stratégies Oracle Cloud Infrastructure Identity and Access Management (IAM) qui autorisent les administrateurs Oracle Integration appartenant à un groupe IAM indiqué à gérer l'instance de processus.

Configurez les stratégies IAM suivantes pour Process :

Reportez-vous à A propos des stratégies IAM pour Process Automation et à Création d'une stratégie IAM dans un domaine d'identité dans Administration d'Oracle Cloud Infrastructure Process Automation.

Pour plus d'informations sur les stratégies IAM pour Oracle Integration, reportez-vous à A propos des stratégies IAM pour Oracle Integration et à Création d'une stratégie IAM dans un domaine d'identité pour Oracle Integration.

Activer le processus

Pour activer une instance de processus avec une instance Oracle Integration, procédez comme suit :

1. Ouvrez le menu de navigation et cliquez sur Services de développeur. Sous Intégration d'application, cliquez sur Intégration.
2. Dans la liste déroulante Compartiment, sélectionnez le compartiment dans lequel provisionner et activer une instance de processus avec une instance Oracle Integration. La page est actualisée afin d'afficher les instances de service existantes dans le compartiment sélectionné.
3. Choisissez une instance existante ou créez une instance Oracle Integration et sélectionnez-la. La page Détails de l'instance d'intégration s'ouvre.
4. Cliquez sur le lien Activer pour le processus dans l'onglet Informations sur l'instance d'intégration.
5. Lorsque vous y êtes invité, cliquez sur Activer pour confirmer l'activation du processus. Prenez note des points suivants :
   • L'icône Oracle Integration devient orange et son statut devient 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 Process indique Activé.
6. Pour accéder à l'instance de processus qui vient d'être créée, cliquez sur Services associés sous Ressources.
7. Sélectionnez l'instance de processus et affichez ses détails.

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

Une fois le processus activé, les utilisateurs existants dotés du rôle ServiceDeveloper ont accès au concepteur de processus et les utilisateurs existants dotés du rôle ServiceAdministrator peuvent effectuer des tâches d'administration dans l'espace de travail.

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 souhaitez migrer des applications individuelles, notez les applications à migrer et les dépendances dont elles disposent.

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 bucket Object Storage. Reportez-vous à Création d'un bucket Object Storage.

        L'URL de bucket de stockage dont vous aurez besoin à l'étape suivante est au 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 dans laquelle vous avez créé le bucket.
        • bucket est le nom du bucket.
     2. Effectuez une demande POST à l'instance Oracle Integration Generation 2 pour exporter vos applications :

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

        Avec la charge utile suivante :

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

        Le travail d'export est terminé lorsque le fichier process_status.json apparaît dans le bucket. Ce fichier contient le statut du travail, son pourcentage d'achèvement et, en cas d'échec, le message d'erreur. Le contenu suivant doit également apparaître dans le bucket :

        • 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 le bucket, envoyez une demande POST à l'instance Oracle Integration 3 pour migrer vos applications :

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

        Avec votre ID de locataire :

        x-tenant-id: tenant_OCID

        Et vos informations de bucket :

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

        Reportez-vous à Sécurité, authentification et autorisation dans API de développeur pour Oracle Cloud Infrastructure Process Automation.

     4. Attendez que le travail de migration se termine. Pour vérifier le statut du travail de migration, procédez comme suit :

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

   • Migrer des applications individuelles
     1. Exportez les applications de traitement Oracle Integration Generation 2.

        Dans l'instance Oracle Integration Generation 2 qui inclut les applications à migrer, exportez chaque application à migrer. Reportez-vous à Export d'une application dans Utilisation de processus dans Oracle Integration Generation 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 Generation 2. Reportez-vous à Import d'une application dans Utilisation d'Oracle Cloud Infrastructure Process Automation.

        Oracle Integration 3 Process convertit les anciennes applications de processus en la dernière version du produit.

3. Consultez 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 reporter au rapport de migration d'origine dans le menu principal. Reportez-vous à Import d'une application dans Utilisation d'Oracle Cloud Infrastructure Process Automation.

Valider et activer les applications de processus importées

Pour valider et activer vos applications de processus, 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 choisissant Valider dans le menu.

   Pour résoudre les problèmes de validation, reportez-vous à la section How Upgrade Affects Process Features.

2. Activez l'application.

   Une fois toutes les erreurs de validation résolues, vous pouvez activer votre application. Reportez-vous à Activation des applications dans le guide Utilisation d'Oracle Cloud Infrastructure Process Automation.

Mapper des utilisateurs et des groupes avec de 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 droits d'accès.

Le tableau suivant montre comment les rôles Oracle Integration Generation 2 sont mis en correspondance avec les 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 Generation 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 Generation 2 existante, les utilisateurs et les groupes existants doivent être disponibles pour sélection.

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

• Utiliser les rôles dans Designer
• Gérer les rôles dans Workspace

Pour plus d'informations sur le processus Oracle Integration 3, reportez-vous à Configuration de rôles pour les applications de processus dans Utilisation d'Oracle Cloud Infrastructure Process Automation.

• Processus d'appel des intégrations
• Intégrations appelées par processus
• Applications Visual Builder
• Clients non-Oracle-Integration
• 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 de processus. Pour ce faire, créez une 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 processus héritée 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 via l'inscription de service. Cela signifie que la connectivité aux intégrations basées sur SOAP ne sera plus possible.

Si vous disposez d'intégrations qui utilisent un déclencheur SOAP et que ces intégrations sont appelées par des processus dans Oracle Integration Generation 2, vous devrez prendre des mesures supplémentaires pour présenter une interface REST au processus Oracle Integration 3. Cela peut signifier que vous devez effectuer l'une des opérations suivantes :

• Créer des intégrations de wrapper REST.

  ou

• Remplacez le déclencheur existant 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 pour vous assurer que la dernière définition est intégrée à l'application de processus. Mettez à jour les mappings de données non valides et redéployez le processus via une nouvelle version.

Applications Visual Builder

Les API de développeur pour l'application Process et Decision 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 les modèles d'intégration en phase d'abandon. Reportez-vous à Utilisation des processus métier dans le guide Création d'applications réactives avec Visual Builder Studio.

Pour ce faire, vous devrez peut-être évaluer l'utilisation actuelle du processus. Examinez chacune de vos applications Visual Builder et déterminez si elles appellent des API de développeur pour des processus via des chaînes d'actions, des appels directs ou à l'aide de composants de processus incorporables (également appelés CCA).

Si vos applications appellent des adresses de processus, procédez comme suit :

1. Connectez-vous au processus Oracle Integration 3.

   Créez une connexion back-end au processus Oracle Integration 3. Ce back-end sera utilisé pour établir une connexion à la nouvelle instance de processus Oracle Integration 3. Reportez-vous à Connexion aux API de développeur pour l'automatisation des processus dans le guide Création d'applications réactives avec Visual Builder Studio.

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

   Oracle vous recommande de créer une version de vos applications Visual Builder pour implémenter les modifications requises. Reportez-vous à Création de versions d'une application dans le guide 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 devrez 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éclencher un processus

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

   1. Accédez à Oracle Integration Generation 2 et notez le processus que vous appelez. Vous pouvez le déterminer à partir de l'étape du processus de la chaîne d'actions ou de l'onglet des 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. Reportez-vous à Création d'une connexion de service à partir d'un catalogue OCI Process Automation dans Création d'applications adaptatives avec Visual Builder Studio. Veillez à sélectionner le même processus que celui auquel vous faisiez référence auparavant.
      Remarque
      
      Votre processus doit déjà être activé.
   3. Créez un type basé sur l'adresse du processus ci-dessus. Reportez-vous à Création d'un type à partir d'une adresse dans le guide Développement d'applications avec Oracle Visual Builder.
   4. Créez une variable basée sur le type ci-dessus. Reportez-vous à Création de variables dans le guide 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 actuelle.
      2. Mettez en correspondance les champs de données et les paramètres d'entrée requis pour appeler le processus.
      3. Faites glisser l'action REST d'appel au-dessus de l'action de processus de démarrage actuelle.
      4. Configurez l'action REST d'appel en sélectionnant l'adresse POST/Instances.
      5. Mettez en correspondance la variable ci-dessus avec le corps de la demande de l'action REST.
      6. Supprimez l'activité Start Process Acton héritée.
   6. Testez l'appel et assurez-vous que le 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 pour votre processus en suivant les étapes ci-dessus, vous remarquerez que l'adresse d'obtention d'instance de processus est désormais disponible dans votre connexion de service.

   Remplacez l'action de processus d'obtention d'instance de processus héritée par une action REST d'appel configurée avec l'adresse ci-dessus, puis remappez le champ instanceID.

   Remarque
   
   Les valeurs de charge utile de réponse ont changé ici.

   Autres actions de processus

   Effectuez les étapes suivantes pour toutes les autres actions de processus telles que Effectuer une tâche et Obtenir une tâche :

   1. Accédez à Oracle Integration Generation 2 et notez les actions de processus que vous utilisez.
   2. Remplacez ces actions par des connexions de service basées sur l'adresse.

      Le tableau suivant met en correspondance chacune de ces actions avec l'API Developer correspondante pour Process.

      Action Visual Builder	API 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, la charge utile, le titre, etc.
      Exécuter la tâche	PUT /process/api/v1/tasks/{id}/payload	Mettez à jour la charge utile de tâche.
      Exécuter la tâche	POST /process/api/v1/tasks/{id}/claim	Demander une tâche
      Exécuter la tâche	POST /process/api/v1/tasks/{id}/release	Libérez 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 collection de tâches	Obtenir /process/api/v1/tasks
      Obtenir la tâche	GET /process/api/v1/tasks/{id}
      Obtenir la collection de processus déployés	Obtenir /process/api/v1/instances
      Obtenir la collection d'instances de processus	POST /process/api/v1/instances

4. Appels directs

   Les API de développeur pour l'application Process et Decision changent après la mise à niveau. Vous devez donc mettre à jour toutes les connexions de service directes. Reportez-vous à API de développeur pour Oracle Cloud Infrastructure Process Automation.

5. Composants CCA

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

   Nom du composant	Oracle Integration Generation 2 CCA	Equivalent de processus Oracle Integration 3
   Liste des tâches	oj-pcs-tâche-liste	oj-opac-task-list
   Détails de la tâche	oj-pcs-tâche-détail	oj-opac-tâche-détail
   Liste d'applications	oj-pcs-app-liste	oj-opac-applist
   Formulaire de départ	oj-pcs-start-forme	oj-opac-start-formulaire
   Liste DP	oj-pcs-dplist	oj-opac-instance-list (affiche le processus structuré et le processus dynamique)
   Visualisation	oj-pcs-visualisation	oj-opac-analytics (Impossible d'enregistrer les visualisations)

Clients non-Oracle-Integration

Si vous appelez des applications de processus à partir de l'extérieur d'Oracle Integration (par exemple, votre propre application personnalisée), vous devez mettre à jour les adresses REST et les stratégies d'autorisation utilisées pour appeler la nouvelle instance de processus Oracle Integration 3 configurée. Pour plus d'informations sur les nouvelles adresses d'API et les stratégies d'autorisation prises en charge, reportez-vous à API de développeur pour Oracle Cloud Infrastructure Process Automation.

Vérification

Effectuez un test d'intégration 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 - Processus des applications vers Oracle Integration 3 - Processus

Procédez comme suit :

1. Activez et déployez les modifications client pour vous assurer que toutes les nouvelles demandes pilotées par 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 ces derniers :
   • Marque-page sur l'espace de travail de processus Oracle Integration 3.
   • Créez des processus uniquement dans le processus Oracle Integration 3.
   • Effectuez leurs nouvelles tâches dans le processus Oracle Integration 3.
3. Retirez les applications Oracle Integration Generation 2 afin qu'aucun nouveau processus ne puisse être créé mais que les processus existants soient autorisés à être exécutés. Reportez-vous à Gestion des applications actives dans Utilisation des processus dans Oracle Integration 2.

Pendant cette période :

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

Au cours de cette période, les utilisateurs du processus doivent :

• Travaillez principalement à partir de l'espace de travail de processus Oracle Integration 3.
• Vérifiez parfois la liste Mes tâches d'Oracle Integration Generation 2.
• Faites autant que possible confiance aux approbations par e-mail, car les liens contenus dans les e-mails 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 sur Oracle Integration Generation 2 soient terminées. Vous devriez chercher activement à raccourcir la durée de cette période autant que possible. Voici quelques directives :

• Empêcher la création de nouvelles transactions sur Oracle Integration Generation 2 à l'aide de la fonctionnalité Retire. Cela s'applique à tous les processus structurés qui ne contiennent pas d'activités de réception. La fonctionnalité de retrait empêche la création d'instances, mais permet également aux transactions existantes de se terminer. Reportez-vous à Gestion des applications actives dans Utilisation des processus dans Oracle Integration 2.
• Visez à accélérer le plus possible l'achèvement des instances Oracle Integration Generation 2 en faisant un suivi auprès des utilisateurs pour qu'ils prennent des mesures allant de leur réalisation. Vous pouvez voir le nombre de transactions en cours par processus et la personne affectée pour les tâches associées à l'aide d'un nouveau rapport disponible si vous accédez à Processus, Administration, puis à Rapport de migration.
• Pour les instances dont l'exécution est très longue et qui ne peuvent pas être terminées en plusieurs mois, explorez les options suivantes :
  • Recréez l'instance dans le processus Oracle Integration 3 et utilisez la fonctionnalité Modifier le flux pour mettre à jour la charge utile et déplacer l'instance de processus vers l'action en cours (dans laquelle elle se trouve actuellement dans le processus Oracle Integration Generation 2). Une fois cette opération effectuée, l'instance Oracle Integration Generation 2 existante peut être arrêtée. Reportez-vous à Modification du flux d'un processus dans le guide Utilisation d'Oracle Cloud Infrastructure Process Automation.
  • Modifiez l'application migrée afin qu'elle puisse être lancée à l'aide du dernier état de l'instance de processus Oracle Integration Generation 2 existante.

Vous pouvez suivre les transactions de traitement Oracle Integration Generation 2 restantes en cliquant sur Mes tâches, puis en choisissant Processus dans votre instance Oracle Integration Generation 2. Vous devez vous connecter avec un utilisateur disposant 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. Reportez-vous à Activation de processus avec Oracle Integration 3. Pour plus d'informations sur l'export ou l'import d'artefacts de conception d'application de processus, reportez-vous à Migration de toutes les adresses REST d'application.