【導(dǎo)讀】調(diào)用規(guī)范等服務(wù)的平臺化工具產(chǎn)品。本產(chǎn)品向外提供一套完整統(tǒng)一的標(biāo)準(zhǔn)U8API調(diào)用接口，功能擴(kuò)展增值服務(wù)，打造量體合身的信息系統(tǒng)。在分類體系上，本產(chǎn)品向外提供的U8API資源主要按照功能模塊以及各個單據(jù)進(jìn)行劃分，載單據(jù)”和“修改單據(jù)”這樣六個標(biāo)準(zhǔn)的API接口，以供客戶調(diào)用。過程中需要注意的內(nèi)容。在左側(cè)“U8API”樹形節(jié)點下，找到某某模塊，如“庫存管理”模塊（可以看到。雙擊這些節(jié)點出現(xiàn)該API的詳細(xì)描述，如下圖所示。代碼示例”則可以看到調(diào)用該API的C#示例代碼，如下圖所示。然后在集成開發(fā)環(huán)境中編輯和編譯這些代碼，即能實現(xiàn)調(diào)用U8標(biāo)準(zhǔn)API。正確使用則可以調(diào)用成功，否則會返回詳細(xì)的錯誤信息。針對兩種語言，需要引用不同的組件。其中，%U8SOFT%表示U8-872的安裝目錄。1)構(gòu)造u8login對象并登陸；3)設(shè)置API地址標(biāo)識參數(shù)；在此種情況下U8API框架會對BO對象各字段進(jìn)行參數(shù)校驗。保DOM對象的正確性。復(fù)合操作，即一項任務(wù)由多個API的協(xié)作來完成。

　　

