插件实现附件面板和附件字段的携带转换原创
页面开发
公共基础服务
金蝶云社区-时空蔷薇
时空蔷薇
28人赞赏了该文章 8049次浏览 未经作者许可，禁止转载编辑于2022年03月10日 14:55:31

关键词：

页面开发，附件面板，附件字段

一、需求

    在BOTP等有业务单据转换的场景，需要把某张单据的附件上传到另外一张单据中，怎么实现？

二、思路与方案

2.1 分析思路

    苍穹系统附件类型有附件面板和附件字段。

    附件面板是面板控件，其附件对象数据存储于bos_attachment，只有控件编程模型，没有数据模型，但我们可以通过AttachmentServiceHelper.getAttachments(String, Object, String)获取附件面板数据、

 

AttachmentServiceHelper.upload(String, Object, String, List<Map<String, Object>>)或者AttachmentServiceHelper.saveTempAttachments(String, Object, String, Map<String, Object>)上传附件面板数据。

    附件字段继承自多选基础资料，具有数据模型，其关联的基础资料类型是bd_attachment，附件字段赋值类似多选基础资料，也可通过fbasedataid实现。

    那么借助这些方法即可随心所欲实现附件面板、附件字段之间的携带转换。

2.2 实现方案

1. 附件面板To附件面板

    先获取源附件面板数据，页面前台用AttachmentPanel.getAttachmentData()或者插件后台用AttachmentServiceHelper.getAttachments(String, Object, String)，然后对lastModified、url等进行数据加工处理，调用AttachmentServiceHelper.upload(String, Object, String, List<Map<String, Object>>)上传到目标附件面板。

2. 附件面板To附件字段

    先获取源附件面板数据，页面前台用AttachmentPanel.getAttachmentData()或者插件后台用AttachmentServiceHelper.getAttachments(String, Object, String)，然后对uid、关联单据实体编码、关联单据实体id等进行数据加工处理，调用AttachmentFieldModel.saveAttachments(IDataModel, String, String, List<Map<String, Object>>)将附件数据上传到文件服务器，生成bd_attachment附件对象，再赋值给目标附件字段。

3. 附件字段To附件字段

    参考多选基础资料字段，先加载源附件字段的数据值集合，取出fbasedataid赋值给目标附件字段。

4. 附件字段To附件面板

    先加载源附件字段的数据值集合，通过bd_attachment附件对象里的url将附件上传到文件服务器，并自己构造附件面板数据，再调用AttachmentServiceHelper.saveTempAttachments(String, Object, String, Map<String, Object>)将数据绑定到目标附件面板。

 

三、实现过程

1. 附件面板To附件面板

(1) 获取源附件面板数据并进行数据加工

关键代码：

//通过AttachmentServiceHelper.getAttachments(formId, pkId, attachKey)获取源单据附件面板附件数据
List<Map<String, Object>> attachmentData = AttachmentServiceHelper.getAttachments("kded_sourcebill", sourcebill.getLong("id"), "attachmentpanel");
attachmentData.forEach(attach -> {
    try {
        //源附件数据的lastModified是timestamp，会出现强转long错误在此置null
        attach.put("lastModified", null);
        //源附件数据的url已经过URL编码，需要在此先解码获取原始下载路径，AttachmentServiceHelper.upload()会进行URL编码
        attach.put("url", getPathfromDownloadUrl(URLDecoder.decode(String.valueOf(attach.get("url")), "UTF-8")));
    } catch (IOException e) {
        //do something with log.
        e.printStackTrace();
    }
})
 
/**
 * 获取文件服务器相对路径
 * @param url
 * @return
 * @throws IOException
 */
private String getPathfromDownloadUrl(String url) throws IOException {
    String path = StringUtils.substringAfter(url, "path=");
    path = URLDecoder.decode(path, "UTF-8");
    return FilePathUtil.dealPath(path, "attach");
}

(2) 将附件数据上传到目标附件面板

关键代码：

//调用AttachmentServiceHelper.upload(formId, pkId, attachKey,  attachments)将附件数据上传到目标附件面板
AttachmentServiceHelper.upload(getView().getEntityId(), getModel().getValue("id"), "attachmentpanel", attachmentData);

 

2. 附件面板To附件字段

(1) 获取源附件面板数据并进行数据加工

关键代码：

