智慧车间增加取数接口

1.   背景

智慧车间通过WEBSERVICE接口可从CLOUD服务器获取某些单据的信息，目前标准产品提供了常用单据的数据获取接口，在某些现场根据自身项目的特点，需要增加其他单据或已有单据不同格式的数据获取接口。

本文档旨在指导二次开发人员利用标准产品的智慧车间API接口平台（详见《智慧车间API接口平台介绍》）增加自定义取数接口。

2.   适用对象

二次开发人员。

3.   基于平台增加取数接口

本文将以“按状态获取工单信息”为例，描述如何通过智慧车间API接口平台新增一个取数接口，并根据传入的状态值及组织信息，获取符合条件的工单数据。

开发的准备步骤详见《智慧车间接口自定义返回值.docx》中的第3章，本文档不再对此赘述，只介绍插件开发的核心方法。 

3.1     定义参数和返回值对象

调用接口时需要指定接口的传入参数类以及返回结果类。本示例想通过调用标准产品预置的通用接口来实现取数，而通用接口的参数类和结果类均使用的是默认值，因此原则上不需要单独建立。

参数可以通过通用接口中的Param1~Param10输入，如本示例中需要传入组织编码和工单状态，因此只使用Param1、Param2即可。当然，对于复杂的参数，建议在Param1~Param10中传入Json文本，后续在处理器中再做解析。

而返回结果需要包含工单的信息，如工单编号、分录行号、分录状态、产品编码、产品名称、数量等信息，由于结构相对复杂，直接返回默认结果类的话，在构造数据和返回显示上不太友好。因此最好建一个类来承接结果数据，这个类需要继承SFSDefaultParam类，命名空间为Kingdee.K3.MFG.SFS.Common.Core.ParamValue。

图3-1 返回结果类

3.2