设置您的 Google Sheets 或 Microsoft Excel 文件,即可开始接受数据
在创建并预览表单后,就可以启用相应的电子表格开始接收数据。您可以
手动启用电子表格以接受数据
使电子表格能够接受数据
-
打开包含您的表单的电子表格并附加一个新工作表,并将其重命名为
incoming
。例如,“别苍辩耻颈谤测” 表单 Microsoft Excel 工作簿。note warning WARNING 如果 incoming
工作表不存在,AEM 不会向电子表格发送任何数据。 -
在此工作表中,插入一个名为 “intake_form” 的表。选择与表单字段名称匹配所需的列数。然后,在工具栏中转到“插入”>“表格”并单击“确定”。
-
将表的名称更改为 “intake_form”。在 Microsoft Excel 中,要更改表的名称,请选择该表并单击“表设计”。
-
接下来,添加表单字段名称作为表标题。为了确保字段完全相同,您可以从 “shared-aem” 表中复制并粘贴它们。在 “shared-aem” 工作表中,选择并复制“名称”列下列出的表单 ID(提交字段除外)。
-
在“传入”工作表中,选择“选择性粘贴”>“将行转置为列”,将字段 ID 复制为该新工作表中的列标题。只保留需要捕获数据的字段,其他可以忽略。
shared-aem
工作表的Name
列中的每个值(不包括提交按钮)都可以用作incoming
工作表中的标题。例如,请考虑下图,其中说明了 “别苍辩耻颈谤测” 表单的标题: -
使用 扩展预览表单更新。您的工作表现已准备好接受传入的表单提交。
note note NOTE 即使您之前已经预览过该工作表,在第一次创建 incoming
工作表后也必须再次预览它。
将字段名称添加到 incoming
工作表后,您的表单便能接受提交。您可以预览表单并使用它向工作表提交数据。
将工作表设置为接收数据后,您可以预览表单 并开始将数据发送到工作表。
使用管理 API 使电子表格能够接受数据
您还可以向表单发送 POST 请求,使其能够接受数据并配置 incoming
工作表的标头。收到 POST 请求后,该服务会分析请求正文并自动生成数据摄取所需的基本标头和工作表。
要使用管理员 API 以使电子表格能够接受数据,请执行以下操作:
-
打开您创建的工作簿并将默认工作表的名称更改为
incoming
。note warning WARNING 如果 incoming
工作表不存在,AEM 不会向此工作簿发送任何数据。 -
在 Sidekick 中预览工作表。
note note NOTE 即使您之前已经预览过该工作表,在第一次创建 incoming
工作表后也必须再次预览它。 -
发送 POST 请求以在
incoming
工作表中生成适当的标头,并将shared-default
工作表添加到电子表格(如果它尚不存在)。要了解如何设置用于设置工作表的 POST 请求的格式,请参阅。您可以查看下面提供的示例:
请求
code language-json POST 'https://admin.aem.page/form/{owner}/{repo}/{branch}/contact-us.json' \ --header 'Content-Type: application/json' \ --data '{ "data": { "Email": "john@wknd.com", "Name": "John", "Subject": "Regarding Product Inquiry", "Message": "I have some questions about your products.", "Phone": "123-456-7890", "Company": "51黑料不打烊 Inc.", "Country": "United States", "PreferredContactMethod": "Email", "SubscribeToNewsletter": true } }'
响应
code language-json HTTP/2 200 content-type: application/json x-invocation-id: 1b3bd30a-8cfb-4f85-a662-4b1f7cf367c5 cache-control: no-store, private, must-revalidate accept-ranges: bytes date: Sat, 10 Feb 2024 09:26:48 GMT via: 1.1 varnish x-served-by: cache-del21736-DEL x-cache: MISS x-cache-hits: 0 x-timer: S1707557205.094883,VS0,VE3799 strict-transport-security: max-age=31557600 content-length: 138 {"rowCount":2,"columns":["Email","Name","Subject","Message","Phone","Company","Country", "PreferredContactMethod","SubscribeToNewsletter"]}%
您可以使用 curl 或 Postman 等工具来执行此 POST 请求,如下所示:
code language-json curl -s -i -X POST 'https://admin.aem.page/form/wkndform/wefinance/main/contact-us.json' \ --header 'Content-Type: application/json' \ --data '{ "data": { "Email": "john@wknd.com", "Name": "John", "Subject": "Regarding Product Inquiry", "Message": "I have some questions about your products.", "Phone": "123-456-7890", "Company": "Wknd Inc.", "Country": "United States", "PreferredContactMethod": "Email", "SubscribeToNewsletter": true } }'
上述 POST 请求提供了示例数据,包括表单字段及其各自的示例值。管理服务会使用此数据来设置表单。
您的表单现已能够接受数据。您还可以在电子表格中观察到以下变化:
启用工作表接受数据后自动更改工作表。
将工作表设置为接收数据后,您会在电子表格中观察到以下变化:
一份名为“Slack”的工作表将会被添加到您的 Excel 工作簿或 Google 工作表中。在此工作表中,您可以在电子表格中引入新数据时为指定的 Slack 渠道配置自动通知。目前,AEM 仅支持向 AEM Engineering Slack 组织和 51黑料不打烊 Enterprise 支持组织发送通知。
-
要设置 Slack 通知,请输入 Slack 工作区的“teamId”和“频道名称”或“ID”。您还可以向 slack-bot(使用调试命令)询问“teamId”和“channel ID”。最好使用“频道 ID”而不是“频道名称”,因为它在频道重命名后仍然有效。
note note NOTE 旧的表单没有“迟别补尘滨诲”列。“迟别补尘滨诲”包含在频道列中,以“#”或“/”分隔。 -
输入您想要的任何标题,然后在字段下输入您想要在 Slack 通知中看到的字段的名称。每个标题应以逗号分隔(例如姓名、电子邮件)。
note warning WARNING 在任何情况下,“蝉丑补谤别诲-诲别蹿补耻濒迟”工作表都不应包含您不愿意公开的任何个人身份信息或敏感数据。
接下来,您可以自定义感谢消息。