# 新建签署

来源快照：`result_data_new_260518.json`

- 来源 ID：`1183979212012396569`
- 模块：低代码平台e-builder
- 目录：页面引擎 - 页面设计器 - 页面组件 - 模块组件 - 模块组件/电子签
- space ID：`1157961794811633670`
- 原文链接：未提供
- 产品基线：未提供

## 正文

# 新建签署

## 一、功能背景及价值用途

新建签署组件是一个专为电子签名场景设计的业务组件，主要解决企业在数字化转型过程中对电子合同签署的需求。随着无纸化办公的推广和法律法规对电子签名效力的认可，电子签名已成为企业提高效率、降低成本的重要手段。该组件整合了主流电子签名平台，提供统一的用户界面和操作流程，为企业提供一站式电子合同签署解决方案，不仅显著提高了签约效率、降低了运营成本、增强了文件安全性，还通过灵活配置和多端支持提升了用户体验，同时满足合规要求，帮助企业加速业务流程、实现数据整合，适用于合同签署、内部审批、客户协议和供应商管理等多种业务场景。

## 二、配置过程图

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331934201905165&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 三、功能概述及使用说明

新建组件主要是为了结合列表数据使用，当EB表单数据是以列表的形式存在，而非EB审批流的方式，此时想针对每条EB表单数据发起签署，就可以使用该功能，需要进行以下步骤的配置；当然也可以独立使用，进行自定义文件的签署，此时可以略过详细配置。

### 1、功能入口

设计器左侧组件列表中，路径为【模块组件】-【电子签】-【新建签署】，拖入设计器中即可使用。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331934266089501&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

### 2、数据源设置

选择具体的数据源，例如选择某个eb应用中的表单数据，在具体取值设置中会带入对应字段信息。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331938454929418&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

### 3、具体取值设置

一、

服务商

不同的签章平台，根据实际需要去选择

二、

绑定服务

绑定服务来自于电子签应用中维护的绑定服务，请事先在电子签应用中设置好。

三、

用印流程

签章平台中设置的用印流程。

四、

签署文件

签署文件取值一般设置为EB表单附件字段或文档字段，会将该字段的值设置为签署文件。

五、

签署方

根据实际需要进行设置，如果进行预设，会从表单数据中获取签署方；也可以不设置，在组件运行时，手动添加签署方。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331938636554306&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

发起组织只能添加一个，组织签署方和个人签署方可以添加多个，根据需要设置默认的签署方信息。

如果有需要，还可以给每个签署动作设置对应的签署位置，配置如下图所示。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331938617573393&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

签署方还附加权限设置，包括了是否允许添加签署方，以及可以添加某些签署动作的角色控制，具体如下图所示。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331942825394179&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

六、

文件主题

一般是表单中的单行文本字段。

七、

发起组织

有些签章平台会有发起组织的概念，可以手动选择默认值。

八、

文件编号

九、

签署截止日期

十、

文件终止日期

十一、

文件备注

十二、

文件抄送

设置文件的抄送方信息。

** **

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331942825394190&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 

十三、

其他

只读：用来控制不允许用户修改。

隐藏：用户无需关注某些字段时，可以将其隐藏。

### 4、回调动作流

可选，用来配置与该组件相关联的动作流。

如果希望签署文件后，将文件下载至指定目录，或回传至数据源，可以进行配置；如果无需将签署后的文件信息回传，则无需关注此设置。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331942805692526&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 四、延伸用法

### 1、从列表上发起签署

一、

维护列表

首先需要创建一个列表，用于对列表中的文件发起签署，具体步骤如下图所示。

新建一个页面，在设计器中拖入列表组件，配置好数据源，显示字段等必要设置项。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331947182342150&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

二、

配置新建签署组件

新建一个页面并拖入【新建签署】组件，参考【功能概述及使用说明】进行必要字段的配置，注意要选择与列表相同的数据源。

三、

从列表上发起签署

可以通过在列表上配置按钮的方式进行发起，具体配置可参考下图。

打开列表check框。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331946999996475&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

添加右上角按钮

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331947009212440&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

 给【发起签署】按钮添加事件动作，这里以js为例。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331951379677185&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

注意需要替换对应的列表组件id，以及需要跳转的新建签署页面地址；具体的js示例在文末给出。

最后，在列表组件勾选需要发起签署的数据信息，点击右上角的发起签署按钮，即可跳转并将数据带入至新建签署组件，进行签署文件的发起。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331951343091735&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

确认数据填写无误后，点击发起签署按钮即可进行文件签署。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331951395627024&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

四、

配置回调动作流（可选）

如果希望签署文件后，将文件下载至指定目录，或回传至数据源，可以进行动作流的配置。

点击新建按钮打开动作流配置页面。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331955755499525&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

设置电子签回调，触发事件以【文件发起】举例，表示文件发起后会执行的动作。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331955808034835&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

接着设置循环逻辑，选择循环方式及参数。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331955755499540&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

添加循环体中需要执行的动作，更新表单字段。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331960045109256&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

选择目标表单。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331960092409872&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

选择数据ID。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331960092409891&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

设置字段映射，将对应数据更新至【签署状态】字段。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331964188254231&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

点击保存后，即可完成回调动作流配置。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331964348465222&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

如需更新其他字段，参上以上步骤即可。

最终实现的效果如下图所示，发起签署后会将文件状态更新至表单数据中。

![](https://weapp.eteams.cn/papi/file/preview?fileId=1163331968657178626&type=redirect&customParam=%7B%22isExtDist%22%3Atrue%2C%22distributeId%22%3A%22%22%2C%22externalId%22%3A%22%22%2C%22appId%22%3A%22%22%7D)

## 五、使用注意点

### 1、新建签署带入数据的逻辑

组件会根据具体的数据id请求接口，带入数据源中的表单数据；数据id从url中获取，格式为/url?id=123456，多个id用英文逗号分隔。

## 六、更多参考资料

### 1、事件动作js示例

/** 获取当前页面指定的列表组件 */

var compInstance = ebuilderSDK?.getPageSDK()?.getCompInstance("aabeb3753b69486b9002a0d9ab6304e5");//需要替换组件ID

/** 获取列表组件被选中的数据 */

const res = compInstance.getCheckedDatas();

if (!res || !res.length) {

ebSdk.msg('请勾选文档！', 2000);

} else {

/** 需要跳转的新建签署组件页面 */

const url = '/sp/ebdpage/view/1133996843631198208/page/1133996843631198208'//需要替换pageId

const ids = res.map(item => item.id)

/** 进行页面跳转 */

window.open(`${url}?id=${ids.join(',')}`)

}

### 2、列表组件文档

[链接地址](https://weapp.eteams.cn/sp/ebdpage/view/freepass/1152863419640021002?id=1159171055794683905&freepass_doc=1&space_id=1157961794811633670 "链接地址")
