年费版-文件上传签署场景 - 简道云

1. 简介

1.1 场景简介

文件上传签署场景是指，通过发起合同签署流程，对合同进行在线签署。支持自动更新签署状态、自动下载签署文件、多格式上传以及自动落章。

1.2 应用场景

适用于不同场景下的合同/文件签署。同时适用单方、双方和多方合同签署，如内部文件签署、劳动合同签署、检测报告盖章、采购合同、项目实施合同等。

1.3 预期效果

提交文件签署申请后，签署人将收到文件签署链接的短信通知，点击链接即可进行签署。

以项目合作合同签署为例，效果如下：

移动端效果如下：

1.4 使用说明

1）该插件包含 9 种执行事件，如下所示：

授权认证
文件签署
模板签署
下载文件
获取模板
弹窗编辑模板
查询模板控件
撤销签署
获取合同链接

2）该插件为年费付费插件，请联系我们进行增购。插件购买流程如下所示：

注：年费是指购买插件的费用，并非指合同进行无限签署。

2. 插件安装及配置

2.1 安装插件

1）直接安装

您可点击右方链接直接安装插件：e 签宝年费版插件。
安装成功后，可参考本文【3.2 配置插件】和【3.3 启用插件】，前往「开放平台 >> 插件管理」处配置并启用插件。

2）插件市场处安装

在简道云「插件市场」处，安装「e签宝电子签章」插件。插件市场处安装方法可参见文档：插件市场中【2.3 插件安装】。

2.2 配置插件

安装后，在「插件管理」处，点击插件右侧的「设置」按钮，将 e签宝电子签章 - 年费版【2.5 获取应用 ID 和应用 secret】中获取到的「应用 ID」和「应用 Secret」配置进去，如为简道云 API 版，则可填写简道云 API Key。

2.3 启用插件

在插件管理中，打开 e 签宝年费版右侧开关，启用插件。

3. 表单搭建

插件体验可点击右侧链接：e 签宝年费版文件上传签署场景表单，插件使用可先安装：e 签宝年费版插件模板。本文将按照示例表单进行讲解。

1）新建「e 签宝合同签署」流程表单，用于填写企业授权、签署方信息和合同信息等相关信息，字段设置如下所示：

字段说明	字段名称	字段类型	字段说明
发起方企业授权	企业名称	单行文本	非必填，当需要更换合同签署发起方企业时填写，如不填写默认应用 ID 所属主企业。
发起方企业授权	手机号码		非必填
合同信息	合同编号		非必填，设置默认值为编辑公式，自动生成合同编号。公式设置如下所示： CONCATENATE("HT",TEXT(SYSTIME(),"yyMMddHHmm"),RIGHT("000"+RECNO(),3))
	签署主题		必填
	签署文件	附件	必填，支持pdf，docx，doc，rtf，xlsx，xls，ppt，wps等格式；上传的文件大小不超过 50 MB。
	抄送类型	下拉框	非必填，设置下拉框选项为：短信邮件
	抄送通知	单行文本	非必填。当抄送类型为短信，则填手机号；当抄送类型为邮件，则填写邮箱地址。
发起方签署信息	签署人类型	下拉框	必填，设置下拉框选项为：个人企业/机构
	签署单位	单行文本	必填，若类型为个人则填姓名，企业/机构填公司全称
	签署手机		必填
	经办人姓名		签署人类型为企业/机构，经办人姓名必填
	自动落章	下拉框	必填，设置下拉框选项为：是否若选是，则会自动落应用 ID 所属主企业电子签章，无需手动签章；若选否，则默认位置签章，根据落章关键字指定位置签署印章。如果签署人为个人或非应用ID 所属主企业则不支持自动落章。
	落章关键字	单行文本	必填，若有多个落章关键字，用英文格式下的逗号隔开。
	指定印章	单行文本	非必填，如需指定印章签章，需填写「e签宝后台 >>用户中心 >>印章管理」中需要指定的印章编码，非授权企业不能进行指定。
	签署类型	下拉复选框	必填，设置下拉框选项为：单页签章骑缝签章可全选，全选时同时签署单页签章和骑缝签章。
	签署顺序	单行文本	非必填，若不填或填写相同数字则默认同时签署，若填写数字则签署双方按数字顺序进行签署。
	聚合字段1	单行文本	设置默认值为编辑公式，公式设置如下所示： CONCATENATE('{', '"signerType":签署人类型', ',"Name":签署单位', ',"Account":签署手机',',"psnName":经办人姓名', ',"autoSign":自动落章', ',"assignedSealId":指定印章', ',"keywords":落章关键字', ',"signFieldStyle":签章类型', ',"signOrder":签署顺序', '}') 注：如签署人类型为企业/机构，经办人姓名必填
