Imprimer      Ouvrir la version PDF de l'aide en ligne


Rubrique précédente

Rubrique suivante

Création d'actions de workflow : Créer un événement d'intégration

L'action Créer un événement d'intégration dans une règle de workflow envoie un événement d'intégration dans une ou plusieurs files d'attente d'intégration lorsque les conditions de la règle de workflow sont réunies et qu'une modification est détectée dans au moins l'un des champs suivis par l'action Créer un événement d'intégration.

A propos de l'action Créer un événement d'intégration et de l'action Attendre

Si vous souhaitez utiliser une action Créer un événement d'intégration pour créer un événement d'intégration qui capture les modifications apportées à un enregistrement par l'événement qui déclenche une règle de workflow, vous devez alors placer cette action Créer un événement d'intégration avant toute action Attendre dans la séquence d'actions de la règle. En effet, si une action Attendre précède l'action Créer un événement d'intégration dans une règle de workflow, l'action Attendre empêche l'action Créer un événement d'intégration de détecter les modifications apportées à l'enregistrement. Lorsque la période d'attente de l'action Attendre prend fin, l'enregistrement fait l'objet d'une nouvelle lecture avant l'exécution des actions restantes de la règle et les valeurs des champs de l'enregistrement définies avant l'événement qui a déclenché la règle de workflow ne sont pas conservées. En conséquence, la valeur précédente et la valeur actuelle d'un champ sont considérées comme identiques et l'action Créer un événement d'intégration ne crée aucun événement d'intégration, car elle ne détecte aucune modification des champs faisant l'objet du suivi.

A propos des formats de valeurs de liste de sélection dans les événements d'intégration

En fonction de la manière dont vous configurez les files d'attente de vos événements d'intégration, les valeurs des champs de liste de sélection des événements d'intégration sont enregistrées dans la langue de l'utilisateur dont l'action cause la création de l'événement d'intégration, ou sous forme de valeurs de code indépendant de la langue (LIC). Pour plus d'informations sur la spécification du format des valeurs de liste de sélection pour une file d'attente d'événement d'intégration, voir Création d'une file d'attente d'événements d'intégration et Gestion des paramètres d'événements d'intégration.

A propos des indicateurs Facturation, Expédition et Principal dans les enregistrements d'adresse de compte et d'interlocuteur

Dans les événements d'intégration relatifs au type d'enregistrement Adresse du compte, vous pouvez inclure les indicateurs Facturation et Expédition qui indiquent si une adresse est désignée comme adresse de facturation ou d'expédition pour le compte. De la même façon, dans les événements d'intégration relatifs au type d'enregistrement Adresse interlocuteur, vous pouvez inclure l'indicateur Principal qui indique si une adresse est l'adresse principale de l'interlocuteur. En revanche, vous ne pouvez pas effectuer le suivi des modifications apportées aux indicateurs Facturation, Expédition et Principal. Cela signifie que les modifications apportées à ces indicateurs ne peuvent pas être utilisées pour déclencher la création d'événements d'intégration, même si vous avez coché la case Toujours inclure correspondante. Si vous incluez un de ces indicateurs dans un événement d'intégration, et si cet indicateur est modifié en même temps qu'un champ pour lequel les modifications font l'objet d'un suivi, l'événement d'intégration dont la création résulte de la modification du champ suivi ne fait pas apparaître la nouvelle valeur de l'indicateur. Au lieu de cela, l'événement d'intégration fait apparaître la valeur de l'indicateur avant que la mise à jour n'ait été effectuée. Cependant, lors de la création suivante d'un événement d'intégration suite à la modification d'un champ suivi, la valeur de l'indicateur après exécution de la mise à jour précédente est incluse dans l'événement créé.

A titre d'exemple, supposons que vous ayez associé deux adresses (Adresse A et Adresse B) à un interlocuteur nommé Jean Durand. L'adresse A est l'adresse principale de Jean Durand. Vous avez défini une action de workflow Créer un événement d'intégration pour le type d'enregistrement Adresse interlocuteur, configurée comme suit :

  • La case Suivi des modifications est cochée uniquement pour le champ Type d'adresse.
  • La case Toujours inclure est cochée pour le champ Principal.

Si un utilisateur met à jour le champ Type d'adresse dans l'adresse A de l'enregistrement d'adresse interlocuteur pour Jean Durand et désactive la case à cocher Principal pour cette même adresse, l'événement d'intégration créé par l'action de workflow suite à la modification du champ Type d'adresse fait apparaître le nouveau type d'adresse, mais la valeur de l'indicateur Principal de cet événement désigne toujours l'adresse A comme adresse principale de Jean Durand. Toutefois, la prochaine fois qu'un utilisateur modifie le champ Type d'adresse dans l'adresse A de l'enregistrement d'adresse interlocuteur et qu'un événement d'intégration est créé suite à cette modification, l'indicateur Principal de cet événement montre que l'adresse A n'est pas l'adresse principale de Jean Durand.

REMARQUE : Vous pouvez créer plusieurs actions pour une règle de workflow, avec un maximum de 25 actions pour chaque règle.

La procédure suivante explique comment créer une action Créer un événement d'intégration.

Avant de commencer. Pour la procédure décrite ici, votre rôle d'utilisateur doit inclure le privilège Gérer les règles de données - Gérer les règles de workflow. Pour plus d'informations sur l'ajout de privilèges aux rôles, voir Ajout de rôles.

