Configurer l'intégration des processus entre Oracle Integration et Oracle Content Management

Pour que vous ou tous les utilisateurs puissiez accéder aux fonctionnalités de document et de conversation, un administrateur doit configurer les paramètres dans Oracle Content Management et Oracle Integration.

Seul un utilisateur disposant de privilèges d'administrateur peut établir une connexion entre les deux services.

Pour les applications Process créées avant la configuration de la connexion à Oracle Content Management, les fonctionnalités de document et de conversation sont désactivées par défaut. Les développeurs peuvent activer manuellement ces fonctionnalités dans leurs applications existantes.

Exigences d'accès pour une intégration réussie

Notez les exigences d'accès suivantes pour une intégration réussie :

L'utilisateur Oracle Content Management configuré dans Oracle Integration doit disposer d'un accès complet au dossier (c'est-à-dire au dossier du document entrant) configuré dans Oracle Content Management pour pouvoir lancer un processus.
Pour un processus lancé par un dossier (c'est-à-dire un processus avec un événement Démarrage de dossier), l'utilisateur Oracle Content Management configuré dans Oracle Integration doit disposer d'un accès de responsable au dossier pour accéder à ce dernier dans Oracle Integration. Par exemple, un accès responsable est requis pour afficher le dossier sur les pages Détails de la tâche et Suivi du processus, pour accéder au dossier lors de l'incorporation des composants de l'interface utilisateur de processus dans une application externe ou pour voir le dossier dans l'application Process Mobile.
Pour afficher un processus dans la liste des processus d'un dossier et pouvoir lancer une instance de processus à l'arrivée d'un nouveau document, l'utilisateur Oracle Integration configuré dans Oracle Content Management doit disposer du rôle d'initiateur de processus.

Utiliser des documents ou des documents joints dans une application de processus

Oracle Integration inclut automatiquement la fonctionnalité standard de fichier joint dans vos applications de processus. Vous pouvez charger des fichiers et les joindre à un processus. Lorsque vous utilisez Oracle Content Management avec Oracle Integration, vous obtenez également la fonctionnalité Documents, qui vous permet de télécharger des fichiers, d'organiser les fichiers dans des dossiers, de gérer l'accès à chaque dossier et même de lancer un processus en téléchargeant un document. En outre, chaque application de traitement peut utiliser des documents ou des documents joints.

Vous déterminez si un traitement utilise des documents ou des pièces jointes au niveau de l'application. Les documents sont activés par défaut. Ce paramètre se trouve dans le volet Informations de l'application.

Description de l'image enable-docs-app-level-cb.png ci-après
Description de l'illustration enable-docs-app-level-cb.png

Une application pour laquelle l'option Intégration de documents est activée peut utiliser des documents (et uniquement des documents). Une application dont l'option Intégration de documents est désactivée ne peut utiliser que des pièces jointes. En fait, la désactivation de documents pour une application permet d'activer les pièces jointes pour cette application.

N'oubliez pas que le paramètre s'applique à l'application. Vous pouvez utiliser des documents ou des pièces jointes dans une application, mais pas les deux.

Pour les pièces jointes, assurez-vous que l'option Masquer les pièces jointes est désélectionnée dans l'écran Personnalisation de l'interface utilisateur. Si l'option Masquer les pièces jointes est sélectionnée, vous ne pourrez pas voir les pièces jointes dans les détails de tâche et les formulaires de début.

Si vous utilisez des API REST pour interagir avec Oracle Integration, veillez à utiliser l'API appropriée selon que votre application de processus utilise des documents ou des pièces jointes :

Pour les documents, veillez à utiliser les API REST /folders.
Pour les pièces jointes, veillez à utiliser les API REST /attachments.

Si vous utilisez une API incorrecte, l'application renvoie un message d'erreur ou s'arrête sans opération.

Si vous ne pouvez pas voir les pièces jointes dans les détails de tâche, vérifiez les options dans l'écran Personnalisation de l'interface utilisateur. Assurez-vous que la case Masquer les pièces jointes est désélectionnée pour voir les pièces jointes.

Configurer les paramètres Oracle Integration dans Oracle Content Management

Activez Oracle Integration pour les documents dans Oracle Content Management.

Connectez-vous à Oracle Content Management en tant qu'administrateur.
Dans le menu Administration, sélectionnez Intégrations.
Sous Applications, sélectionnez Oracle Integration pour activer le service, puis définissez les valeurs suivantes :
- URL de service : URL du service REST auquel les utilisateurs peuvent accéder pour leurs applications, qui se termine par bpm/api/4.0/processes (par exemple, https://servicename/bpm/api/4.0/processes).
- Utilisateur de service : saisissez l'adresse électronique de l'utilisateur qui possède le processus à utiliser dans Oracle Content Management.
- Mot de passe de service : saisissez le mot de passe utilisateur.

Lorsqu'une étape de tâche est terminée, le fichier peut être géré en fonction du processus défini. Pour un document entrant, un utilisateur peut effectuer des actions en fonction du rôle affecté à ce document : Contributeur, Téléchargeur ou Visualiseur.

Lorsque Oracle Content Management démarre un processus, les données traitées suivantes sont envoyées pour lancer le processus :

{

        "operation":"startEvent",

        "processDefId":"testing~LoanApplicationProcessing!1.0~LoanApplicationProcessing"

        "params": {

               "id": "abc123",

               "name": "document name",

               "startedBy": "user id",

               "type": "d",

               "role": "role that should be used to generate subsequent applinks",

                "version": "version"

         }

}

En tant que développeur, vous devez connaître les exigences suivantes pour le processus que vous développez :

Il doit s'agir d'un processus qui utilise un événement de début de document Oracle Content Management.
Lors du déploiement du processus, vous devez le partager avec l'utilisateur spécifié pour activer l'intégration afin que l'utilisateur ait les droits de déclencher le processus,
Pour que l'utilisateur qui a chargé le fichier s'affiche en tant qu'utilisateur ayant démarré la tâche, le processus doit utiliser la valeur transmise dans le champ startedby comme nom d'affichage de l'initiateur.

Configuration des paramètres des documents dans Oracle Integration

En tant qu'administrateur, vous devez également configurer la connexion entre Oracle Integration et Oracle Content Management. Vous devez entrer des informations telles que l'URL et les informations d'identification de connexion pour Oracle Content Management.

Pour configurer les paramètres dans Oracle Integration, procédez comme suit :

Dans le panneau de navigation Oracle Integration, cliquez sur Mes tâches, cliquez sur Espace de travail, puis sur Administration.
Cliquez sur Services.
Dans la section Oracle Content Management, entrez les informations suivantes :
- URL : adresse Web d'Oracle Content Management. L'administrateur de service reçoit un courriel de bienvenue dans Oracle Cloud lorsque le service est prêt à être utilisé. Le courriel contient l'URL de votre instance Oracle Content Management. Par exemple, https ://your_service_name.com/documents.
- Domaine d'identité : nom du domaine d'identité auquel appartient votre instance Oracle Content Management. Vous pouvez configurer une connexion à Oracle Content Management (pour la fonctionnalité Documents) sans fournir de domaine d'identité.
- Utilisateur et Mot de passe : informations d'identification de compte d'un utilisateur ayant accès à Oracle Content Management. Ce compte utilisateur est utilisé pour tester la connexion entre les services. Il est également utilisé lors de l'exécution pour se connecter aux services et effectuer toutes les opérations d'exécution, telles que la création de dossiers.
Important :

Si vous voulez collaborer à l'aide de conversations, le rôle suivant doit être affecté à l'utilisateur indiqué ici :

service_instance_name.CECIntegrationUser

Utilisez l'application Oracle Cloud My Services pour affecter des rôles à vos utilisateurs.
Cliquez sur Tester.

Chaque fois que vous apportez des modifications aux paramètres de configuration, il est conseillé de vérifier que les valeurs que vous avez entrées sont correctes. Vous voulez confirmer qu'une connexion réussie a été établie avec Oracle Content Management.

Vérifiez les résultats du test, qui peuvent inclure des messages, des erreurs et des avertissements.
Sélectionnez l'une des options suivantes pour continuer :
- S'il existe des erreurs ou des avertissements, apportez les modifications nécessaires, puis cliquez à nouveau sur Tester pour vérifier les nouvelles valeurs. Répétez le test chaque fois que vous modifiez les paramètres.
- Si le test de connexion réussit, cliquez sur Enregistrer pour enregistrer les paramètres de configuration.
- Pour annuler et revenir aux dernières valeurs enregistrées, cliquez sur Rétablir.