このチュートリアルでは、どのようにして Tildaと AppMaster.あるフォームがTilda で作成されたとします。私たちのタスクは、フォームに入力されたデータがAppMaster に送られ、そこで処理されてデータベースに保存されることを保証することです。
でwebhookを作成するAppMaster
Tilda は、Webhook を介してサードパーティーのサービスにデータを送信します。したがって、必要なwebhookを作成し、まず、その運用のためのビジネスプロセスを準備することから始めるとよいでしょう。
このプロセスの特徴は、どのような正確なデータが取得されるのかが事前にわからないということです。Webhookは、適切に処理される必要がある "raw"リクエストを適切に処理する必要があります。これを行うには Get Request Bodyブロックを使用します。一般的にどのようなデータがTilda から来るのか、それをString に変換し、ログに書き込み、リクエストに応答して表示するようにしてみましょう。
エンドポイントセクションで、早速新しいwebhookを作成してみましょう。ここで重要なのは、リクエストタイプは必ず Rawなぜなら、ハードコードされた入力パラメータを持たず、どのようなデータでも受け入れることができるからです。を無効化する必要もあります。 Middleware Token Authなぜなら、Tilda のフォームに入力するために、AppMaster で認証を受ける必要がなく、データの送信は誰にでも開かれているからです。
Tilda フォーム設定
次のステップは、作成した Webhook にTilda を接続することです。そのためには、サイトのフォームの設定で、URLを指定するだけでよいのですが、必要に応じて、追加のオプションを使用することができます。たとえば、追加の保護のために、リクエストの本体またはヘッダーに特別なキーを渡すこともできます。
すべてが正しく行われた場合、対応するメッセージが表示され、この Webhook をサイト上のすべてのフォームに即座にリンクさせることができるようになります。
あとはフォームを含むページを公開し、動作テストを行うだけです。
AppMaster のログを開くことで、フォームからのデータが実際に受信されたことを確認することができます。
メッセージ“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”
フォームに記入された情報はすべて見ることができます。同時に、データを受信する際に、その形式が明らかになります。 x-www-form-urlencodedのフォーマットで受信すると、それぞれ、生データの集合体としてではなく、個々のフィールドの集合体として処理することができるようになります。
AppMaster データベースモデル
あとは、正しいハンドラを作るだけです。そして、すべての情報が保存されるデータベースモデルから始めるのがベストです。
標準的なフォームの場合、4つのフィールドを持つシンプルなモデルで十分です。
- Email (String)
- Name (String)
- Phone (String)
- Comments (Text)
次に、作成したビジネスプロセスに戻り、リクエストの構成について受け取った情報を考慮して、それを変更する必要があります。
入力されるテーブルのフィールド名は、入力パラメータとして使用されます。そこからのデータは、モデル(Make Tilda)を作成し、データベースに書き込む(DB: Create Tilda).
最後に、先に作成した webhook 用のエンドポイントを変更します。入力されるデータの形式を把握して処理するので Request payload typeでなければなりません。 Form.同時に、ビジネスプロセスで作成したパラメータを、入力されたフォームのフィールド名と正確に一致させる必要があります (リクエストからデータを生データとして受け取ったときに、ログでそれらを確認しました)。この例では、ほとんど同じですが、最初の文字のケースが異なります。
これで、作成したアプリケーションを公開し、動作を確認することができます。Tilda でフォームへの入力と送信を繰り返すと、データがAppMaster に送信され、データベースに書き込まれます。 Swagger.
