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

注意：所有参数名不限大小写。3)给“OUT型”参数赋值为方便用户使用U8API，如果参数数据类型为一般值类型，如String、Integer、Long、Single、Double、Boolean、Date，则不必传入一个参数变量（传入也可）；否则，则必须一个参数变量。如：……//该参数curID为OUT型参数，由于其数据类型为string，为一般值类型，因此不必传入一个参数变量。在API调用返回时，可以通过GetResult(\//该参数CurDom为OUT型参数，由于其数据类型为MSXML2.IXMLDOMDocument2，非一般值类型，因此必须传入一个参数变量。在API调用返回时，可以直接使用该参数MSXML2.IXMLDOMDocument2CurDom=newMSXML2.IXMLDOMDocument2();broker.AssignNormalValue(\CurDom);……当不传入一个参数变量时，在API调用返回时，可以通过GetResult(参数名)获取其值；当不必传入一个参数变量时，在API调用返回时，可以直接引用该参数。4)给“INOUT型”参数赋值对“INOUT型”型参数，则不论是否是一般值类型，都需要传入参数变量。其他与“OUT型”参数一样。6．调用API//示例调用如下：if(!broker.Invoke()){//错误处理ExceptionapiEx=broker.GetException();if(apiEx!=null){if(apiExisMomSysException){MomSysExceptionsysEx=apiExasMomSysException;Console.WriteLine(\+sysEx.Message);//todo:异常处理}elseif(apiExisMomBizException){MomBizExceptionbizEx=apiExasMomBizException;Console.WriteLine(\+bizEx.Message);//todo:异常处理}}//结束本次调用，释放API资源broker.Release();return;}注意：对调用失败，可以获取出错信息，如果是API框架的原因，则报告MomSysException异常，如果是业务组件的原因，则报告MomBizException异常。7．获取返回结果1)获取BO对象在“装载单据”时，通过GetBoParam方法获取表头或表体参数BusinessObjectDomHeadRet=broker.GetBoParam(\Console.WriteLine(\+DomHeadRet.RowCount);//获取BO对象的行数注意：如果要取原始的XMLDOM对象结果，请使用GetResult(\asMSXML2.DOMDocumentMSXML2.DOMDocumentDomHeadRet=broker.GetResult(\asMSXML2.DOMDocument;以上获取的行数是BO对象的实际行数。//获取BO对象各字段的值。以下代码示例只取第一行。字段定义详见API服务接口定义/******************************以下是必输字段****************************/intpoid=Convert.ToInt32(DomHeadRet[0][\//主关键字段，int类型DateTimedpodate=Convert.ToDateTime(DomHeadRet[0][\//日期，DateTime类型stringcpoid=Convert.ToString(DomHeadRet[0][\//订单编号，string类型……/*****************************以下是非必输字段****************************/stringipresent=Convert.ToString(DomHeadRet[0][\//现存量，string类型DateTimecmaketime=Convert.ToDateTime(DomHeadRet[0][\//制单时间，DateTime类型……2)获取普通返回值代码如下：//获取普通返回值。此返回值数据类型为System.String，此参数按值传递，具体请参考服务接口定义System.Stringresult=broker.GetReturnValue()asSystem.String;3)获取普通“OUT型”或“INOUT型”返回值如前所述，对普通“OUT型”或“INOUT型”参数，如果是一般值类型，则通过GetResult方法获取其返回值，否则直接使用该引用。如，//获取普通OUT参数curID。此返回值数据类型为string，在使用该参数之前，请判断是否为空stringcurIDRet=broker.GetResult(\asstring;//获取普通OUT参数CurDom。此返回值数据类型为MSXML2.IXMLDOMDocument2，前面已定义该参数，请直接使用……2.2.2销售管理

?功能介绍

为了支持U8二次开发对业务单据的开发，本功能提供了实现销售业务单据各种操作功能的编程接口。使用销售管理API开发接口，可以完成销售管理的销售报价单、销售订单、销售发货单、销售退货单、销售普通发票、销售专用发票、委托代销发货单、委托代销结算单、销售调拨单等单据的审核、弃审、获取、新增、修改、删除。?使用环境

必须安装.NETFrameWork2.0；必须安装U8-872版本的销售管理产品；必须安装API适配器组件SAAPIConcrete.dll；?接口说明

销售管理二次开发接口及参数说明：?审核或弃审单据-Audit方法参数：domHead——单据表头，DOM对象，必输bVerify——审核/弃审标志，必输。true表审核；false表弃审API上下文：VoucherType——单据类型，必输。具体类型参看API上下文描述?删除单据-Delete方法参数：domHead——单据表头，DOM对象，必输API上下文：VoucherType——单据类型，必输。具体类型参看API上下文描述装载单据-Load方法参数：domHeaddomBodyVouchIDblnAuthAPI上下文：VoucherType?————————单据表头，DOM对象，必输单据表体，DOM对象，必输需要装载的单据号，可选是否控制权限：true——单据类型，必输。具体类型参看API上下文描述?新增或修改单据-Save方法参数：domHead——domBody——VoucherState——VNewID——DomConfig——API上下文：VoucherType——单据表头，DOM对象，必输单据表体，DOM对象，必输保存状态，必输。0增加；1修改单据的id，可选ATO,PTO选配配置，必输，可设置为nothing单据类型，必输。具体类型参看API上下文描述?开发步骤

实现销售单据某一功能，主要有以下七个步骤：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，含义：单据类型//构造环境上下文对象//传入login

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