本文档详细介绍 Nota Sign 中所有控件类型及其使用场景。控件是签署流程中的核心元素，发件人通过拖拽控件到文档中，指定收件人需要完成的操作（签名、填写信息、盖章等）。
一、控件概述
Nota Sign 提供的控件类型分为两大类：
- 签署控件：签名、图章、签署日期、手绘；
- 填写控件：文本、复选框、图片、附件。
此外还有特殊控件：电子印章控件、印花税控件。
1. 控件通用属性
点击控件后，可在右侧配置属性：
- 所属收件人：指定谁需填写此控件；
- 是否必填：设置是否强制填写；
- 控件名称：便于识别控件内容；
- 使用提示：设置引导性说明文字；
- 默认内容：设置预填文本内容；
- 字体样式：支持加粗、斜体、下划线；
- 字体类型与大小：支持多种字体与字号（12px–28px）。
2. 控件设置界面
签署设置页面主要用于设置控件；其中区分：
（1） 收件人设置：可选择不同的收件人分别进行控件设置； （2） 控件设置面板：可对收件人设置必要填写的控件、盖章的位置； （3） 文档正文预览区：提供上传的文档预览，并可对其设置对应的控件； （4） 文档列表导航区：可浏览并快速导航到相应文档。
二、签署控件
1. 签名控件
点击签名控件，系统将提供多种签名方式：默认签名样式、手写签名、上传签名图片。
使用场景： 用于收件人签署确认，是最基础的签署控件。
若签署方被指定为Electronic_Signature，则只能放置Electronic_Signature类控件。
若签署方被指定为数字签名，则只能放置数字签名类控件。提交签署后会出现CA选择弹窗。
系统仅显示发起方预设好的签名域和表单域。收件人不可以手动添加新控件，只能在指定位置完成填写和签名。
> 对于包含填写与签署双重任务的收件人，仅需一次提交即可完成该节点的全部内容。请在提交前核对所有必填字段，确保签署流程顺利推进。
2. 日期控件
（1）当发件人提前为收件人设置好"日期控件"后，收件人进入签署页面时，系统将自动填充为当前日期。
使用场景： 用于在签署文档中自动填充签署日期，无需手填。
（2）目前支持以下日期格式：
| 日期格式 | 示例 |
|---|---|
| YYYY-MM-DD | 2026-08-04 |
| YYYY/MM/DD | 2026/08/04 |
| MM/DD/YYYY | 08/04/2026 |
| DD/MM/YYYY | 04/08/2026 |
| DD-MM-YYYY | 04-08-2026 |
| DD-MMM-YYYY | 04-Aug-2026 |
其中：
- YYYY 表示四位年份；
- MM 表示两位月份；
- MMM 表示英文月份缩写；
- DD 表示两位日期。
当选择 DD-MMM-YYYY 格式时，月份固定使用英文缩写，包括 Jan、Feb、Mar、Apr、May、Jun、Jul、Aug、Sep、Oct、Nov、Dec，不随系统或用户的语言设置变化。
3. 图章控件
用于加盖公司或个人图章。选取已获授权图章或上传符合要求的图章照片。
设置方式：
第一步：启用图章控件
发件人需先在【管理】-【发送设置】中启用图章控件，并配置以下选项：
- 限制图章使用范围：可选择「不限制」「仅允许使用授权图章」「仅允许使用上传图章」；
- 默认尺寸规则：可选择「按控件设置大小展示」或「按实际图章尺寸展示」（默认为按控件设置大小展示）。
💡 注意：当前信封为 SES 信封时，支持上述两种尺寸选项；当前信封为 AES/Singpass 信封时，仅支持「按控件设置大小展示」。
第二步：配置签署偏好（可选）
如需允许收件人在签署过程中切换使用不同图章，发件人可在【管理】-【签署偏好】中勾选【允许收件人使用不同图章进行签章】。
- 勾选后，收件人点击图章控件时可弹出图章选择弹窗，更换为其他图章；
- 不勾选时，收件人只能选择或替换当前图章，无法切换为不同图章。
第三步：在信封中放置图章控件
在信封创建时拖拽【图章】至签署区域，在右侧设置面板中进行以下配置：
- 使用范围：调整用章权限（不限制 / 仅授权图章 / 仅上传图章）；
- 尺寸规则：选择「按控件设置大小展示」或「按实际图章尺寸展示」。此项将覆盖发送设置中的默认值。
尺寸规则效果说明：
| 尺寸规则 | 效果 |
|---|---|
| 按控件设置大小展示 | 图章等比例填充控件区域（与原有行为一致） |
| 按实际图章尺寸展示 | 图章按图片原始尺寸显示，图章图片与控件大小可以不一致 |
使用场景： 用于企业或个人加盖图章，支持授权图章和上传图章两种模式，并支持灵活控制图章尺寸与切换权限。
使用图章签署
（1） 在邮件中点击【查看文件】查看信封。
（2） 选择或上传图章。
- 当发件人「不限制图章使用范围」时，收件人可选择上传图章或选择已授权的电子图章进行签署，点击【确认】。
- 当发件人设置「仅允许使用授权图章」时，仅允许选择已授权的电子图章进行签署，点击【确认】。
- 当发件人设置「仅允许使用上传图章」时，仅允许通过拖拽或点击选择电子图章，点击【确认】。
（3） 切换图章（需发件人提前在签署偏好中开启【允许收件人使用不同图章】）。
- 点击已填充的图章控件，系统弹出图章选择弹窗；
- 在弹窗中选择其他图章，即可替换当前图章；
- 如未开启此功能，点击已填充图章将自动重新填充当前图章，无法切换为不同图章。
（4） 签署所有未完成签名，点击【提交】，完成签署。
4. 手绘控件
手绘控件用于让收件人在指定位置手写内容，适用于补充说明、用途说明、手写确认等场景。手绘控件与签名控件不同，不一定用于正式签署，也可以用于填写短句或手写备注。
第一步：添加手绘控件
在信封、模板或批量任务的控件设置页面，选择需要填写该控件的收件人，将左侧控件栏中的【手绘】控件拖拽到文档指定位置。
第二步：调整控件
点击已添加的手绘控件后，可在右侧属性面板中设置控件名称、是否必填、使用提示、引导文字等内容。
手绘控件支持两种内容模式：
- 背景手绘模式：收件人在控件所在区域上手绘，系统会保留控件区域的文档背景和手绘内容。适合需要在原文档内容上圈选、标注或补充说明的场景。
- 仅笔迹填充模式：收件人手绘完成后，系统只保留有效笔迹，不保留 PDF 背景，并将笔迹按控件大小居中填充。适合只需要收件人手写文字、短句或备注的场景。
如果您希望收件人在原文档内容上标注，请选择【背景手绘模式】；如果只需要收件人手写文字或说明，建议选择【仅笔迹填充模式】。
发件人也可以根据文档中的填写区域调整手绘控件大小。对于较窄的手写区域，控件支持设置为较低高度，方便放置在单行填写区域中。
建议将控件区域设置得略大于预期手写内容，避免收件人填写时笔迹过小或显示不完整。
第三步：保存并发送
确认手绘控件的位置、大小和内容模式无误后，保存控件设置并继续发送信封。
注意：手绘控件适合手写内容，不等同于签名控件。如需正式签署确认，建议使用签名控件。新添加的手绘控件会读取发送设置中的默认内容模式，发件人也可以在单个控件上调整。当发件人在签署信封设置好"手绘控件"后，收件人可选择手绘签名。
使用场景： 需要收件人使用手写签名风格的签名时使用。
三、填写控件
1. 文本控件
用于填写关键信息，如姓名、地址、编号等。请根据发送方预设提示准确填写。
将左侧菜单的"文本"控件拖入文档后，您可以在右侧的设置菜单中调整其属性： 如果不勾选"多行文本"，控件将默认处于单行模式；如勾选"多行文本"，该控件将允许签署人回车换行，输入长段文字。
使用文本填写控件时，指定的收件人需先完成该控件后签署流程才能继续。
使用场景： 需要收件人填写文字信息，如姓名、地址、身份证号、备注等。
2.单选框控件
用于在多个选项中仅选择一项的场景，如性别、婚姻状况、是/否确认、套餐选择等。
发件人将左侧菜单的"单选框"控件拖入文档后，可在右侧属性面板中进行以下配置：
- 所属收件人：指定该单选框组由谁填写；
- 是否必填：必填组提交时必须选择一项；
- 控件名称：便于识别控件内容；
- 使用提示：设置引导性说明文字；
- 控件大小：左右滑动调整控件大小；
- 单选项：可增/删/编辑各单选项的具体文字内容，每项不超过 50 字。
配置说明：
- 添加/删除单选项：点击底部"+ 添加单选项"可在末位新增一行，达到 50 项时按钮变为不可用。点击单选项右侧的删除图标可删除该选项，每组至少保留 2 个单选项；
- 调整布局：每个单选项可在当前页面独立拖拽；调整尺寸时整组同步缩放，不支持单选项独立缩放；将任一单选项拖到其他页面时，整个单选框组会一起移动到目标页面；
3. 复选框控件
用于在多个选项中勾选一个或多个的场景，例如条款确认、附加服务勾选等。
发件人将左侧菜单的"复选框"控件拖入文档后，可在右侧属性面板中进行以下配置：
- 所属收件人：指定该复选框组由谁填写；
- 是否必填：必填组提交时必须至少勾选一项；
- 控件名称：便于识别控件内容；
- 使用提示：设置引导性说明文字；
- 控件大小：左右滑动调整控件大小；
- 复选项：可增/删/编辑各复选项的具体文字内容，每项不超过 50 字。
4. 图片控件
如需上传身份证件、营业执照等，可使用图片控件。
使用场景： 需要收件人上传身份证、营业执照等图片类文件时使用。
5. 附件控件
用于上传签署文件相关的补充文档。
发件人创建信封时，可启用附件控件并为收件人设置上传权限。收件人可在签署过程中上传指定的补充文件，确保签署文件内容的完整性与合规性。
典型应用场景包括：
- 收集收件人身份证明、营业执照等资质文件；
- 要求收件人提供与合同相关的补充材料（如报价单、证明文件等）；
- 在业务办理过程中，统一收集附件资料以便归档和审计。
启用附件控件后，附件资料将与签署文件一并保存，可在历史记录和审计报告中查阅，满足企业合规与存档需求。
设置方式：
发件人需先在【管理】-【发送设置】中开启附件控件并设置允许的附件数量：
然后在信封创建时拖拽【附件】至签署区域：
（1）收件人如何上传附件
1） 在邮件中点击【查看文件】查看信封;
2） 打开信封后，点击【上传附件】;
3） 可在菜单栏查看已上传附件。
（2）发件人如何下载附件
信封发出后，您可在邮箱中或信封签署记录处下载附件。
在邮箱中下载：
收件人完成签署后，发件人可从签署完成的通知邮件处下载附件。
在信封签署记录处下载：
1） 点击【查看】；
2） 下载附件。
四、特殊控件
1. 电子印章控件
使用场景： 需要使用企业电子印章签署正式文件。
发件人设置好电子印章后，从左侧控件面板中拖拽电子印章控件至文档正文区域中相应位置。
启用前，需管理员在【管理】-【发送设置】中勾选【开启电子印章】。
添加电子印章控件后，可根据文件中的签章区域调整控件大小。选中电子印章控件，在右侧属性面板中分别设置控件的宽度和高度。电子印章控件的宽度和高度支持独立调整，无需保持固定比例。例如，当需要展示方形印模时，可以将控件调整为正方形，以适配不同的印章图片和文件版式。
说明：
- 电子印章控件默认尺寸为 274 × 66；
- 最小宽度为 137，最小高度为 33；
- 调整控件尺寸后，电子印章将按照设置的控件区域进行展示；
- 在模板中设置电子印章控件尺寸后，使用模板创建信封时将继承该尺寸。
签署方点击电子印章控件后，可选择已获授权的电子印章进行签署。
2. 印花税控件
用户在创建信封 -> 控件设置页中，左上角收件人下拉框中，选择"印花税"，选中后，下方左侧控件菜单中，将仅显示一个"印花税"控件。
💡 注意: 印花税需等所有收件人签完后才能最后盖章。
💡 注意: 当轮到印花税签署节点时，系统自动完成印花税自动盖章,无需手动盖章。
使用场景： 印尼法律要求加电子印花税的文件，需订阅印尼电子印花税服务后使用。
3. Singpass 签署控件
发起时签名类型选择 Singpass，给签署人设置 Singpass 签署位置。
使用场景： 新加坡用户使用 Singpass 电子身份进行签署的场景。
五、自动签署控件配置
在使用 API 自动签署时，控件配置有特殊要求：
1. 配置签署控件
在配置签署控件时，请根据所需的签署形式（签名或印章）设置相应的参数：若使用签名控件，添加后系统将自动抓取收件人姓名生成自动签名；若使用图章控件，则必须明确指定唯一且已获授权的图章ID。
2. 配置填写控件
如果文档中包含"填写控件"且被指定为必填，则在发起信封时，必须预先传入填写值。
使用场景： 企业通过 API 自动完成文档签署的集成场景。