Konfigurieren einer API-Aufgabe in einem Formular

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

Vorbereitungen

  • Sie müssen über eine Bot Creator-Lizenz verfügen.
  • Sie müssen zuerst eine API-Aufgabe erstellen, die über das Formular aufgerufen werden soll.
In diesem Thema wird beschrieben, wie Sie eine API-Aufgabe in einem Formular aufrufen. In diesem Beispiel erstellen Sie ein Postleitzahlenformular, das eine API-Aufgabe 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-Aufgabe aufrufen möchten. Weitere Details finden Sie unter Erstellen eines Formulars.
    Benennen Sie dieses Formular mit API-Aufgabe – 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-Aufgabe 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 die Formularregeln mit denWenn-undDann-Bedingungen festlegen und die Aktionen angeben, die ausgeführt werden sollen, 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-Aufgabe abruft. Während der Ausführung funktioniert die API-Aufgabe 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-Aufgabe abrufen“).
    3. Geben Sie eine Wenn-Bedingung ein, um zu validieren, ob die Schaltfläche gedrückt wird.Aufrufen einer API-Aufgabe im Formular
    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. Mit der Option Variablenzuordnung hinzufügen können Sie Variablen, die mit dem API-Aufgabe verknüpft sind, zuordnen.
      Anmerkung: Wenn Sie einen veröffentlichten API-Aufgabe 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-Aufgabe einchecken, nachdem Sie die Variablen hinzugefügt haben.
    6. Klicken Sie auf Durchsuchen, um einen bestimmten API-Aufgabe zum Durchführen einer angegebenen Operation auszuwählen. In diesem Beispiel wird ein API-Aufgabe (API-Aufgabe – Postleitzahl) ausgewählt, um den Ort und das Bundesland einer beliebigen Postleitzahl abzurufen.