Création d'intégrations personnalisées de surveillance des événements

Dans Task Manager, vous pouvez créer une intégration de surveillance d'événements pour une application externe. L'intégration de surveillance des événements est déclenchée lorsqu'un événement externe se produit dans une autre application sur site ou de service cloud. Un exemple d'intégration de surveillance des événements est un déclencheur d'Oracle E-Business Suite - General Ledger lorsqu'une période est clôturée, par exemple janvier 2018.

Assurez-vous que vous disposez des prérequis, et suivez ces étapes pour configurer une intégration entre Task Manager et une application externe.

Pour obtenir un aperçu du flux d'intégrations personnalisées, reportez-vous à la section Création d'intégrations personnalisées.

Prérequis

Remarque :

La surveillance des événements peut également être déclenchée via tout outil d'intégration capable d'appeler des API REST. Dans ce cas, vous pouvez ignorer les prérequis suivants.

Pour intégrer Task Manager à une application externe, vous devez avoir les éléments suivants :
  • Un abonnement à Oracle Integration Cloud Service, pour effectuer une intégration aux services sur site et autres qu'EPM Cloud.

    Remarque :

    vous avez besoin d'une instance Integration Cloud par instance Oracle EPM cloud.
  • La configuration de l'application externe.
  1. Abonnez-vous à Oracle Integration Cloud/Oracle Autonomous Integration Cloud. Pour obtenir des informations détaillées, reportez-vous à la documentation Integration Cloud Service .
  2. Installez l'agent Integration Cloud dans votre environnement d'application afin de communiquer avec votre instance Oracle EPM cloud. Pour plus d'informations sur la configuration d'un agent Integration Cloud, reportez-vous à Gestion des groupes d'agents.

    Remarque :

    Si les services d'application sur site sont déployés dans un environnement défini dans une configuration de zone démilitarisée (DMZ) et sont donc accessibles publiquement via Internet, l'installation de l'agent Integration Cloud est inutile.

Configuration de l'intégration dans Task Manager

  1. Sur la page d'accueil, cliquez sur Application, puis sur Task Manager.
  2. Cliquez sur l'onglet Intégrations à gauche, puis sur Nouveau.
  3. Dans l'onglet Propriétés, indiquez les informations requises :

    1. Pour Nom, saisissez le nom de l'intégration.

    2. Pour Code, saisissez un code d'intégration pour la tâche d'intégration.

      Le code permet d'exécuter l'intégration et de mapper les mises à jour avec une intégration à partir d'un import de fichier.

    3. Facultatif : dans Description, entrez la description de la tâche d'intégration.

    4. Pour Connexion, sélectionnez l'application à laquelle appartient la tâche.

      Vous pouvez gérer la liste d'applications à partir de l'icône Gérer les connexions dans la boîte de dialogue Gérer les connexions.

    5. Pour Type d'exécution, sélectionnez Surveillance d'événements.

    6. Pour Nom de l'événement, entrez le nom de l'événement.

  5. Dans l'onglet Paramètres, cliquez sur Nouveau et indiquez les informations requises :

    1. Pour Nom, entrez le nom du paramètre.

    2. Pour Code du paramètre, entrez un code de paramètre.

    3. Facultatif : entrez une info-bulle de paramètre.

    4. Dans la liste Type de paramètre, sélectionnez un type et entrez toute information supplémentaire pour le paramètre :

      • Case à cocher : valeur booléenne

      • Date : valeur de date

      • Entier : valeur numérique en nombres entiers

      • Nombre : valeur numérique en nombres entiers ou fractions

      • Groupe d'options : case à cocher pour un ensemble prédéfini de valeurs

      • Liste statique : ensemble prédéfini de valeurs de texte

      • Informations sur la tâche : informations sur la tâche (par exemple, le destinataire, la durée, les dates de début et de fin)

      • Texte : valeur de texte en format libre

      • Artefact EPM : nom de l'artefact, tel que le formulaire ou le rapport

    5. Si le paramètre requiert une valeur, sélectionnez Obligatoire.

    6. Cliquez sur OK pour enregistrer le paramètre.

    7. Cliquez sur Enregistrer et fermer pour enregistrer l'intégration.

Création d'un type de tâche pour l'intégration

  1. Sur la page d'accueil, cliquez sur Application, puis sur Task Manager.

  2. Cliquez sur l'onglet Types de tâche sur la gauche.

  3. Cliquez sur Nouveau.

  4. Dans l'onglet Propriétés, indiquez un nom de type de tâche et un ID de type de tâche.

  5. Pour Intégration, cliquez sur Rechercher, sélectionnez l'intégration et cliquez sur OK.

  6. Dans l'onglet Paramètres, définissez les paramètres de type de tâche.

Configuration de la connexion à Integration Cloud dans Task Manager

Task Manager utilise Oracle Integration Cloud pour toutes les intégrations à des applications externes. Vous pouvez configurer une connexion à Oracle Integration Cloud dans Task Manager à l'aide de l'authentification de base ou OAuth 2.0.

