3U8API开发手册（C#版）1 - 图文(3)

//重新构造APIBrokerbroker=newU8ApiBroker(myApiAddress,envContext);//表头或表体参数赋值broker.SetBoParam(\,DomRet);//API参数赋值broker.AssignNormalValue(\,\);……//调用UPDATE接口APIif(!broker.Invoke()){……}最后，获取返回结果。//获取普通返回值System.Stringresult=broker.GetReturnValue()asSystem.String;//获取out/inout参数值……//结束本次调用，释放API资源broker.Release();2.2.API内容2.2.1采购管理

?功能介绍

为了支持U8二次开发对业务单据的开发，本功能提供了实现采购业务单据各种操作功能的编程接口。使用采购管理的API开发接口，可以对库存管理中的采购到货单、采购普通发票、采购专用发票、采购订单、请购单、采购运费发票等单据进行审核、弃审、获取（或装载）、新增、修改、删除。?使用环境

必须安装.NETFrameWork2.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方法?参数：DomHeaddomBodystrWherevarVoucherIDstrLocateWhereAPI上下文：VoucherTypebPositivesBillTypesBusType?删除单据-Delete方法参数：DomHeaddomBodyCurDomAPI上下文：VoucherTypebPositivesBillTypesBusType——————————————————表头DOM对象表体DOM对象过滤条件串单据主表ID定位条件串单据类型，具体类型参看API上下文描述红蓝标识：True,蓝字；False,红字为空串业务类型：普通采购,直运采购,受托代销——表头DOM对象——表体DOM对象——返回DOM格式错误信息————————单据类型，具体类型参看API上下文描述红蓝标识：True,蓝字；False,红字为空串业务类型：普通采购,直运采购,受托代销?新增或修改新单据-VoucherSave方法参数：DomHead——单据表头，DOM对象，必输domBody——单据表体，DOM对象，必输VoucherState——保存状态，必输。2增加；1修改；0非编辑curID——返回单据头IDCurDom——返回DOM格式错误信息UserMode——使用模式，0：CS；1:BSAPI上下文：VoucherType——单据类型，具体类型参看API上下文描述bPositive——红蓝标识：True,蓝字；False,红字sBillType——为空串sBusType——业务类型：普通采购,直运采购,受托代销?开发步骤

实现采购单据某一功能，主要有以下七个步骤：1．构造u8login对象并登陆声明和创建u8login类对象前应该先引用U8API类库中的Interop.U8Login.dll，代码示例如下：U8Login.clsLoginu8Login=newU8Login.clsLogin();StringsSubId=\StringsAccID=\StringsYear=\StringsUserID=\StringsPassword=\StringsDate=\StringsServer=\StringsSerial=\if(!u8Login.Login(refsSubId,refsAccID,refsYear,refsUserID,refsPassword,refsDate,refsServer,refsSerial)){Console.WriteLine(\+u8Login.ShareString);Marshal.FinalReleaseComObject(u8Login);return;}//声明u8login对象//登陆如果当前环境中有login对象则可以省去第一步。2．构造环境上下文对象，传入login，并按需设置其它上下文参数U8EnvContextenvContext=newU8EnvContext();envContext.U8Login=u8Login;//设置上下文参数envContext.SetApiContext(\newint());//上下文数据类型：int，含义：单据类型envContext.SetApiContext(\newbool());//上下文数据类型：bool，含义：红蓝标识：True,蓝字envContext.SetApiContext(\newstring());//上下文数据类型：string，含义：为空串envContext.SetApiContext(\newstring());//上下文数据类型：string，含义：业务类型：普通采购,直运采购,受托代销//构造环境上下文对象//传入login如果是外部事务，则需要传递ADO.Connection对象，并将IsIndependenceTransaction设置为true：envContext.BizDbConnection=newADO.Connection();envContext.IsIndependenceTransaction=true;3．设置API地址标识(Url)参数//如当前API“新增或修改”的地址标识为：U8API/PurchaseOrder/VoucherSaveU8ApiAddressmyApiAddress=newU8ApiAddress(\4．构造APIBrokerU8ApiBrokerbroker=newU8ApiBroker(myApiAddress,envContext);5．API对象参数赋值1)给BO表头参数DomHead和表体参数domBody赋值有两种方法，如下：方法一是直接传入MSXML2.DOMDocumentClass对象，代码如下MSXML2.DOMDocumentClassdomHead=newMSXML2.DOMDocumentClass();domHead.load(\);broker.AssignNormalValue(\,domHead);方法二是构造BusinessObject对象，具体方法如下：//首先通过GetBoParam方法获取表头表体参数BusinessObjectDomHead=broker.GetBoParam(\DomHead.RowCount=10;//设置行数//其中，给BO对象的字段赋值，值可以是真实类型，也可以是无类型字符串//以下代码示例只设置第一行值。各字段定义详见API服务接口定义注意：设置行数为某个值，行数并不限定为该最大值，可以一直顺序添加至任意行，但有一个规则：例如当设置为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类型……2)给普通参数赋值例如，//给普通参数VoucherState（参数名）赋值。此参数的数据类型为int，此参数按值传递，具体请参考服务接口定义broker.AssignNormalValue(\newint());

百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读，免费范文网，提供经典小说教育文库3U8API开发手册（C#版）1 - 图文(3)在线全文阅读。