{{Sig_es_:signer1:signature}}
新增功能
快速入门
管理
- Admin Console 概述
- 用户管理
- 帐户/组设置
- 设置概述
- 全局设置
- 帐户级别和 ID
- 自签名工作流
- 批量发送
- Web 表单
- 自定义发送工作流程
- Power Automate 工作流程
- 库文档
- 收集包含协议的表单数据
- 有限文件可见性
- 附加已签名协议的 PDF 副本
- 在电子邮件中包含链接
- 在电子邮件中包含图像
- 附加至电子邮件的文件将命名为
- 将审核报告附加到文档
- 将多个文档合并为一个
- 上传签名文档
- 我的账户中的用户委托
- 允许外部收件人委派
- 授权签名
- 授权发送
- 授权添加电子密封
- 设置默认时区
- 设置默认日期格式
- 位于多个组的用户 (UMG)
- 组管理员权限
- 替换接收者
- 审核报告
- 概述
- 允许在事务验证页面上进行未经身份验证的访问
- 包含提醒
- 包含查看事件
- 包含协议页面/附件计数
- 在产品消息发送和指南中
- 可访问的 PDF
- 新版“编辑”体验
- 医疗保健客户
- 帐户设置
- 添加标志
- 自定义公司主机名/URL
- 添加公司名称
- 发布协议 URL 重定向
- 签名首选项
- 格式精美的签名
- 允许收件人签名的方式
- 签名者可以更改其姓名
- 允许接收者使用其保存的签名
- 自定义使用条款和消费者信息披露条款
- 在表单字段中导航收件人
- 拒绝签名
- 允许图章工作流
- 要求签名者提供其职务或公司
- 允许签名者打印并置入书面签名
- 进行电子签名时显示消息
- 需要签名者使用移动设备创建其签名
- 请求签名者的 IP 地址
- 从参与者图章中排除公司名称和职务
- 数字签名
- 电子签章
- 数字身份
- 报告设置
- 新版报告体验
- 经典报告设置
- 安全设置
- 发送设置
- 登录后显示“发送”页面
- 发送时需要收件人姓名
- 锁定已知用户的名称值
- 允许的收件人角色
- 收件人组
- 必填字段
- 附加文件
- 字段拼合
- 修改协议
- 协议名称
- 语言
- 私人消息
- 允许的签名类型
- 提醒
- 已签名文档的密码保护
- 通过以下方式发送协议通知
- 签名者身份识别选项
- 内容保护
- 启用 Notarize 事务
- 文件过期
- 预览、定位签名和添加字段
- 签名顺序
- “液体”模式
- 自定义工作流控件
- 电子签名页面的上传选项
- 签名后确认 URL 重定向
- 消息模板
- 生物识别设置
- 工作流程集成
- 公证设置
- 付款集成
- 签名者消息发送
- SAML 设置
- SAML 配置
- 安装 Microsoft Active Directory 联合身份验证服务
- 安装 Okta
- 安装 OneLogin
- 安装 Oracle Identity Federation
- SAML 配置
- 数据管理
- 时间戳设置
- 外部归档
- 账户语言
- 电子邮件设置
- 从 echosign.com 迁移到 adobesign.com
- 为收件人配置选项
- 监管要求指导
- 批量下载协议
- 申请您的域
- “举报滥用”链接
发送、签署和管理协议
- 收件人选项
- 发送协议
- 在文档中创作字段
- 应用程序内创作环境
- 使用文本标记创建表单
- 使用 Acrobat (AcroForms) 创建表单
- 字段
- 创作常见问题
- 签署协议
- 管理协议
- 审核报告
- 报告和数据导出
高级协议功能和工作流程
- Web 表单
- 可重复使用的模板(库模板)
- 转让 Web 表单和库模板的所有权
- Power Automate 工作流程
- Power Automate 集成和包含的权限概述
- 启用 Power Automate 集成
- “管理”页面上的上下文操作
- 跟踪 Power Automate 使用情况
- 创建新的工作流(示例)
- 用于工作流的触发器
- 从 Acrobat Sign 外部导入工作流
- 管理工作流
- 编辑工作流
- 共享工作流
- 禁用或启用工作流
- 删除工作流
- 实用模板
- 仅限管理员
- 协议存档
- Web 表单协议存档
- 将已完成的 Web 表单文档保存到 SharePoint 库
- 将已完成的 Web 表单文档保存到 OneDrive for Business
- 将已完成的文档保存到 Google Drive
- 将已完成的 Web 表单文档保存到 Box
- 协议数据提取
- 协议通知
- 发送包含协议内容和已签名协议的自定义电子邮件通知
- 在 Teams 渠道中获取 Adobe Acrobat Sign 通知
- 在 Slack 中获取 Adobe Acrobat Sign 通知
- 在 Webex 中获取 Adobe Acrobat Sign 通知
- 协议生成
- 通过 Power Apps 表单和 Word 模板生成文档,并发送以供签名
- 从 OneDrive 中的 Word 模板生成协议并获取签名
- 为所选 Excel 行生成协议,发送以供审阅和签名
- 自定义发送工作流程
- 共享用户和协议
与其他产品集成
- Acrobat Sign 集成概述
- Acrobat Sign for Salesforce
- Acrobat Sign for Microsoft
- 其他集成
- 合作伙伴管理的集成
- 如何获取集成密钥
Acrobat Sign 开发人员
- REST API
- Webhook
支持和故障排除
概述
Adobe Acrobat Sign 文本标记是设置了特殊格式的文本,可放置在文档内容中的任何位置,用来指定字段(如签名和缩写签名字段)、复选框、单选按钮和表单字段的位置、大小和类型以及高级可选字段处理规则。在创建包含表单字段的 PDF 时,也可以使用文本标记。请参见《Acrobat 参考指南》中的“创建表单”。
当发送文档以供签名或上传时,文本标记将转换为 Acrobat Sign 表单字段。Acrobat Sign 文本标记可放置在任何类型的文档中,如 PDF、Microsoft Word、PowerPoint、Excel 和文本文件(.txt 和 .rtf)。
例如:
|
一个签名字段,分配给标识为 signer1 的接收者。 |
{{Cmpy_es_:signer2:company}} |
此字段用于输入标识为 signer2 的接收者的公司名称。 |
{{address_es_:signer1}} |
此字段供标识为 signer1 的接收者输入他们的地址。 |
{{*city_es_:signer1}} |
一个必填字段,供标识为 signer1 的接收者输入他们所在的城市。 |
{{!price}} |
一个只读字段。接收者无法更改此字段的值。 |
Acrobat 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}} |
一个只读字段,包含签名的日期。 通过添加 :format 指令允许设置格式。例如,Dte_es_:signer1:date:format(date,dd-mm-yy) |
{{Em_es_:signer1:email}} |
一个只读字段,包含签名者的电子邮件地址。 |
另一种方法是仅使用“signer1”、“signer2”、“signer3”等角色,而不使用“发送者”和“签名者”角色。请确保在发送文档时按正确的顺序添加这些参与者。
发送者字段
仅当在发送过程中指定了“我需要首先/最后签名”选项时,才能使用“发送者”角色。“发送者”角色始终指定分配给“发送者”的字段,而不管他们首先签名还是最后签名。
{{*Ttl_es_:sender:title}} |
一个必填字段,供发送者输入他们的职务。 |
所有人字段
这个“超链接”字段具有一个特殊(可选)的收件人角色:所有人。
当就绪后,该角色要求所有收件人在按照协议完成操作之前,都要与该字段进行交互。
所有人都必须单击这个超链接。
预填字段
{{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])}} |
此字段的值自动计算为“小计”和“税”字段的总和。 |
文本标记转换为表单字段
字段长度和格式设置
在可编辑的文档中使用文本标记时,Acrobat Sign 将叠加一个矩形,使其覆盖文本标记的整个范围(从开头的“{{”到结尾的“}}”),并将文本标记转换为相应的 Acrobat Sign 表单字段。
通过在文本标记开头紧跟在“{{”后面添加空格字符或在文本标记末尾紧靠在“}}”前面添加空格字符,可以增加表单字段的长度。通过减小文本标记的字体大小可以减小表单字段的大小以达到适当的长度。
表单字段的格式设置(字体大小、类型、颜色等)由第一个“{”的格式确定。要确保 Acrobat Sign 正确处理文本标记,应该在文档中以常见的字体(Helvetica、Times、Arial、Verdana 或 Courier)指定标记定义。要通过指令强制使用特定字段大小和/或字体样式,请参阅使用指令控制字段大小部分。
文本标记定义区分大小写,并且必须指定为小写文本。
下图显示了放置在 Microsoft Word 文档中的文本标记。
文本标记的整个范围(从开头的花括号到结尾的花括号)必须在单行中容纳得下。如果文本标记在源文档中或在处理的 PDF 中跨越多行,Acrobat Sign 将无法正确识别表单字段,可能会导致签名者在为文档签名时看到底层文本。
在 PDF 表单中使用时,花括号不得包含在 PDF 表单字段的名称中,字段的大小由 PDF 表单字段的大小确定,在字段中所输入数据的格式设置由 PDF 表单字段属性确定。
单个文档不能同时包含 PDF 表单字段和使用文本标记定义的字段。
在签名过程中与表单字段交互
在签名体验中,上方的文本标记将转换为下方的可填写字段:
已签名文档中的表单字段
数据合并到已签名的文档中后,以下内容将出现在已签名的 PDF 中:
长文本标记
在可编辑的文档中使用时,包含多个指令的文本标记可能会变得非常长,从而使得很难在文档中指定小字段。Acrobat Sign 提供了一个简单的机制,用于在文档中指定较短的标记。
例如,如果需要设置一个分配给发送者的必填电话字段,可以不放置完整的
{{*Mobile_es_:signer1:phone}} 标记,而是在文档中的适当位置使用一个较短的标记 {{$mob }},在此标记中使用空格调整字段的大小。此文本标记的完整定义
{{#mob=*Mobile_es_:signer1:phone}} 可以放置在文档中的其他位置。要了解有关如何缩短文本标记的更多信息,请参见缩短文本标记。
文本标记深入讲解
文本标记语法
Acrobat Sign 文本标记定义为:
其中,各个组成部分定义如下:
- 必填 - 一个可选的标志,指定特定的字段是否为必填字段,是否必须由签名者在签名过程中填写。如果不存在此标志,表明表单字段不是必填字段,签名者在签名过程中可以(但不是必须)填写值。
- 只读 - 一个可选的标志,指明特定的字段是一个只读字段。将字段标记为只读可确保在签名过程中任何人都无法修改字段中的数据。在发送文档以供签名之前,可使用 Acrobat Sign API 或通过 CSV 使用批量发送将数据合并到只读字段中。
- 字段名称 - 一个唯一的名称,可以在文档中标识特定的字段。字段名称用于标识从服务导出数据后在签名过程中提供的值。
- 如果文档中的多个文本标记具有相同的名称但不同的指令或这些指令在名称相同的文本标记中的顺序不同,则 Acrobat Sign 将自动在名称开头添加“efield”+ 唯一编号 +“_”。例如,如果文档中出现两个名为“Address”的字段,则 Acrobat Sign 会将其中一个字段的名称更改为“efield2_Address”。
- 如果文档中的两个文本标记具有相同的字段名称、相同的指令和相同的指令顺序,则将这两个字段看作克隆的字段。在一个字段中输入的数据将自动克隆到文档中的另一个字段位置。
- ES 标识符 - 一个特定的文本字符串“_es_”,必须包含在文本标记中的字段名称后面,才能启用特定的 Acrobat Sign 功能。如果未在字段名称后面包含此 Acrobat Sign 标识符,则会向文档中添加一个没有任何指令的表单字段。
- 指令 - 包含一个或多个定义的列表,以冒号(“:”)开头,可指定角色、字段类型以及其他字段处理规则(用于定义字段中允许的输入类型)。指令可按任何顺序定义。
- 角色 - 与此字段关联的参与者(例如发送者和签名者)。
- 字段类型 - Acrobat Sign 表单字段的类型(例如签名、缩写签名、复选框或文本字段)。
- 规则 - 高级处理规则,例如数据验证、根据条件显示/隐藏字段的逻辑等。
在签名过程中控制字段交互
在签名工作流程中,可将文档中的表单字段分配给特定的签名者。Acrobat Sign 可确保签名者在签名过程中只能与已分配给他们的字段交互。通过在文本标记中添加特定的指令,可将表单字段分配给特定的签名者。
将表单字段分配给特定的签名者
Acrobat Sign 支持使用以下指令将表单字段分配给特定的签名者。
{{Field2_es_:signer1}} |
协议中的一个字段,分配给不是协议发送者的第一个人。 |
{{Field3_es_:signer1}} {{Field4_es_:signer2}} |
如果协议需要多个签名者且每个签名者都需要在签名过程中提供数据,可以使用 signer<x> 指令将协议中的字段分配给特定的签名者,其中 <x> 是签名者签署协议的序号。以 signer1 指令标记的字段分配给第一个签名者,以 signer2 指令标记的字段分配给第二个签名者,依此类推。Acrobat Sign 可确保签名者只能与分配给他们的字段交互。 如果协议的发送者在签名过程中首先签名,则所有标记为“signer1”的字段(除标记为“sender”的字段以外)都会呈现给发送者。 |
发送者预填数据
在某些情况下,在发送协议以供签名之前,发送者并非必须在协议上签名,但是必须输入数据。这通过向协议中的相关表单字段添加“prefill”指令来实现。Acrobat Sign 允许发送者在发送协议以供签名之前填写这些字段。
{{Field5_es_:prefill}} |
协议中的一个字段,需要发送者在发送协议以供签名之前填写。 |
默认情况下,为上传到 Acrobat Sign 文档库的文档启用预填功能。此外,也可以通过在发送文档时启用“预览并添加签名字段”选项来启用预填功能。要为从“发送”页面中发送的所有协议启用预填功能而不管是否启用了“预览”选项,请与 Adobe 支持人员联系。
未分配的字段
未包含角色(或角色指令拼写错误)的字段允许接收者列表中的任何人填写。填写该字段后,它将处于锁定状态,阻止后续签名者更改其值。
{{Address}} |
协议中的一个字段,可由任何签名者填写。 |
{{zip_es_:zip4}} |
协议中的一个字段,供任何签名者输入邮政编码并进行验证。 |
默认情况下,如果未分配的字段标记为“必填”,则第一个收件人需要填写该值。
帐户设置 > 发送设置中存在一个控制选项,用于修改未分配和必填字段的组合以仅将字段标记为最后一个接收者必填。
基本 Acrobat Sign 字段类型
通过在文本标记中使用特定的指令,可以在文档中创建多种字段类型。在签名过程中,Acrobat Sign 会解释这些标记并将其转换为相应的表单字段。可以通过 Acrobat Sign Web 应用程序添加到文档的所有字段类型也能通过文本标记来指定。
签名和缩写签名字段
您可以通过添加指令来指定签名字段的类型,从而将 Acrobat Sign 签名或缩写签名字段放置在文档中的特定位置。默认情况下,签名和缩写签名字段是必填字段。
但是,某些文档要求签名者选择性地在文档中的其他特定位置签名或用缩写签名。也可使用文本标记在文档中定义可选的签名或缩写签名字段。
对于文档的每个签名者,Acrobat 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)}} |
一个图章字段,可用作签名选项。除非签名者没有其他签名字段,否则不需要图章。 |
特殊 ACROBAT Sign 字段
Acrobat Sign 提供了可放置在文档中的特殊字段,用于收集签名者的信息,如签名者的职务或公司名称。如果已经有这些字段的信息,在签名过程中呈现给签名者时,Acrobat Sign 将自动填充这些字段。
{{Ttl1_es_:title}} |
此字段用于指定签名者的职务。 |
{{Cmpy1_es_:company}} |
此字段用于指定签名者的公司。 |
特殊只读字段
此外,Acrobat Sign 还支持在协议中收集签名日期、电子邮件地址以及签名者的姓名。这些字段由 Acrobat Sign 自动填充,签名者在协议上签名时无法对其进行修改。
{{Dte1_es_:date}} |
一个只读字段,包含签名的日期。 通过添加 :format 指令允许设置格式。例如,Dte_es_:signer1:date:format(date,dd-mm-yy) |
{{Em1_es_:email}} |
此字段用于自动获取签名者的电子邮件地址。在 Acrobat Sign Web 表单中使用时,签名者可以在签署 Web 表单时编辑此电子邮件地址字段。在完成 Web 表单签署过程之前,Acrobat Sign 会根据您的帐户配置,验证签名者提供的电子邮件地址。 |
{{fn1_es_:signer:firstname}} |
一个字段,它自动显示在签名字段中读取的第一个字符串。用于表示签名的名字。 |
{{ln1_es_:signer:lastname}} |
一个字段,它自动显示签名字段中第一个字符串之后的字段内容。用于表示签名的姓氏。 |
{{Name1_es_:fullname}} |
一个字段,用于在一个字符串中指定签名者的全名 |
签名块
如果未在文档中为特定的签名者放置签名字段,Acrobat Sign 将自动为该特定的签名者在文档底部放置一个签名块。默认情况下,签名块包括签名和电子邮件地址字段。但是,如果您的帐户或组管理员启用了“需要签名者在进行电子签名时提供其职务”或“需要签名者在进行电子签名时提供其公司名称”设置亦或同时启用了这两项设置(在“签名首选项”中),则职务和/或公司字段将包含在签名块中。下图显示了一个包含全部四个字段的签名块。
您可以使用“signatureblock”指令将整个 Acrobat 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 的接收者填写。 |
必填字段由字段左侧的红色星号来标识。
可编辑/只读字段
默认情况下,不是只读字段的所有字段均可编辑。例外情况包括默认是只读字段的一些特殊签名者字段(电子邮件、签名者姓名和签名日期)。有关更多信息,请参见特殊只读字段。
在使用 Acrobat Sign API 或“批量发送”数据合并功能自动将数据合并到文档中时,只读字段很有用。只读字段可确保签名者在签名过程中无法更改合并的数据。
向字段名称添加感叹号 (!)前缀或使用“readonly”指令可将其标记为只读字段。
例如:
{{!price}} {{price_es_:readonly}} |
定义一个要在发送文档以供签名之前通过合并数据填写的只读文本字段。 |
高级文档处理与文本标记
其他字段类型
复选框
您可以使用文本标记创建复选框,方法是在文档中放置复选框标记或使用复选框指令。
{{[]}} |
在文档中放置一个未命名的复选框。 |
{{CB_es_:checkbox}} | 在文档中放置一个已命名的复选框。 |
{{[x]}} |
在文档中放置一个默认情况下处于选中状态的复选框。 |
{{CB1_es_:checkbox(checked)}} |
在文档中放置一个默认情况下处于选中状态的已命名复选框。 |
{{[]Comm_es_:signer1}} |
放置一个名为“Comm”的复选框,它将分配给标识为 signer1 的接收者。 |
{{Comm_es_:checkbox:signer1}} |
使用该指令将放置一个名为“Comm”的复选框,它将分配给标识为 signer1 的接收者 |
{{[]*}} |
一个未命名的必填复选框,它必须由标识为 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”)}} |
定义一个单选按钮组并为每个单选按钮提供一个简单易懂的标签。此标签在签名过程中显示给签名者。 |
指定单选按钮样式
Acrobat 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 中屏蔽接收者选择的选项。
支持文档(文件附件)
在签名过程中,Acrobat Sign 可用于从签名者收集支持文档。在签名体验中,Acrobat Sign 将文本标记转换为一个字段,签名者可选择向其上传文件。上传的文档作为已签名文档的一部分包含在内,在签名过程完成后,将转换为 PDF 并随附在已签名协议的末尾。可使用“attachment”指令定义用于从签名者收集文件的表单字段。
{{*DriversLicense_es_:signer1:attachment}} |
定义一个名为“DriversLicense”的必填字段,它将分配给标识为 signer1 的接收者。在签名过程中,接收者必须使用此字段上传一个文件。 |
{{photo_es_:signer1:attachment:label("Photo")}} |
定义一个名为“photo”的可选字段,它将分配给标识为 signer1 的接收者。在签名过程中,接收者可以使用此字段上传一个图像。指令标签可用于为字段指定简单易懂的说明。此标签在签名过程中显示给签名者。 |
定义一个文件附件字段:
在签名过程中显示的文件附件字段:
超链接
Acrobat 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”。 |
{{*companyToU_es_:everyone:link(https://www.adobe.com/legal/terms.html):label(Terms of Use)}} |
定义一个所有收件人都必须单击的必填字段的超链接。包括一个将在签名过程中显示给收件人的标签“Terms of Use”。 |
参与者图章和事务 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 中所有页面上同一位置的图章。 |
数字签名(仅限企业服务级别)
数字签名 - Acrobat Sign 支持每个收件人最多 10 个数字签名字段。为一个收件人创建多个签名字段时,每个字段都必须具有唯一的名称。如果复制数字签名文本标记名称,Acrobat Sign 会通过添加“-n”附加编号自动重命名这些字段,其中“n”是从 1 开始的数字,并对每个找到的复制字段名称递增。例如,{{digsig1_es_:signer1:digitalsignature}} 将会变成 {{digsig1-1_es_:signer1:digitalsignature}} 和 {{digsig1-2_es_:signer1:digitalsignature}},以此类推。
{{digsig1_es_:signer1:digitalsignature}} |
为标识为 signer1 的接收者定义一个数字签名。 |
如果预期收件人通过下载文件并应用他们自己的数字签名证书来签署文档,则只允许一个数字签名字段。
如果文档上存在多个数字签名字段,则收件人无法使用下载并应用本地签名的选项。
在线应用的数字签名要求收件人使用支持 TSP 签发的云签名。
图章签名
图章是一种具有双重用途的字段类型,可替代签名字段,构成图章的可以是公司签署时偏好使用的印章,或者是它支持的传统签名,如判子。与数字签名字段一样,每个接收者只能定义一个图章字段。默认情况下,除非标记为必填项,或者没有为签名者安排其他签名字段,否则图章字段是可选项。
图章字段需要在 :stampimage 指令中包含一个指示字段高度的额外参数。字段高度基于文本标记的字体大小,由行数来衡量。
{{Stamp1_es_:signer1:stampimage(28)}} |
为标识为 signer1 的接收者定义一个高度为 28 行的图章字段。 |
指定默认值
Acrobat Sign 支持使用文本标记指定字段的默认值。指定的默认值在签名过程中显示给参与者。
文本标记指令 |
示例 |
---|---|
:default |
:default("Default value specified in double quotes") :default('Default value specified in single quotes') |
如果默认值包含单引号或撇号,则必须用双引号将默认值引起来。例如:{{location_es_:signer1:default("Signer's Business")}}。如果默认值必须包含双引号,则默认值必须放在单引号中。
指定工具提示
使用文本标记也可指定 Acrobat Sign 表单字段的工具提示。工具提示最多可包含 4096 个字符,且在签名过程中向收件人显示。
文本标记指令 |
示例 |
---|---|
:tooltip |
:tooltip("Please provide a copy of your Driver's License") :tooltip('Choose a color') |
使用指令控制字段大小
:dimension 指令可用于控制字段的高度和宽度,以覆盖大括号的输入。
如果您的文档是通过不允许修改字体大小的系统生成的,则此功能非常有用。
此指令的形式为 :dimension(width=XXnn, height=YYmm)
其中 XX 和 YY 是数字计量值,而计量单位类型由 nn 和 mm 值定义。
- 数字值是十进制值,可接受小数点后最多有五位有效数字。
- 可用的计量单位类型值包括:
- pt - 磅(每磅为一英寸的 1/72),如果未提供其他计量单位类型,则默认值为磅
- in - 英寸
- cm - 厘米
- mm - 毫米
{{BigSig_es_:signer1:signature:dimension(width=35mm, height=12mm)}} |
一个签名字段,其大小设置为 35 毫米宽、12 毫米高。 |
如果计量单位类型是杜撰的,或者 :dimension 指令格式错误,则标记将忽略该指令,并恢复为根据大括号调整字段大小。
指定字体外观
文本标记可用于更改字段的字体外观,以便覆盖关于字体名称、颜色和大小的文本标记中使用的字体外观。要指定字体名称,请使用现有文档中任意字体的字体名称或以下字体之一: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) – 将字段复制到文档中指定的页面上或一定范围的页面上的同一位置。 |
指定数据验证规则
Acrobat Sign 支持由附加文本标记指令指定的各种字段验证类型。当签名者在签名过程中填写数据时,将应用指定的数据验证规则。如果输入的数据不符合指定的验证规则,Acrobat 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=alpha) | ||||
:string(char=num) | ||||
:string(char=alphanum) | ||||
num – 仅数字 | ||||
alphanum – 字母和数字 | :string(maxlen=10) | |||
maxlen | 特定的最大长度 | :string(char=alpha,maxlen=10) | ||
数字 | :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 |
mm/dd/yyyy | :isdate(format=dd/mm/yy) | |||
dd/mm/yy | ||||
dd/mm/yyyy | ||||
mm/yy | ||||
"mmm d, yyyy" | :isdate(format="mmm d, yyyy") | |||
逗号是特殊的分隔符。 在格式表达式中使用时,表达式必须用引号括起来。 |
||||
时间 | :time | :time | ||
电子邮件 | :isemail | :isemail | ||
邮政编码 | :zip | country | us – 默认美国邮政编码格式 | :zip |
uk - 英国邮政编码格式 | :zip(country=uk) | |||
邮政编码 + 4 | :zip4 | :zip4 | ||
电话 | :phone | country | us – 默认美国电话号码格式 | :phone |
uk - 英国电话号码格式 | :phone(country=uk) | |||
社会保险号 | :ssn | :ssn | ||
正则表达式 | :custom | regexp | 一个以字符串形式表示的正则表达式。请参见下方的“注意”。 | :custom(regexp="^5[1-5][0- |
msg | 当数据不符合指定的表达式时要向接收者显示的消息。 | :custom(regexp="^.{3}$",msg="Not a match for three chars in a row!") |
- 不支持
不区分大小写的“?i”和“?-a” - 作为正则表达式构造的一部分,反斜杠字符(例如“\w”)必须始终使用反斜杠来转义(即“\\w”)
- 要搜索反斜杠,必须使用 \\\\
- 正则表达式字符串以双引号 (") 字符作为开始和结束
- 如果预计收件人输入的字符串中会出现一个双引号字符,那么验证字符串可采用以下方法来匹配这个双引号字符:通过使用反斜杠对该字符进行转义 \"
- 如果预计收件人输入的字符串中会出现一个双引号字符,那么验证字符串可采用以下方法来匹配这个双引号字符:通过使用反斜杠对该字符进行转义 \"
关于 Acrobat Sign 所用正则表达式的语法,在此处可找到很好的参考。
单个字段只能包含一个验证指令。如果在单个文本标记中指定了多个验证规则,只会应用第一个验证规则。所有后续验证规则都将被忽略。
屏蔽敏感数据
Acrobat Sign 支持通过向文本标记添加特定指令来屏蔽在签名过程中收集的敏感数据。在签名过程中,签名者退出此类字段后,他们在其中输入的数据将立即转换为星号 (*) 或用户定义的屏蔽字符。签名者输入的数据也不会显示给任何后续签名者或包括在完成的 PDF 中。签名者输入的数据可以从 Acrobat Sign 中或通过 Acrobat Sign API 导出。
文本标记定义:
在签名过程中:
在最终 PDF 中:
{{*CC_es_:signer1:mask}} |
定义一个名为“CC”的必填字段,它将分配给标识为 signer1 的接收者,并且在签名过程中屏蔽。 |
{{*CC_es_:signer1:mask(char=-)}} |
定义一个名为“CC”的必填字段,它将分配给标识为 signer1 的接收者,并且在签名过程中使用“-”屏蔽。如果未在文本标记中指定字符,星号 (*) 将用作默认屏蔽字符。 |
指定字段的条件规则
Acrobat 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 |
附件字段 |
attached 和 unattached |
attachment=attached; attachment=unattached |
可将条件分配给任何字段,包括必填字段,如缩写签名、签名和签名块。为必填字段定义条件时,仅当条件使字段在签名过程中对签名者可见时,才将其看作必填字段。换句话说,如果某个签名字段有一个使其隐藏的条件,该字段将对签名者不可见,因此不需要签名者在此特定字段中提供签名。签名页面底部的“必填字段”计数将根据定义的条件动态更新,以准确反映签名者在完成文档的签名之前必须填写的字段数。
每个签名者必须有一个未分配有任何条件的签名字段。正因如此,如果给定签名者的所有签名字段都有一个条件,将在文档末尾为该签名者添加一个新的签名块。
指定字段的计算公式
Acrobat Sign 支持根据其他字段值/客户在签名过程中做出的选择在签名过程中动态填充文档中的字段值,这些类型的字段称为计算型字段。
可使用文本标记或在 Acrobat 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。
有关计算型字段以及如何在文档中使用这些字段的更多信息,请参阅计算型字段参考指南。
缩短文本标记
文本标记提供了一个非常强大的机制,用于在文档中定义不同类型的字段、将这些字段分配给特定的签名者、指定字段的验证规则和/或对这些字段应用条件规则。对单个表单字段应用全部这些会使字段定义很长,可能会因字段定义而导致文档结构发生变化。此外,由于每个字段定义必须放在一行中,因此使用多个复杂的指令会使文档布局非常困难。为了确保文档结构的一致性,Acrobat Sign 支持一种机制,用于在文档中定义缩短型文本标记。缩短型文本标记由两部分组成:
- 引用标记 - 缩短型标记定义,放置在文档中的适当位置。引用标记控制文档中实际表单字段的大小和位置。引用标记的语法如下:{{$shortened_name}}。例如,{{$r}} 定义了一个引用标记,其中“r”是此标记的简称。字段的大小可使用紧跟在最后一个左花括号后面或紧靠在第一个右花括号前面的空格进行调整。
- 定义标记 - 是指特定标记的完整定义,可在文档中的任意位置定义。定义标记的大小和位置并不决定文档中实际表单字段的大小和位置。定义标记的语法如下:
{{#shortened_name=Standard Tag Syntax}}。例如,{{#r=[]ReceiveCommunication_es_:signer1}} 为名为“r”的引用标记定义完整的标记定义。在本例中,此标记定义了一个分配给标识为 signer1 的接收者的复选框。
例如,下图显示了文档中放置的两个引用标记。
这两个引用标记的完整定义在文档中的其他位置进行定义,如下图中所示。
文本标记的完整定义非常长,如果不能在文档中的适当位置定义缩短型标记,将无法保持原始文档的结构。
从输出中移除页面
通过将表单字段的位置与字段的定义分离,可以将文档中的所有标记定义放置在文档的末尾或文档中一个完全独立的页面上。通过 Acrobat Sign 发送文档时,会处理所有文本标记,并在文本标记定义的上面放置一个白框,以使文本不再对签名者可见。这可能会导致在经过 Acrobat Sign 处理后文档中出现完全空白的页面,页面中仅包含文本标记。为了避免文档中出现不需要的额外空白页面,Acrobat Sign 支持一种特殊文本标记定义,用于在发送文档以供签名之前从 Acrobat Sign 生成的处理后输出文档中移除特定的页面。
{{#REMOVE_PAGE_FROM_OUTPUT}} |
一个特殊指令,指示 Acrobat Sign 从文档的处理后输出中移除出现此指令的页面。此标记可以出现在页面上的任意位置。发送至 Acrobat Sign 的文档必须至少包含一页。如果此指令出现在发送至 Acrobat 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。使用此机制,计算型字段可用于根据用户在签名过程中做出的选择自动填充商品的价格。 |
有关计算型字段的更多信息,请参见计算型字段参考指南。