功能说明

由于指定的字段可能会随着环境的变化而要求独特的值,为此,您可以修改 Widget URL,以使用相关内容来填充相应的字段,进而扩展单个 Widget 的实用性。

例如,当您要将多个信息亭分布在某个区域时,如果希望使用商店名称和员工编号来自动填充 Widget,那么只需将一对参数放在 Wiget URL 末端,即可轻松达到上述目的。

要完成此操作,只需正确标识要填充的字段,并且把要插入的值准确地添加到 URL 中即可。

Adobe Sign 使用 URL 井号片段来支持该功能。这可以确保 Adobe Sign 服务器永远不会看到通过 URL 传递的内容,进而保护任何可能属于插入参数的个人数据。


使用方式

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

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

 

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

要将字段设置为“可使用 URL 参数”,请执行以下操作:

  • 创建或编辑 Widget,以获取字段的访问权限
  • 添加您希望通过 URL 填充的文本字段
    • 只有文本字段才可以接受值
  • 双击字段,以打开该字段的属性
  • 编辑一个有意义的字段名称。字段名称是您将要使用的参数的第一部分,所以通常越短越好
  • 选中默认值有可能来自 URL 复选框
    • (可选)如果您不希望该值是可编辑的,请选中只读复选框
  • 单击确定以保存参数
  • 对所有需要接受 URL 参数的字段重复执行上述操作
  • 单击保存以保存 Widget
field_settings_toallowvaluestopassinviaurl

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

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

 

如何构建要插入的 URL 参数

构建 URL 的一种简便方法是:

  • 从 Widget 复制 URL。执行此操作的最简便方法是:
    • 在“管理”页面编辑这个 Widget
    • 单击复制 Widget URL 链接
  • 将 Widget URL 粘贴到文本编辑器(如“记事本”)
copy_widget_url

Widget URL 很长,不过,我们在此提供了一个简短的 URL 作为示例(您的 URL 看起来会有所不同):

示例 URL:

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

 

  • 添加参数

请在 Widget URL 的末尾处添加一个井号 (#) 来标识参数的开始。

然后,按照 {field_name}={value} 的格式添加参数

带有单个参数的 URL 示例

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

 

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

带有两个参数的 URL 示例

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

 

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

Widget 将会随着填充的字段一起呈现:

populated_widget

属性和限制条件

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

 

错误处理

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


配置选项

没有涉及此项功能的选项。


如何启用或禁用

通过 URL 填充字段的功能是 Widget 的固有属性,无法禁用。

本产品经 Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License 许可  Twitter™ 与 Facebook 中的内容不在 Creative Commons 的条款约束之下。

法律声明   |   在线隐私策略