第三方影像系统接入EAS Cloud知识(二) ----影像系统接EAS Cloud介绍篇

上篇写了EAS Cloud接影像,来而不往非礼也,有来就有往,这篇写,影像系统该怎么接EAS。完成了这一步从逻辑上，两个系统就通了就只差配置了。

其实EAS就一个核心功能提供给影像系统，更新影像状态。EAS不会记录影像的图片以及影像地址。但是会记录状态，避免每次都要去影像系统查询状态，造成过多的调用。

所有的面向影像系统的接口都由此核心功能衍生关联。

首先分化出来两个最常用接口:

1. 通知影像已就绪接口(imageReady)---影像系统在收到影像图片后,通知EAS对应单据有影像了,同步状态。

2. 通知影像退回重扫(updateImageState)---审核人员,在影像系统驳回（退回）影像,通知EAS同步状态。

   
   

这里由于历史原因这俩接口的名字就比较奇怪了..一个(imageReady)是有点词不达意(imageReady),另一个(updateImageState)是看起来好像功能很强大.实际上只能驳回.

有一个新接口是包含了这俩功能的:

    1.更新影像状态接口(updateImageStateNew)---前面两个接口合二为一

剩下的是辅助型接口:

1. 登录接口(login)---所有eas的接口调用都要先进行登录.

2. 获取影像信息(getImageInfo)---上传影像前,确认EAS相关数据,以确认是否正常

3. 同步组织(snchronyOrg)--同步组织信息接口,如无必要可以不用

4. 同步用户(snchronyUser)--同步用户信息接口,如无必要可以不用

5. 登出接口(logout)---登出接口,不一定是必调的,超时登录信息自动失效.

   
   

一次完整的业务流程,从提单人制单,上传影像,审核影像批退,重传,审核通过,到结束.这样一个流程中,影像系统是怎样通知EAS的呢?

其中,上传影像,驳回影像(仅发起点在影像系统的时候),重传影像;这三个点需要调用EAS接口.

   一)上传影像调用接口

        1.login---获取sessionid

        2.getImageInfo--配合1步骤拿到的sessionid获取影像编码对应EAS数据信息,确认数据是否正常

        3.login---获取sessionid(视情况可以不调用,用1拿到的sessionid,不过一般二开难以判断,建议是每次操作都新取一个)

        4.imageReady(或updateImageStateNew)--配合3步骤拿到的sessionid通知EAS影像系统已接到影像.

    二)驳回影像

         1.login---获取sessionid

          2.updateImageState(或updateImageStateNew)--配合1步骤拿到的sessionid通知EAS影像已被驳回

    三)重传影像

        和(一)场景一毛一样

关于EAS webservice的安全模式对接参考https://vip.kingdee.com/article/248820435755109888

另以上所有接口都处理过,在EAS Cloud的openAPI里都有.身份认证有一点区别.

系列文章:

第三方影像系统接入EAS Cloud知识(一) ----EAS Cloud 接影像系统篇

第三方影像系统接入EAS Cloud知识(三) ----影像系统接EAS Cloud文档篇.

第三方影像系统接入EAS Cloud知识(四) ----影像系统接EAS Cloud文档补充篇

第三方影像系统接入EAS Cloud知识(五) ----影像系统接EAS Cloud 配置篇