//重新构造APIBroker
broker = new U8ApiBroker(myApiAddress, envContext); //表头或表体参数赋值
broker.SetBoParam(\表头或表体参数名\, DomRet); //API参数赋值
broker.AssignNormalValue(\参数名\, \参数值\); ??
//调用UPDATE接口API if (!broker.Invoke()) { }
??
最后，获取返回结果。
//获取普通返回值
System.String result = broker.GetReturnValue() as System.String; //获取out/inout参数值 ??
//结束本次调用，释放API资源 broker.Release();
2.2. API内容 2.2.1 采购管理
? 功能介绍
为了支持U8二次开发对业务单据的开发，本功能提供了实现采购业务单据各种操作功能的编程接口。使用采购管理的API开发接口，可以对库存管理中的采购到货单、采购普通发票、采购专用发票、采购订单、请购单、采购运费发票等单据进行审核、弃审、获取（或装载）、新增、修改、删除。
? 使用环境
必须安装.NET FrameWork 2.0； 必须安装U8-872版本的采购管理产品； 必须安装API适配器组件PUAPIConcrete.dll
? 接口说明
采购管理二次开发接口说明：
? 审核单据-ConfirmPO方法
参数：
domHead —— 单据表头，DOM对象，必输 API上下文：
VoucherType —— 单据类型，具体类型参看API上下文描述 bPositive —— 红蓝标识：True,蓝字 ；False,红字 sBillType —— 为空串
sBusType —— 业务类型：普通采购,直运采购,受托代销
? 弃审单据- CancelconfirmPO方法
参数：
domHead —— 单据表头，DOM对象，必输 API上下文：
VoucherType —— 单据类型，具体类型参看API上下文描述 bPositive —— 红蓝标识：True,蓝字 ；False,红字 sBillType —— 为空串
sBusType —— 业务类型：普通采购,直运采购,受托代销
? 装载单据-Load方法
参数：
DomHead —— 表头DOM对象 domBody —— 表体DOM对象 strWhere —— 过滤条件串 varVoucherID —— 单据主表ID strLocateWhere —— 定位条件串 API上下文：
VoucherType —— 单据类型，具体类型参看API上下文描述 bPositive —— 红蓝标识：True,蓝字 ；False,红字 sBillType —— 为空串
sBusType —— 业务类型：普通采购,直运采购,受托代销
? 删除单据-Delete方法
参数：
DomHead —— 表头DOM对象 domBody —— 表体DOM对象
CurDom —— 返回DOM格式错误信息 API上下文：
VoucherType —— 单据类型，具体类型参看API上下文描述 bPositive —— 红蓝标识：True,蓝字 ；False,红字 sBillType —— 为空串
sBusType —— 业务类型：普通采购,直运采购,受托代销
? 新增或修改新单据- VoucherSave方法
参数：
DomHead —— 单据表头，DOM对象，必输 domBody —— 单据表体，DOM对象，必输
VoucherState —— 保存状态，必输。2增加；1修改 ；0非编辑 curID —— 返回单据头ID
CurDom —— 返回DOM格式错误信息 UserMode —— 使用模式，0：CS；1:BS API上下文：
VoucherType —— 单据类型，具体类型参看API上下文描述 bPositive —— 红蓝标识：True,蓝字 ；False,红字 sBillType —— 为空串
sBusType —— 业务类型：普通采购,直运采购,受托代销
? 开发步骤
实现采购单据某一功能，主要有以下七个步骤： 1． 构造u8login对象并登陆
声明和创建u8login类对象前应该先引用U8API类库中的Interop.U8Login.dll，代码
示例如下：
U8Login.clsLogin u8Login = new U8Login.clsLogin(); //声明u8login对象 String sSubId = \String sYear = \String sUserID = \String sPassword = \String sDate = \String sServer = \String sSerial = \
if(!u8Login.Login(ref sSubId, ref sAccID, ref sYear, ref sUserID, ref sPassword, ref sDate, ref sServer, ref sSerial))
{
}
Console.WriteLine(\登陆失败，原因：\Marshal.FinalReleaseComObject(u8Login); return;
//登陆
String sAccID = \
如果当前环境中有login对象则可以省去第一步。
2． 构造环境上下文对象，传入login，并按需设置其它上下文参数 U8EnvContext envContext = new U8EnvContext();
envContext.U8Login = u8Login; //设置上下文参数
envContext.SetApiContext(\new int()); //上下文数据类型：int，含义：单据类型 envContext.SetApiContext(\上下文数据类型：bool，含义：红蓝标
识：True,蓝字
envContext.SetApiContext(\new string()); //上下文数据类型：string，含义：为空
串
envContext.SetApiContext(\上下文数据类型：string，含义：业务
类型：普通采购,直运采购,受托代销
//构造环境上下文对象 //传入login
如果是外部事务，则需要传递ADO.Connection对象，并将IsIndependenceTransaction设置为true：
envContext.BizDbConnection = new ADO.Connection(); envContext.IsIndependenceTransaction = true;
3． 设置API地址标识(Url)参数
//如当前API“新增或修改”的地址标识为：U8API/PurchaseOrder/VoucherSave
U8ApiAddress myApiAddress = new U8ApiAddress(\
4． 构造APIBroker
U8ApiBroker broker = new U8ApiBroker(myApiAddress, envContext);
5． API对象参数赋值
1) 给BO表头参数DomHead和表体参数domBody赋值有两种方法，如下： 方法一是直接传入MSXML2.DOMDocumentClass对象，代码如下
MSXML2.DOMDocumentClass domHead = new MSXML2.DOMDocumentClass(); domHead.load(\);
broker.AssignNormalValue(\, domHead);
方法二是构造BusinessObject对象，具体方法如下：
//首先通过GetBoParam方法获取表头表体参数
注意：设置行数为某个值，行数并不限定为该最大值，可以一直顺序添加至任意行，但有一个规则：例如当设置为10时，可以对第0、1、??9行赋值，当对第10行赋值时候，则会顺序添加一个新行，但此时是不能对第11行赋值的，当添加一个新行（第10行）后，又可以对第11行进行赋值。
/****************************** 以下是必输字段 ****************************/ DomHead[0][\主关键字段，int类型 DomHead[0][\日期，DateTime类型 DomHead[0][\订单编号，string类型 DomHead[0][\供货单位，string类型 DomHead[0][\币种，string类型 DomHead[0][\汇率，double类型 ??
/***************************** 以下是非必输字段 ****************************/ DomHead[0][\现存量，string类型 DomHead[0][\制单时间，DateTime类型 DomHead[0][\修改时间，DateTime类型 DomHead[0][\审核时间，DateTime类型 DomHead[0][\审核日期，DateTime类型 DomHead[0][\修改日期，DateTime类型 BusinessObject DomHead = broker.GetBoParam(\DomHead.RowCount = 10; //设置行数
//其中，给BO对象的字段赋值，值可以是真实类型，也可以是无类型字符串 //以下代码示例只设置第一行值。各字段定义详见API服务接口定义
??
2) 给普通参数赋值 例如，
//给普通参数VoucherState（参数名）赋值。此参数的数据类型为int，此参数按值传递，具体请参考服务接口定义
broker.AssignNormalValue(\
百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说综合文库U8API开发手册(C#版)(3)在线全文阅读。
相关推荐：