Configurer une tâche API dans un formulaire

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

Prérequis

  • Vous devez disposer d'une licence Bot Creator.
  • Vous devez en premier lieu créer une Tâche API pour l'invoquer dans le formulaire.
Cette rubrique décrit comment invoquer une Tâche API dans un formulaire. Dans cet exemple, vous allez créer un formulaire de code postal qui invoque une Tâche API 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 Tâche API. Pour plus d'informations, voir Créer un formulaire.
    Nommez ce formulaire Tâche API - 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 Tâche API.
    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 à l'aide des conditionssietalorset indiquer 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 Tâche API. Lors de l'exécution, la Tâche API 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 Tâche API).
    3. Saisissez une condition Si pour valider si le bouton est activé.Invoquer une tâche API dans un 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 Tâche API sur un formulaire en utilisant l'option Ajouter un mappage de variables.
      Remarque : Si vous modifiez un Tâche API 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 Tâche API après l'ajout les variables.
    6. Cliquez sur Parcourir pour sélectionner une Tâche API spécifique afin d'effectuer une opération spécifiée. Dans cet exemple, un Tâche API (Tâche API - Code postal) est sélectionné pour récupérer le lieu et l'état de n'importe quel code postal.