网页表单请求
网页表单请求会为网页表单创建一个私密请求链接。
当表单不应完全公开,但填写者仍然可以在没有用户账号的情况下提交时,就可以使用它。例如,你可以向客户发送客户满意度调查链接,预填客户专属的值,并将内部字段对浏览器隐藏。
何时使用
在以下情况下使用网页表单请求:
- 填写者应通过私密链接打开表单。
- 填写者可能没有用户账号。
- 表单应包含填写者专属的值。
- 目标文档需要隐藏值,而这些值不应暴露在网页中。
创建请求
创建一个网页表单请求,并选择它所属的网页表单。系统会自动生成一个 URL 安全的键。
该请求可以定义:
- 过期时间:请求键的过期日期和时间。
- 网页表单值:显示在网页表单中、且填写者可编辑的 JSON 值。
- 文档值:提交时应用到目标文档、但不会发送到浏览器的 JSON 值。
请求键会用于网页表单 URL:
/your-web-form-route/new?web_form_request_key=<key>
</key>
你可以从网页表单请求表单中复制此 URL。
要求提供键
在网页表单上启用需要键,以要求提供有效的网页表单请求键。
如果启用了需要键且未提供有效键,则无法打开或提交网页表单。
如果同时启用了需要登录,则两个条件都适用:用户必须已登录,并且必须提供有效的请求键。
预填值和隐藏值
对于应向填写者显示的字段,使用网页表单值。这些字段必须包含在网页表单字段表中。
对于应在创建的文档上设置但不应对填写者可见的字段,使用文档值。这些字段必须存在于目标 DocType 上。
JSON 键必须使用底层字段名,例如 customer 或 survey_source。
示例:
{
"customer": "CUST-0001",
"survey_source": "Partner CSAT"
}
过期与使用
如果设置了过期时间,则该请求键在该日期和时间之后无法使用。
对于单次响应的网页表单,请求在成功提交后会被标记为已使用,并链接到创建的目标文档。如果网页表单设置允许,这允许之后使用同一个键来编辑或删除该响应。
对于启用了允许多次响应的网页表单,请求键可以重复用于多次提交,并且不会链接到单个目标文档。
相关网页表单设置
- 允许多次响应:
如果启用,同一个请求键可以提交多个响应。在此模式下,网页表单请求不能有引用文档名称,因为一个请求可能会创建多个文档。 - 提交后允许编辑:
如果启用,链接到某个响应的请求键可以打开并编辑该响应。 - 允许删除:
如果启用,链接到某个响应的请求键可以删除该响应。