Verwenden Sie den Anforderungstyp „Formulardaten“, um verschiedene Parameter zu Ihrem Anforderungstext hinzuzufügen.

Aktionen

Folgende Parameteraktionen sind aktiviert:

Hinzufügen
Um Parameter zum Anfragetext hinzuzufügen.
Klicken Sie auf das Symbol Hinzufügen, um einen Parameter hinzuzufügen. Die Anzahl der Parameter, die im Titel der Parameter-Tabelle angezeigt wird, wird automatisch aktualisiert.
Bearbeiten
Um die vorhandenen Parameter zu bearbeiten, die im Anforderungstext verfügbar sind.
In der Tabelle Parameter fahren Sie mit der Maus über das vertikale Auslassungszeichen des Parameters, den Sie bearbeiten möchten, und klicken Sie dann auf das Bearbeiten-Symbol. Sie können den Schlüssel, den Schlüsseltyp und die Werte der Parameter im Parameter bearbeiten-Modal bearbeiten.
Aktivieren/Deaktivieren
Um die im Anforderungstext verfügbaren Parameter zu aktivieren oder zu deaktivieren. Sie können einen Parameter für die folgenden Szenarien deaktivieren:
  • Wenn die API-Anfrage Standardwerte verwendet.
  • Bei der Einführung einer neuen Funktion in einem kontrollierten Connector-Paket-Rollout.
  • Beim Testen und Iterieren neuer Funktionen in einem Connector-Paket.
  • Beim Beheben von Problemen mit einem Connector-Paket, das Parameter mit Fehlern enthält.
In der Tabelle Parameter fahren Sie mit der Maus über das vertikale Auslassungszeichen des Parameters, den Sie aktivieren oder deaktivieren möchten, und klicken Sie dann auf den Aktivieren/Deaktivieren-Schalter. Der Status des Parameters wird entsprechend in der Tabelle Parameter aktualisiert. Deaktivierte Parameter sind nicht im veröffentlichten Connector-Paket enthalten.
Text
Um die vorhandenen Parameter zu replizieren, die im Anforderungstext verfügbar sind.
In der Tabelle Parameter fahren Sie mit der Maus über das vertikale Auslassungszeichen des entsprechenden Parameters und klicken Sie auf das Kopieren-Symbol, um den ausgewählten Parameter zu duplizieren. Achten Sie darauf, dass Sie einen neuen Schlüssel im Kopieren-Modal eingeben. Alle anderen Attribute des ursprünglichen Parameters werden auf den neuen Parameter kopiert. Sobald kopiert, ist der neue Parameter standardmäßig aktiviert. Verwenden Sie den Aktivieren/Deaktivieren-Schalter, um den Parameter manuell zu deaktivieren. Der Parameteranzahl im Titel der Tabelle Parameter wird automatisch aktualisiert, wenn ein neuer Parameter mit der Option Kopieren erstellt wird.
Sie können den Schlüsseltyp und Werttyp des duplizierten Parameters im Kopieren-Modal ändern.
Löschen
Um die Parameter zu löschen, die im Anforderungstext verfügbar sind.
Führen Sie eine der folgenden Aktionen aus, um Parameter zu löschen:
  • Klicken Sie auf das Kontrollkästchen Alle auswählen im Tabellen-Header und dann auf das Symbol Löschen, das über der Tabelle verfügbar ist, um mehrere Parameter zu löschen.
  • Fahren Sie mit der Maus über das vertikale Ellipsenmenü jedes Parameters und klicken Sie dann auf das Löschen-Symbol, um den Parameter einzeln zu löschen.

Parametertabelle

Der Titel der Tabelle Parameter zeigt die Gesamtanzahl der Anforderungsparameter in einer Aktion an. Diese Zahl umfasst sowohl aktivierte als auch deaktivierte Parameter.

Sehen Sie sich Parameterdetails in der folgenden Tabelle an.

Spalte Beschreibung
Schlüssel Zeigt den Parameter-Schlüssel an. Der Paketnutzer kann den Schlüssel im Bot Editor oder API-Aufgaben-Editor nicht sehen. Der Schlüssel wird als Teil des Headers gesendet.
Schlüsseltyp Zeigt den Typ der Formulardaten an. Er bestimmt, wie die Daten interpretiert und verarbeitet werden.
  • Text: Wenn der Schlüsseltyp eine einfache Texteingabe ist. Der Inhalt wird als Nur-Text (text/plain) behandelt. Dieser Schlüsseltyp eignet sich für Daten wie Namen, Adressen oder Beschreibungen.
  • Datei: Wenn der Schlüsseltyp ein Upload einer Binärdatei ist. Der Inhalt umfasst die Rohdaten der hochgeladenen Datei selbst. Dieser Schlüsseltyp wird für das Hochladen von Dokumenten, Bildern oder anderen Binärdaten verwendet.
    Anmerkung: Das Feld „Dateityp“ ist immer benutzerdefiniert, und Nutzer können Dateien über den Bot Editor hochladen.
