In diesem Tutorial werden wir uns genauer ansehen, wie Sie Tilda und AppMaster. Nehmen wir an, dass ein bestimmtes Formular in Tilda erstellt wurde, und unsere Aufgabe ist es, dafür zu sorgen, dass die Daten, wenn sie ausgefüllt werden, zu AppMaster gelangen, dort verarbeitet und in der Datenbank gespeichert werden.
Webhook erstellen in AppMaster
Tilda sendet Daten über einen Webhook an Drittanbieterdienste. Daher lohnt es sich, mit der Erstellung des erforderlichen Webhooks zu beginnen und zunächst den Geschäftsprozess für seinen Betrieb vorzubereiten.
Eine Besonderheit dieses Prozesses ist, dass nicht im Voraus bekannt ist, welche Daten genau abgefragt werden. Der Webhook arbeitet mit "raw" Anfragen, die ordnungsgemäß verarbeitet werden müssen. Hierfür wird der Get Request Body Block. Schauen wir uns an, welche Daten im Allgemeinen von Tilda kommen, wandeln sie in String um, schreiben sie in das Protokoll und zeigen sie als Antwort auf die Anfrage an.
Im Abschnitt Endpunkte erstellen wir sofort einen neuen Webhook. Es ist wichtig zu beachten, dass der Anforderungstyp Raw sein muss, da er keine fest kodierten Eingabeparameter hat und bereit ist, beliebige Daten zu akzeptieren. Sie müssen auch deaktivieren Middleware Token Auth deaktivieren, da Sie zum Ausfüllen eines Formulars in Tilda keine Autorisierung in AppMaster vornehmen müssen und das Senden von Daten für jedermann möglich ist.
Tilda Formular einrichten
Der nächste Schritt besteht darin, Tilda mit dem erstellten Webhook zu verbinden. Dazu genügt es, in den Einstellungen der Website-Formulare die URL anzugeben, wobei Sie bei Bedarf zusätzliche Optionen verwenden können. Als zusätzlichen Schutz können Sie zum Beispiel auch einen speziellen Schlüssel im Text der Anfrage oder in der Kopfzeile angeben.
Wenn alles richtig gemacht wurde, erscheint eine entsprechende Meldung mit der Möglichkeit, diesen Webhook sofort mit allen Formularen auf der Website zu verknüpfen.
Es bleibt nur noch, die Seite mit dem Formular zu veröffentlichen und es in Aktion zu testen.
Durch Öffnen der AppMaster-Protokolle können Sie sich vergewissern, dass die Daten des Formulars tatsächlich empfangen wurden.
Meldung: “Email=test%40gmail.com&Name=John+Smith&Phone=%2B1-202-202-22-22&Comments=Hello%2C+world%21%0AThis+is+my+comment&tranid=6355139%3A3971256761&formid=form513738662”
Sie können alle Informationen sehen, die in das Formular eingegeben werden. Zugleich wird deutlich, dass die Daten im x-www-form-urlencoded Format vorliegen bzw. nicht mehr als eine Menge von Rohdaten verarbeitet werden können, sondern als eine Sammlung von Einzelfeldern.
AppMaster Datenbankmodell
Bleibt nur noch, den richtigen Handler zu machen. Und am besten beginnt man mit einem Datenbankmodell, in dem alle Informationen gespeichert werden sollen.
Für ein Standardformular ist ein einfaches Modell mit 4 Feldern ausreichend:
- Email (String)
- Name (String)
- Phone (String)
- Comments (Text)
Als Nächstes müssen Sie zum erstellten Geschäftsprozess zurückkehren und ihn unter Berücksichtigung der erhaltenen Informationen über die Zusammensetzung der Anfrage ändern.
Die Namen der Felder aus der Tabelle, die ausgefüllt werden sollen, werden als Eingabeparameter verwendet. Die Daten daraus werden zur Erstellung eines Modells (Make Tilda) und anschließend in die Datenbank geschrieben (DB: Create Tilda).
Als letztes muss der zuvor erstellte Endpunkt für den Webhook geändert werden. Wir kennen das Format der eingehenden Daten und verarbeiten es, daher muss der Request payload type sein muss Form. Gleichzeitig ist es notwendig, die im Geschäftsprozess erstellten Parameter mit den genauen Namen der Felder aus dem ausgefüllten Formular abzugleichen (wir haben sie in den Protokollen gesehen, als wir die Daten aus der Anfrage als Rohdaten erhalten haben). In diesem Beispiel sind sie fast identisch, unterscheiden sich aber im Fall des ersten Zeichens.
Nun können Sie die erstellte Anwendung veröffentlichen und in der Praxis testen. Wenn Sie das Ausfüllen und Absenden des Formulars in Tilda wiederholen, werden die Daten an AppMaster gesendet und in die Datenbank geschrieben, was Sie mit Swagger.
