Webformular
Zuletzt aktualisiert
Zuletzt aktualisiert
Ähnlich wie beim JSON-Connector akzeptiert auch dieser Connector Daten im JSON-Format. Allerdings ist das Schema, wie das JSON aufgebaut sein muss, bei diesem Connector bereits vorgegeben.
Um einen neuen Webformular-Connector zu erstellen, wählen Sie den Menüpunkt Connectoren und klicken anschliessend auf das Symbol.
Anschliessend geben Sie einen Namen ein, wählen die Option Webformular aus und klicken auf Weiter.
Mit der Definition von Formularfeldern legen Sie fest, welche Daten für diesen Connector erwartet werden. Jedes Formularfeld wird als Event-Variable im Workflow zur Verfügung gestellt.
So definieren Sie ein Formularfeld:
Wählen Sie den Datentyp des Formularfeldes auf der rechten Seite aus.
Ziehen Sie den Datentyp per Drag'n'Drop auf die linke Seite.
Geben Sie den gewünschten Namen für das Feld ein.
Es stehen folgende Datentypen für ein Formularfeld zur Verfügung:
Text
Datum
Zahl
Zeitstempel
Boolean
Der Datentyp bestimmt, wie das Formularfeld im JSON formatiert wird.
Ein Datum muss im Format yyyy-mm-dd
gesendet werden, zum Beispiel 2024-11-26
.
Zeitstempel sind im ISO-8601 Format zu senden, zum Beispiel 2024-11-26T14:24:41+01:00
.
Boolean kann nur die Werte true
oder false
annehmen.
Das JSON welches Sie an Robot schicken, muss auf oberster Ebene zwei Properties haben:
payload
callbackUrl
Der Payload beinhaltet die von Ihnen definierten Formularfelder. Der Name jedes Formularfeldes fungiert dabei als Key.
Die callbackUrl
ist optional und kann eine URL enthalten, die von Robot aufgerufen wird, wenn der Workflow abgeschlossen ist. Wenn Sie keine Callback-URL wünschen, können Sie dieses Property mit dem Wert null
senden.
Ausgehend vom Webformular, welches unter Formularfelder zu sehen ist, muss das JSON wie folgt aussehen:
Im payload
sind alle Formularfelder zu finden, die für diesen Connector definiert wurden.
Die URL, an die Sie Daten im JSON-Format senden können, wird angezeigt, sobald Sie den Connector öffnen. Ist das Feld leer und keine URL sichtbar, bedeutet das, dass Ihrem Projekt noch kein API-Key zugewiesen wurde. In diesem Fall wenden Sie sich bitte an Ihren Ansprechpartner, um einen API-Key zu erhalten.
Daten können nur über die POST-Methode gesendet werden. Die Anfrage wird mit dem HTTP-Status-Code 202 Accepted
bestätigt, wobei der Response-Body leer bleibt.
Erhalten Sie einen anderen Status-Code, wurden Ihre Daten nicht akzeptiert und auch kein Workflow ausgelöst.