U8API开发手册 下载本文

图 2.4 添加对Interop.MSXML2.dll引用

图 2.5 添加对U8API框架类库引用(.dll)

图2.6 添加对U8API框架类库引用(.tlb)

图2.7 添加Microsoft XML v3.0引用

? API调用

添加必要的引用后,可以直接利用自动生成的代码示例(支持C#和VB两种语言),结合API接口详细描述,填入必要的参数值,就可以调用U8 API。

总体上,对U8 API的调用分成七个步骤: 1) 构造u8login对象并登陆;

2) 构造环境上下文对象,传入login,并按需设置其它上下文参数; 3) 设置API地址标识(Url)参数; 4) 构造APIBroker; 5) API参数赋值; 6) 调用API;

7) 获取返回结果。

详细的API调用过程请看下文“API内容”中各个模块中介绍的“开发步骤”。

? BO参数赋值

API参数分两种类型:BO参数和普通参数。BO参数即单据表头或表体类型的参数,普通参数则是非表头表头类型的参数。对BO参数,支持两种方式传入,一种传BO对象,另一种传DOM对象。以下分别介绍:

(1) 传BO对象

给BO表头参数或表体参数赋值,推荐使用BO对象(BussinessObject)。 例如:

BusinessObject DomHead = broker.GetBoParam(\);

/***************************** 以下是非必输字段****************************/ DomHead[0][\] = \; //现存量,string类型 DomHead[0][\] = \; //制单时间,DateTime类型 DomHead[0][\] = \; //修改时间,DateTime类型 ??

/****************************** 以下是必输字段****************************/ DomHead[0][\] = \; //主关键字段,int类型 DomHead[0][\] = \; //日期,DateTime类型 DomHead[0][\] = \; //订单编号,string类型 ??

DomHead.RowCount = 10; //设置行数,不设置也可

//给BO对象的字段赋值,值可以是真实类型,也可以是无类型字符串 //以下代码示例只设置第一行值。各字段定义详见API服务接口定义

在此种情况下U8 API框架会对BO对象各字段进行参数校验。对字段进行赋值时,值可以是真实类型,也可以是无类型字符串。

(2) 传DOM对象

给BO表头参数或表体参数赋值,也支持直接传入DOM对象(DOMDocument)。 例如:

MSXML2.DOMDocumentClass domHead = new MSXML2.DOMDocumentClass(); domHead.load(\);

broker.AssignNormalValue(\, domHead);

但是,在此种情况下U8 API框架不会对DOM对象进行参数验证。请在使用该方法之前,确保DOM对象的正确性。

2.1.3 API典型应用场景 ? 执行单一操作

单一操作指一项任务只需要一个API完成,比如:单据新增、审核/弃审、删除等单一操作。这是API调用最常见的场景,只需按照API的接口规范构造参数直接调用即可。

? 执行复合操作

复合操作,即一项任务由多个API的协作来完成。比如,自定义的单据维护界面的主要逻辑,一般由以下四个步骤构成:

1) 加载单据;

2) 在编辑界面上显示; 3) 用户修改单据字段; 4) 提交保存。

以上步骤需要进行两次API调用: 1) 加载单据时候调用“加载API”,以获取单据BO对象(或原始DOM对象)并在界面

上展现;

2) 用户在修改单据时其实就是在修改BO对象,用户保存单据时调用“保存API”,此

时要将此BO对象传给“保存API”(而不用构造新的BO对象)。

代码示例:

首先,登陆;

//构造u8login对象并登陆

U8Login.clsLogin u8Login = new U8Login.clsLogin(); String sSubId = \;

String sAccID = \; String sYear = \; String sUserID = \; String sPassword = \; String sDate = \; String sServer = \;