Phase 1 : Migrer des applications de processus vers l'automatisation des processus OCI

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

1. Créez une nouvelle instance autonome d'automatisation des processus OCI.

   Voir Provisionner une instance d'automatisation des processus dans Administration d'Oracle Cloud Infrastructure Process Automation.

   Lorsque vous créez l'instance :

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

     Si vous n'utilisez pas le même compartiment, assurez-vous que l'utilisateur qui crée l'instance d'automatisation du processus OCI dispose des autorisations nécessaires pour gérer à la fois l'instance Oracle Integration et l'instance d'automatisation du processus OCI.

     Vous gérez ces autorisations avec des politiques 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 Automatisation des processus OCI :

     • 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 à l'automatisation des processus OCI.

   Pour que vos développeurs puissent accéder à la nouvelle instance OCI Process Automation provisionnée et travailler sur les tâches suivantes, assurez-vous qu'ils disposent du rôle d'application approprié pour accéder à l'instance. Voir Affecter des rôles d'application à des groupes dans un domaine d'identité dans Administration d'Oracle Cloud Infrastructure Process Automation.

3. Enregistrez une instance Oracle Integration Génération 2 non en production pour le test.

   Si vos applications de processus appellent des intégrations existantes, enregistrez Oracle Integration Génération 2 dans la nouvelle instance d'automatisation de processus OCI. Votre instance d'automatisation des processus OCI peut ainsi se connecter et détecter vos intégrations existantes.

   Assurez-vous d'utiliser une instance Oracle Integration Génération 2 non en production pour l'enregistrement de service à cette étape. Assurez-vous que l'enregistrement de l'instance Oracle Integration Génération 2 sélectionnée n'aura aucune incidence négative sur les processus en production.

   1. Sélectionnez une instance Oracle Integration Génération 2 non en production à enregistrer.
   2. Dans la console Oracle Cloud, recherchez et notez l'OCID de l'instance Oracle Integration Génération 2 sélectionnée.
   3. Dans Automatisation des processus OCI, enregistrez l'instance Oracle Integration Génération 2. Voir Inscrire des services dans Utilisation d'Oracle Cloud Infrastructure Process Automation.
      Note
      
      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 test et développement.

   Si vous allez migrer des applications individuelles, notez les applications que vous souhaitez 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 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 devriez é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 l'automatisation des processus OCI.

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

        L'automatisation des processus OCI convertit les applications de processus existantes à 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 du 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 consulter le rapport de migration initial dans le menu principal. Voir Importer une application dans Utilisation d'Oracle Cloud Infrastructure Process Automation.

Les rôles d'application ont considérablement changé dans Automatisation des processus OCI. Les rôles ProcessOwner, AnalyticsViewer et ProcessReviewer sont maintenant 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 avec les rôles d'automatisation de processus OCI.

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 l'automatisation du processus OCI partage le même domaine d'identité que votre instance Oracle Integration Génération 2 existante, les utilisateurs et 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 l'automatisation des processus OCI, voir Configurer les rôles pour les applications de processus dans Utilisation d'Oracle Cloud Infrastructure Process Automation.

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. Activer l'application.

   Après avoir résolu toutes les erreurs de validation, vous pouvez activer votre application. Voir Activer des applications 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 intégrés Oracle
• Vérification

Processus d'appel des intégrations

Les API de développement pour l'automatisation des processus et l'application de décision ont été modifiées après la mise à niveau. Vous devez reconfigurer l'intégration à l'aide de l'assistant d'appel du service Automatisation des processus. Voir Reconfigurer l'intégration.

Intégrations appelées par processus

L'automatisation des processus OCI prend en charge les communications REST uniquement au moyen de l'enregistrement de 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 qui sont appelées par des processus dans Oracle Integration Génération 2, vous devez prendre des mesures supplémentaires pour présenter une interface REST à l'automatisation des processus OCI. Cela peut signifier que vous devez effectuer l'une des opérations suivantes :

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

  ou

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

De plus, pour que l'enregistrement du service fonctionne comme prévu, assurez-vous que votre déclencheur REST utilise la politique de sécurité d'authentification de base OAuth 2.0 ou.

Applications Visual Builder

Les API de développement pour l'automatisation des processus et l'application 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 l'automatisation des processus 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 endpoints Process, procédez comme suit :

1. Connectez-vous à OCI Process Automation.

   Créez une connexion dorsale au service d'automatisation des processus pour OCI. Ce serveur dorsal sera utilisé pour établir une connexion à la nouvelle instance du service d'automatisation des processus pour OCI. 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'action

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

   Déclenchement d'un traitement

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

   1. Naviguez jusqu'à Oracle Integration Génération 2 et prenez note du 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 Processus dans le menu de l'application à gauche.
   2. Créez une connexion de service basée sur le catalogue pour votre processus dans la nouvelle version de votre application Visual Builder. Voir Créer une connexion de service à partir d'un catalogue d'automatisation des 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. Naviguez jusqu'à 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. Mappez les champs de données et les paramètres d'entrée requis pour appeler votre processus. Pour un exemple, voir Intégrer l'automatisation d'Oracle Process au service Visual Builder.
      3. Faites glisser l'action REST Appeler au-dessus de votre action Démarrer le processus courante.
      4. Configurez l'action REST d'appel 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 l'acton Start Process existant.
   6. Testez l'appel et assurez-vous que votre processus est appelé avec succès dans Automatisation des processus OCI.

   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 le point d'extrémité Get Process Instance est maintenant disponible dans votre connexion de service.

   Remplacez l'action de processus Get Process Instance existante par une action REST Call 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 traitement

   Effectuez les étapes suivantes pour toutes les autres actions de processus telles que Exécuter la tâche et Obtenir la tâche :

   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 l'automatisation des processus.

      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, Refuser, etc.
      Exécuter la tâche	PUT /process/api/v1/tasks/{id}	Mettez à jour la priorité de 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 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	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éassignez une tâche.
      Obtenir une collection de tâches	OBTENEZ /process/api/v1/tasks
      Obtenir une tâche	GET /process/api/v1/tasks/{id}
      Obtenir la collecte 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 l'automatisation des processus et l'application 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 équivalent d'automatisation de processus OCI.

   Nom du composant	CCA d'Oracle Integration génération 2	Équivalent dans le cas de l'automatisation des processus OCI
   Liste des tâches	oj-pcs-task-list	oj-opac-task-list
   Détails de la tâche	oj-pcs-tâche-détail	oj-opac-tâche-détail
   Liste des 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 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 OCI Process Automation 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 :

• Automatisation des processus OCI - Processus pour Oracle Integration Génération 2 - Intégrations
• Oracle Integration Génération 2 - Intégrations à l'automatisation de processus OCI - Processus
• Visual Builder - Applications pour l'automatisation des processus OCI - Processus