Documentation Oracle Cloud Infrastructure

Mapping de flux

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

Mapper une intention à un flux

Lorsque vous créez un flux, vous pouvez mettre en correspondance une intention avec un flux :

  1. Sur la page Evénements, cliquez sur + Ajouter un flux.
  2. Dans la boîte de dialogue Créer un flux, renseignez les champs requis, y compris Nom de l'intention.

Si vous avez déjà défini un flux et que vous devez à présent lui mettre en correspondance une intention, voici comment mettre en correspondance l'intention :

  1. Sur la page Flux, dans la liste des flux, sélectionnez Flux principal.
  2. Cliquez sur Il s'agit d'une image de l'icône Ajouter. dans la section Evénements d'intention.
    Image de l'en-tête de section Evénements d'intention.

  3. Dans la boîte de dialogue Créer un gestionnaire d'événements d'intention, sélectionnez le nom de l'intention et le flux mis en correspondance, puis cliquez sur Créer.
    Voici la description de df-create-intent-event-handler-dialog.png :
    Description de l'image df-create-intent-event-handler-dialog.png

    .

Mettre en correspondance un événement intégré avec un flux

  1. Sélectionnez Flux principal.
  2. Cliquez sur Il s'agit d'une image de l'icône Ajouter. dans la section Evénements intégrés.
    Image de l'en-tête Événements intégrés.

  3. Dans la boîte de dialogue Créer un gestionnaire d'événements intégré, sélectionnez le type d'événement dans le flux mis en correspondance, puis cliquez sur Créer.
    Description de l'image df-2-0-build-events-mapping-dialog.png ci-après
    Description de l'illustration df-2-0-build-events-mapping-dialog.png

Mettre en correspondance un événement de transition avec un flux

  1. Sélectionnez le flux vers lequel vous souhaitez mapper l'événement.
  2. Sélectionnez l'onglet Configuration.
  3. Développez la section Mises en correspondance d'événements.
  4. Dans le champ de la transition que vous voulez mapper, sélectionnez un état.

Appeler un flux à partir d'un autre flux

Pour appeler un flux à partir d'un autre flux, utilisez les composants Invoke Flow et End Flow. Voici comment cela fonctionne :

  • 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 de flux de fin du flux enfant retransmet ses paramètres de sortie au flux parent et peut également déclencher une action que le flux parent exécute une fois le flux enfant terminé.

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

    (Les transitions d'action vous permettent de brancher le flux parent en fonction des résultats du flux enfant. Par exemple, si vous disposez d'un flux enfant censé rechercher un compte, il peut transmettre une action en cas de succès et une action en cas d'échec.)

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

Par exemple, un flux Mettre à jour le compte dans une brique 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 le 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 à l'endroit 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. Sur la page Général, entrez un nom et une description.
  5. Sur 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. Ensuite, cliquez sur Enregistrer. 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 (parent) en cours qui est définie sur la valeur du paramètre de sortie.
  8. Ouvrez la page Transitions pour définir l'état suivant et, si nécessaire, ajoutez des transitions d'action telles que l'annulation ou l'erreur.
  9. Si vous avez configuré des transitions d'action dans le flux parent, configurez les états de flux de fin dans le flux enfant pour déclencher ces actions. Pour ce faire, accédez à la page Composant de l'inspecteur de propriétés de chaque flux final.
  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 du flux d'appel du flux parent. Entrez ensuite une valeur de sortie de paramètre et cliquez sur Enregistrer.

Appeler une autre brique à partir d'un flux

Pour appeler une autre brique à partir d'un flux, utilisez les composants Invoke Skill et End Flow. Voici comment cela fonctionne :

  • La brique que vous appelez doit se trouver dans le même assistant numérique que la brique à partir de laquelle vous appelez.
  • La brique que vous appelez doit avoir un flux désigné comme public.
  • Le flux appelant utilise un état d'appel de brique pour indiquer une version d'une brique et un flux cible dans cette brique. Il utilise cet état pour transmettre des valeurs à la brique appelée et en recevoir.
  • L'état de flux de fin du flux cible retransmet ses paramètres de sortie au flux appelant et peut également déclencher une action que le flux appelant exécute une fois le flux cible terminé.

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

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

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

Par exemple, un flux de mise à jour de compte dans une brique financière serait le flux appelant qui ne peut terminer la demande de mise à jour de l'utilisateur qu'en appelant un flux cible, Get Account. 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 d'appel de brique 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 la bascule Public.
    Il s'agit d'une capture d'écran d'une partie de la page Configuration qui affiche le champ Autorisation requise et le commutateur public.

  3. Dans le flux appelant, cliquez sur l'icône Ajouter un état à l'endroit où vous voulez appeler le flux cible et sélectionnez le composant Contrôle de flux > Appeler une brique. Cliquez ensuite sur Insérer.
  4. Ouvrez l'inspecteur de propriétés pour l'état d'appel de brique que vous venez d'ajouter.
  5. Sur la page Général, entrez un nom et une description.
  6. Sur la page Composant, sélectionnez une brique dans la liste déroulante Brique.
  7. Sélectionnez une version dans la liste déroulante Version de brique.
    Remarque

    Cette valeur s'applique uniquement si la brique référencée est une brique autonome. Si la brique cible se trouve dans le même assistant numérique que la brique appelante, lors de l'exécution, la version de cette brique 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 Nom de flux, sélectionnez l'un des flux publics appartenant à la brique 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. Ensuite, cliquez sur Enregistrer. 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 définie sur la valeur du paramètre de sortie.
    Remarque

    Si le flux cible n'est pas encore disponible, vous pouvez indiquer que le flux utilise des données de simulation pour les paramètres de sortie afin que vous puissiez continuer à développer et tester le flux en attendant que le flux cible devienne disponible. Pour ce faire, définissez la propriété Utiliser la simulation sur True et entrez les paramètres et les valeurs de sortie dans le champ Paramètres de sortie de simulation. Entrez 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, ajoutez des transitions d'action telles que l'annulation ou l'erreur.
  12. Si vous avez configuré des transitions d'action dans le flux appelant, configurez les états de flux de fin dans le flux cible pour déclencher ces actions. Pour ce faire, accédez à la page Composant de l'inspecteur de propriétés de chaque flux final.
  13. Si vous devez retransmettre un paramètre au flux appelant, cliquez sur Ajouter, puis entrez le nom correspondant au nom du paramètre dans l'état de brique d'appel du flux appelant. Entrez ensuite une valeur de sortie de paramètre et cliquez sur Enregistrer.