Remarque :

  • Pour Oracle Integration Cloud Generation 2, l'authentification de base et l'authentification OAuth 2.0 sont prises en charge.
  • Pour Oracle Integration Cloud Generation 3, seule l'authentification OAuth 2.0 est prise en charge.
  • L'utilisateur qui recourt à l'authentification de base doit disposer du rôle d'administrateur de service pour Oracle Integration Cloud.
  • Pour OAuth 2.0, seules les informations d'identification client sont prises en charge. L'application client OAuth 2.0 doit disposer du rôle d'administrateur de service pour Integration Cloud, et la portée autorisée doit être Tout.

Avant de configurer la connexion OAuth 2.0, assurez-vous que vous disposez des informations d'identification client telles que l'URL de jeton d'accès, l'ID client, la clé secrète client et la portée. Pour configurer l'application client OAuth, reportez-vous à la section Authentification OAuth dans Oracle Integration dans la documentation Oracle Integration Cloud Generation 3.

Pour configurer la connexion à Integration Cloud dans Task Manager, procédez comme suit :

  1. Sur la page d'accueil, cliquez sur Application, puis sur Task Manager.

  2. Cliquez sur l'onglet Intégrations à gauche.

  3. Cliquez sur Gérer les connexions, et dans Actions, sélectionnez Connexion à Integration Cloud.
  4. Sélectionnez l'un des mécanismes d'authentification suivants :
    • Authentification de base : indiquez l'URL Integration Cloud, l'ID utilisateur de l'administrateur de service et le mot de passe.
    • OAuth 2.0 : indiquez l'URL Integration Cloud, l'URL de jeton d'accès, l'ID client, la clé secrète client et la portée.

    Remarque :

    Entrez l'URL : https://<SERVICE_NAME>-<TENANT_NAME>.integration.ocp.oraclecloud.com
  5. Cliquez sur Valider. Une fois la validation réussie, cliquez sur Enregistrer. Cela enregistre le serveur et les informations d'identification de la connexion.

Configuration de l'intégration dans Integration Cloud

Remarque :

Si vous n'envisagez pas d'utiliser Integration Cloud, passez à l'étape suivante.

Pour configurer l'intégration dans Integration Cloud, procédez comme suit :

  1. Connectez-vous à Integration Cloud.
  2. Créez une connexion à votre service EPM à l'aide de l'adaptateur Oracle Enterprise Performance Management Cloud. Pour plus d'informations, reportez-vous au lien suivant : Création d'une connexion à Oracle Enterprise Performance Management Cloud.
  3. Créez des connexions à l'autre application si nécessaire.
  4. Créez une intégration de surveillance d'événements à l'aide des connexions créées, puis activez-la. Reportez-vous à l'exemple suivant : Utilisation de l'adaptateur Oracle Enterprise Performance Management Cloud avec Oracle Integration.

Configuration de l'intégration sans Integration Cloud

Remarque :

Si vous envisagez d'utiliser Integration Cloud, passez à l'étape suivante.
Configurez l'outil d'intégration que vous voulez utiliser.

1. Passez en revue l'API REST, Mise à jour du statut de tâche pour la surveillance des événements dans API REST pour Oracle Enterprise Performance Management Cloud.

2. Configurez l'outil d'intégration pour appeler l'API REST afin de fermer la tâche de surveillance des événements en transmettant les paramètres de l'événement.

Pour plus d'informations, reportez-vous à la section Mise à jour du statut de tâche pour la surveillance des événements dans le guide API REST pour Oracle Enterprise Performance Management Cloud.

Configuration de l'intégration dans Task Manager

Suivez ces étapes pour effectuer la configuration de l'intégration dans Task Manager.

  1. Sur la page d'accueil, cliquez sur Application, puis sur Task Manager.
  2. Cliquez sur l'onglet Intégrations à gauche et vérifiez que la nouvelle intégration est affichée.
  3. Dans Task Manager, cliquez sur Echéanciers et créez un échéancier à l'état En attente. Reportez-vous à Création manuelle d'échéanciers.
  4. Créez la tâche de surveillance des événements et ajoutez-la à l'échéancier. Reportez-vous à Création de tâches.
  5. Dans Echéanciers, sélectionnez et ouvrez l'échéancier.
  6. Déclenchez l'action qui génère l'événement dans l'application externe (par exemple, EBS). Si vous n'utilisez pas Integration Cloud, mais un autre outil d'intégration, appelez l'API REST à partir de cet outil.

    Remarque :

    Transmettez les paramètres tel qu'attendu par le type d'intégration, l'événement et les paramètres, sinon la tâche ne sera pas prise en compte s'ils ne correspondent pas.
  7. Attendez que la tâche soit terminée.
  8. Facultatif : pour surveiller le statut de l'intégration dans Integration Cloud Services, connectez-vous à Integration Cloud et accédez à Surveillance.