Création d'un dossier ou d'un document dans Oracle Content and Experience Cloud à l'aide du processus dans Oracle Integration Cloud

Utilisez l'événement Début du document pour modéliser un processus pouvant être lancé par un document. Utilisez l'événement Début du dossier pour modéliser un processus pouvant être lancé par un dossier.

Pour pouvoir créer l'un de ces processus, vous devez disposer d'un compte Oracle Content Management et configurer une connexion entre ce service et votre instance Oracle Integration.

En activant l'intégration Oracle Content Management, vous pouvez définir des dossiers qui seront créés automatiquement sur Oracle Content Management pour chaque instance de processus, en fournissant une organisation prédéfinie des documents concernés. Vous pouvez également remplacer le type d'accès au niveau de la tâche afin de définir les autorisations appropriées pour le dossier ou le document d'une tâche particulière, en fonction des besoins de votre entreprise. Par exemple, vous pouvez empêcher les utilisateurs d'afficher un document ou un dossier classé associé à une tâche.

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

Pour pouvoir démarrer un processus, 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 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 y accéder 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.

Pour concevoir un processus pouvant être démarré par un document ou un dossier :

Définissez le document entrant ou le dossier entrant dans Oracle Integration.
Modéliser un processus comportant un événement de début de document ou un événement de début de dossier.
Personnalisez son implémentation pour mapper l'événement de début avec le document ou dossier entrant correspondant que vous avez créé. Les options d'implémentation vous permettent de définir la manière dont le document ou le dossier est exposé aux utilisateurs.
Vous pouvez éventuellement modifier le rôle pouvant accéder au document ou au dossier au niveau de la tâche.
Configurez le dossier dans Oracle Content Management pour lancer un processus à l'arrivée d'un document.

Vous pouvez également utiliser l'API REST et fournir toutes les valeurs en entrée.

Définir le document ou le dossier entrant

Vous pouvez utiliser la page Documents d'Oracle Integration (Process Builder) pour définir un document ou un dossier entrant.

Ouvrez l'application de processus que vous modélisez et cliquez sur Documents. La page Documents répertorie les documents entrants et les dossiers entrants déjà définis.

Pour créer un nouveau document ou dossier entrant, cliquez sur Nouveau , sélectionnez le type approprié, entrez un nom et sélectionnez le droit d'accès par défaut.

Traitements de modèle pouvant être démarrés à partir d'événements de début de document ou de dossier

Vous pouvez modéliser un processus dans Oracle Integration qui peut être démarré à partir d'un événement de début de document ou de dossier.

Avant de commencer, ajoutez l'événement de début de document ou de dossier à partir de la palette Eléments. Seul le premier événement de début que vous ajoutez à un processus est pris en charge.

Dans l'onglet Accueil de l'application, cliquez sur Processus.
Cliquez sur Nouveau processus pour ouvrir la boîte de dialogue Créer un processus.
Sélectionner Aucun
Entrez le nom du processus, assurez-vous que la case Ouvrir immédiatement est cochée, puis cliquez sur Créer.
Dans la Palette d'éléments, cliquez sur Evénements.
Faites glisser l'événement Démarrage du document ou Démarrage du dossier vers le canevas.
Ajoutez un flux de séquence de votre nouvel événement de début de document ou de dossier à l'événement de fin.
Supprimez l'événement de début vide.
Poursuivez pour modifier et définir le processus. Veillez à le tester et à le déployer.

Activer les rôles utilisateur pour lancer un processus lancé par un document ou un dossier

Vous pouvez activer certains rôles utilisateur pour lancer un processus de document ou de dossier lancé dans Oracle Integration.

Pour permettre à un rôle d'utilisateur de charger un document pour lancer un traitement :

Ouvrez le processus.
Dans le couloir d'activité contenant l'événement de début de document ou de dossier, cliquez sur le nom du rôle, puis sur Modifier .
Dans le champ Rôle, sélectionnez Gestionnaire automatique.

Personnaliser un processus lancé par un document ou un dossier

