最近，有小伙伴在后台留言：工作流中做下推操作（即进行单据转换），能否在下推时，把附件面板上面的附件，由源单下推到目标单？

针对上述场景，金蝶云·苍穹V5.0.011及以上版本可以配置实现BOTP携带附件和图片。如果客户还未升级，可通过如下二开插件实现。

本期文章，小编便为大家详细介绍如何通过二开插件的方式，在工作流中进行下推操作，且在下推的同时，把附件面板的数据下推到目标单。欲知详情，请往下看~

1 业务实现思路

实现该业务场景主要可以通过下述3个方面完成：

1.1 工作流

想要在工作流中做下推操作，可以通过工作流插件实现。审核节点中，在“同意”时，注册一个工作流插件，然后在工作流插件中使用ConvertServiceHelper（单据转换帮助类）进行单据转换。

1.2 单据转换规则

无论是在设计器页面中配置下推操作，还是用代码调用ConvertServiceHelper，均需创建一个单据转换规则。

1.3 单据转换插件

为了能让附件面板从源单下推到目标单，需要用单据转换插件来实现，因此需要编写和注册一个单据转换插件。

在单据转换插件中，从源单中获取到附件信息，然后用AttachmentServiceHelper（附件帮助类），把源单的附件信息绑定给目标单。

2 业务实现过程

1.1 准备工作

首先，需要创建2个用于工作流和单据转换的单据（源单为大写文本和目标单为小写文本），如下图所示：

上传图片创建【源单】和【目标单】

上传图片

表单设计器示例-文本大写

上传图片

表单设计器示例-文本小写

2.2 新建工作流

在【流程服务云】→【工作流服务】中，新建流程，如下图所示：

上传图片

新增流程示例

选择刚刚创建好的“源单” 单据，填写必填项目。

上传图片为源单填写必填项目

创建完成后，进入工作流设计器，绑定创建好的源单，如下图所示：

上传图片

在流程设计器中绑定源单

审批节点中，在任务处理时执行，注册Java插件。

上传图片

注册Java插件

审核同意时，执行该工作流插件：

上传图片

执行工作流插件

随后，配置节点参与人，如下图所示：

上传图片

配置节点参与人

点击“保存”和“发布”之后，工作流即生效。

上传图片工作流成功绑定插件

2.3 编写工作流插件代码

首先，构造下推数据：

   Long pkid = execution.getId();// 单据pkid
        /*String billNumber = execution.getEntityNumber();// 单据标识
        String billNo = ((ExecutionEntityImpl) execution).getBillNo();// 单据编码*/
        List<ListSelectedRow> selectedRows = new ArrayList();
        ListSelectedRow selectedRow = new ListSelectedRow(pkid);
        selectedRows.add(selectedRow);

随后，构造PushArgs对象，准备下推：

         // 生成下推参数PushArgs
        PushArgs pushArgs = new PushArgs();
        // 必选，源单标识
        pushArgs.setSourceEntityNumber("kdec_wrx_source");
        // 必选，目标单标识
        pushArgs.setTargetEntityNumber("kdec_wrx_target");
        // 是否输出详细错误报告
        pushArgs.setBuildConvReport(false);
        // 必选，设置需要下推的源单及分录内码
        pushArgs.setSelectedRows(selectedRows);

下推及下推结束之后，打印下推结果。

注意：这里调用的方法是pushAndSave，下推并保存。因为在工作流里面，不能进行图形界面化的操作，所以选择了下推并保存。

如果是在普通的单据页面上进行下推，开发者可以选择调用push方法，生成缓存的目标单据后，弹出到目标单据里面，让用户自己去保存。下推并保存代码示例如下：

         // 调用单据转换帮助类，下推目标单 并保存
        ConvertOperationResult pushResult = ConvertServiceHelper.pushAndSave(pushArgs);

        if ( pushResult.isSuccess() ) {
            System.out.println("DemoBOTPWorkflowPlugin: kdec_wrx_source 转换kdec_wrx_target 成功");

            Set<Object> targetBillSet = pushResult.getTargetBillIds();
            StringBuilder builder = new StringBuilder();
            for (Object o : targetBillSet) {
                builder.append(o.toString() + ", ");
            }
            System.out.println("下推成功，目标单id：" + builder.toString());
        } else {
            System.out.println("DemoBOTPWorkflowPlugin: kdec_wrx_source 转换kdec_wrx_target 失败");
        }

2.4 创建单据转换规则

这一步，共需要配置以下4个地方：

（1）配置源单的单据头，和目标单的单据头进行转换；

（2）配置源单的单据编码和组织，直接下推到目标单；

（3）配置源单的一个文本字段，使用小写函数，把字段值转换为小写，下推到目标单；

