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

cnnFromTimeStampdomMsgbCheckbBeforCheckStockbList?装载单据-Load方法参数：sVoucherTypesWhereDomHeaddomBodydomPoserrMsgbGetBlanksBodyWhere_Order————————————连接对象(由调用方控制事务时必须传入)单据时间戳(用于检查单据是否修改，空串时不检查)超可用量提示信息DOM对象(返回DOM格式的信息)是否进行业务检查是否检查可用量传入false————————————————单据类型：01条件串表头DOM对象表体DOM对象货位DOM对象错误信息是否获取空白单据表体排序方式字段注意：其中sWhere设计为:如果按单据号加载，则语法为ccode=N'要加载的单据号'，例如broker.AssignNormalValue(\\=N'0000000001'\如果按单据ID加载，则语法为id=XXX，例如broker.AssignNormalValue(\\=1\?删除单据-Delete方法参数：sVoucherTypeVoucherIderrMsgcnnFromTimeStampdomMsgbCheckBeforCheckStockbList?添加新单据-Add方法参数：sVoucherTypeDomHeaddomBodydomPositionerrMsg————————————单据类型：01单据ID错误信息连接对象（由调用方控制事务时需要传入连接对象）单据时间戳返回DOM格式的信息：主要是检查可用量和控制可用量信息——是否进行业务检查——是否检查可用量——传入false——————————单据类型：01表头DOM对象表体DOM对象货位DOM对象：传空返回错误信息cnnFromVoucherIddomMsgbCheckbBeforCheckStockbIsRedVouchsAddedStatebReMote——连接对象，如果由调用方控制事务，则需要设置此连接对象，否则传空——返回单据ID——返回DOM格式的信息：主要返回可用量和现存量的错误信息——是否进行业务检查(是否控制可用量)——是否检查可用量(检查可用量)——是否红字单据——传空字符串——是否远程?修改单据-Update方法参数：sVoucherTypeDomHeaddomBodydomPositionerrMsgcnnFromdomMsgbCheckbBeforCheckStockbIsRedVouchsAddedStatebUpdateNeedEas————————————————————————单据类型：01表头DOM对象表体DOM对象货位DOM对象错误信息连接对象超可用量提示信息DOM对象（返回DOM格式的信息）是否进行业务检查是否检查可用量是否红字单据修改状态传true?开发步骤

实现库存单据某一功能，主要有以下七个步骤：1．构造u8login对象并登陆声明和创建u8login类对象前应该先引用U8API类库中的Interop.U8Login.dll，代码示例如下：U8Login.clsLoginu8Login=newU8Login.clsLogin();StringsSubId=\StringsAccID=\StringsYear=\StringsUserID=\StringsPassword=\StringsDate=\StringsServer=\//声明u8login对象//登陆StringsSerial=\if(!u8Login.Login(refsSubId,refsAccID,refsYear,refsUserID,refsPassword,refsDate,refsServer,refsSerial)){Console.WriteLine(\+u8Login.ShareString);Marshal.FinalReleaseComObject(u8Login);return;}如果当前环境中有login对象则可以省去第一步。2．构造环境上下文对象，传入loginU8EnvContextenvContext=newU8EnvContext();envContext.U8Login=u8Login;//构造环境上下文对象//传入login3．设置API地址标识(Url)参数//如当前API“新增或修改”的地址标识为：U8API/SaleOrder/SaveU8ApiAddressmyApiAddress=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][\=\//盘点单号，string类型DomHead[0][\=\//盘点日期，DateTime类型DomHead[0][\=\//账面日期，DateTime类型DomHead[0][\=\//盘点仓库，string类型……/*****************************以下是非必输字段****************************/DomHead[0][\=\//修改人，string类型DomHead[0][\=\//修改日期，DateTime类型DomHead[0][\=\//制单时间，DateTime类型DomHead[0][\=\//修改时间，DateTime类型DomHead[0][\=\//审核时间，DateTime类型……2)给普通参数赋值例如，给普通参数sVouchType（参数名）赋值：broker.AssignNormalValue(\newSystem.String());注意：所有参数名不限大小写。3)给“OUT型”参数赋值为方便用户使用U8API，如果参数数据类型为一般值类型，如String、Integer、Long、Single、Double、Boolean、Date，则不必传入一个参数变量（传入也可）；否则，则必须一个参数变量。如：……//该参数errMsg为OUT型参数，由于其数据类型为System.String，为一般值类型，因此不必传入一个参数变量。在API调用返回时，可以通过GetResult(\//该参数domMsg为OUT型参数，由于其数据类型为MSXML2.IXMLDOMDocument2，非一般值类型，因此必须传入一个参数变量。在API调用返回时，可以直接使用该参数MSXML2.IXMLDOMDocument2domMsg=newMSXML2.IXMLDOMDocument2();broker.AssignNormalValue(\domMsg);……注意：当不传入一个参数变量时，在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服务接口定义/******************************以下是必输字段****************************/intid=Convert.ToInt32(DomHeadRet[0][\//主关键字段，int类型stringccvcode=Convert.ToString(DomHeadRet[0][\//盘点单号，string类型DateTimedcvdate=Convert.ToDateTime(DomHeadRet[0][\//盘点日期，DateTime类型DateTimedacdate=Convert.ToDateTime(DomHeadRet[0][\//账面日期，DateTime类型stringcwhname=Convert.ToString(DomHeadRet[0][\//盘点仓库，string类型……/*****************************以下是非必输字段****************************/stringcmodifyperson=Convert.ToString(DomHeadRet[0][\//修改人，string类型DateTimedmodifydate=Convert.ToDateTime(DomHeadRet[0][\//修改日期，DateTime类型DateTimednmaketime=Convert.ToDateTime(DomHeadRet[0][\//制单时间，DateTime类型DateTimednmodifytime=Convert.ToDateTime(DomHeadRet[0][\//修改时间，DateTime类型DateTimednverifytime=Convert.ToDateTime(DomHeadRet[0][\//审核时间，DateTime类型……2)获取普通返回值代码如下：//获取普通返回值。此返回值数据类型为System.String，此参数按值传递，具体请参考服务接口定义System.Stringresult=broker.GetReturnValue()asSystem.String;3)获取普通“OUT型”或“INOUT型”返回值如前所述，对普通“OUT型”或“INOUT型”参数，如果是一般值类型，则通过GetResult方法获取其返回值，否则直接使用该引用。如，//获取普通OUT参数domPos。此返回值数据类型为MSXML2.IXMLDOMDocument2，前面已定义该参数，请直接使用//获取普通OUT参数errMsg。此返回值数据类型为System.String，在使用该参数之前，请判断是否为空System.StringerrMsgRet=broker.GetResult(\asSystem.String;……

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