//通过AttachmentServiceHelper.getAttachments(formId, pkId, attachKey)获取源单据附件面板附件数据
List<Map<String, Object>> attachmentData1 = AttachmentServiceHelper.getAttachments("kded_sourcebill", sourcebill1.getLong("id"), "attachmentpanel");
attachmentData1.forEach(attach -> {
    //修改附件数据的uid、关联单据实体编码、关联单据实体id
    attach.put("uid", getUid().toString());
    attach.put("entityNum", getView().getEntityId());
    attach.put("billPkId", String.valueOf(getModel().getValue("id")));
});
/**
 * 获取附件uid
 * @return
 */
private StringBuffer getUid() {
    StringBuffer uid = new StringBuffer("rc-upload-");
    uid.append((new Date()).getTime());
    uid.append("-");
    int index = (int)(1.0D + Math.random() * 10.0D);
    uid.append(index);
    return uid;
}

 

(2) 调用AttachmentFieldModel.saveAttachments(IDataModel, String, String, List<Map<String, Object>>)将附件数据上传到文件服务器

关键代码：

AttachmentEdit attEdit = this.getView().getControl("kded_attachment");
List<DynamicObject> saveAttachments = attEdit.getAttachmentModel().saveAttachments(attEdit.getModel(), this.getView().getPageId(), this.getModel().getDataEntityType().getName(), attachmentData1);

 

(3) 给目标附件字段赋值

关键代码：

List<Long> idSet = new ArrayList<>();
//获取保存后的bd_attachment附件对象id
saveAttachments.forEach(save -> idSet.add(save.getLong("id")));
//给目标附件字段赋值
getModel().setValue("kded_attachment", idSet.toArray());

 

3. 附件字段To附件字段

(1) 获取源附件字段附件对象（bd_attachment）的id集合

关键代码：

//获取源附件字段的值
DynamicObject sourceBill2 = BusinessDataServiceHelper.loadSingle("kded_sourcebill", "id,kded_attachment", qFilter2.toArray());
DynamicObjectCollection sourceAttachcol = (DynamicObjectCollection) sourceBill2.get("kded_attachment");
//获取源附件字段附件对象id集合 
List<Long> attchIdSet = new ArrayList<>();
sourceAttachcol.forEach(attach -> {
    attchIdSet.add(attach.getDynamicObject("fbasedataId").getLong("id"));
});

 

(2) 给目标附件字段赋值

方案一：因为在目标单据页面操作，获取源附件字段附件对象bd_attachment的id通过setValue赋值给目标附件字段即可。

关键代码：

getModel().setValue("kded_attachment", attchIdSet.toArray());

 

方案二：后台处理可先获取目标单据附件字段的集合，根据源附件字段附件对象id（bd_attachment）加载附件数据再通过fbasedataid赋值给目标附件字段。

关键代码：

DynamicObjectCollection targetAttachCol = this.getModel().getDataEntity(true).getDynamicObjectCollection("kded_attachment");
DynamicObject[] sourceAttachments = BusinessDataServiceHelper.load(attchIdSet.toArray(), EntityMetadataCache.getDataEntityType("bd_attachment"));
//将bd_attachment查出来的附件对象绑定到目标附件字段上，即跟源单共用附件基础资料
Arrays.asList(sourceAttachments).forEach(attachObj -> 
    targetAttachCol.addNew().set("fbasedataid", attachObj)
);
//刷新当前页面验证效果
getView().updateView("kded_attachment");

 

注意：案例中此时源字段与目标字段共用同个附件对象数据，有一方删除附件则另一方也同时删除。可通过附件url获取文件流再自行上传至文件服务器创建另一个附件对象。

 

4. 附件字段To附件面板

(1) 获取源附件字段附件对象（bd_attachment）数据

关键代码：

//获取源附件字段的值
DynamicObject sourceBill3 = BusinessDataServiceHelper.loadSingle("kded_sourcebill", "id,kded_attachment", qFilter3.toArray());
DynamicObjectCollection sourceAttachCol3 = (DynamicObjectCollection) sourceBill3.get("kded_attachment");

 

(2) 根据附件字段数据构造附件面板数据，通过FileServiceFactory获取AttachmentFileService，并通过附件字段附件对象数据获取源附件文件流上传到文件服务器，拿到返回的url构造附件面板数据集。

