Forms

プロジェクト ディレクトリの任意の場所に Excel ブックまたはGoogle シートを作成します。 このドキュメントでは、OneDrive のシートを使用します email-form.xlsx AEM プロジェクトのルートで指定します。

AEM ユーザーであることを確認します（例： helix@adobe.com）が含まれています 権限を編集 シートに。

作成したワークブックを開き、デフォルトシートの名前をに変更します incoming.


注意： 次の場合、AEMではこのワークブックにデータが送信されません incoming シートが存在しません。

Sidekick でシートをプレビューします。
注意： シートが以前にプレビューされている場合でも、シートを作成した後に再度プレビューする必要があります。 incoming 初めてシートを作成します。

取り込まれるデータに一致するヘッダーを含むシートを設定します。 手動で実行するか、AEM Admin Service のフォームルートにPOSTリクエストを送信することで実行できます。 管理サービスは、POST本文のデータを確認し、データの取り込みと Forms サービスからの最大限の活用に必要なヘッダー/テーブルおよびシートを作成します。
シートを設定するためのPOSTリクエストのフォーマットについては、を参照してください。 管理 API のドキュメントと次の例を参照してください。

リクエスト：

POST /form/{owner}/{repo}/{ref}/en/email-form.json HTTP/1.1
{"data":{"firstName":"test"}}

応答：

HTTP/1.1 200 OK
{"rowCount":2,"columns":["firstName"]}

curl やPostmanなどのツールを使用して、このPOSTリクエストを行うことができます。 次に例を示します。

curl -s -i -X POST 'https://admin.hlx.page/form/{owner}/{repo}/{ref}/en/email-form.json' \
--header 'Content-Type: application/json' \
--data '{"data":{"firstName":"test"}}'

上記のPOSTリクエストを通じて、フォームを設定するために管理サービスで使用されるフォームフィールドとサンプル値のサンプルデータを提供しています。
シートを設定するには Admin サービスをお勧めしますが、ヘッダーを手動で作成する場合は、ドキュメントを参照してください Forms シートの手動設定.

送信後 POST admin サービスへのリクエスト ワークブックには、次のような変更が表示されます。

1. というシート helix-default が作成されました。 このシートのデータは、 GET シートに対してリクエストが行われます。 スプレッドシートの数式を使用して、 incoming 他の場所で消費するためのシート。
   
   注意： この helix-default シートには、個人を特定できる情報や、公開アクセスが許可されていない他のデータを含めないでください。

2. というシート slack 作成されました。 ここでは、データがスプレッドシートに取り込まれるたびに、Slackチャネルに自動通知を設定できます。 現在、AEMは、AEM Engineering Slack 組織とAdobeエンタープライズサポート組織への通知のみをサポートしています。

   1. Slack通知を設定するには、 teamId Slackワークスペースおよびの channel 名前または ID。 slack-bot に debug command）を使用して、 teamId および channel ID。 使用， channel チャネルの名前は変更できないので、名前の代わりに ID をお勧めします。
      
      注意： 古いフォームにはありませんでした teamId 列。 この teamId はに含まれていました channel 列（で区切る） # または /.
   2. 次のいずれかを入力 タイトル あなたはとの下に欲しい フィールド Slack通知に表示するフィールドの名前を入力します。 各見出しはコンマで区切る必要があります（例： name, email）に設定します。