用户指南 取消(C)

通过 Liquid Mode 改善移动 Web 签名体验

 

Adobe Acrobat Sign 指南

新增功能

快速入门

管理

发送、签署和管理协议

高级协议功能和工作流程

与其他产品集成

Acrobat Sign 开发人员

支持和故障排除

介绍

Liquid Mode 签名体验可根据收件人的设备类型改善文档的显示效果,从而减少了捏合和缩放的需要,并可轻松聚焦于需要填写的字段上。

为收件人生成的符合 Liquid Mode 规范的协议具有以下两个视图:

  1. PDF 视图:该视图是使用上传的 HTML 中的所有样式信息生成的。该视图对应于可供下载的协议的已签名版本 - 与 Adobe Acrobat Sign 为所有协议生成的 PDF 视图别无二致。
  2. Liquid Mode 视图:该视图可对输入 HTML 文档进行重排,并针对小屏幕尺寸进行优化。Liquid Mode 视图提供的是精心设置的体验,覆盖了原始 HTML 文档中指定的样式

界面允许您的收件人根据自己的喜好在 Liquid Mode 视图和传统的 PDF 视图之间轻松切换,并捕获您所期望的具有相同法律约束力的签名。

 

符合 Liquid Mode 规范的协议是使用单个 HTML 文件作为源内容创建的。

在这种情况下,上载的 HTML 文档中的 HTML 和表单字段构造将存在一些限制。具体包括:

  • 必须使用单个 HTML 文档(即只能使用一个文件)创建协议
    • 如果使用多个文档创建协议,则只会生成 PDF 视图
  • HTML 文档中不得包含 JavaScript。不允许将 <script> 标记用作内联 JavaScript 或对外部 JavaScript 文件的引用,也不允许将其用于 HTML 标签的属性
    • 如果在 HTML 文档中找到了 JavaScript,则 Acrobat Sign 只会创建 PDF 视图
  • HTML 文档的 <body> 中只能使用支持的 HTML 标记,如支持的 HTML 标签部分所述
    • 如果 HTML 文档的 body 中使用了不支持的 HTML 标签,则 Acrobat Sign 只能创建 PDF 视图

由于 Liquid Mode 视图提供的是精心设置的体验,因此将忽略 HTML 文件中指定的 CSS(仅限 Liquid Mode 视图),并且只有支持的 HTML 标记的属性才能影响 Liquid Mode 视图。但是,PDF 视图不存在这些限制。Acrobat Sign 可使用可用于支持标记的所有属性以及 HTML 文档中指定的 CSS 生成 PDF 视图。

Adobe Acrobat Sign 文本标记表示法用于指定 HTML 文档中的表单字段。

Liquid Mode 工作流

注意:

如果启用了 Liquid Mode 功能,但出于某种原因无法生成 Liquid Mode 视图,则只能使用 PDF 视图生成协议。

发送给协议发件人的确认电子邮件将列出无法生成 Liquid Mode 视图的原因。

手机设备上当前支持 Liquid Mode,更多支持尚在开发中。


启用/发送符合 Liquid Mode 规范的协议

  1. 确保在 Acrobat Sign 管理员菜单中启用 Liquid Mode:

    • 导航至发送设置 > Liquid Mode
      • 可以在帐户或组级别修改设置
    导航到 Liquid Mode 控件

  2. 使用以下任一方法提交一个 HTML 文件:

    发送 HTML 文档


支持的 HTML 标记

要成功使用 Liquid Mode 视图创建协议,HTML 文档不得包含 JavaScript 构造。

HTML 文档的 <body> 中只能使用以下标记:

类别

HTML 标记

可影响 Liquid Mode 视图的属性

限制

标题

<h1>、<h2>、<h3>、<h4>、<h5>、<h6>

NONE

 

内容划分

<div>

align

 

换行

<br>

NONE

 

水平分隔线

<hr>

NONE

 

段落

<p>

align

 

图像

<img>

src、alt、height、width

请参阅图像支持部分

内联文本

<b>、<i>、<u>、<s>、<strong>、<em>、<span>、<sub>、<sup>

NONE

 

有序列表

<ol>、<li>

value、type、reversed、start

 

无序列表

<ul>、<li>

value、reversed、start

 

超链接

<a>

href

URL 协议仅限于 http、https 和 mailto

<table>、<thead>、<tbody>、<tfoot>、<th>, <tr>、<td>、<caption>、<col>、<colgroup>

NONE

1. 支持嵌套表格

2. 支持表格中的表单字段

表单字段标签

<label>

for

请参阅“表单字段标签”部分。

表单字段分组

<fieldset>、<legend>

NONE

请参阅“标记字段组”部分。

图像

<img>

src、alt、height、width

图像加上整个 HTML 的大小应小于 400KB。支持以下格式:JPEG、PNG、GIF、BMP 和 TIFF。图像源必须是 HTTPs URL。


表单字段规范