Wert Zeigt den Parameterwert an. Der Paketnutzer kann diesen Wert im Bot Editor oder API-Aufgaben-Editor sehen und aktualisieren.
Wert wird vom Nutzer bereitgestellt Zeigt den Status des Werts an.
  • Ja: Wenn der Wert vom Nutzer bereitgestellt wird. Der Paketnutzer muss einen entsprechenden Wert angeben, wenn er diesen Parameter im Bot Editor oder API-Aufgaben-Editor konfiguriert.
  • Nein: Wenn der Wert hartcodiert ist. Der Paketnutzer kann diesen Wert im Bot Editor oder API-Aufgaben-Editor nicht sehen. Dieser Wert wird als Teil des Headers gesendet.
Status Zeigt den Status des Parameters an.
  • Aktiviert: Wenn der Parameter aktiviert ist.
  • Deaktiviert: Wenn der Parameter deaktiviert ist.
Benennung Zeigt das Label für Werte, die Von Nutzer bereitgestellt wurden. Der Paketnutzer kann das Parameter-Label im Bot Editor oder API-Aufgaben-Editor sehen.
Beschreibung Zeigt die Parameterbeschreibung an. Der Paketnutzer kann die Parameterbeschreibung im Bot Editor oder API-Aufgaben-Editor sehen.

Anforderungstext-Parameter hinzufügen

Führen Sie diese Schritte aus, um einen Parameter zum Anforderungstext der Formulardaten hinzuzufügen:

  1. Klicken Sie auf die Registerkarte Anforderungstext im Bereich Konfiguration.
  2. Wählen Sie Formulardaten aus der Dropdown-Liste Typ.
  3. Klicken Sie auf Parameter hinzufügen oder auf das Plus-Symbol (+) am oberen Rand der Tabelle, um einen Parameter hinzuzufügen.
  4. Führen Sie Folgendes im Modal Parameter hinzufügen aus.
    1. Schlüssel: Geben Sie einen geeigneten Schlüsselnamen ein. Der Schlüsselname wird dem Paketnutzer im Bot Editor oder API-Aufgaben-Editor nicht angezeigt. Dieser Name wird als Teil des Headers gesendet.
    2. Schlüsseltyp: Wählen Sie den entsprechenden Schlüsseltyp aus der Dropdown-Liste aus.
    3. Wählen Sie eine der folgenden Optionen im Abschnitt Wert wird:
      Typ Beschreibung
      Hartcodiert Geben Sie einen Wert ein, der für den Parameter hartcodiert ist. Der Paketnutzer kann diesen Wert im Bot Editor oder API-Aufgaben-Editor nicht sehen. Dieser Wert wird als Teil des Headers gesendet.
      Vom Nutzer bereitgestellt
      1. Werteingabetyp: Aktivieren Sie dieses Kontrollkästchen, wenn Sie den Eingabewerttyp sichern möchten. Wenn Sie gesichert auswählen, können Sie den Parameter über Anmeldedaten, eine Variable oder eine unsichere Zeichenfolge eingeben.
      2. Ist dieses Feld obligatorisch? Wählen Sie Nein oder Ja, je nach den Anforderungen des Parameters.
      3. Wert (optional): Geben Sie einen Wert ein. Der Paketnutzer kann diesen Wert im Bot Editor oder API-Aufgaben-Editor sehen und aktualisieren.
      4. Bezeichnung: Geben Sie eine Bezeichnung für den Parameter ein. Der Paketnutzer kann das Parameter-Label im Bot Editor oder API-Aufgaben-Editor sehen.
      5. Beschreibung (optional): Geben Sie eine Beschreibung für den Parameter ein. Der Paketnutzer kann die Parameterbeschreibung im Bot Editor oder API-Aufgaben-Editor sehen. Die Beschreibung wird als Hilfetext im Editor angezeigt.
  5. Klicken Sie auf Hinzufügen, um den Parameter zum Anfragetext hinzuzufügen.

    Der neue Parameter wird in der Tabelle Parameter angezeigt.

Wiederholen Sie die Schritte, um weitere Parameter zum Anfragetext hinzuzufügen.