上篇介绍了 EAS Cloud开放给影像系统有哪些接口.这篇详细介绍下这些接口,也就是等效于接口文档.
login(基础服务提供的登录接口,有三个重载的方法,这里只介绍一个)
userName:登录用户名
password:密码
slnName:固定值'eas'
dcName:登录的数据中心编码---易错项,不是名称是编码,可以从EAS服务器端的管理控制台数据库页签看到.也可以从前端登录界面f12审查元素,看select对应的真实值.
authPattern:一般用默认值即可'BaseDB'
isEncodePwd:0,1决定是否加密密码---如果传的是加密的密码,密码加密这块就不在文章里面细讲了.提单联系基础部门.
return(返回值): WSContext对象
调用代码,可以参考 https://vip.kingdee.com/article/173164492883473920
getImageInfo(获取影像信息接口)
入参:inputXml---String类型,一个xml字符串
return:retXml---String类型,一个xml字符串
所以着重介绍这两个xml的内容:
inputXml:
<?xml version="1.0" encoding="UTF-8" ?> <ImageList> <Image imageNo="必填,影像编码,一般扫描封面的二维码得到" billNo="非必填,EAS单据的id,历史原因写的No实际不是.是id,是id,是id" scanClientIP="非必填,扫描点信息,扫描点名称或者编码,其实也不是ip,当然你要传ip也成" scanTime="非必填,扫描时间,2020-03-16 14:00:00" scanUserID="非必填,扫描人员id,一般用eas的person表的id,传名字或者其他问题也不大" /> </ImageList> 支持传多个(虽然一般都是传一个), retXml:
3.imageReady(通知EAS 影像已就绪)
入参:inputXml---String类型,一个xml字符串
return:imageNo---String类型,成功则返回影像编码,为空字符串则是失败
inputXml:
<?xml version="1.0" encoding="UTF-8" ?>
<ImageList>
<Image imageNo="影像编号,必填"
billNo="单据id"
scanClientIP="扫描点"
scanTime="2020-06-04 14:00:00,扫描时间"
scanUserID="扫描人员" />
</ImageList>
imageNo: 成功则返回影像编码,为空字符串则是失败
4.updateImageState(退回重扫接口)
void返回值
入参依然是 xml
<?xml version="1.0" encoding="UTF-8" ?>
<ImageList>
<Image imageNo="影像编号"
state="3"
rescanUser="退扫人员"
rescanMessage="退扫原因" />
</ImageList>
5.updateImageStateNew(就绪&退扫 合并接口)
入参:inputXml---String类型,一个xml字符串
return:retXml---String类型,一个xml字符串
inputXml:
<?xml version="1.0" encoding="utf-8"?>
<DATA>
<barCodeList>
<barCodeInfo>
<barCode>影像编号</barCode>
<imageCount>该份影像有几张图片组成</imageCount>
</barCodeInfo>
</barCodeList>
<imageState>影像状态,2代表影像上传(等效imageReady),3代表退扫(等效updateImageState)</imageState>
<updaterID>操作人id,用的是eas的userid</updaterID>
<updReason>操作的原因</updReason>
</DATA>
retXml:
<?xml version="1.0" encoding="utf-8"?>
<DATA>
<retCode>0</retCode>
<retMsg>retCode 0表示成功,此时retMsg里面是success</retMsg>
</DATA>
替换ip和对应端口,浏览器输入地址 http://EAS服务器IP:EAS服务器端口/ormrpc/services
可以查看eas所有接口的 wsdl 文件
系列文章:
第三方影像系统接入EAS Cloud知识(一) ----EAS Cloud 接影像系统篇
第三方影像系统接入EAS Cloud知识(二) ----影像系统接EAS Cloud介绍篇
第三方影像系统接入EAS Cloud知识(四) ----影像系统接EAS Cloud文档补充篇
第三方影像系统接入EAS Cloud知识(五) ----影像系统接EAS Cloud 配置篇
推荐阅读