【正文】 參數(shù)： sVoucherType —— 單據(jù)類型： 01 DomHead —— 表頭 DOM 對象 domBody —— 表體 DOM 對象 domPosition —— 貨位 DOM 對象 errMsg —— 錯誤信息 nFrom —— 連接對象 domMsg —— 超可用量提示信息 DOM 對象（ 返回 DOM 格式的信息 ） bCheck —— 是否進(jìn)行業(yè)務(wù)檢查 bBeforCheckStock —— 是否檢查可用量 bIsRedVouch —— 是否紅字單據(jù) sAddedState —— 修改狀態(tài) bUpdateNeedEas —— 傳 true ? 開發(fā)步驟 實現(xiàn) 庫存 單據(jù)某一功能，主要有以下七個步驟： 1． 構(gòu)造 u8login 對象并登陸 聲明和創(chuàng)建 u8login 類對象前應(yīng)該先 引用 U8API 類庫中的 ，代碼示例如下： u8Login = new ()。 //聲明 u8login 對象 String sSubId = AS。 //登陸 String sAccID = (default)@001。 String sYear = 2020。 String sUserID = demo。 String sPassword = 。 String sDate = 20200930。 String sServer = localhost。 String sSerial = 。 if(!(ref sSubId, ref sAccID, ref sYear, ref sUserID, ref sPassword, ref sDate, ref sServer, ref sSerial)) { (登陸失敗 ， 原因 ： + )。 (u8Login)。 return。 } 如果當(dāng)前環(huán)境中有 login 對象則可以省去第一步。 2． 構(gòu)造環(huán)境上下文對象，傳入 login U8EnvContext envContext = new U8EnvContext()。 //構(gòu)造環(huán)境上下文對象 = u8Login。 //傳入 login 3． 設(shè)置 API 地址標(biāo)識 (Url)參數(shù) //如當(dāng)前 API“ 新增或修改 ” 的地址標(biāo)識為： U8API/SaleOrder/Save U8ApiAddress myApiAddress = new U8ApiAddress(U8API/SaleOrder/Save)。 4． 構(gòu)造 APIBroker U8ApiBroker broker = new U8ApiBroker(myApiAddress, envContext)。 5． API 對象參數(shù)賦值 1) 給 BO 表頭參數(shù) DomHead 和表體參數(shù) domBody 賦值 有兩種方法，如下 ： 方法一是直接傳入 ，代碼如下 domHead = new ()。 ()。 (domHead, domHead)。 方法二是構(gòu)造 BusinessObject對象，具體方法如下： //首先通過 GetBoParam方法獲取表頭表體參數(shù) BusinessObject DomHead = (DomHead)。 = 10。 //設(shè)置行數(shù) //其中， 給 BO對象的字段賦值，值可以是真實類型，也可以是無類型字符串 //以下代碼示例只設(shè)置第一行值。各字段定義詳見 API服務(wù)接口定義 注意： 設(shè)置行數(shù)為某個值， 行數(shù) 并不限定 為 該最大值，可以一直順序添加至任意行，但 有 一個規(guī)則 ：例如當(dāng)設(shè)置為 10時，可以對第 0、 ?? 9行賦值，當(dāng)對第 10行賦值時候，則會順序添加一個新行，但此時是不能對第 11行賦值的，當(dāng)添加一個新行 （第 10行） 后，又可以對第 11行進(jìn)行賦值。 /****************************** 以下是必輸字段 ****************************/ DomHead[0][id] = 。 //主關(guān)鍵字段， int類型 DomHead[0][ccvcode] = 。 //盤點單號， string類型 DomHead[0][dcvdate] = 。 //盤點日期， DateTime類型 DomHead[0][dacdate] = 。 //賬面日期， DateTime類型 DomHead[0][cwhname] = 。 //盤點倉庫， string類型 ?? /***************************** 以下是非必輸字段 ****************************/ DomHead[0][cmodifyperson] = 。 //修改人， string類型 DomHead[0][dmodifydate] = 。 //修改日期， DateTime類型 DomHead[0][dnmaketime] = 。 //制單時間， DateTime類型 DomHead[0][dnmodifytime] = 。 //修改時間， DateTime類型 DomHead[0][dnverifytime] = 。 //審核時間， DateTime類型 ?? 2) 給 普通參數(shù)賦值 例如， 給普通參數(shù) sVouchType（參數(shù)名） 賦值 ： (sVouchType, new ())。 注意： 所有 參數(shù)名不限大小寫 。 3) 給“ OUT 型 ” 參數(shù)賦值 為方便用戶使用 U8API，如果參數(shù) 數(shù)據(jù)類型為一般值類型，如 String、 Integer、 Long、Single、 Double、 Boolean、 Date， 則不必傳入一個參數(shù)變量 （傳入也可）；否則，則必須 一個參數(shù)變量。 如： ?? // 該參數(shù) errMsg為 OUT型參數(shù)，由于其數(shù)據(jù)類型為 ，為一般值類型，因此不必傳入一個參數(shù)變量。在 API調(diào)用返回時，可以通過 GetResult(errMsg)獲取其值 //該參數(shù) domMsg為 OUT型參數(shù)，由于其數(shù)據(jù)類型為 ，非一般值類型，因此必須傳入一個參數(shù)變量。在 API調(diào)用返回時，可以直接使用該參數(shù) domMsg = new ()。 (domMsg, domMsg)。 ?? 注意： 當(dāng)不傳入一個參數(shù)變量時，在 API調(diào)用返回時，可以通過 GetResult(參數(shù)名 )獲取其值；當(dāng)不必傳入一個參數(shù)變量時，在 API調(diào)用返回時，可以直接引用該參數(shù)。 4) 給“ INOUT 型 ” 參數(shù)賦值 對“ INOUT 型 ”型參數(shù)，則不論是否是一般值類型，都需要傳入?yún)?shù)變量。其他與“ OUT型 ” 參數(shù) 一樣。 6． 調(diào)用 API //示例調(diào)用如下 ： if (!()) { //錯誤處理 Exception apiEx = ()。 if (apiEx != null) { if (apiEx is MomSysException) { MomSysException sysEx = apiEx as MomSysException。 (系統(tǒng)異常 ： + )。 //todo:異 常處理 } else if (apiEx is MomBizException) { MomBizException bizEx = apiEx as MomBizException。 (API異常 ： + )。 //todo:異常處理 } } //結(jié)束本次調(diào)用 ， 釋放 API資源 ()。 return。 } 注意 ： 對調(diào)用失敗 ， 可以獲取出錯信息 ， 如果是 API 框架的原因 ， 則報告 MomSysException 異常，如果是業(yè)務(wù)組件的原因，則報告 MomBizException 異常。 7． 獲取返回結(jié)果 1) 獲取 BO 對象 在 “ 裝載單據(jù) ” 時，通過 GetBoParam 方法獲取表頭或表體參數(shù) BusinessObject DomHeadRet = (DomHead)。 (BO對象行數(shù)為 ： + )。 //獲取 BO對象的行數(shù) 注意 ： 如果要取原始的 XMLDOM對象結(jié)果 ， 請使用 GetResult(DomHead) as DomHeadRet = broker. GetResult(DomHead) as 。 以上獲取的行數(shù)是 BO對象的實際行數(shù)。 //獲取 BO 對象各字段的值。以下代碼示例只取第一行。字段定義詳見 API 服務(wù)接口定義 /****************************** 以下是必輸字段 ****************************/ int id = (DomHeadRet[0][id])。 //主關(guān)鍵字段， int類型 string ccvcode = (DomHeadRet[0][ccvcode])。 //盤點單號， string類型 DateTime dcvdate = (DomHeadRet[0][dcvdate])。 //盤點日期， DateTime類型 DateTime dacdate = (DomHeadRet[0][dacdate])。 //賬面日期， DateTime類型 string cwhname = (DomHeadRet[0][cwhname])。 //盤點倉庫， string類型 ?? /***************************** 以下是非必輸字段 ****************************/ string cmodifyperson = (DomHeadRet[0][cmodifyperson])。 //修改人， string類型 DateTime dmodifydate = (DomHeadRet[0][dmodifydate])。 //修改日期， DateTime類型 DateTime dnmaketime = (DomHeadRet[0][dnmaketime])。 //制單時間， DateTime類型 DateTime dnmodifytime = (DomHeadRet[0][dnmodifytime])。 //修改時間， DateTime類型 DateTime dnverifytime = (DomHeadRet[0][dnverifytime])。 //審核時間， DateTime類型 ?? 2) 獲取 普通返回值 代碼如下： //獲取普通返回值。此返回值數(shù)據(jù)類型為 ，此參數(shù)按值傳遞，具體請參考服務(wù)接口定義 result = () as 。 3) 獲取普通“ OUT 型”或 “ INOUT 型” 返回值 如前所述 ， 對普通 “ OUT型 ” 或 “ INOUT 型” 參數(shù)，如果是一般值類型，則通過 GetResult 方法獲取其返回值，否則直接使用該引用。 如， //獲取普通 OUT參數(shù) domPos。此返回值數(shù)據(jù)類型為 ，前面已定義該參數(shù)，請直接使用 //獲取普通 OUT參數(shù) errMsg。此返回值數(shù)據(jù)類型為 ，在使用該參數(shù)之前，請判斷是否為空 errMsgRet = (errMsg) as 。??