接收签署方信息	签署人类型	下拉框	必填，下拉框选项：个人企业/机构
	签署单位	单行文本	必填，类型为个人，签署单位填姓名，企业/机构填公司全称
	签署手机		必填
	经办人姓名		若签署单位类型为企业/机构时必填。
	签署类型	下拉复选框	必填，下拉复选框选项：单页签章骑缝签章可全选，全选时同时签署单页签章和骑缝签章。
	落章关键字	单行文本	必填，若有多个落章关键字，用英文格式下的逗号（“,”）隔开。
	签署顺序		非必填，若不填或填写相同数字则默认同时签署，若填写数字则签署双方按数字顺序进行签署。
	聚合字段2		设置默认值为编辑公式，公式设置如下所示： CONCATENATE('{','"signerType":签署人类型',',"Name":签署单位',',"Account":签署手机',',"psnName":经办人姓名',',"keywords":落章关键字',',"signFieldStyle":签章类型',',"signOrder":签署顺序','}')
合同文件	签署ID	单行文本	回填字段
	签署完成合同	附件
	签署状态	单行文本
	签署链接	多行文本
	签署信息聚合	多行文本	设置默认值为编辑公式，公式设置如下所示： CONCATENATE(聚合字段1,CHAR(10),聚合字段2)
获取合同链接	合同链接	单行文本	回填字段合同签署完成后的合同文件下载链接，链接时效较短，尽快下载使用。
获取合同链接	重新获取合同链接	按钮	——

注：

1）指定印章可支持应用 ID 所属企业和授权企业指定，获取印章编号参考 e 签宝电子签章-年费版【2.6 获取印章编号】。

2）若为单方签署，只需配置一方签署信息，公式字段仅需传聚合字段 1 即可。

3）若为多方签署，可新增签署方信息，并新增聚合字段 3 ，签署信息聚合中，公式新增为： CONCATENATE(聚合字段1,CHAR(10),聚合字段2,CHAR(10),聚合字段3)

2）表单搭建完成后，在「扩展功能 >> 数据推送」处，点击「设置字段别名」：

签署 ID：设置为 flow_id；
签署完成合同：设置为 contract；
签署状态：设置为 status。

3.2 撤销签署流程表单

新建「撤销签署」流程表单，用于撤销签署中的合同：

字段名称	字段类型	字段设置
撤销合同签署主题	单行文本	——
撤销合同签署 ID		在「字段属性 >> 默认值」处设置为「数据联动」，联动设置如下：联动表单：发起合同签署表单联动表单字段满足条件：签署主题等于撤销合同主题触发以下联动：撤销合同签署ID联动显示签署 ID 注：此项可手动填写，手动填写时无需【撤销合同签署主题】字段
撤销原因		——
撤销结果		——

4. 流程设定

流程表单配置完成后，切换至「流程设定」中，进行流程配置。

4.1 发起签署流程配置

4.1.1 配置流程发起节点

点击流程发起节点，在「节点属性 >> 节点名称」处，修改节点名称为「签署发起节点」；在「节点属性 >> 字段权限」处，勾选部分字段的「可见」、「可编辑」权限：

4.1.2 配置审批节点

点击流程审批节点，进行如下操作：

在「节点属性 >> 节点名称」处，修改节点名称为「合同审批」；
在「节点属性 >> 负责人」处，设置节点处的负责人；
在「字段权限」处，勾选全部字段的「可见」、「可编辑」权限。

4.1.3 配置插件节点

点击插件配置节点，进行以下操作：

插件：选择「e签宝年费版 >> 文件签署」插件；
发起方企业：设置为字段值，即「企业名称」字段；
发起方手机：设置为字段值，即「手机号码」字段；
签署主题：设置为字段值，即「签署主题」字段；
签署文件：设置为字段值，即「签署文件」字段；
签署人信息：设置为字段值，即「签署人信息」字段；
抄送类型：设置为字段值，即「抄送类型」字段；
抄送通知：设置为字段值，即「抄送通知」字段；
回调地址：设置为自定义，填写智能助手Pro中设置的 HTTP 触发中的触发地址，获取方式参考【6. 智能助手配置】。
点击添加按钮，全选字段：

