【正文】 6． 調(diào)用 API //示例調(diào)用如下： if (!()) { //錯誤處理 Exception apiEx = ()。 //單據(jù)號， string類型 DateTime ddate = (domHeadRet[0][ddate])。 ，例如(sWhere, ccode = N39。 2． 構(gòu)造環(huán)境上下文對象，傳入 login U8EnvContext envContext = new U8EnvContext()。 //盤點倉庫， string類型 ?? /***************************** 以下是非必輸字段 ****************************/ DomHead[0][cmodifyperson] = 。 if (apiEx != null) { if (apiEx is MomSysException) { MomSysException sysEx = apiEx as MomSysException。 //盤點日期， DateTime類型 DateTime dacdate = (DomHeadRet[0][dacdate])。此返回值數(shù)據(jù)類型為 ，在使用該參數(shù)之前，請判斷是否為空 errMsgRet = (errMsg) as 。以下代碼示例只取第一行。 ?? 注意： 當不傳入一個參數(shù)變量時，在 API調(diào)用返回時，可以通過 GetResult(參數(shù)名 )獲取其值；當不必傳入一個參數(shù)變量時，在 API調(diào)用返回時，可以直接引用該參數(shù)。 //主關(guān)鍵字段， int類型 DomHead[0][ccvcode] = 。 if(!(ref sSubId, ref sAccID, ref sYear, ref sUserID, ref sPassword, ref sDate, ref sServer, ref sSerial)) { (登陸失敗 ， 原因 ： + )。此返回值數(shù)據(jù)類型為 ，前面已定義該參數(shù)，請直接使用 ?? 庫存 管理 ? 功能介紹 為了支持 U8 二次開發(fā)對業(yè)務(wù)單據(jù)的開發(fā)，本功能提供了實現(xiàn)庫存業(yè)務(wù)單據(jù)各種操作功能的編程接口。 //獲取 BO 對象各字段的值。 (CurDom, CurDom)。 /****************************** 以下是必輸字段 ****************************/ domHead[0][id] = 。 return。 true 表 審核 ； false 表 棄審 API 上下文： VoucherType —— 單據(jù)類型，必輸。 //獲取 BO 對象各字段的值。 (CurDom, CurDom)。 //訂單編號， string類型 DomHead[0][cvenabbname] = 。 //上下文數(shù)據(jù)類型 ： bool， 含義 ： 紅藍標識 ： True,藍字 (sBillType, new string())。 //聲明 u8login 對象 String sSubId = AS。 (API異常： + )。 String sPassword = 。 (2) 傳 DOM 對象 給 BO 表頭參數(shù) 或 表體參數(shù) 賦值，也支持直接傳入 DOM 對象（ DOMDocument）。 詳細的 API 調(diào)用過程請看下文“ API 內(nèi)容”中各個模塊中介紹的“開發(fā)步驟”。 客戶可以在“ U8API 資源管理器”中查看要調(diào)用的 API 接口描述，同時可以獲取調(diào)用 該 API 的代碼示例（目前支持兩種語言 C和 VB）， 客戶 只需要 結(jié)合 API 接口描述并 按照代碼注釋中給出的提示 步驟 進行操作就可以方便的使用 U8 API 資源。 以下代碼中均以 C為例， VB 語言請具體查看對應(yīng)的 VB 代碼示例部分。 //主關(guān)鍵字段， int類型 DomHead[0][dpodate] = 。比如，自定義的單據(jù)維護界面的主要邏輯，一般由以下四個步驟構(gòu)成： 1) 加載單據(jù)； 2) 在編輯界面上顯示； 3) 用戶修改單據(jù)字段； 4) 提交保存。 //設(shè)置上下文參數(shù) ?? //設(shè)置 API 地址標識 (Url) U8ApiAddress myApiAddress = new U8ApiAddress(“裝載單據(jù)的地址標識 ”)。 ?? //調(diào)用 UPDATE接口 API if (!()) { ?? } 最后，獲取返回結(jié)果 。 (u8Login)。 方法二是構(gòu)造 BusinessObject對象，具體方法如下： //首先通過 GetBoParam方法獲取表頭表體參數(shù) BusinessObject DomHead = (DomHead)。 //修改日期， DateTime類型 ?? 2) 給 普通參數(shù)賦值 例如， //給普通參數(shù) VoucherState（參數(shù)名） 賦值。 //todo:異常處理 } } //結(jié)束本次調(diào)用 ， 釋放 API資源 ()。 3) 獲取 普通 “ OUT 型”或 “ INOUT 型” 返回值 如前所述 ， 對普通 “ OUT型 ” 或 “ INOUT 型” 參數(shù)，如果是一般值類型，則通過 GetResult 方法獲取其返回值，否則直接使用該 引用。 String sUserID = demo。 5． API 對象參數(shù)賦值 1) 給 BO 表頭參數(shù) DomHead 和表體參數(shù) domBody 賦值 有兩種方法，如下 ： 方法一是直接傳入 ，代碼如下 domHead = new ()。 //預(yù)發(fā)貨日期， DateTime類型 ?? 2) 給 普通參數(shù)賦值 例如， //給普通參數(shù) VoucherState（參數(shù)名） 賦值。 //todo:異常處理 } } //結(jié)束本次調(diào)用 ， 釋放 API資源 ()。 //稅率， double類型 string cexch_name = (domHeadRet[0][cexch_name])。 //登陸 String sAccID = (default)001。 ()。 //審核時間， DateTime類型 ?? 2) 給 普通參數(shù)賦值 例如， 給普通參數(shù) sVouchType（參數(shù)名） 賦值 ： (sVouchType, new ())。 return。 //制單時間， DateTime類型 DateTime dnmodifytime = (DomHeadRet[0][dnmodifytime])。 //審核時間， DateTime類型 ?? 2) 獲取 普通返回值 代碼如下： //獲取普通返回值。 7． 獲取返回結(jié)果 1) 獲取 BO 對象 在 “ 裝載單據(jù) ” 時，通過 GetBoParam 方法獲取表頭或表體參數(shù) BusinessObject DomHeadRet = (DomHead)。 3) 給“ OUT 型 ” 參數(shù)賦值 為方便用戶使用 U8API，如果參數(shù) 數(shù)據(jù)類型為一般值類型，如 String、 Integer、 Long、Single、 Double、 Boolean、 Date， 則不必傳入一個參數(shù)變量 （傳入也可）；否則，則必須 一個參數(shù)變量。 方法二是構(gòu)造 BusinessObject對象，具體方法如下： //首先通過 GetBoParam方法獲取表頭表體參數(shù) BusinessObject DomHead = (DomHead)。 String sUserID = demo。此返回值數(shù)據(jù)類型為 ，此參數(shù)按值傳遞，具體請參考服務(wù)接口定義 result = () as 。 } 注意 ： 對調(diào)用失敗 ， 可以獲取出錯信息 ， 如果是 API 框架的原因 ， 則報告 MomSysException 異常，如果是業(yè)務(wù)組件的原因，則報告 MomBizException 異常。 注意： 所有 參數(shù)名不限大小寫 。 (domHead, domHead)。 String sDate = 20200930。此返回值數(shù)據(jù)類型為 string，在使用該參數(shù)之前，請判斷是否為空 string curIDRet = (curID) as string。 } 注意： 對調(diào)用失敗，可以獲取出錯信息，如果是 API 框架的原因，則報告 MomSysException 異常，如果是業(yè)務(wù)組件的原因，則報告 MomBizException 異常。 注意： 所有 參數(shù)名不限大小寫 。 //設(shè)置行數(shù) //其中，給 BO對象的字段賦值，值可以是真實類型，也可以是無類型字符串 //以下代碼示例只設(shè)置第一行值。 } 如果當前環(huán)境中有 login 對象則可以省去第一步。 //獲取 out/inout 參數(shù)值 ?? //結(jié)束本次調(diào)用，釋放 API資源 ()。 //API參數(shù)賦值 (參數(shù)名 , 參數(shù)值 )。 代碼示例： 首先，登陸； //構(gòu)造 u8login 對象并登陸 u8Login = new ()。 //訂單編號， string類型 ?? /***************************** 以下是非必輸字段 ****************************/ DomHead[0][ipresent] = 。 (1) C： %U8SOFT%\Interop\、 %U8SOFT%\Interop\、 %U8SOFT%\UFMOM\U8APIFramework\、 %U8SOFT%\UFMOM\U8APIFramework\、 %U8SOFT%\UFMOM\U8APIFramework\UF 如下圖 、 、 所示。 本產(chǎn)品向外提供 一套完整統(tǒng)一的標準 U8 API 調(diào)用接口，以便基于 U8 標準 API 資源，采用統(tǒng)一編程模型和開發(fā)規(guī)范，為企業(yè)提供應(yīng)用集成和個性化功能擴展增值服務(wù)，打造量體合身的信息系統(tǒng)。 圖 添加 對 引用 圖 添加 對 引用 圖 添加 對 U8API 框架類庫引用 （ .dll） 圖 添加 對 U8API 框架類庫引用 (.tlb) 圖 添加 Microsoft XML 引用 ? API 調(diào)用 添加必要的引用后， 可以直接利用自動生成的代碼示例（支持 C和 VB 兩種語言），結(jié)合 API 接口詳細 描述，填入必要的參數(shù)值，就可以調(diào)用 U8 API。 //修改時間， DateTime類型 ?? 在此種情況下 U8 API框架會對 BO對象各字段進行參數(shù)校驗。 String sYear = 2020。 (系統(tǒng)異常： + )。 ? 使用環(huán)境 必須安裝 .NET FrameWork ； 必須安裝 U8872 版本的 采購 管理產(chǎn)品； 必須安裝 API 適配器組件 ? 接口 說明 采購管理二次開發(fā)接口說明： ? 審核單據(jù) ConfirmPO 方法 參數(shù)： domHead —— 單據(jù)表頭， DOM 對象，必輸 A