（4）注册单据转换插件。

首先，新增一个“转换规则”，如下图所示：

上传图片新增“转换规则”

上传图片

转换规则详情

接着，新建一个单据头的转换，如下图所示：

上传图片

单据头转换

随后，配置单据编码转换规则，如下图所示：

上传图片

配置单据编码转换规则示例

配置普通文本字段，使用大写转换为小写的函数：

上传图片转换小写函数

然后，注册单据转换插件：

上传图片

注册单据转换插件示例

接着，将单据转换插件的必填信息补充完整。

上传图片

补充必填信息

2.5 编写单据转换插件代码

在afterConvert事件中，可以在单据转换之后，获取到目标单和源单信息：

@Override
public void afterConvert(AfterConvertEventArgs e) {
    ExtendedDataEntitySet targetExtDataEntitySet = e.getTargetExtDataEntitySet();
    // 获取转换后的目标单
    ExtendedDataEntity[] extendedDataEntities = targetExtDataEntitySet.FindByEntityKey("kdec_wrx_target");
}

注意：此处必须给目标单设置一个pkid。

如果目标单没有pkid，附件面板的数据是无法绑定到目标单据上的。

long id = DB.genGlobalLongId();
dynamicEntity.set("id", id);

数据对象是否有id，取决于先前在工作流插件中，调用ConvertServiceHelper.push还是ConvertServiceHelper.pushAndSave。

如果是调用pushAndSave方法，由于单据转换结束时，该单据已经保存，所以是有id的。同时，可以用一个if代码块判断是否有id，如果没有，即可设置一个。

下面这个判断代码非必写，为了防止流程中出现异常，此处加了一个判断id的if代码块：

if (dynamicEntity.get("id") instanceof Long && ((Long) dynamicEntity.get("id")) < 1) {
......
}

遍历目标单，获取对应的源单，如果是一对一的转换，源单的列表长度都是1：

    // 获取源单数据
            List<DynamicObject> convertSource = (List<DynamicObject>) extendedDataEntity.getValue("ConvertSource");

            // 遍历源单数据
            for (DynamicObject dynamicObject : convertSource) {
                // 获取源单id，通过源单id获取源单的附件信息
                long sourceId = dynamicObject.getLong("id");
                List<Map<String, Object>> attachments = AttachmentServiceHelper.getAttachments("kdec_wrx_source", sourceId, "attachmentpanel");

                // 把源单的附件信息设置给目标单
                AttachmentUntil.uploadTargetAttachments("kdec_wrx_target", dynamicEntity.get("id"), "attachmentpanel", attachments);
            }

3 效果展示

新增“源单”单据，填写单据编号，文本写上大写字母，添加附件图片，点击“保存”和“提交”按钮。

上传图片

“源单”单据操作示例

可以看到，当前用户接收到审批消息，如下图所示：

上传图片

用户接收审批消息

进入【消息中心】，可以“同意”此条审核单据。

上传图片

单据审核操作示例

此时，单据处理状态为“成功”。

上传图片

单据状态示例

随后，查看日志打印进行确认，显示下推成功。

上传图片

查看单据日志

随后，源单状态，显示已经是“已审核”状态。

上传图片

源单状态示例

接着，查看目标单列表，也发现已经下推成功。

上传图片

目标单列表示例

进入目标单详情，发现源单的两个附件已经绑定在目标单上。

上传图片

目标单详情示例

再进入开发平台，查看附件明细表：

上传图片查找附件明细

发现两张单据已经绑定在了目标单的附件面板上。

上传图片【开发平台】→【附件明细表】示例

4 划重点

想要在工作流中，使用ConvertServiceHelper进行下推操作，且在下推的同时，把附件面板的数据下推到目标单，具体可以通过以下三步：

1、首先，配置工作流和单据转换规则。

2、其次，在配置审核通过时，进行下推操作，有以下2种方式：

（1）设计器中配置审核操作的服务端服务，新增一个“自动下推”。

（2）如案例中，在工作流节点配置插件，当同意时，在插件中进行下推操作。

3、最后，在转换规则插件中，将源单的附件信息绑定到目标单。

如果觉得插件实现太复杂，赶快升级到金蝶云·苍穹V5.0.011及以上版本吧~轻松配置转换规则，即可支持下推携带附件和图片！

#往期推荐#

# 如何以二开的方式引出Excel并自定义样式

# 一个字段，帮你轻松搞定单据关联

# BOTP支持携带附件和图片，单据流转效率大提升

# BOTP（单据转换）移动端体验优化，用户体验大升级

更多精彩内容，“码”上了解！↓

上传图片

开发案例 | 如何通过插件实现下推附件数据到目标单

开发案例 | 如何通过插件实现下推附件数据到目标单

恭喜您！