Phase 1 : Migration des applications de processus vers OCI Process Automation

Pour plus de détails sur cette recommandation, reportez-vous à FAQ sur la mise à niveau.

1. Créez une instance autonome OCI Process Automation.

   Reportez-vous à Provisionnement d'une instance Process Automation dans le guide Administration d'Oracle Cloud Infrastructure Process Automation.

   Lorsque vous créez l'instance :

   • Sélectionnez un modèle de mesure basé sur un pack d'exécution pour tirer parti de la tarification de niveau gratuit lors de la mise à niveau.
   • L'utilisateur qui crée l'instance autonome OCI Process Automation doit provenir du même domaine d'identité que l'utilisateur qui a créé l'instance Oracle Integration Generation 2.
   • Vous devez créer l'instance autonome OCI Process Automation dans la même location, la même région et, de préférence, le même compartiment que votre instance Oracle Integration Generation 2.

     Si vous n'utilisez pas le même compartiment, assurez-vous que l'utilisateur qui crée l'instance OCI Process Automation dispose des droits d'accès permettant de gérer à la fois l'instance Oracle Integration et l'instance OCI Process Automation.

     Vous gérez ces droits d'accès avec des stratégies IAM.

     Pour Oracle Integration :

     • allow group domain-name/group_name to manage integration-instance in compartment compartment-name
     • allow group domain-name/group_name to manage integration-instance in tenancy

     Par exemple :

     • allow group admin/oci-integration-admins to manage integration-instance in tenancy

     Pour OCI Process Automation :

     • allow group domain-name/group_name to manage process-automation-instance in compartment compartment-name
     • allow group domain-name/group_name to manage process-automation-instance in tenancy

     Par exemple :

     • allow group admin/oci-integration-admins to manage process-automation-instance in tenancy
2. Accorder aux développeurs l'accès à OCI Process Automation.

   Pour vous assurer que vos développeurs peuvent accéder à la nouvelle instance OCI Process Automation provisionnée et travailler sur les tâches suivantes, assurez-vous que le rôle d'application approprié leur est affecté pour accéder à l'instance. Reportez-vous à Affectation de rôles d'application à des groupes dans un domaine d'identité dans Administration d'Oracle Cloud Infrastructure Process Automation.

3. Inscrivez une instance Oracle Integration Generation 2 hors production à des fins de test.

   Si vos applications de processus appellent des intégrations existantes, inscrivez Oracle Integration Generation 2 dans la nouvelle instance OCI Process Automation. Cela permet à votre instance OCI Process Automation de se connecter et de repérer vos intégrations existantes.

   Veillez à utiliser une instance Oracle Integration Generation 2 hors production pour l'inscription de service à cette étape. Assurez-vous que l'inscription de l'instance Oracle Integration Generation 2 sélectionnée n'aura aucun impact négatif sur les processus en production.

   1. Choisissez une instance Oracle Integration Generation 2 hors production à inscrire.
   2. Dans la console Oracle Cloud, recherchez l'OCID de l'instance Oracle Integration Generation 2 sélectionnée et notez-le.
   3. Dans OCI Process Automation, inscrivez l'instance Oracle Integration Generation 2. Reportez-vous à Inscription de services dans le guide Utilisation d'Oracle Cloud Infrastructure Process Automation.
      Remarque
      
      Vous pouvez créer un utilisateur ServiceAccount dédié pour cette connexion.

1. Déterminez les applications à migrer.

   Vous voudrez peut-être profiter de cette occasion pour vous débarrasser des applications inutiles. Déterminez si vous souhaitez migrer uniquement les applications qui se trouvent dans votre environnement de production ou si vous souhaitez également migrer les applications en cours de test et de développement.

   Si vous souhaitez migrer des applications individuelles, notez les applications à migrer et 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 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 du 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. Faites une demande POST à votre 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"
            }
        }

        Vous saurez que le travail d'export est terminé lorsque le fichier process_status.json apparaît dans votre bucket. Ce fichier contient le statut du travail, son pourcentage de réalisation et, en cas d'échec, le message d'erreur. Vous devez également voir le contenu suivant dans votre bucket :

        • Process/project folder : contient toutes les applications de processus.
        • Process/dmn folder : contient tous vos modèles de décision.
     3. Une fois les applications exportées dans le bucket, effectuez une demande POST vers l'instance Oracle Integration 3 pour migrer les 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. Attendre la fin du travail de migration. 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

   • Migration d'applications individuelles
     1. Exportez les applications de processus 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 des processus dans Oracle Integration Generation 2.

     2. Importez les applications de processus dans OCI Process Automation.

        Dans OCI Process Automation, importez les applications de processus Oracle Integration Generation 2. Reportez-vous à Import d'une application dans Utilisation d'Oracle Cloud Infrastructure Process Automation.

        OCI Process Automation convertit les applications de processus héritées en version de produit la plus récente.

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 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.

