Documentation sur Oracle Cloud Infrastructure

Mappage de flux

Les rubriques suivantes présentent les différents types d'événement à partir desquels vous pouvez mapper un flux.

Mapper une intention à un flux

Vous pouvez mapper une intention à un flux lorsque vous créez le flux :

  1. Dans la page Événements, cliquez sur + Ajouter un flux.
  2. Dans la boîte de dialogue Créer un flux, remplissez les champs obligatoires, notamment Intent Name (Nom de l'intention).

Si vous avez déjà défini un flux et que vous devez maintenant lui mapper une intention, voici comment mapper l'intention :

  1. Dans la page Flux, dans la liste des flux, sélectionnez Flux principal.
  2. Cliquez sur Ceci est une image de l'icône Add (Ajouter). dans la section Intent Events (Événements d'intention).
    Ceci est une image de l'en-tête de section Intent Events (Événements d'intention).

  3. Dans la boîte de dialogue Créer un programme de traitement d'événements d'intention, sélectionnez le nom de l'intention et le flux mappé, puis cliquez sur Créer
    Description de df-create-intent-event-handler-dialog.png :
    Description de l'illustration df-create-intent-event-handler-dialog.png

    .

Mapper un événement prédéfini à un flux

  1. Sélectionnez Flux principal.
  2. Cliquez sur Ceci est une image de l'icône Add (Ajouter). dans la section Événements intégrés.
    Ceci est une image de l'en-tête Built-In Events (Événements intégrés).

  3. Dans la boîte de dialogue Créer un programme de traitement d'événements intégré, sélectionnez le type d'événement dans le flux et mappé, puis cliquez sur Créer.
    Description de df-2-0-built-events-mapping-dialog.png ci-dessous
    Description de l'illustration df-2-0-built-events-mapping-dialog.png

Mapper un événement de transition à un flux

  1. Sélectionnez le flux auquel vous voulez mapper l'événement.
  2. Sélectionnez l'onglet Configuration.
  3. Développez la section Mappage d'événements.
  4. Dans le champ de la transition à mapper, sélectionnez un état.

Appeler un flux à partir d'un autre flux

Si vous souhaitez appeler un flux à partir d'un autre flux, utilisez les composants Invoke Flow et End Flow. Fonctionnement :

  • Le flux parent appelle le flux enfant à partir d'un état de flux d'appel. Il utilise cet état pour transmettre des valeurs au flux enfant et en recevoir.
  • L'état du flux de fin du flux enfant transmet ses paramètres de sortie au flux parent et peut également déclencher une action que le flux parent exécute après la fin du flux enfant.

    Si le flux enfant se branche et a plusieurs états de flux de fin, chacun peut transmettre sa propre action au flux parent, et le flux parent peut utiliser ces actions pour déterminer la branche à suivre.

    (Les transitions d'actions vous permettent de brancher le flux parent en fonction des résultats du flux enfant. Par exemple, si vous avez un flux enfant qui est censé rechercher un compte, il peut passer une action pour le succès et une action pour l'échec.)

  • Une fois le flux enfant terminé, le flux parent reprend.

Par exemple, un flux Mettre à jour un compte dans une compétence financière serait le flux parent qui ne peut terminer la demande de mise à jour de l'utilisateur qu'en appelant un flux enfant, Obtenir un compte. Le résultat, ou paramètre de sortie attendu par le flux parent après l'exécution du flux enfant, est le compte utilisateur. Dans ce cas, le compte est le paramètre de sortie envoyé à l'état de flux d'appel par l'état de flux de fin du flux enfant.

Pour lier des flux :
  1. Créez les paramètres d'entrée et de sortie pour le flux enfant.
  2. Dans le flux parent ou appelant, cliquez sur l'icône Ajouter un état au point où vous voulez appeler le flux enfant et sélectionnez le composant Contrôle de flux > Appeler le flux. Cliquez ensuite sur Insérer.
  3. Ouvrez l'inspecteur de propriétés pour l'état du flux d'appel que vous venez d'ajouter.
  4. Dans la page Général, entrez un nom et une description.
  5. Dans la page Composant, sélectionnez le flux enfant dans la liste déroulante Flux.
  6. Si le flux parent doit transmettre des paramètres au flux enfant, cliquez sur Ajouter, puis sélectionnez le paramètre d'entrée appartenant au flux enfant et entrez une valeur par défaut. Cliquez sur Save. Répétez cette étape pour chaque paramètre d'entrée.
  7. Si le flux parent attend un résultat du flux enfant, cliquez sur Ajouter pour sélectionner le paramètre de sortie appartenant au flux enfant, puis nommez la variable du flux courant (parent) qui est réglée à la valeur du paramètre de sortie.
  8. Ouvrez la page Transitions pour définir l'état suivant et, si nécessaire, ajouter des transitions d'action telles que l'annulation ou l'erreur.
  9. Si vous avez configuré des transitions d'actions dans le flux parent, configurez les états de flux de fin dans le flux enfant pour déclencher ces actions. Vous effectuez ces opérations dans la page Composant de l'inspecteur des propriétés de chaque flux de fin.
  10. Si vous devez retransmettre un paramètre au flux parent, cliquez sur Ajouter, puis entrez le nom correspondant au nom du paramètre dans l'état d'appel du flux parent. Entrez ensuite une valeur de sortie de paramètre et cliquez sur Enregistrer.