表单字段需要使用 Adobe Acrobat Sign 文本标记表示法在 HTML 文档中指定。

下表显示了使用 Acrobat Sign 文本标记指定的示例表单字段:

字段

Sign 文本标记

签名字段(签名、缩写签名、签名块、图章)

{{Sig_es_:signer1:signature}}



{{Int_es_:signer1:initials}}



{{SigB_es_:signer1:signatureblock}}



{{OSig_es_:signer1:optsignature}}



{{OInt_es_:signer1:optinitials}}



{{SigStamp_es_:signer1:stampimage(25)}}

签名者字段

{{Cmpy_es_:signer1:company}}



{{N_es_:signer2:fullname}}



{{Dte_es_:signer1:date}}



{{Em_es_:signer1:email}}

发件人字段

{{*Ttl_es_:sender:title}}

参与者图章和事务 ID

{{userstamp_es_:signer1:stamp:repeat}}

{{transstamp1_es_:transactionid:repeat}}

只读字段

{{! price}}

{{price_es_:readonly}}

文本输入

{{address_es_:signer1}}

{{*city_es_:signer1}}

复选框

{{CB1_es_:checkbox(checked)}}

单选按钮

{{(Red)Color_es_:signer1:label(“Red”)}}

{{(Blue)Color_es_:signer1:label(“Blue”)}}

{{(Green)Color_es_:signer1:label(“Green”)}}

图像

{{Image1_es_:signer1:inlineimage(4)}}

下拉菜单