Les rôles d'application ont considérablement changé dans OCI Process Automation. 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 droits d'accès.

Le tableau suivant montre comment les rôles Oracle Integration Generation 2 sont mis en correspondance avec les rôles OCI Process Automation.

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 OCI Process Automation 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 l'activation dans le concepteur ou après l'activation dans l'espace de travail.

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

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

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 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.

   Après avoir résolu toutes les erreurs de validation, vous pouvez activer votre application. Reportez-vous à Activation des applications dans le guide Utilisation d'Oracle Cloud Infrastructure Process Automation.

• Processus d'appel d'intégrations
• Intégrations appelées par processus
• Applications Visual Builder
• Clients non Oracle-Integration
• Vérification

Processus d'appel d'intégrations

Les API de développeur pour l'application Process Automation et Decision ont été modifiées après la mise à niveau. Vous devez reconfigurer l'intégration à l'aide de l'assistant d'appel Process Automation. Reportez-vous à Reconfiguration de l'intégration.

Intégrations appelées par processus

OCI Process Automation 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 qu'elles sont appelées par des processus dans Oracle Integration Generation 2, vous devrez prendre des mesures supplémentaires pour présenter une interface basée sur REST à OCI Process Automation. Cela peut signifier que vous devez effectuer l'une des opérations suivantes :

• Créer des intégrations de wrapper basées sur REST.

  ou

• Remplacez le déclencheur existant SOAP par REST.

En outre, pour que l'inscription de service fonctionne comme prévu, assurez-vous que votre déclencheur REST utilise la stratégie OAuth 2.0 ou Basic Authentication Security.

Applications Visual Builder

Les API de développeur pour Process Automation et l'application 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 l'automatisation 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 à OCI Process Automation.

   Créez une connexion back-end à OCI Process Automation. Ce back-end sera utilisé pour établir une connexion à la nouvelle instance OCI Process Automation. 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 version de vos applications.

   Oracle recommande de créer une version de vos applications Visual Builder afin d'implémenter les modifications requises. Reportez-vous à Création de versions d'une application dans le manuel 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'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 Démarrer le processus 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 de processus de la chaîne d'actions ou à partir de l'onglet Processus dans le menu de l'application à gauche.
   2. Créez une connexion de service basée sur le 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. Assurez-vous de 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 en fonction de l'adresse du processus ci-dessus. Reportez-vous à Création d'un type à partir d'une adresse dans 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 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 votre 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 votre action de démarrage de processus 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 votre processus est appelé avec succès dans OCI Process Automation.

   GET - Instance de processus

   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 le catalogue pour votre processus en suivant les étapes ci-dessus, vous remarquerez que l'adresse Obtenir l'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 et mettez à nouveau en correspondance le champ instanceID.

   Remarque
   
   Les valeurs de charge utile de réponse ici ont été modifiées.

   Autres actions de processus

   Effectuez les étapes suivantes pour toutes les autres actions de processus, telles que Exécuter la tâche et Obtenir la 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 une adresse.

      Le tableau suivant mappe chacune de ces actions avec l'API de développeur correspondante pour Process Automation.

      Action Visual Builder	API de développement pour l'automatisation des 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 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	Réclamez 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 une collection de tâches	Obtenir /process/api/v1/tasks
      Obtenir la tâche	GET /process/api/v1/tasks/{id}
      Obtenir la collecte de processus déployée	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 Process Automation et l'application 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 équivalent OCI Process Automation.

   Nom de composant	CCA Oracle Integration Generation 2	Equivalent OCI Process Automation
   Liste des tâches	oj-pcs-task-list	oj-opac-task-list (liste des tâches)
   Détails de tâche	oj-pcs-task-detail	oj-opac-task-detail
   Liste d'applications	oj-pcs-app-list	oj-opac-applist
   Formulaire de départ	oj-pcs-start-form	oj-opac-start-form
   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 Oracle-Integration

Si vous appelez des applications de processus depuis 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 OCI Process Automation 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 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 :

• OCI Process Automation - Processus vers Oracle Integration Generation 2 - Intégrations
• Oracle Integration Generation 2 - Intégrations à OCI Process Automation - Processus
• Visual Builder - Applications à OCI Process Automation - Processus