Pour créer une action Créer un événement d'intégration

  1. Naviguez jusqu'à la règle dans laquelle vous souhaitez créer l'action :
    1. Dans le coin supérieur droit de la page en cours, cliquez sur le lien général Admin.
    2. Dans la section Gestion du processus, cliquez sur Configuration du workflow.
    3. Dans la page Liste des règles de workflow, recherchez la règle dans laquelle vous souhaitez créer l'action.

      Pour plus d'informations sur la recherche de règles de workflow dans la liste, voir la rubrique Filtrage de listes.

  2. Cliquez sur le lien Nom du workflow de la règle.
  3. Dans la barre de titre Actions de la page Règle de workflow - Détails, cliquez sur Menu, puis sélectionnez Créer un événement d'intégration.

    REMARQUE : L'événement déclencheur de la règle de workflow détermine les types d'actions qui peuvent être créés pour la règle.

    CONSEIL : Vous pouvez créer une copie d'une action de règle de workflow existante en cliquant sur le lien Copier correspondant à l'action.

  4. Dans la page Modification de l'action du workflow, attribuez un nom à l'action.
  5. Si vous souhaitez activer l'action, cochez la case Actif.
  6. Sélectionnez les files d'attente d'intégration dans lesquelles les événements d'intégration seront consignés.
  7. Dans le champ Version du schéma, si le type d'enregistrement de la règle de workflow prend en charge les schémas pour Web Services v1.0 et Web Services v2.0, sélectionnez la version du service Web qui doit être utilisée pour les événements d'intégration.

    Si le type d'enregistrement de la règle de workflow prend en charge les schémas pour Web Services v1.0 et Web Services v2.0, Web Services v2.0 est sélectionné par défaut dans le champ Version du schéma mais vous pouvez modifier la sélection avant d'enregistrer l'action de workflow.

    REMARQUE : Une fois que vous avez créé et enregistré l'action de workflow, vous ne pouvez plus modifier la valeur du champ Version du schéma.

    Si le type d'enregistrement de la règle de workflow prend seulement en charge un schéma, cette version du service Web est alors sélectionnée par défaut. Pour plus d'informations sur ces services Web, voir Oracle Web Services On Demand Guide.

  8. Enregistrez l'action de workflow.
  9. A partir de la liste d'actions du menu au niveau enregistrement, sélectionnez Configurer pour l'action d'événement d'intégration que vous souhaitez configurer.

    REMARQUE : L'option Configurer n'est pas disponible pour les actions pour lesquelles l'événement déclencheur est Lors fusion enregistrements.

  10. Dans la page de suivi Configurer une action d'événement d'intégration, cochez les cases des champs en fonction de vos besoins :
    • Cochez la case Toujours inclure si vous souhaitez que le champ soit inclus dans l'événement d'intégration, même si sa valeur n'a pas été modifiée.
    • Cochez la case Suivi des modifications si vous souhaitez qu'un événement d'intégration soit généré à chaque fois que ce champ est mis à jour.
  11. Enregistrez vos modifications.

Le tableau suivant décrit les champs de la page de suivi Configurer une action d'événement d'intégration.

Champ

Description

Nom d'affichage

Nom du champ tel qu'il apparaît dans l'interface utilisateur.

Balise d'intégration

Balise d'intégration utilisée lorsque le champ est inclus dans l'événement d'intégration.

Les balises d'intégration sont affichées dans la colonne Balise d'intégration - Web Services v2.0 de la page Champs du type d'enregistrement.

Requis

Cette case à cocher en lecture seule indique si le champ a été configuré comme champ obligatoire.

Toujours inclure

Cochez cette case si vous souhaitez que le champ soit inclus dans l'événement d'intégration, même si sa valeur n'a pas été modifiée.

Remarque : La case Toujours inclure est cochée par défaut et ne peut pas être désélectionnée dans certains champs utilisés par Oracle CRM On Demand.

Suivi des modifications

Cochez cette case si vous souhaitez qu'un événement d'intégration soit généré à chaque fois que ce champ est mis à jour. Pour plus d'informations sur la case à cocher Suivi des modifications, voir A propos de la case à cocher Suivi des modifications.

A propos de la case à cocher Suivi des modifications

La case à cocher Suivi des modifications n'est pas disponible si l'événement déclencheur de la règle de workflow est Avant suppression enregistrement, Après l'association avec le parent ou Après la dissociation du parent. Par ailleurs, si l'événement déclencheur de la règle de workflow est Après l'association avec le parent ou Après la dissociation du parent, l'ensemble de champs affiché sur la page est celui défini au niveau de l'enregistrement enfant. En effet, vous ne pouvez pas configurer le jeu de champs inclus dans l'événement d'intégration au niveau de l'enregistrement parent.

Dans le cas des actions de workflow pour lesquelles la case à cocher Suivi des modifications est disponible, l'action crée un événement d'intégration uniquement si cette case est cochée pour au moins un champ et si une modification est détectée pour au moins un des champs pour lesquels cette case est cochée. Lors de la création de l'événement d'intégration, tous les champs pour lesquels la case Toujours inclure est cochée dans l'action de workflow sont inclus dans l'événement.

Exceptions de champ système

Lorsque l'événement déclencheur de la règle de workflow est autre que Lors de la sauvegarde d'un nouvel enregistrement, Oracle CRM On Demand ne génère pas d'événements d'intégration dans les cas où la case Suivi des modifications est cochée pour un ou plusieurs des champs système suivants et où elle est désélectionnée pour tous les autres champs :

  • ModifiedDate
  • ModifiedById
  • CreatedDate
  • CreatedById
  • ID

Pour plus d'informations sur les événements d'intégration, reportez-vous à la rubrique A propos des événements d'intégration.

Vous trouverez des procédures détaillées relatives à la création d'autres types d'actions de workflow dans les rubriques suivantes :

Rubriques connexes

Pour consulter les informations connexes sur les workflows, voir les rubriques suivantes :


Publié en septembre 2017 Copyright © 2005, 2017, Oracle. Tous droits réservés. Legal Notices.