API Task in einem Formular konfigurieren

Erstellen und konfigurieren Sie ein Formular, um den API Task aufzurufen, und ordnen Sie die API Task-Variablen den Pflichtfeldern des Formulars zu.

Vorbereitungen

  • Sie müssen über eine Bot Creator-Lizenz verfügen.
  • Sie müssen zuerst eine API Task erstellen, die über das Formular aufgerufen werden soll.
In diesem Thema wird beschrieben, wie Sie eine API Task in einem Formular aufrufen. In diesem Beispiel erstellen Sie ein Postleitzahlenformular, das eine API Task aufruft, um place (Ort) und state (Bundesland) auf der Grundlage der eingegebenen Postleitzahl zu erhalten. Das erstellte Formular wird durch einen Prozess ausgeführt. Sie können ein Formular mit den Feldern erstellen, die für Ihren Anwendungsfall spezifisch sind.

Prozedur

  1. Navigieren Sie zu einem Formular oder erstellen Sie ein neues Formular, in dem Sie einen API Task aufrufen möchten. Weitere Details finden Sie unter Erstellen eines Formulars.
    Benennen Sie dieses Formular mit API Task – Postleitzahl-Formular.
  2. Ein Formular entwerfen: Verwenden Sie die Formularelemente, um ein interaktives Formular auf der Grundlage Ihres Anwendungsfalls zu erstellen. In diesem Beispiel ist das Formular für die Zuordnung der Postleitzahlvariablen aus der API Task vorgesehen.
    1. Ziehen Sie aus der Spalte Elemente das Element Textfeld und legen Sie es in Ihrem Formulardesigner ab.
      Die Registerkarte Eigenschaften erscheint mit den entsprechenden Feldern auf der rechten Seite des Bildschirms.
    2. Geben Sie eine Elementbezeichnung ein. Beispiel: Postleitzahl.
    3. Ziehen Sie das Schaltflächen-Element in den Designer unterhalb des Textfelds Postleitzahl. Geben Sie einen Namen für diese Schaltfläche in das Feld Schaltflächentext (erforderlich) ein und wählen Sie Senden.
    4. Ziehen Sie außerdem zwei weitere Textfeld-Elemente in den Bereich und benennen Sie sie als Ort und Bundesland.
  3. Fügen Sie die Formularregeln hinzu. Formularregeln legen die Bedingungen fest, die für jedes Element des Formulars erforderlich sind. Sie können Formularregeln mit den Bedingungen Wenn und Dann festlegen und die Aktionen angeben, die ausgeführt werden, wenn die Bedingungen erfüllt sind. In diesem Beispiel sind die Formularregeln so konfiguriert, dass nach Eingabe einer Postleitzahl und Drücken der Schaltfläche Senden das Elementfeld für Ort und Bundesland die Werte aus den Variablen der API Task abruft. Während der Ausführung funktioniert die API Task nicht wie erwartet, wenn die Bedingungen der Formularregel nicht erfüllt sind.
    1. Klicken Sie auf die Registerkarte Formularregeln.
    2. Geben Sie, falls gewünscht, einen Namen für die Regel ein. (Zum Beispiel „API Task abrufen“).
    3. Geben Sie eine Wenn-Bedingung ein, um zu validieren, ob die Schaltfläche gedrückt wird.Eine API Task im Formular aufrufen
    4. Um die Dann-Klausel zu definieren, wählen Sie Formularaktionen und dann aus der Dropdown-Liste die Option Wert von API-Aufruf abrufen.
    5. Sie können dem API Task zugeordnete Variablen mithilfe der Option Variablenzuordnung hinzufügen einem Formular zuordnen.
      Anmerkung: Wenn Sie einen veröffentlichten API Task bearbeiten und zusätzliche Variablen hinzufügen, nachdem Sie die Aufgabe eingecheckt haben, werden die Variablen nicht im Formular angezeigt. Sie müssen den API Task einchecken, nachdem Sie die Variablen hinzugefügt haben.
    6. Klicken Sie auf Durchsuchen, um einen bestimmten API Task zum Durchführen einer angegebenen Operation auszuwählen. In diesem Beispiel wird ein API Task ( API Task – Postleitzahl ) ausgewählt, um den Ort und das Bundesland einer beliebigen Postleitzahl abzurufen.