{{Color_es_:signer1:dropdown(options="Red,Green,B lue”, values=”R,G,B”)}}


超链接

{{companywebsite_es_:link(http://www.adobe.com):label(Adobe)}}


文件附件

{{*DriversLicense_es_:signer1:attachment}}

工具提示

{{Car_color_es:signer1:tooltip('Choose a color')}}

数字签名

{{digsig1_es_:signer1:digitalsignature}}

字段验证

{{*Mobile_es_:signer1:phone}}

{{d_es_:signer1:num(>0,<60)}}

条件规则

例如,{{field_es_:showif(price>60)}}

计算型字段

{{TV_es_:calc([SubTotal]+[Tax])}}

注意:

以下构造之外,所有其他 Acrobat Sign 表单字段结构体都受支持:

类别

不支持的构造

例外情况

数字签名表单字段

将不支持 :digitalsignature



预填工作流

将不支持 :prefill 指令。



超链接表单字段

将不支持 :page(N) 指令。

使用 http、https 和 mailto 以外其他协议的 :link

将支持 :signer1:everyone 指令。

未命名的表单字段

将不支持未命名的表单字段。

将支持未命名的复选框

重命名的表单字段

将不支持具有相同名称但不同指令的多个表单字段




表单字段标签

每个表单字段都应有一个关联的标签。虽然并非每个表单字段都必须有关联的标签,但强烈建议为表单字段设置标签。

具体而言,在 Liquid Mode 下,标签具有以下用途:

  • 可使用标签增强字段的视觉呈现效果
  • 与字段关联的标签可提供辅助功能提示。当某个字段具有焦点时,屏幕阅读器将可以使用标签向用户播报该字段
  • 可以通过单击标签在某个字段上设置焦点,或者当字段为单选按钮或复选框时,单击标签可切换值

可以通过以下某种方式使用 HTML <label> 标记将表单字段与标签绑定:

  1. 包含在 <label> 标记内的 Acrobat Sign 表单字段
    • <label>Signature: {{sig_es_:signer1:signature}}</label>
  2. <label> 标记的“for”属性可引用单字段的名称以将标记绑定到表单字段。
    • {{sig_es_:signer1:signature}} … <label for=”sig”>Signature: </label>

无法通过上述规则与表单字段绑定的标签将显示为未绑定标签文本。

此外,对于以下表单字段类型,Acrobat Sign 文本标记支持 :label 指令:

  • 文件附件
  • 超链接
  • 复选框
  • 单选按钮

Acrobat Sign 文本标记 :label 指令和 <label> 标记可通过以下方式进行组合:

表单字段类型

:label 指令的用途

HTML <label> 标记的用途

文件附件、

超链接

指定在表单字段框内显示的标签。

<label> 标记用于指定表单字段的标签或标题。

复选框、

单选按钮选项

指定表单字段的标签或标题。

如果表单字段中不存在 Acrobat Sign 文本标记 :label 指令,则 <label> 将代替该指令

如果同时存在 :label 和 <label>,则将无法创建 Liquid Mode。

示例:

  • {{CB_es_:checkbox: signer1:label("I agree.")}}} <label for=” CB”> Yes</label>
  • {{(Red_v)Color_es_:signer1::label(“Red Color”)} <label for=”(Red_v)Color”>Red</label>
注意:

可按照以下方式为复选框字段指定标签:

  • {{CB_es_:checkbox: signer1:label("I agree.")}}
  • <label> {{CB_es_:checkbox:signer1}} I agree.</label>
  • {{CB_es_:checkbox:signer1}} <label for="CB"> I agree.</label>

可按照以下方式为单选按钮选项指定标签:

  • {{(Red_v)Color_es_:signer1:label(“Red”)}}
  • <label> {{(Red_v)Color_es_:signer1}} Red </label>
  • {{(Red_v)Color_es_:signer1}} <label for=”(Red_v)Color”>Red</label>
注意:

在 HTML 中,“for”属性通常引用字段 ID 值。  但 Liquid Mode 会使用“for”属性引用字段名称。  这可能会导致克隆的表单字段含混不清,因为同时存在多个表单字段实例具有完全相同的 Acrobat Sign 文本标记指令。  在这种情况下,我们需要避免使用“for”属性,因此必须通过将文本标记包含在 <label> 元素内来关联标签。

例如,在以下用例中,将为移动重排视图中的两个实例分别创建具有不同标签的克隆表单字段:

  • <label> Official {{name_of_official_es_:signer1}} </label>
  • <label> Name {{name_of_official_es_:signer1}} </label>

如果克隆的表单字段使用“for”属性指定标签,则引用将模糊不清,无法解析。  在这种情况下,将无法生成 Liquid Mode 视图。

 例如,以下用例将仅生成 PDF 视图:

  • <label for="name_of_official> Official </label> {{name_of_official_es_:signer1}}
  • <label for="name_of_official> Name</label> {{name_of_official_es_:signer1}}


标记字段组

多个标签可与一个表单字段关联。如果要将一个标签/题注与字段组(特别是单选按钮字段组)关联,我们鼓励使用 fieldset 和 legend 元素。  fieldset 用于对元素进行分组,而 legend 用于为组提供题注/标签。  与标签类似,在 Liquid Mode 下,标签字段组具有以下好处:

  • 增强与字段组关联的题注/标题的视觉呈现效果
  • 提供良好的辅助功能体验。  屏幕阅读器将使用 legend 中的内容播报正确的字段组

例如:

<fieldset>

        <legend>Choose your favorite primary color</legend>             

        {{(Red)Color_es_:signer1:label("Red")}}<br/>       

        {{(Blue)Color_es_:signer1:label("Blue")}}<br/>       

        {{(Green)Color_es_:signer1:label("Green")}}<br/>       

</fieldset>

注意:

对于大多数文档,作者都不希望使用 fieldset 元素的默认呈现方式。 

可使用以下 CSS 删除边框:

    fieldset {

        border: none;

        margin: 0;

        padding: 0;

    }

图像支持

支持图像,但有以下限制:

  • 仅支持 <img> 元素
  • <img>src 可以作为嵌入式数据 (data: scheme) 或 Web URL(仅限 https: scheme)提供
  • 支持以下格式:JPEGPNGGIFBMPTIFF
    • 对于动画 GIF,将使用第一帧作为静态图像
  • 从 Web URL 检索到的图像大小限制为 5 MB


不支持的 Acrobat Sign 工作流

Liquid Mode 支持以下 Acrobat Sign 工作流:

  • 从多个文档创建的协议
  • 从非 HTML 文档创建的协议
  • 从库模板创建的协议
  • 以“草稿”或“正在编辑”状态创建的协议
  • 数字签名工作流
  • 书面签名工作流
  • 修改正在进行的工作流
  • 组中默认启用“预览”复选框的工作流
  • 已启用签名原因的协议
  • 已配置为在签名者每次单击签名字段时都要求其进行身份验证的协议

当尝试在上述工作流中生成 Liquid Mode 视图时,将仅使用 PDF 视图创建协议。  发送给协议发件人的确认电子邮件将列出无法生成 Liquid Mode 视图的原因。


Liquid Mode 错误通知

如果协议发件人尝试使用 Liquid Mode 视图生成协议,但 Acrobat Sign 却无法生成,则会在协议确认电子邮件中向发件人指出导致无法生成 Liquid Mode 视图的具体问题。发件人可以解决报告的问题,并重新尝试以 Liquid Mode 视图生成协议。

报告的问题可分为以下几类:

  • 不支持的 HTML 构造
  • 不支持的 Acrobat Sign 文本标记
  • 不支持的 Acrobat Sign 工作流
  • Liquid Mode 内部错误

当服务器在尝试创建 Liquid Mode 视图时出现意外错误,则会发生 Liquid Mode 内部错误。

对于其他类型的错误,您可以在以下子部分中找到关于所报告问题的详细信息:


示例 HTML 文档:信用报告请求

生成 Liquid Mode 的主要目标是处理具有以下特点的表单:

  • 文档中包含许多大文本块,因而可能需要大量捏合和缩放操作
  • 表单中没有重叠的字段,且可接受使用 Liquid Mode 对字段进行重排


已知问题和常见问题解答

更快、更轻松地获得帮助

新用户?