网页表单请求

网页表单请求

网页表单请求会为网页表单创建一个私密请求链接。

当表单不应完全公开,但填写者仍然可以在没有用户账号的情况下提交时,就可以使用它。例如,你可以向客户发送客户满意度调查链接,预填客户专属的值,并将内部字段对浏览器隐藏。

何时使用

在以下情况下使用网页表单请求:

  1. 填写者应通过私密链接打开表单。
  2. 填写者可能没有用户账号。
  3. 表单应包含填写者专属的值。
  4. 目标文档需要隐藏值,而这些值不应暴露在网页中。

创建请求

创建一个网页表单请求,并选择它所属的网页表单。系统会自动生成一个 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"
}

过期与使用

如果设置了过期时间,则该请求键在该日期和时间之后无法使用。

对于单次响应的网页表单,请求在成功提交后会被标记为已使用,并链接到创建的目标文档。如果网页表单设置允许,这允许之后使用同一个键来编辑或删除该响应。

对于启用了允许多次响应的网页表单,请求键可以重复用于多次提交,并且不会链接到单个目标文档。

  • 允许多次响应:
    如果启用,同一个请求键可以提交多个响应。在此模式下,网页表单请求不能有引用文档名称,因为一个请求可能会创建多个文档。
  • 提交后允许编辑:
    如果启用,链接到某个响应的请求键可以打开并编辑该响应。
  • 允许删除:
    如果启用,链接到某个响应的请求键可以删除该响应。