将签署 ID 的值存储到「签署ID」字段；
签署链接：存储到「签署链接」字段；
签署状态：存储到「签署状态」字段;
点击「确定」按钮后保存并启用流程。

4.1.4 启用流程

完成配置后，点击「保存」后，再点击「启用流程」，即可启用当前流程。

4.2 撤销合同流程配置

进入「撤销签署」流程表单中，切换至「流程设定」处，进行流程配置。

4.2.1 配置合同撤销发起节点

点击流程发起节点，发起节点设置如下：

在「节点属性 >> 节点名称」处，修改节点名称为「撤销合同发起」；
在「节点属性 >> 字段权限」处，勾选以下 4 个字段字段的「可见」、「可编辑」权限：

「撤销合同签署」
「撤销合同主题」
「撤销合同签署ID」
「撤销原因」

4.2.2 配置审批节点

点击审批节点，在「节点属性 >> 基础属性」中进行如下操作：

在「节点名称」处，修改节点名称为「撤销合同审批」；
在「节点负责人」处，选择审批负责人；
在「字段权限」处，勾选以下 3 个字段以外的字段「可见」权限：

「撤销合同签署」
「撤销合同主题」
「撤销原因」

4.2.3 配置插件节点

添加插件节点，在「节点属性 >> 插件」处，设置插件节点如下所示：

选择插件：选择「e 签宝年费版 >> 撤销签署」；
签署ID：设置为字段值，即「撤销合同签署ID」字段；
撤销原因：设置为字段值，即「撤销原因」字段。
点击「添加」按钮，将「撤销结果」的值存储到「撤销结果」中。

全部设置完成后，点击「确定」按钮。

4.2.4 启用流程

全部设置完成后，点击右上方「保存」并「启用流程」，启用流程节点。

5. 前端事件配置

5.1 添加按钮执行动作

进入「e签宝合同签署-文件上传」表单中，点击「重新获取合同链接」按钮字段，在「字段属性 >> 执行动作」处，点击「添加执行动作」。

5.2 设置事件名称和说明

添加好前端事件后，首先设置前端事件的基础信息，即事件名称和事件说明，用于区分前端事件：

5.3 设置执行动作

设置执行动作如下：

选择插件：选择「 e 签宝年费版 >> 获取合同链接」；
签署ID：设置为字段值，即「签署ID」字段；
字段存储关系：点击「添加」按钮并选择添加「全部」，将「合同链接」的值存储到「合同链接」中。

全部设置完成后，点击保存。

6. 智能助手配置

6.1 新建智能助手

在「扩展功能 >> 智能助手」处，点击「新建智能助手」，并修改智能助手的名称为「合同文件」，设置触发方式为「HTTP 触发」。

6.2 配置HTTP触发

1）点击HTTP触发，复制触发地址后，点击右方链接：触发数据列表，进入触发数据列表页面后粘贴触发地址，获取触发结果，若为 success 则返回至 HTTP 触发配置页面下方，「点击获取示例数据」；

3）在获取触发数据列表成功获取后，进行「触发配置」：

指定可触发的 IP 填写为： 118.31.35.8；
自定义返回内容选择 JSON ，填写为：{"code":"200","msg":"success"}

6.3 配置插件节点

点击插件节点，进行如下操作：

在「插件读写表单」处，选择表单「e 签宝合同签署」；
在「执行插件」处，选择「e 签宝年费版 >>下载文件」；
在「应用 ID」处，选择组合字段，勾选「插件读写表单--应用 ID(ID)」；
在「表单 ID」处，选择组合字段，勾选「插件读写表单--表单 ID(ID)」；
在「签署 ID」处，选择组合字段，勾选「触发数据 -- body_signFlowld (文本)」；
在「执行结果」处：

添加「签署状态」字段，选择「文本类型」；
添加「合同链接」字段，选择「文本类型」。

6.4 配置修改数据节点

点击修改数据，进行如下操作：

在「修改对象」处，选择表单「e签宝合同签署」；
在「筛选出要修改的数据」处，添加「登录ID」,勾选「触发数据--body_signFlowld」；
在「设置字段值」处：

添加「签署状态」，勾选「插件节点--签署状态」；
添加「合同链接」，勾选「插件节点--合同链接」。

6.5 效果演示

