{{Sig_es_:signer1:signature}}
概述
Adobe Sign 文本标记是设置了特殊格式的文本,可放置在文档内容中的任何位置,用来指定字段(如签名和缩写签名字段)、复选框、单选按钮和表单字段的位置、大小和类型以及高级可选字段处理规则。在创建包含表单字段的 PDF 时,也可以使用文本标记。请参见《Acrobat 参考指南》中的“创建表单”。
当发送文档以供签名或上传时,文本标记将转换为 Adobe Sign 表单字段。Adobe Sign 文本标记可放置在任何类型的文档中,如 PDF、Microsoft Word、PowerPoint、Excel 和文本文件(.txt 和 .rtf)。
例如:
|
一个签名字段,分配给标识为 signer1 的接收者。 |
{{Cmpy_es_:signer2:company}} |
此字段用于输入标识为 signer2 的接收者的公司名称。 |
{{address_es_:signer1}} |
此字段供标识为 signer1 的接收者输入他们的地址。 |
{{*city_es_:signer1}} |
一个必填字段,供标识为 signer1 的接收者输入他们所在的城市。 |
{{!price}} |
一个只读字段。接收者无法更改此字段的值。 |
Adobe Sign 文本标记提供了一个强大的机制来设置文档模板,这些模板可用于放置签名和缩写签名字段、在协议中收集多方的数据、针对收集的数据定义验证规则,以及添加资格认定条件。在某个文档中正确设置文本标记后,在发送文档以供签名时,该文档可用作一个模板,从而确保为协议收集的数据在整个组织内保持一致且有效。
在适用的情况下,会注明特定于 Adobe Sign – 业务、Adobe Sign – 企业或这两个计划的特性和功能。
文本标记快速入门指南
文本标记示例
下面的所有示例都假定标记用在文档内容中。将标记用作 PDF 表单字段名称时,省略左侧的‘{{’和右侧的‘}}’。
签名和缩写签名字段
{{Sig_es_:signer1:signature}} |
一个签名字段,分配给标识为 signer1 的接收者。 |
{{Int_es_:signer1:initials}} |
一个缩写签名字段,分配给标识为 signer1 的接收者。 |
{{SigB_es_:signer1:signatureblock}} |
一个签名块,分配给标识为 signer1 的接收者。 |
{{OSig_es_:signer1:optsignature}} |
一个可选签名字段,分配给标识为 signer1 的接收者。 |
{{OInt_es_:signer1:optinitials}} |
一个可选缩写签名字段,分配给标识为 signer1 的接收者。 |
{{SigStamp_es_:signer1:stampimage(25)}} |
一个图章字段,可用作签名选项。除非签名者没有其他签名字段,否则不需要图章。 |
接收者角色字段
签名者和发送者字段用于指定协议的接收者角色。
签名者字段
“签名者”角色指定不是“发送者”的第一个接收者(签名者或审批人)。在所有情况下,“signer1”角色都标识第一个接收者。如果发送者先在协议上签名或审批协议,则标识为“signer1”的接收者可以是发送者。
{{Cmpy_es_:signer1:company}} |
此字段供标识为 signer1 的接收者输入他们的公司名称。 |
{{N_es_:signer2:fullname}} |
一个只读字段,供标识为 signer2 的接收者输入他们的全名。 |
{{Dte_es_:signer1:date}} |
一个只读字段,包含签名的日期。 |
{{Em_es_:signer1:email}} |
一个只读字段,包含签名者的电子邮件地址。 |
另一种方法是仅使用“signer1”、“signer2”、“signer3”等角色,而不使用“发送者”和“签名者”角色。请确保在发送文档时按正确的顺序添加这些参与者。
发送者字段
仅当在发送过程中指定了“我需要首先/最后签名”选项时,才能使用“发送者”角色。“发送者”角色始终指定分配给“发送者”的字段,而不管他们首先签名还是最后签名。
{{*Ttl_es_:sender:title}} |
一个必填字段,供发送者输入他们的职务。 |
另一种方法是仅使用“signer1”、“signer2”、“signer3”等角色,而不使用“发送者”和“签名者”角色。请确保在发送文档时按正确的顺序添加这些接收者。
预填字段
{{price_es_:prefill}} |
发送者在发送文档之前填写的字段。 |
文本字段
{{address_es_:signer1}} |
一个可选字段,供标识为 signer1 的接收者输入他们的地址。 |
{{*city_es_:signer1}} |
一个必填字段,供标识为 signer1 的接收者输入他们所在的城市。 |
只读字段
{{!price}} |
一个只读字段。签名者无法更改此字段的值。 |
复选框
{{[]}} |
一个复选框。 |
{{[x]}} |
一个复选框,默认情况下处于选中状态。 |
单选按钮
{{(Red)Color}} |
一个单选按钮,选中时值为红色。 |
图像
{{Image1_es_:signer1:inlineimage(4)}} |
一个高度为 4 行的内嵌图像字段 |
字段验证
{{*Mobile_es_:signer1:phone}} |
一个必填电话字段,允许美国电话号码格式。 |
{{d_es_:signer1:num(>0,<60)}} |
一个可选数字字段,允许介于 0 到 60 之间的值。 |
条件规则
{{field_es_:showif(price>60)}} |
当“price”的值大于 60 时显示的字段。 |
计算型字段
{{TV_es_:calc([SubTotal]+[Tax])}} |
此字段的值自动计算为“小计”和“税”字段的总和。 |
文本标记转换为表单字段
字段长度和格式设置
在可编辑的文档中使用文本标记时,Adobe Sign 将铺上一个矩形,使其覆盖文本标记的整个范围(从开头的“{{”到结尾的“}}”),并将文本标记转换为相应的 Adobe Sign 表单字段。
通过在文本标记开头紧跟在“{{”后面添加空格字符或在文本标记末尾紧靠在“}}”前面添加空格字符,可以增加表单字段的长度。通过减小文本标记的字体大小可以减小表单字段的大小以达到适当的长度。
表单字段的格式设置(字体大小、类型、颜色等)由第一个“{”的格式确定。要确保 Adobe Sign 正确处理文本标记,应该在文档中以常见的字体(Helvetica、Times、Arial、Verdana 或 Courier)指定标记定义。要强制使用特定的字体样式,请参阅字体外观部分。
文本标记定义区分大小写,并且必须指定为小写文本。
下图显示了放置在 Microsoft Word 文档中的文本标记。
文本标记的整个范围(从开头的花括号到结尾的花括号)必须在单行中容纳得下。如果文本标记在源文档中或在处理的 PDF 中跨越多行,Adobe Sign 将无法正确识别表单字段,可能会导致签名者在为文档签名时看到底层文本。
在 PDF 表单中使用时,花括号不得包含在 PDF 表单字段的名称中,字段的大小由 PDF 表单字段的大小确定,在字段中所输入数据的格式设置由 PDF 表单字段属性确定。
单个文档不能同时包含 PDF 表单字段和使用文本标记定义的字段。
在签名过程中与表单字段交互
在签名体验中,上方的文本标记将转换为下方的可填写字段:
已签名文档中的表单字段
数据合并到已签名的文档中后,以下内容将出现在已签名的 PDF 中:
长文本标记
在可编辑的文档中使用时,包含多个指令的文本标记可能会变得非常长,从而使得很难在文档中指定小字段。Adobe Sign 提供了一个简单的机制,用于在文档中指定较短的标记。
例如,如果需要设置一个分配给发送者的必填电话字段,可以不放置完整的
{{*Mobile_es_:signer1:phone}} 标记,而是在文档中的适当位置使用一个较短的标记 {{$mob }},在此标记中使用空格调整字段的大小。此文本标记的完整定义
{{#mob=*Mobile_es_:signer1:phone}} 可以放置在文档中的其他位置。要了解有关如何缩短文本标记的更多信息,请参见缩短文本标记。
文本标记深入讲解
文本标记语法
Adobe Sign 文本标记定义为:
其中,各个组成部分定义如下:
- 必填 - 一个可选的标志,指定特定的字段是否为必填字段,是否必须由签名者在签名过程中填写。如果不存在此标志,表明表单字段不是必填字段,签名者在签名过程中可以(但不是必须)填写值。
- 只读 - 一个可选的标志,指明特定的字段是一个只读字段。将字段标记为只读可确保在签名过程中任何人都无法修改字段中的数据。在发送文档以供签名之前,可使用 Adobe Sign API 或通过 CSV 使用 MegaSign 将数据合并到只读字段中。
- 字段名称 - 一个唯一的名称,可以在文档中标识特定的字段。字段名称用于标识从服务导出数据后在签名过程中提供的值。
- 如果文档中的多个文本标记具有相同的名称但不同的指令或这些指令在名称相同的文本标记中的顺序不同,则 Adobe Sign 将自动在名称开头添加“efield”+ 唯一编号 +“_”。例如,如果文档中出现两个名为“Address”的字段,则 Adobe Sign 会将其中一个字段的名称更改为“efield2_Address”。
- 如果文档中的两个文本标记具有相同的字段名称、相同的指令和相同的指令顺序,则将这两个字段看作克隆的字段。在一个字段中输入的数据将自动克隆到文档中的另一个字段位置。
- ES 标识符 - 一个特定的文本字符串“_es_”,必须包含在文本标记中的字段名称后面,才能启用特定的 Adobe Sign 功能。如果未在字段名称后面包含此 Adobe Sign 标识符,则会向文档中添加一个没有任何指令的表单字段。
- 指令 - 包含一个或多个定义的列表,以冒号(“:”)开头,可指定角色、字段类型以及其他字段处理规则(用于定义字段中允许的输入类型)。指令可按任何顺序定义。
- 角色 - 与此字段关联的参与者(例如发送者和签名者)。
- 字段类型 - Adobe Sign 表单字段的类型(例如签名、缩写签名、复选框或文本字段)。
- 规则 - 高级处理规则,例如数据验证、根据条件显示/隐藏字段的逻辑等。
在签名过程中控制字段交互
在签名工作流程中,可将文档中的表单字段分配给特定的签名者。Adobe Sign 可确保签名者在签名过程中只能与已分配给他们的字段交互。通过在文本标记中添加特定的指令,可将表单字段分配给特定的签名者。
将表单字段分配给特定的签名者
Adobe Sign 支持使用以下指令将表单字段分配给特定的签名者。
{{Field2_es_:signer1}} |
协议中的一个字段,分配给不是协议发送者的第一个人。 |
{{Field3_es_:signer1}} {{Field4_es_:signer2}} |
如果协议需要多个签名者且每个签名者都需要在签名过程中提供数据,可以使用 signer<x> 指令将协议中的字段分配给特定的签名者,其中 <x> 是签名者签署协议的序号。以 signer1 指令标记的字段分配给第一个签名者,以 signer2 指令标记的字段分配给第二个签名者,依此类推。Adobe Sign 可确保签名者只能与分配给他们的字段交互。 如果协议的发送者在签名过程中首先签名,则所有标记为“signer1”的字段(除标记为“sender”的字段以外)都会呈现给发送者。 |
发送者预填数据
在某些情况下,在发送协议以供签名之前,发送者并非必须在协议上签名,但是必须输入数据。这通过向协议中的相关表单字段添加“prefill”指令来实现。Adobe Sign 允许发送者在发送协议以供签名之前填写这些字段。
{{Field5_es_:prefill}} |
协议中的一个字段,需要发送者在发送协议以供签名之前填写。 |
默认情况下,为上传到 Adobe Sign 文档库的文档启用预填功能。此外,也可以通过在发送文档时启用“预览并添加签名字段”选项来启用预填功能。要为从“发送”页面中发送的所有协议启用预填功能而不管是否启用了“预览”选项,请与 Adobe 支持人员联系。
未分配的字段
在签名过程中,任何签名者均可填写没有指令规定分配给特定接收者的字段。填写该字段后,它将处于锁定状态,阻止后续签名者更改其值。
{{Address}} |
协议中的一个字段,可由任何签名者填写。 |
{{zip_es_:zip4}} |
协议中的一个字段,供任何签名者输入邮政编码并进行验证。 |
基本 Adobe Sign 字段类型
通过在文本标记中使用特定的指令,可以在文档中创建多种字段类型。在签名过程中,Adobe Sign 会解释这些标记并将其转换为相应的表单字段。可以通过 Adobe Sign Web 应用程序添加到文档的所有字段类型也能通过文本标记来指定。
签名和缩写签名字段
您可以通过添加指令来指定签名字段的类型,从而将 Adobe Sign 签名或缩写签名字段放置在文档中的特定位置。默认情况下,签名和缩写签名字段是必填字段。
但是,某些文档要求签名者选择性地在文档中的其他特定位置签名或用缩写签名。也可使用文本标记在文档中定义可选的签名或缩写签名字段。
对于文档的每个签名者,Adobe Sign 要求文档中至少包含一个对应的签名。对于文档的审批人,在签名过程中文档中不需要包含对应的签名字段。
{{Sig1_es_:sender:signature}} |
一个必填签名字段,分配给发送者。 |
{{Int1_es_:signer1:initials}} |
一个必填缩写签名字段,分配给标识为 signer1 的接收者。 |
{{OSig1_es_:signer2:optsignature}} |
一个可选签名字段,分配给标识为 signer2 的接收者。 |
{{OInt1_es_:signer1:optinitials}} |
一个可选缩写签名字段,分配给标识为 signer1 的接收者。 |
{{SigStamp_es_:signer1:stampimage(25)}} |
一个图章字段,可用作签名选项。除非签名者没有其他签名字段,否则不需要图章。 |
特殊 Adobe Sign 字段
Adobe Sign 提供了可放置在文档中的特殊字段,用于收集签名者的信息,如签名者的职务或公司名称。如果已经有这些字段的信息,在签名过程中呈现给签名者时,Adobe Sign 将自动填充这些字段。
{{Ttl1_es_:title}} |
此字段用于指定签名者的职务。 |
{{Cmpy1_es_:company}} |
此字段用于指定签名者的公司。 |
特殊只读字段
此外,Adobe Sign 还支持在协议中收集签名日期、电子邮件地址以及签名者的姓名。这些字段由 Adobe Sign 自动填充,签名者在协议上签名时无法对其进行修改。
{{Dte1_es_:date}} |
此字段用于自动获取签名日期。 |
{{Em1_es_:email}} |
此字段用于自动获取签名者的电子邮件地址。在 Adobe Sign Widget 中使用时,签名者在为 Widget 签名时可以编辑此电子邮件地址字段。根据您的帐户配置,在完成 Widget 签名过程之前,Adobe Sign 将验证签名者提供的电子邮件地址。 |
{{Name1_es_:fullname}} |
此字段用于指定签名者的全名。 |
签名块
如果未在文档中为特定的签名者放置签名字段,Adobe Sign 将自动为该特定的签名者在文档底部放置一个签名块。默认情况下,签名块包括签名和电子邮件地址字段。但是,如果您的帐户或组管理员启用了“需要签名者在进行电子签名时提供其职务”或“需要签名者在进行电子签名时提供其公司名称”设置亦或同时启用了这两项设置(在“签名首选项”中),则职务和/或公司字段将包含在签名块中。下图显示了一个包含全部四个字段的签名块。
您可以使用“signatureblock”指令将整个 Adobe Sign 签名块放置在文档中。
{{SBlk1_es_:signatureblock}} |
将签名块放置在文档中的指定位置。 |
文本字段
在文档中定义的所有不包含任何附加字段类型定义指令的字段都看作文档中的可填写文本字段。
{{propertyName_es_:signer}} |
在文档中定义一个名为“propertyName”的可编辑文本字段。 |
定义必填/可选字段
{{*phone_es_:signer1}} {{phone_es_:signer1:required}} {{phone_es_:prefill:required}} |
定义一个名为“phone”的必填文本字段,它将由签名者填写或在预填过程中填写。 |
{{address_es_:signer1}} |
定义一个名为“address”的可选字段,它将由标识为 signer1 的接收者填写。 |
必填字段由字段左侧的红色星号来标识。
可编辑/只读字段
默认情况下,不是只读字段的所有字段均可编辑。例外情况包括默认是只读字段的一些特殊签名者字段(电子邮件、签名者姓名和签名日期)。有关更多信息,请参见特殊只读字段。
在使用 Adobe Sign API 或 MegaSign 数据合并功能自动将数据合并到文档中时,只读字段很有用。只读字段可确保签名者在签名过程中无法更改合并的数据。
向字段名称添加感叹号 (!) 前缀或使用“readonly”指令可将其标记为只读字段。
例如:
{{!price}} {{price_es_:readonly}} |
定义一个要在发送文档以供签名之前通过合并数据填写的只读文本字段。 |
高级文档处理与文本标记
其他字段类型
复选框
您可以使用文本标记创建复选框,方法是在文档中放置复选框标记或使用复选框指令。
{{[]}}{{CB_es_:checkbox}} |
在文档中放置一个未命名的复选框。 |
{{[x]}}{{CB1_es_:checkbox(checked)}} |
在文档中放置一个默认情况下处于选中状态的复选框。 |
{{[]Comm_es_:signer1}}{{Comm_es_:checkbox:signer1}} |
放置一个名为“Comm”的复选框,它将分配给标识为 signer1 的接收者。 |
{{[]*}}{{CB2_es_:required:checkbox}} |
一个未命名的必填复选框,它必须由标识为 signer1 的接收者填写。有关定义必填字段的更多信息,请参见定义必填/可选字段。 |
{{[]!}}{{CB3_es_:readonly:checkbox}} |
一个未命名的只读复选框。有关定义必填字段的更多信息,请参见定义必填/可选字段。 |
{{CB4_es_:checkbox:label("I agree.")}} |
定义一个带有标签的复选框,标签对复选框进行了简单易懂地说明。此标签在签名过程中显示给签名者,在本例中显示的是“I agree.”。 |
单选按钮
文本标记可用于在文档中定义和放置单选按钮。一个单选按钮组(即,在文档中由同一字段名称标识的组)中的单选按钮必须至少具有两个选项(选择)。单选按钮的每个选项(选择)必须具有不同的选择值。可以使用以下语法来定义单选按钮。
{{(option_value)fieldname_es_}} |
在文档中放置一个单选按钮。 |
{{(Red)Color_es_:signer1}} {{(Blue)Color_es_:signer1}} {{(Green)Color_es_:signer1}} |
定义三个单选按钮,它们属于名为“Color”的同一个组,将分配给标识为 signer1 的接收者。选项的值为“Red”、“Blue”和“Green”。 |
{{Color_es_:signer1:radio(Red)}} {{Color_es_:signer1:radio(Blue)}} {{Color_es_:signer1:radio(Green)}} |
一种替代方法,即使用“radio”指令来定义“Color”单选按钮组。 |
{{(Red)Color_es_:signer1:label(“Red”)}} {{(Blue)Color_es_:signer1:label(“Blue”)}} {{(Green)Color_es_:signer1:label(“Green”)}} |
定义一个单选按钮组并为每个单选按钮提供一个简单易懂的标签。此标签在签名过程中显示给签名者。 |
指定单选按钮样式
Adobe Sign 支持创建不同样式的单选按钮。PDF 中将显示指定的单选按钮样式。但是,在签名过程中,单选按钮选项始终显示为圆形。
(内嵌)图像字段
图像字段用来捕捉图像文件,像是照片或扫描的文档(例如,驾驶证)。这些图像可以从签名文档中提取出来。指令 :inlineimage 要求添加一个定义字段高度的额外参数。字段高度取决于标记的字体大小,由该字体值的行数来衡量。
{{inlineImageEx_es_:signer1:inlineimage(20)}} |
定义一个高度为 20 行的图像字段 |
多行文本字段
文本标记可用于定义可以跨越多行的文本字段。这些字段可在文档中使用,以便在签名过程中收集多行数据。
{{largeField_es_:signer1:multiline}} |
定义一个名为“largeField”的字段,它将分配给标识为 signer1 的接收者,在签名过程中允许签名者在此字段中输入多行数据。 |
{{largeField2_es_:signer1:multiline(4)}} |
定义一个名为“largeField2”的字段,它将分配给标识为 signer1 的接收者,在签名过程中允许签名者输入四行数据。如果缺少行数参数,则此字段支持两行数据。 |
下拉式列表
文本标记可用于在文档中定义和放置下拉式列表。下拉式列表可以包含多个选项,用户在为文档签名时可以从这些选项中选择一个。下拉式列表定义包含两个组成部分:一组唯一的选项,接收者可以从中选择一个选项;从协议中导出数据时返回的一组可选值。
虽然下拉值不需要唯一(即,可以从多个下拉选项中导出相同的值),但是下拉选项必须唯一。下拉值是可选的。如果未定义下拉值,从协议中导出数据时将返回下拉选项。
如果定义了下拉值,定义的值数必须与选项数匹配。如果指定的选项数与值数不匹配,这样会导致错误,不会将字段看作下拉式列表。
定义下拉式列表定义的默认选择或根据接收者从下拉式列表中选择的一个选项定义另一个字段的条件时,必须使用导出值(而不是选项)。如果未定义导出值,则使用下拉选项。
{{*Color_es_:signer1:dropdown(options="Red,Green, Blue”)}} |
在文档中放置一个必填下拉式列表。在签名过程中,此列表允许标识为 signer1 的接收者从三个可用选项中选择一个。此下拉式列表未指定任何导出值,因此将从“管理”页面中、通过 API 或从“报告”页面中导出选择的选项。 |
{{Color_es_:signer1:dropdown(options="Red,Green,B lue”, values=”R,G,B”)}} |
在文档中放置一个下拉式列表。在签名过程中,此列表允许标识为 signer1 的接收者从三个可用选项中选择一个。在本例中,此下拉式列表还指定了可能的导出值(“R”、“G”和“B”)。根据接收者在签名过程中选择的选项,将从“管理”页面中、通过 API 或从“报告”页面中导出相应的值。例如,如果接收者选择“Red”,导出的值为“R”。 |
{{Color_es_:signer1:dropdown(options="Red,Green,Blue”, values=”R,,B”)}} |
在本例中,此下拉式列表的选项与上一个示例中的相同,但是其中一个值为空。如果标识为 signer1 的接收者在签名过程中从此下拉式列表中选择“Green”,不会为此字段导出任何值。 |
{{Color_es_:signer1:dropdown(options="Red,,Blue”, values=”R,G,B”)}} |
在本例中,此下拉式列表在签名过程中向标识为 signer1 的接收者显示三个选项,其中第二个选项为空。如果接收者选择该空选项,导出的值为“G”。 |
可以根据需要向下拉字段定义中添加其他指令,例如,通过将下拉式列表设为必填、将条件逻辑应用于下拉式列表或指定应该在 PDF 中屏蔽接收者选择的选项。
支持文档(文件附件)
在签名过程中,Adobe Sign 可用于从签名者收集支持文档。在签名体验中,Adobe Sign 将文本标记转换为一个字段,签名者可选择向其上传文件。上传的文档作为已签名文档的一部分包含在内,在签名过程完成后,将转换为 PDF 并随附在已签名协议的末尾。可使用“attachment”指令定义用于从签名者收集文件的表单字段。
{{*DriversLicense_es_:signer1:attachment}} |
定义一个名为“DriversLicense”的必填字段,它将分配给标识为 signer1 的接收者。在签名过程中,接收者必须使用此字段上传一个文件。 |
{{photo_es_:signer1:attachment:label("Photo")}} |
定义一个名为“photo”的可选字段,它将分配给标识为 signer1 的接收者。在签名过程中,接收者可以使用此字段上传一个图像。指令标签可用于为字段指定简单易懂的说明。此标签在签名过程中显示给签名者。 |
定义一个文件附件字段:
在签名过程中显示的文件附件字段:
超链接(业务和企业)
Adobe Sign 可用于在文档中指定超链接。超链接在签名过程中可单击,可将接收者导航到文档中的某个位置或外部 URL。也可为超链接指定标签,以使文档显示文本标签而非直接 URL。
{{companywebsite_es_:link(http://www.adobe.com):label(Adobe)}} |
定义一个链接到外部 URL 的超链接。包括一个将在签名过程中显示给接收者的标签“Adobe”。 |
{{doclink_es_:link:page(10):label(View this section)}} |
定义一个链接到当前文档中第 10 页的超链接。包括一个将在签名过程中显示给接收者的标签“View this section”。 |
参与者图章和事务 ID(业务和企业)
可为签名者将参与者图章和事务 ID 添加到已签名的 PDF 中。特定参与者为文档签名或批准文档后,将显示此人的图章。参与者图章包括参与者的姓名、签名/批准事件的时间和电子邮件。事务 ID 和图章将显示在最终签名的 PDF 中。
{{userstamp1_es_:signer1:stamp}} |
为标识为 signer1 的接收者定义一个参与者图章。此图章将显示在最终签名的 PDF 中。 |
{{userstamp2_es_:signer2:stamp}} |
为标识为 signer2 的接收者定义一个参与者图章。此图章将显示在最终签名的 PDF 中。 |
{{transstamp2_es_:transactionid}} |
定义一个将显示在最终签名的 PDF 中的事务 ID 图章。 |
{{userstamp_es_:signer1:stamp:repeat}} {{transstamp1_es_:transactionid:repeat}} |
定义一个将显示在最终签名的 PDF 中所有页面上同一位置的图章。 |
数字签名(企业)
数字签名可添加到文档中。每个文档中只能有每个签名者的一个数字签名。如果添加每个签名者的多个数字签名(例如 {{digsig1_:signer1: digitalsignature}} 和 {{digsig2_:signer1: digitalsignature}}),则发送文档以供签名时,将仅保留第一个而自动移除其他数字签名,除非发送之前在预览和编制环境中手动移除。
{{digsig1_es_:signer1:digitalsignature}} |
为标识为 signer1 的接收者定义一个数字签名。 |
图章签名
图章是一种具有双重用途的字段类型,可替代签名字段,构成图章的可以是公司签署时偏好使用的印章,或者是它支持的传统签名,如判子。与数字签名字段一样,每个接收者只能定义一个图章字段。默认情况下,除非标记为必填项,或者没有为签名者安排其他签名字段,否则图章字段是可选项。
图章字段需要在 :stampimage 指令中包含一个指示字段高度的额外参数。字段高度基于文本标记的字体大小,由行数来衡量。
{{Stamp1_es_:signer1:stampimage(28)}} |
为标识为 signer1 的接收者定义一个高度为 28 行的图章字段。 |
指定默认值
Adobe Sign 支持使用文本标记指定字段的默认值。指定的默认值在签名过程中显示给参与者。
文本标记指令 |
示例 |
---|---|
:default |
:default("Default value specified in double quotes") :default('Default value specified in single quotes') |
如果默认值包含单引号或撇号,则必须用双引号将默认值引起来。例如:{{location_es_:signer1:default("Signer's Business")}}。如果默认值必须包含双引号,则默认值必须放在单引号中。
指定工具提示
使用文本标记也可指定 Adobe Sign 表单字段的工具提示。工具提示在签名过程中显示给接收者。
文本标记指令 |
示例 |
---|---|
:tooltip |
:tooltip("Please provide a copy of your Driver's License") :tooltip('Choose a color') |
指定字体外观
文本标记可用于更改字段的字体外观,以便覆盖关于字体名称、颜色和大小的文本标记中使用的字体外观。要指定字体名称,请使用现有文档中任意字体的字体名称或以下字体之一:Lato、Roboto、Slabo 13px、Source Serif Pro、Source Sans Pro 和 Source Code Pro。要指定颜色,应使用 RGB 十六进制值或以下任意有效的颜色值:white、lightgray、gray、darkgray、black、red、pink、orange、yellow、green、magenta、cyan 或 blue。默认情况下,字体名称和大小是文本标记开头第一个括号“{”的字体名称和大小。
文本标记指令 |
示例 |
---|---|
:font |
:font(name=Lato, color=#FF0000, size=12) – 将字段外观指定为:Lato 字体,红色文本,字体大小为 12 磅
:font(name=Source Code Pro, color=green, size=14) – 将字段外观指定为:Source Code Pro 字体,绿色文本,字体大小为 14 磅 |
指定字段对齐方式
文本标记可用于对齐在表单字段中输入的值。默认情况下,表单字段中的值左对齐。但是,通过在文本标记中使用指令,可居中对齐或右对齐表单字段。
文本标记指令 |
示例 |
---|---|
:align(alignment) |
:align(left) – 左对齐字段中的文本。这是表单字段的默认行为,无需符合指令。 :align(right) – 右对齐字段中的数据。 :align(center) – 居中对齐在表单字段中输入的数据。 |
指定重复字段
文本标记可用于在文档中的每个页面上重复相同的字段,而无需在每个页面上复制文本标记。例如,这对于冗长文档中的签名字段或参与者图章会特别有用。
文本标记指令 |
示例 |
---|---|
:repeat |
:stamp:repeat – 将参与者图章复制到文档中其他每个页面上的同一位置。确保为图章定义签名者角色(例如 signer1 和 signer2)。 :signature:repeat – 将签名字段复制到文档中其他每个页面上的同一位置。确保为图章定义签名者角色(例如 signer1 和 signer2)。 :repeat(even) – 将字段复制到文档中偶数页面上的同一位置。 :repeat(odd) – 将字段复制到文档中奇数页面上的同一位置。 :repeat(after) – 将字段复制到该字段添加到的页面后面所有页面上的同一位置。 :repeat(before) – 将字段复制到该字段添加到的页面前面所有页面上的同一位置。 :repeat(2,10)、:repeat(6-9) 和 :repeat(2,6-9) – 将字段复制到文档中指定的页面上或一定范围的页面上的同一位置。 |
指定数据验证规则
Adobe Sign 支持由附加文本标记指令指定的各种字段验证类型。当签名者在签名过程中填写数据时,将应用指定的数据验证规则。如果输入的数据不符合指定的验证规则,Adobe Sign 将不允许接收者完成签名过程。
例如:
{{*Mobile_es_:signer1:phone}} |
定义一个名为“Mobile”的必填字段,它将分配给标识为 signer1 的接收者。在签名过程中,接收者必须在此字段中提供一个有效的电话号码。 |
{{Birthday_es_:signer2:isdate}} |
定义一个名为“Birthday”的字段,它将分配给标识为 signer2 的接收者。在签名过程中,接收者需要输入一个日期值。 |
某些字段验证类型可能包含附加属性,用于缩小字段中所允许值的范围。
{{duration_es_:signer1:num(>=0,<=60)}} |
定义一个名为“duration”的可选字段,此字段的值必须介于 0 到 60 之间。 |
{{tenNum_es_:signer1:string(char=num,maxlen=10)}} |
定义一个名为“tenNum”的可选字段,它最多允许输入 10 位数。 |
支持的字段验证规则
验证类型 |
文本标记指令 |
可选参数和 值 |
示例 | |
---|---|---|---|---|
字符串 |
:string |
char |
alpha – 仅字母 |
:string :string(char=num)
|
|
num – 仅数字 |
|||
|
alphanum – 字母和数字 |
|||
maxlen |
特定的最大长度 |
|||
数字 |
:num |
>= |
大于或等于 |
:num :num(<=1000) :num(>=50,<=500) |
<= |
小于或等于 |
|||
货币 |
:curr |
country |
:curr :curr(country=us) :curr(country=uk) :curr(<=500) :curr(country=us,<=100) |
|
>= |
||||
<= |
||||
百分比 |
:pct |
>= |
大于或等于 |
:pct :pct(>=50) :pct(>=0,<=100) |
<= |
小于或等于 |
|||
日期 |
:isdate |
format |
mm/dd/yy(默认值) |
:isdate :isdate(format=dd/mm/yy) |
mm/dd/yyyy |
||||
dd/mm/yy |
||||
dd/mm/yyyy |
||||
mm/yy |
||||
时间 |
:time |
:time | ||
电子邮件 |
:isemail |
:isemail | ||
邮政编码 |
:zip |
country |
us – 默认美国邮政编码格式 |
:zip :zip(country=uk) |
uk - 英国邮政编码格式 |
||||
邮政编码 + 4 |
:zip4 |
:zip4 | ||
电话 |
:phone |
country |
us – 默认美国电话号码格式 |
:phone :phone(country=uk) |
uk - 英国电话号码格式 |
||||
社会保险号 |
:ssn |
:ssn | ||
在文本标记中使用正则表达式来验证数据 |
:custom |
regexp |
一个以字符串形式表示的正则表达式。请参见下方的“注意”。 |
:custom(regexp="^5[1-5][0- 9]{14}$") |
msg |
当数据不符合指定的表达式时要向接收者显示的消息。 |
:custom(regexp="^.{3}$",msg="Not amatch for three chars in a row!") |
在此语法中,作为正则表达式构造一部分的反斜杠字符(如“\w”)必须始终用反斜杠来转义(即“\\w”)。要搜索反斜杠,必须使用 \\\\。字符串的开头和结尾字符是双引号 (")。如果接收者输入的数据中预期会出现引号,要提供与引号匹配的正则表达式验证字符串,它们必须在表达式中转义为 \"。关于 Adobe Sign 所用正则表达式的语法,在此处可找到很好的参考。
单个字段只能包含一个验证指令。如果在单个文本标记中指定了多个验证规则,只会应用第一个验证规则。所有后续验证规则都将被忽略。
屏蔽敏感数据
Adobe Sign 支持通过向文本标记添加特定指令来屏蔽在签名过程中收集的敏感数据。在签名过程中,签名者退出此类字段后,他们在其中输入的数据将立即转换为星号 (*) 或用户定义的屏蔽字符。签名者输入的数据也不会显示给任何后续签名者或包括在完成的 PDF 中。签名者输入的数据可以从 Adobe Sign 中或通过 Adobe Sign API 导出。
文本标记定义:
在签名过程中:
在最终 PDF 中:
{{*CC_es_:signer1:mask}} |
定义一个名为“CC”的必填字段,它将分配给标识为 signer1 的接收者,并且在签名过程中屏蔽。 |
{{*CC_es_:signer1:mask(char=-)}} |
定义一个名为“CC”的必填字段,它将分配给标识为 signer1 的接收者,并且在签名过程中使用“-”屏蔽。如果未在文本标记中指定字符,星号 (*) 将用作默认屏蔽字符。 |
指定字段的条件规则
Adobe Sign 支持对文档中的字段应用条件规则。条件规则可用于定义文档中的特定字段在签名过程中何时显示给签名者或对其隐藏。
对特定字段应用的条件基于文档中一个或多个其他字段的值。对特定字段应用的条件规则也可指定是在满足为特定字段定义的所有条件时显示或隐藏特定字段,还是在满足为特定字段定义的任一条件时显示或隐藏特定字段。
{{_es_:signer1:showif(condition)}} {{_es_:signer1:showifany(condition)}} |
当满足定义的任一条件时,将字段显示给标识为 signer1 的接收者。 |
{{_es_:signer1:showifall(condition)}} |
仅当满足定义的所有条件时,才将字段显示给标识为 signer1 的接收者。 |
{{_es_:signer1:hideif(condition)}} {{_es_:signer1:hideifany(condition)}} |
当满足定义的任一条件时,对标识为 signer1 的接收者隐藏字段。 |
{{_es_:signer1:hideifall(condition)}} |
仅当满足定义的所有条件时,才对标识为 signer1 的接收者隐藏字段。 |
{{_es_:signer1:enableif(condition)}} {{_es_:signer1:enableifany(condition)}} |
当满足定义的任一条件时,为标识为 signer1 的接收者启用字段。这类似于“showif”条件,只不过当不满足条件时,在签名过程中字段外观可见,但灰显且不可编辑。灰显的字段将显示字段的默认值(如果适用)。此值也会显示在签名的 PDF 中。 |
{{_es_:signer1:enableifall(condition)}} |
仅当满足定义的所有条件时,才为标识为 signer1 的接收者启用字段。 |
{{_es_:signer1:disableif(condition)}} {{_es_:signer1:disableifany(condition)}} |
当满足定义的任一条件时,为标识为 signer1 的接收者禁用字段。禁用的字段在签名过程中显示为灰显的字段。如果存在默认字段值,已禁用字段的值仍会显示在签名的 PDF 中。 |
{{_es_:signer1:disableifall(condition)}} |
仅当满足定义的所有条件时,才为标识为 signer1 的接收者禁用字段。 |
按以下方式定义条件:字段名 运算符 值,其中字段名是文档中条件所基于的表单字段的名称。下表显示了支持的运算符和支持的各种表单字段的有效值。
条件字段运算符
运算符 |
含义 |
值 |
示例 |
---|---|---|---|
=、== 和 eq |
等于 |
单个值 |
myCheck=checked |
!=、<> 和 neq |
不等于 |
单个值 |
signature!=signed |
< 和 lt |
小于 |
单个值,数字 |
myNumber < 10 |
> 和 gt |
大于 |
单个值,数字 |
myNumber > 40 |
<= 和 lte |
小于或等于 |
单个值,数字 |
myNumber <= 15 |
>= 和 gte |
大于或等于 |
单个值,数字 |
myNumber >= 0 |
?= 和 in |
在 |
逗号分隔列表,必须在引号或括号中 |
option ?="1,2,3" |
?!=、!in、not in 和 notin |
不在 |
逗号分隔列表,必须在引号或括号中 |
option ?!= "1,2,3" |
~= 和 contains |
包含 |
单个值 |
Title ~= Manager |
~!=、!contains、not contains 和 notcontains |
不包含 |
单个值 |
Title ~!= Junior |
单个字段的多个条件可以使用逗号进行分隔。例如:
{{notRed_es_:showifall(checkbox=checked,Color!=Red)}} 定义一个名为“notRed”的字段,当同时满足两个条件时,将此字段显示给签名者。
支持的文本标记字段的条件字段值
字段类型 |
有效值 |
示例 |
---|---|---|
签名 |
signed 和 unsigned |
signHere=signed |
缩写签名 |
signed 和 unsigned |
initHere!=signed |
复选框 |
checked 和 unchecked |
myCheck=checked |
单选按钮 |
单选按钮选项的值 |
Color=Red |
文本字段 |
文本字段的值 |
Title!=Senior Title~=Chief Price>100 |
可将条件分配给任何字段,包括必填字段,如缩写签名、签名和签名块。为必填字段定义条件时,仅当条件使字段在签名过程中对签名者可见时,才将其看作必填字段。换句话说,如果某个签名字段有一个使其隐藏的条件,该字段将对签名者不可见,因此不需要签名者在此特定字段中提供签名。签名页面底部的“必填字段”计数将根据定义的条件动态更新,以准确反映签名者在完成文档的签名之前必须填写的字段数。
每个签名者必须有一个未分配有任何条件的签名字段。正因如此,如果给定签名者的所有签名字段都有一个条件,将在文档末尾为该签名者添加一个新的签名块。
指定字段的计算公式
Adobe Sign 支持根据其他字段值/客户在签名过程中做出的选择在签名过程中动态填充文档中的字段值,这些类型的字段称为计算型字段。
可使用文本标记或在 Adobe Sign 拖放编制环境中定义计算公式,定义方式与文档中的其他字段类似。计算公式可引用文档中的一个或多个现有字段,也可基于文档中的其他计算型字段。计算可应用于数值字段、日期字段和文本字段。
除了计算文档中字段的值之外,计算型字段也可包含格式设置信息,以适当设置文档中计算所得值的输出样式。此外,也可通过文本标记对计算型字段应用条件规则、字段屏蔽等附加规则。
f1_es_:signer1:calc(formula) |
一个计算型字段,分配给标识为 signer1 的接收者。将根据定义的公式自动计算此字段的值。 |
f2_es_:signer1:calc(formula):format(formatType, format) |
一个计算型字段,分配给标识为 signer1 的接收者。将根据定义的公式计算此字段的值,所得的输出值属于特定类型并设置为指定的格式。 |
示例:可使用一个计算型字段来动态计算订单上应交的总税额。
{{Tax_es_:signer1:calc([subtotal] * [taxrate]):format(number, "$,.00")}}
税额的计算基于客户所订购商品的总成本以及签名者的住处所在国家的税率。计算所得税额的格式为金额前面带有美元 ($) 符号,并且所得值包含两位小数。例如,如果小计为 1250 且税率为 6.25%,则文档中“税”字段中显示的计算所得值将为 $1,328.13。
有关计算型字段以及如何在文档中使用这些字段的更多信息,请参阅计算型字段参考指南。
缩短文本标记
文本标记提供了一个非常强大的机制,用于在文档中定义不同类型的字段、将这些字段分配给特定的签名者、指定字段的验证规则和/或对这些字段应用条件规则。对单个表单字段应用全部这些会使字段定义很长,可能会因字段定义而导致文档结构发生变化。此外,由于每个字段定义必须放在一行中,因此使用多个复杂的指令会使文档布局非常困难。为了确保文档结构的一致性,Adobe Sign 支持一种机制,用于在文档中定义缩短型文本标记。缩短型文本标记由两部分组成:
- 引用标记 - 缩短型标记定义,放置在文档中的适当位置。引用标记控制文档中实际表单字段的大小和位置。引用标记的语法如下:{{$shortened_name}}。例如,{{$r}} 定义了一个引用标记,其中“r”是此标记的简称。字段的大小可使用紧跟在最后一个左花括号后面或紧靠在第一个右花括号前面的空格进行调整。
- 定义标记 - 是指特定标记的完整定义,可在文档中的任意位置定义。定义标记的大小和位置并不决定文档中实际表单字段的大小和位置。定义标记的语法如下:
{{#shortened_name=Standard Tag Syntax}}。例如,{{#r=[]ReceiveCommunication_es_:signer1}} 为名为“r”的引用标记定义完整的标记定义。在本例中,此标记定义了一个分配给标识为 signer1 的接收者的复选框。
例如,下图显示了文档中放置的两个引用标记。
这两个引用标记的完整定义在文档中的其他位置进行定义,如下图中所示。
文本标记的完整定义非常长,如果不能在文档中的适当位置定义缩短型标记,将无法保持原始文档的结构。
从输出中移除页面
通过将表单字段的位置与字段的定义分离,可以将文档中的所有标记定义放置在文档的末尾或文档中一个完全独立的页面上。通过 Adobe Sign 发送文档时,会处理所有文本标记,并在文本标记定义的上面放置一个白框,以使文本不再对签名者可见。这可能会导致在经过 Adobe Sign 处理后文档中出现完全空白的页面,页面中仅包含文本标记。为了避免文档中出现不需要的额外空白页面,Adobe Sign 支持一种特殊文本标记定义,用于在发送文档以供签名之前从 Adobe Sign 生成的处理后输出文档中移除特定的页面。
{{#REMOVE_PAGE_FROM_OUTPUT}} |
一个特殊指令,指示 Adobe Sign 从文档的处理后输出中移除出现此指令的页面。此标记可以出现在页面上的任意位置。发送至 Adobe Sign 的文档必须至少包含一页。如果此指令出现在发送至 Adobe Sign 的文档中的所有页面上,将不会删除第一页。 |
高级文本标记示例
下面显示了几个文本标记示例,并对每个标记进行了说明。
复选框
{{[]_es_:signer1}} |
一个复选框,分配给标识为 signer1 的接收者。 |
{{[]*}} |
一个必填复选框。 |
{{[]!}} |
一个只读复选框。 |
单选按钮
{{(Daily)Rate_es_:signer1}} |
一个分配给 signer1 的单选按钮,值为“Daily” |
下拉式列表
{{*Color_es_:signer1:dropdown(options= "Red,Green,Blue”)}} |
一个必填下拉式列表,包含三个可能的选项。此列表分配给标识为 signer1 的接收者。 |
{{Color_es_:signer1:dropdown(options= "Red,Green,Blue”):default(“Red”)}} |
此下拉式列表包含三个可能的选项,默认情况下选择的是选项“Red”。此列表分配给标识为 signer1 的接收者。如果在此下拉式列表的定义中指定了值,必须使用值来指定默认值,否则将使用选项。 |
{{Color_es_:dropdown(options=Red,Green,Blue” , values=”R,G,B”):default(“R”):mask}} |
此下拉式列表不会分配给任何接收者,它包含三个可能的选项,这些选项对应于三个导出值。 值“R”对应于接收者选择的“Red”,默认情况下选择的是此值,结果选择的选项在 PDF 中屏蔽(显示为“*”)。 |
{{Color_es_:dropdown(options= "Red,Green,Blue”):showif(Rate=”Daily”)}} |
此下拉式列表不会分配给任何接收者,它包含三个可能的选项。仅当名为“Rate”的单选按钮的值为“Daily”时,才会显示此下拉式列表。 |
字段验证
{{Birthday_es_:signer2:isdate}} |
一个可选的日期字段,供标识为 signer2 的接收者以美国日期格式输入日期。 |
{{*Zip2_es_:signer2:zip}} |
一个必填字段,供标识为 signer2 的接收者提供有效的邮政编码。此字段可验证接收者输入的值。 |
缩短文本标记
|
{{$r}} |
一个指定字段位置的引用标记。 |
|
{{#r=[]Spouse_es_:prefill}} |
一个要由发送者预填的复选框的定义。 |
文本标记缩短也可用作函数,而不仅仅是替换整个字段。
例如,我们使用以下标记:
{{field1_es_:signer1:showif(fieldA=‘Yes)}}
上方的标记也可通过以下方式缩短:
{{field_es_:$A:$B}}
#A=signer
#B=showif(fieldA=‘Yes’)
文本标记缩短的行为方式还能像计算方法一样。例如,我们使用以下标记:
{{field1_es_:calc(a * b / c)}}
上方的标记也可通过以下方式缩短:
Field1_es_:$1(a,b,c)
#1(option1, option2, option3) = calc([option1] * [option2] / [option3])
条件规则
{{f_es_:hideifall(sig=unsigned,initials=unsigned}} |
仅当同时提供了签名和缩写签名时,才会显示此字段。 |
{{*emailAddress_es_:signer1:isemail:showif (TypeOfComm="receiveEmail")}} |
一个必填字段,供标识为 signer1 的接收者输入有效的电子邮件地址。仅当另一个名为“TypeOfComm”的字段的值为“receiveEmail”时,才会显示此字段。此字段可验证接收者输入的值。 |
{{f_es_:hideifany(Color=”Red”,Color=”Green”}} |
当接收者在名为“Color”的下拉式列表中选择颜色“Red”或颜色“Green”时,将隐藏此字段。 |
计算型字段
{{shipState_es_:signer1:calc([billingState]) :showif(sameAs=unchecked)}} |
文档中的一个字段,分配给第一个签名者,仅当取消选中另一个名为“sameAs”的字段(一个复选框)时,才会显示此字段。将以签名者在文档中的字段“billingState”中输入的值自动填充此字段的值。 |
{{total_es_:signer1:calc(q1*pr1) :format(Number,”$,0.00”):align(right)}} |
文档中的一个字段,分配给标识为 signer1 的接收者。此字段的值将自动计算为字段“q1”和“pr1”中的值的乘积。所得值的格式设置为货币值,所得值前面显示有美元 ($) 符号,并且包含两位小数。此外,所得值在字段中右对齐。 |
{{price_es_:signer1:calc(if(pn1=”W1”,9.99, if(pn1=”W2”,5.99,if(pn1=”W3”,24.99,0))))}} |
文档中一个名为“price”的字段,将根据签名者在文档中的另一个字段“pn1”中选择的值计算此字段的值。在本例中,如果字段“pn1”等于 W1,则“price”字段中显示的值为 9.99;如果字段“pn1”等于 W2,则“price”字段中显示的值为 5.99,依此类推。如果没有任何值与字段“pn1”的值匹配,则“price”字段中显示的值为 0。使用此机制,计算型字段可用于根据用户在签名过程中做出的选择自动填充商品的价格。 |
有关计算型字段的更多信息,请参见计算型字段参考指南。
本指南的可下载版本
下载