用户指南 取消(C)

使用 URL 参数预填充 Web 表单字段值

 

Adobe Acrobat Sign 指南

新增功能

快速入门

管理

发送、签署和管理协议

高级协议功能和工作流程

与其他产品集成

Acrobat Sign 开发人员

支持和故障排除

使用 URL 参数填写 Web 表单字段

要将值插入到 Web 表单字段,您需要了解两件事情:

  • 如何将字段标记为“可使用 URL 参数”
  • 如何构建要插入的 URL 参数

 

如何将字段标记为“可使用 URL 参数”

  1. 创建或编辑 Web 表单,以获取字段的访问权限

  2. 添加您希望通过 URL 填充的文本字段

    •  只有文本字段才可以接受值
  3. 双击字段,以打开该字段的属性

  4. 编辑一个有意义的字段名称。字段名称是您将要使用的参数的第一部分,所以通常越短越好

  5. 选中“默认值有可能来自 URL”复选框

    • (可选)如果您不希望该值是可编辑的,请选中“只读”复选框
  6. 单击确定以保存参数

  7. 对所有需要接受 URL 参数的字段重复执行上述操作

  8. 单击保存以保存 Web 表单

URL

在本示例中,我们创建了两个通过 URL 填充的字段:

  • Branch_Office - 接受分支机构字符串的字段(如上所示)
  • Emp_ID - 接受员工 ID 的字段

 

如何构建要插入的 URL 参数

  1. 从 Web 表单复制 URL。执行此操作的最简便方法是:

    • 在“管理”页面上编辑该 Web 表单
    • 单击复制 Web 表单 URL 链接
    URL

    Web 表单 URL 很长,因此我们在此提供了一个简短的 URL 作为示例(您的 URL 看起来会与此不同):

    示例 URL:

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*

  2. 将 Web 表单 URL 粘贴到文本编辑器(如“记事本”)

  3. 添加参数

    • 请在 Web 表单 URL 的末尾处添加一个井号 (#) 来标识参数的开始。
    • 然后,按照 {field_name}={value} 的格式添加参数

    带有一个参数的 URL 示例

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch_Office=San Jose #621

    • 在字段值之间插入与号 (&) 可添加多个值。

    带有两个参数的 URL 示例

    https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch_Office=San Jose #621&Emp_ID=429939

  4. 将所有的“field=value”参数对添加到 URL 后,复制完整的字符串并将其粘贴到浏览器。

    Web 表单将会随着填充的字段一起呈现:

    URLWeb 表单上的参数

属性和限制条件

  • 定义参数的起始位置时,只使用一次井号标记
    • 值中后续出现的井号标记不会对结果产生负面影响
  • 在提供的值中使用空格是可以接受的
  • 只有在 URL 中明确插入 %20 作为空格字符时,才可以接受在字段名称中使用空格
    • 下面的 URL 有效:https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch%20Office=San Jose #621
    • 下面的 URL 无效:https://secure.na1.adobesign.com/public/esignWidget?wid=CBF2s*#Branch Office=San Jose #621
    • 通常,我们建议您在字段名称中使用下划线,而不是空格。这种方式最终可以帮助您节省时间
  • 在“字段名称”、等号和值的开始位置之间不允许出现任何空格 (Fieldname=Value)
  • 如果需要添加多个值,则与号 (&) 的两侧也不应当出现空格
  • 对于可通过 URL 参数获取值的字段来说,它们的数量没有限制(除了 URL 长度限制之外)
  • 无法覆盖经过计算的文本字段,并且这些字段的属性中也不会显示复选框。
  • URL 参数不适用于经过身份验证的 Web 表单。在使用 URL 井号片段的情况下,如果 Web 表单受密码或其他身份验证保护,那么在身份验证结束后,URL 参数将不会传递回客户端(服务器永远不会看到 URL 的这一部分)。

 

错误处理

  • 任何与表单字段名称不完全匹配的 URL 参数,都将被忽略
  • 任何试图将值分配给以下字段的 URL 参数都将被忽略:非文本字段,或者未启用“默认值有可能来自 URL”的文本字段