关键代码：

//根据附件字段数据构造附件面板数据
Map<String, Object> attachemnts = new HashMap<>();
List<Map<String, Object>> attachmentData3 = buildAttachmentDataFromEdit(sourceAttachCol3);
//key:目标附件面板标识，value:目标附件面板附件数据
attachemnts.put("attachmentpanel", attachmentData3);
 
/**
 * 根据附件字段数据构造附件面板数据
 * @param sourceAttachCol
 * @return
 */
private List<Map<String, Object>> buildAttachmentDataFromEdit(DynamicObjectCollection sourceAttachCol) {
    List<Map<String, Object>> attachDataList = new ArrayList<>();
    sourceAttachCol.forEach(attach -> {
        DynamicObject attachObj = attach.getDynamicObject("fbasedataid");
        Map<String, Object> attachMap = new HashMap<>();
        //description
        attachMap.put("description", attachObj.getString("description"));
        attachMap.put("type", attachObj.getString("type"));
        //获取附件inputstream上传到缓存服务
        InputStream inputStream = FileServiceFactory.getAttachmentFileService().getInputStream(attachObj.getString("url"));
        String saveUrl = CacheFactory.getCommonCacheFactory().getTempFileCache().saveAsFullUrl(attachObj.getString("name"), new BufferedInputStream(inputStream), 2*3600);
        //url
        attachMap.put("url", saveUrl);
        //uid
        attachMap.put("uid", getUid());
        //name
        attachMap.put("name", attachObj.getString("name"));
        //size
        attachMap.put("size", attachObj.get("size"));
        attachMap.put("fattachmentpanel", "attachmentpanel");
        //entityNum
        attachMap.put("entityNum", getView().getEntityId());
        attachMap.put("billPkId", String.valueOf(getModel().getValue("id")));
        //lastModified
        attachMap.put("lastModified", new Date().getTime());
        attachMap.put("status", "success");
        //client
        attachMap.put("client", null);
        attachDataList.add(attachMap);
    });
    return attachDataList;
}

 

(3) 调用AttachmentServiceHelper.saveTempAttachments(String, Object, String, Map<String, Object>)将数据绑定到目标附件面板。

关键代码：

AttachmentServiceHelper.saveTempAttachments(getView().getEntityId(), getModel().getValue("id"), "kded_clztest", attachemnts);
//刷新页面
getView().updateView("attachmentpanel");

四、效果图

1. 附件面板To附件面板，如图1-图3。

 

 

图片1.png

图 1 源单据附件面板上传图片

图片2.png

 

图 2 通过插件将源附件面板图片上传到目标附件面板

图片3.png

 

图 3 目标附件面板图片可正常浏览

 

2. 附件面板To附件字段，借用图1附件面板的数据0.0，如图4，也可正常浏览的噢。

图片4.png

图 4 通过插件将源附件面板图片上传到目标附件字段

3. 附件字段To附件字段，如图5-图6，还是可以正常浏览哒。

图片5.png

  

图 5 源单据附件字段上传图片

 

图片6.png

图 6 通过插件将源附件字段图片上传到目标附件字段

 

4. 附件字段To附件面板，借用图5附件面板的数据0-0，如图7。

图片7.png

 

图 7 通过插件将源附件字段图片上传到目标附件面板


插件实现附件面板和附件字段的携带转换_元数据.zip(16.25KB)

插件实现附件面板和附件字段的携带转换_代码.zip(2.74KB)

赞 28

推荐阅读

如何实现把单据的附件字段同步到表单的附件面板 …

关键字：附件字段、附件面板、动态表单 一、需求背景： 【附件专题系列样例】 表单の附件字段（落库） -> 表单の附件面板（不落库）-界面 业务场景：单据A的单据 …

    文章

    2152

附件字段和附件面板的区别

问题描述 在日常工作中，发现有许多小伙伴没有意识到附件面板和附件字段的区别，这篇文章用于给大家简要地说明其最显著的区别，帮助大家在开发时选择正确的控件。 附件面 …

    知识

    2510

附件面板/附件字段新增排序功能

用户场景 用户需要根据表单的场景，对上传的文件进行排序，便于文件的区分 功能介绍 1. 在设计器中，可看到附件新增了排序字段和排序方式的属性，默认值为上传时间和 …

    知识

    741