Après avoir modélisé un processus dans Oracle Integration, vous pouvez ajouter un document ou un dossier de démarrage dans un processus et le personnaliser.

Pour personnaliser un processus lancé par un document ou un dossier :

Dans le diagramme du processus, cliquez sur l'événement Début du document ou Début du dossier.
Cliquez sur Menu, puis sélectionnez Ouvrir les propriétés.
Définissez le mode de gestion du document ou du dossier entrant.
- En place : la sélection de cette valeur conserve l'emplacement du document tel qu'il est. Si vous le souhaitez, vous pouvez mettre en correspondance le document ou dossier entrant avec l'un des documents ou dossiers prédéfinis pour sa gestion. (Pour ce faire, ouvrez la liste déroulante.)
  
  Si aucun document ou dossier entrant prédéfini n'est adapté à ce processus particulier, cliquez sur Nouveau pour en créer un.
- Non géré : le document ou le dossier est ignoré par le processus en cours. Oracle Integration Cloud n'affiche pas de document ou de dossier non géré lors de l'exécution. Il appartient au modélisateur de processus de gérer le document ou le dossier entrant. Par exemple, si vous souhaitez déplacer le dossier ou le document entrant vers un autre emplacement, vous pouvez utiliser une expression XPath pour obtenir des propriétés, telles que Id ou Type, et transmettre les informations de propriété à un service REST.

Configurer un dossier

Pour qu'un processus démarre automatiquement lorsqu'un document est chargé dans un dossier, vous devez configurer le dossier dans Oracle Content Management.

Pour configurer le dossier afin qu'il lance un processus lorsqu'un document arrive :

Connectez-vous à Oracle Content Management.
Sélectionnez le dossier.
Sélectionnez Propriétés dans la barre de menus.
Activez le paramètre Lancer le processus à l'arrivée du document.
Sélectionnez le processus dans la liste.
Cliquez sur Enregistrer.

Le dossier et ses sous-dossiers peuvent désormais être utilisés dans l'interface Oracle Integration. Toute modification apportée à un fichier du dossier ou à un nouveau fichier chargé dans le dossier déclenche le processus associé au dossier. Vous pouvez remplacer le processus hérité pour un sous-dossier, mais vous ne pouvez pas désactiver l'association avec un processus.

Lorsqu'un fichier est chargé à partir d'Oracle Content Management dans un dossier configuré pour être utilisé avec Oracle Integration, le fichier est utilisé pour la tâche associée à ce dossier. Les utilisateurs d'Oracle Integration peuvent y effectuer n'importe quelle action sur les fichiers, par exemple les approbations. Lorsqu'une étape de tâche est terminée, le fichier peut être déplacé ou géré en fonction du processus défini.

Lorsque Oracle Content Management démarre un processus, les données traitées envoyées pour le lancement du processus incluent les informations suivantes :

ID de document
Nom du document
ID de l'utilisateur qui a démarré le processus
Type
Rôle (indique le rôle à utiliser pour générer les liens d'application suivants)
Version

L'exemple suivant utilise uniquement l'ID de document et le nom de document à afficher dans le formulaire dans Oracle Integration. En outre, il utilise l'ID de document lorsqu'il effectue des appels d'API REST pour déplacer ou copier le fichier dans Oracle Content Management dans le dossier de tâches.

{
   "processDefId":"testing~UserFileApproval!1.0~FormApprovalProcess",
   "operation": "startEvent",
   "params": {
        "id": "D2806600E495B744E66BF3981212FF6185DE89BE6812",
        "type": "d",
        "name": "document-name",
        "startedBy": "user-id",
        "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 :

Le processus doit utiliser un événement de début Oracle Content Management.
Lorsque vous déployez le traitement, vous devez le partager avec l'utilisateur spécifié pour activer l'intégration. Sinon, l'utilisateur ne disposera pas des droits nécessaires pour 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.
Si vous activez l'intégration de processus pour un dossier, vous devez partager ce dossier avec le compte utilisateur Oracle Content Management utilisé pour activer l'intégration dans Oracle Integration.