Forms

在项目目录下的任何位置创建Excel工作簿或Google工作表。 本文档在OneDrive中使用了一个名为的工作表 email-form.xlsx 在AEM项目的根目录下。

确保AEM用户(例如 helix@adobe.com)对于对于您的项目所配置的 编辑权限 在工作表上。

打开创建的工作簿，并将默认工作表重命名为 incoming.


注意： 如果符合以下条件，AEM将不会向此工作簿发送任何数据 incoming 工作表不存在。

在 Sidekick 中预览工作表。
注意： 即使以前预览过工作表，也必须在创建 incoming 首次填写工作表。

设置带有与所摄取数据匹配的标头的工作表。 您可以手动执行此操作，也可以向AEM管理服务中的表单路由发送POST请求。 Admin服务将查看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 请求管理员服务，您将看到对工作簿的以下更改。

1. 名为的工作表 helix-default 创建。 此表中的数据是当 GET 向工作表发出请求。 这是使用电子表格公式汇总以下各项的数据的好地方： incoming 可供其他地区消费的资产。
   
   注意： 此 helix-default 工作表绝不应包含任何个人身份信息或您不可以公开访问的其他数据。

2. 名为的工作表 slack 创建。 在此，您可以设置无论何时将数据摄取到电子表格中，都向Slack渠道自动发送通知。 当前，AEM仅支持向AEM工程部Slack组织以及Adobe企业支持组织发送通知。

   1. 要设置Slack通知，请输入 teamId Slack工作区和 channel 名称或ID。 您还可以询问Slack机器人(使用 debug 命令) teamId 和 channel 标识。 使用 channel 最好使用ID而不是名称，因为它在渠道重命名中幸存下来。
      
      注意： 旧表单没有 teamId 列。 此 teamId 包含在 channel 列，以 # 或 /.
   2. 输入任意 标题 想要而且位于下 字段 输入要在Slack通知中查看的字段名称。 每个标题应以逗号分隔(例如， name, email)。