API-Aufgabe in einem Formular aufrufen

Erstellen Sie ein Formular, um den API-Aufgabe aufzurufen, und ordnen Sie die API-Aufgabe-Variablen den erforderlichen Feldern 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 den Ort und das Bundesland auf der Grundlage der eingegebenen Postleitzahl abzurufen. Das erstellte Formular kann durch einen Prozess ausgeführt werden. 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.
    Nennen Sie dieses Formular 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. Falls erforderlich, geben Sie ein Min. und Max. Zeichenlimit ein. Sie können in das Feld Min. 1 und in das Feld Max. 5 eingeben.
    4. Ziehen Sie außerdem zwei weitere Textfeld-Elemente in den Bereich und benennen Sie sie als Ort und Bundesland.
    5. Ziehen Sie aus der Spalte Elemente ein Schaltfläche-Element und legen Sie es in Ihrem Formulardesigner ab. Geben Sie einen Namen für diese Schaltfläche in das Feld Schaltflächentext (erforderlich) ein (zum Beispiel: Zurücksetzen). Das folgende Bild zeigt ein ausgefülltes Formular:
      Aufgabenbeispiel für Postleitzahl-API
  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 der Wert des Postleitzahl-Elements größer oder gleich fünf sein muss. Wenn diese Bedingung erfüllt ist, werden die Werte aus den API-Aufgabe-Variablen in die Elementfelder „Ort“ und „Bundesland“ übernommen. 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 die von Ihnen eingegebene Postleitzahl zu überprüfen. Sie können zum Beispiel prüfen, ob die eingegebene Postleitzahl mindestens 5 Zeichen hat.
      Beispiel für eine Aufgabenüberprüfung für eine Postleitzahl-API auf mindestens 5 Zeichen
    4. Um die Dann-Klausel zu definieren, wählen Sie Formularaktionen und dann aus der Dropdown-Liste die Option Wert von API-Aufruf abrufen.
      Dann-Bedingung für Aufgabenformular der Postleitzahl-API
    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 (Postleitzahl-Aufgabe) ausgewählt, um den Ort und das Bundesland einer beliebigen Postleitzahl abzurufen.
  4. Fügen Sie der Schaltfläche Zurücksetzen eine Regel hinzu. In diesem Beispiel sind die Formularregeln für die Schaltfläche „Zurücksetzen“ so definiert, dass die Werte in allen Feldern gelöscht werden, wenn Sie auf die Schaltfläche Zurücksetzen klicken.
    1. Klicken Sie auf die Schaltfläche Regel hinzufügen.
    2. Geben Sie eine Wenn-Bedingung ein, um den Zustand Ist angeklickt der Schaltfläche zu erfassen. Diese Bedingung ist immer dann erfüllt, wenn die Schaltfläche angeklickt wird.
      Beispiel für eine Aufgabenüberprüfung für eine Postleitzahl-API auf mindestens 5 Zeichen
    3. Um die Dann-Klausel zu definieren, klicken Sie auf Aktion hinzufügen und dann auf das Dropdown-Menü Element auswählen, um alle TextBox-Elemente auszuwählen, die beim Klicken auf die Schaltfläche Zurücksetzen gelöscht werden sollen.
      Aufgabenformular „Zurücksetzen“ für Postleitzahl-API
    4. Klicken Sie auf das Dropdown-Menü unter dem Dropdown-Menü Element auswählen und wählen Sie Wert löschen.
      Anmerkung: Wenn Sie in einer einzigen Sitzung einen API-Aufgabe in einem Formular mehrmals aufrufen, kann ein Fehler auftreten. Um diesen Fehler zu beheben, fügen Sie dem Formular eine Schaltfläche zum Zurücksetzen hinzu, um die vorhandenen Werte zu löschen.