Appeler une autre compétence à partir d'un flux

Pour appeler une autre compétence à partir d'un flux, utilisez les composants Invoke Skill et End Flow. Fonctionnement :

  • La compétence que vous appelez doit se trouver dans le même assistant numérique que la compétence d'où vous appelez.
  • La compétence que vous appelez doit avoir un flux désigné comme public.
  • Le flux appelant utilise un état Invoke Skill pour spécifier une version d'une compétence et un flux cible dans cette compétence. Il utilise cet état pour transmettre des valeurs à et recevoir des valeurs de la compétence appelée.
  • L'état du flux de fin du flux cible transmet ses paramètres de sortie au flux appelant et peut également déclencher une action que le flux appelant exécute après la fin du flux cible.

    Si le flux cible se branche et a plusieurs états de flux de fin, chacun peut transmettre sa propre action au flux appelant, et le flux appelant peut utiliser ces actions pour déterminer la branche à suivre.

    (Les transitions d'actions vous permettent de brancher le flux appelant en fonction des résultats du flux cible. Par exemple, si vous avez un flux cible qui est censé rechercher un compte, il peut transmettre une action pour le succès et une action pour l'échec.)

  • Une fois le flux cible terminé, le flux appelant de la compétence appelante reprend.

Par exemple, un flux Mettre à jour un compte dans une compétence financière serait le flux d'appel qui ne peut terminer la demande de mise à jour de l'utilisateur qu'en appelant un flux cible, Obtenir un compte. Le résultat, ou paramètre de sortie attendu par le flux appelant après l'exécution du flux cible, est le compte utilisateur. Dans ce cas, le compte est le paramètre de sortie envoyé à l'état de compétence d'appel par l'état de flux de fin du flux cible.

Pour lier des flux :
  1. Créez les paramètres d'entrée et de sortie pour le flux cible.
  2. Dans le flux cible, sélectionnez l'onglet Configuration, développez la section Général et activez le commutateur Public.
    Il s'agit d'une capture d'écran d'une partie de la page Configuration qui affiche le champ Require Authorization (Exiger une autorisation) et le commutateur Public (Public).

  3. Dans le flux d'appel, cliquez sur l'icône Add State (Ajouter un état) au point où vous voulez appeler le flux cible et sélectionnez le composant Flow Control (Contrôle de flux) > Invoke Skill (Appeler une compétence). Cliquez ensuite sur Insérer.
  4. Ouvrez l'inspecteur de propriétés pour l'état d'appel de compétence que vous venez d'ajouter.
  5. Dans la page Général, entrez un nom et une description.
  6. Dans la page Component (Composant), sélectionnez une compétence dans la liste déroulante Skill (Compétences).
  7. Sélectionnez une version dans la liste déroulante Skill Version (Version de compétence).
    Note

    Cette valeur s'applique uniquement si la compétence référencée est une compétence autonome. Si la compétence cible se trouve dans le même assistant numérique que la compétence appelante, à l'exécution, la version de cette compétence qui se trouve dans l'assistant numérique est utilisée et la valeur de ce champ est ignorée.
  8. Dans la liste déroulante Flow Name (Nom du flux), sélectionnez l'un des flux publics appartenant à la compétence sélectionnée.
  9. Si le flux appelant doit transmettre des paramètres au flux cible, cliquez sur Ajouter, puis sélectionnez le paramètre d'entrée appartenant au flux cible et entrez une valeur par défaut. Cliquez sur Save. Répétez cette étape pour chaque paramètre d'entrée.
  10. Si le flux appelant attend un résultat du flux cible, cliquez sur Ajouter pour sélectionner le paramètre de sortie appartenant au flux cible, puis nommez la variable du flux appelant qui est réglée à la valeur du paramètre de sortie.
    Note

    Si le flux cible n'est pas encore disponible, vous pouvez spécifier que le flux utilise des données fictives pour les paramètres de sortie afin que vous puissiez continuer à développer et à tester le flux en attendant que le flux cible soit disponible. Pour ce faire, réglez la propriété Utiliser la simulation à True et entrez les paramètres et les valeurs de sortie dans le champ Paramètres de sortie de la simulation. Entrer chaque paramètre sur une ligne distincte dans le formulaire 
    ParamName: ParamValue
  11. Ouvrez la page Transitions pour définir l'état suivant et, si nécessaire, ajouter des transitions d'action telles que l'annulation ou l'erreur.
  12. Si vous avez configuré des transitions d'actions dans le flux appelant, configurez les états de flux de fin dans le flux cible pour déclencher ces actions. Vous effectuez ces opérations dans la page Composant de l'inspecteur des propriétés de chaque flux de fin.
  13. Si vous devez retransmettre un paramètre au flux appelant, cliquez sur Add (Ajouter), puis entrez le nom correspondant au nom du paramètre dans l'état d'appel de compétence du flux appelant. Entrez ensuite une valeur de sortie de paramètre et cliquez sur Enregistrer.