效果参见【1.3 预期效果】。

7. 注意事项

7.1 企业授权

发起方企业授权适用于签署发起方为非应用所属 ID 企业的情况，如企业下属分公司需要签署合同，可先授权后再发起签署、执行授权插件。可阅读以下内容完成授权相关配置：

表单搭建：参见 e签宝电子签章-次数版【3.1 企业授权表单】
前端事件配置：参见 e签宝电子签章-次数版【4. 前端事件配置】

7.2 子表单配置签署

若包含子表数据，需要对子表单数据进行处理，然后通过单行文本聚合子表单信息，传递给插件。新建「签署合同 - 子表版」流程表单，如下所示：

字段说明	字段名称	字段类型	字段解释
发起方企业授权	企业名称	单行文本	非必填，当需要更换合同签署发起方企业时填写，如不填写默认应用 ID 所属主企业。
发起方企业授权	手机号码		非必填
合同信息	合同编号		非必填，设置默认值为编辑公式，自动生成合同编号。公式设置如下所示： CONCATENATE("HT",TEXT(SYSTIME(),"yyMMddHHmm"),RIGHT("000"+RECNO(),3))
	签署主题		必填
	签署文件	附件	必填
	抄送类型	下拉框	非必填，设置下拉框选项为：短信邮件
	抄送通知	单行文本	非必填。当抄送类型为短信，则填手机号；当抄送类型为邮件，则填写邮箱地址。
签署人信息	签署人列表	子表单	——
	签署人类型	子表单-下拉框	必填，设置下拉框选项为：个人企业/机构
	签署单位	子表单-单行文本	必填，若类型为个人则填姓名，企业/机构填公司全称
	签署手机		必填
	经办人姓名		签署人类型为企业/机构，经办人姓名必填
	自动落章	子表单-下拉框	必填，设置下拉框选项为：是否若选是，则会自动落应用 ID 所属主企业电子签章，无需手动签章；若选否，则默认位置签章，根据落章关键字指定位置签署印章。如果签署人为个人或非应用ID 所属主企业则不支持自动落章。
	指定印章	子表单-单行文本	非必填，如需指定印章，需填写「e签宝后台 >>用户中心 >>印章管理」中需要指定的印章编码。非应用 ID 所属企业或授权企业，不支持指定印章。
	印章类型	子表单-下拉框	必填，设置下拉框选项为：单页签章骑缝签章可全选，全选时同时签署单页签章和骑缝签章。
	落章关键字	子表单-单行文本	必填，如有多个落章关键字，用英文格式下的逗号（“,”）隔开。
	人员聚合字段	子表单-单行文本	设置默认值为编辑公式，公式设置如下所示： CONCATENATE('{','"signerType":签署人列表,签署人类型',',"Name":签署人列表.签署单位',',"Account":签署人列表.签署手机',',"psnName":签署人列表,经办人姓名',',"autoSign":签署人列表,自动落章',',"assignedSealId":签署人列表,指定印章',',"keywords":签署人列表,落章关键字',',"signfieldStyle":签署人列表,签章类型','}')
	签署人聚合	单行文本	设置默认值为编辑公式，公式设置如下所示 JOIN(签署人列表.人员聚合字段,CHAR(10))
合同文件	签署ID	单行文本	回填字段
	签署完成合同	附件
	签署状态	单行文本
	签署链接
获取合同链接	合同链接		回填字段合同签署完成后的合同文件下载链接，链接时效较短，尽快下载使用。
获取合同链接	重新获取合同链接	按钮	——

注：

1）子表签署顺序默认为签署列表顺序。

2）子表签署流程配置和智能助手 Pro 配置参考【4 流程设定】和【5 智能助手Pro配置】。

3）根据业务需求选择子表签署或主表签署，两种配置公式有些许差别。

7.3 签署状态说明

1）原「合同文件 >> 签署状态」字段中，返回的是签署流程的状态，经实际使用和用户反馈，已做迭代，目前版本返回签署人状态，如为多方签署，回传多个签署人状态。

2）签署状态字段无需重新配置，仅返回值有变化，已安装使用用户无需更改配置，新安装用户按本文本说明配置即可。

8. 联系方式

该插件为官方合作的服务商开发，若您在使用过程中有任何疑问，可通过以下方式咨询：

公司：成都轻如燕企业服务有限公司
联系人：赵鹏
联系电话：18583980516（微信同号）