一、业务场景

• 二次开发业务场景详细描述

二开单据如何快速实现查看影像功能

影像二开汇总帖 

戳我查看

二、实践思路

• 二开实践思路概述

二开单据接入EAS影像集成模块需要实现的关键核心是在EAS影像映射表里面创建单据影像映射（记录单据id、影像编码，影像状态）；

三、详细设计

第一步：业务单据保存后调用影像服务接口生成单据影像映射信息

接口文档如下：

2. 生成影像编码(指定单据id)

推荐使用此接口；业务单据如果需要用到影像，需要调用EAS生成影像编码接口；生成的影像编码是跟影像系统交互的唯一标识；影像编码生成规：影像前缀  +  单据bosType前缀 + 单据编码

2.1 接口定义

/**
* @param ctx 上下文
* @param bosType 单据实体bostype；可以传空字符串
* @param billID 单据id；Required
*/
public String getImageNumber(String bosType, String billID) throws BOSException

2.2 调用代码示例

String imageNumber = BillImageFacadeFactory.getLocalInstance(ctx).getImageNumber("单据实体bostype","单据id");

2.3 注意事项

1:导入代码包需要导入com.kingdee.eas.base.wssc下的包
2:此接口存在多个重载方法，调用时请注意区分

3. 生成影像编码(指定单据id、指定单据的编码)

无特殊需求，不推荐使用此接口；影像编码生成规则：影像前缀 + 单据bosType + 指定的单据编码；用户使用此接口可以指定一个影像编码，那么这个影像编码将是有这个单据编码组成的；一般可以应用在一些单据编码不唯一，通过自定义规则生成一个唯一单据编码的情况。

3.1 接口定义

/**
* @param ctx 上下文
* @param billID 单据id；Required；
* @param billNumber 指定的单据编码；如果传空，跟2接口无区别
*/
public String getImageNumber(String bosType, String billID, String billNumber) throws BOSException

3.2 代码调用示例

String imageNumber = BillImageFacadeFactory.getLocalInstance(ctx).getImageNumber("单据实体bostype","单据id","单据编码");

3.3 注意事项

1:导入代码包需要导入com.kingdee.eas.base.wssc下的包
2:此接口存在多个重载方法，调用时请注意区分

4. 生成影像编码(苍穹同步单据到EAS业务场景)

此接口专为苍穹苍穹业务单据同步到EAS，EAS再调用共享平台生成影像编码而设计的接口

4.1 接口定义

/**
* @param ctx 上下文
* @param bosType 单据实体bostype；
* @param easBilllId EAS业务单据id；Required；
* @param extendBillID 外部系统单据id；Required；
* @param imageNo 影像编码；
*/
public String getImageNumber(String bosType, String easBillId, String extendName, String extendBillID, String imageNo) throws BOSException, EASBizException

4.2 代码调用示例

String imageNumber = BillImageFacadeFactory.getLocalInstance(ctx).getImageNumber("单据实体bostype","eas单据id","苍穹单据id","影像编码");

4.3 注意事项

1:导入代码包需要导入com.kingdee.eas.base.wssc下的包
2:此接口存在多个重载方法，调用时请注意区分
3:此接口在EAS8.5及高版本才有此功能

戳我跳转到完整的影像接口文档

第二步：单据页面配置查看影像按钮

四、代码样例

生成影像编码调用示例：

BillImageFacadeFactory.getLocalInstance(ctx).getImageNumber("单据实体bostype","单据id");

五、注意事项

1:导入代码包需要导入com.kingdee.eas.base.wssc下的包

2:此接口存在多个重载方法，调用时请注意区分

六、补丁影响

影像集成模块补丁助记码：WSSC

参考补丁知识贴

EAS8.6补丁知识贴

EAS8.5补丁知识贴

EAS8.2补丁知识贴