Créez et configurez un formulaire pour invoquer le API Task et associez les variables du API Task aux champs obligatoires du formulaire.

Prérequis

  • Vous devez disposer d\'une licence Bot Creator.
  • Vous devez en premier lieu créer une API Task pour l\'invoquer dans le formulaire.
Cette rubrique décrit comment invoquer une API Task dans un formulaire. Dans cet exemple, vous allez créer un formulaire de code postal qui invoque une API Task pour récupérer les détails des éléments place et state en fonction du code postal fourni. Le formulaire créé est exécuté par le biais d\'un processus. Vous pouvez créer un formulaire avec les champs propres à votre cas d\'utilisation.

Procédure

  1. Accédez à un formulaire existant ou créez-en un nouveau à l\'emplacement où vous souhaitez invoquer un API Task. Pour plus d\'informations, voir Créer un formulaire.
    Nommez ce formulaire API Task - Formulaire Code postal.
  2. Concevoir un formulaire : Utilisez les éléments de formulaire pour construire un formulaire interactif basé sur votre cas d\'utilisation. Dans cet exemple, le formulaire est conçu pour mapper les variables de code postal à partir de la API Task.
    1. Dans la colonne Éléments, faites glisser l\'élément Zone de texte et déposez-le dans votre concepteur de formulaires.
      L\'onglet Propriétés apparaît avec les champs pertinents sur le côté droit de l\'écran.
    2. Saisissez un Libellé de l\'élément. Par exemple : Code postal.
    3. Faites glisser l\'élément Bouton et déposez-le dans le concepteur sous la zone de texte Code postal. Nommez ce bouton dans le champ Texte du bouton (obligatoire) Soumettre.
    4. En outre, faites glisser deux autres éléments Zone de texte et nommez-les Lieu et État.
  3. Ajoutez les règles de formulaire. Les règles de formulaire fournissent les conditions requises pour chaque élément du formulaire. Vous pouvez définir des règles de formulaire en utilisant les conditions if et then et spécifier les actions qui seront exécutées lorsque les conditions sont remplies. Dans cet exemple, les règles du formulaire sont configurées de telle sorte que lorsqu\'un code postal est saisi et que le bouton Soumettre est activé, la zone Lieu et État récupère les valeurs des variables API Task. Lors de l\'exécution, la API Task ne fonctionnera pas comme prévu si les conditions de la règle de formulaire ne sont pas remplies.
    1. Cliquez sur l\'onglet Règles de formulaire.
    2. Si vous le souhaitez, saisissez un nom pour la règle. (Par exemple, Appel du API Task ).
    3. Saisissez une condition Si pour valider si le bouton est activé.Invoquer un API Task dans le formulaire
    4. Pour définir la clause Alors, sélectionnez Actions de formulaire, puis sélectionnez Obtenir la valeur de l\'appel d\'API dans le menu déroulant.
    5. Vous pouvez mapper les variables associées au API Task sur un formulaire en utilisant l\'option Ajouter un mappage de variables.
      Remarque : Si vous modifiez un API Task publié et que vous ajoutez des variables supplémentaires après avoir archivé la tâche, les variables ne s\'affichent pas dans le formulaire. Vous devez procéder au check-in de API Task après l\'ajout les variables.
    6. Cliquez sur Parcourir pour sélectionner une API Task spécifique afin d\'effectuer une opération spécifiée. Dans cet exemple, un API Task ( API Task - Code postal ) est sélectionné pour récupérer le lieu et l\'état de n\'importe quel code postal.