【正文】 LOAD 接口獲取 BO 對(duì)象； //構(gòu)造環(huán)境上下文對(duì)象，傳入 login，并按需設(shè)置其它上下文參數(shù) U8EnvContext envContext = new U8EnvContext()。 (u8Login)。 String sSerial = 。 String sDate = 20200930。 String sUserID = demo。 String sAccID = (default)001。 代碼示例： 首先，登陸； //構(gòu)造 u8login 對(duì)象并登陸 u8Login = new ()。比如，自定義的單據(jù)維護(hù)界面的主要邏輯，一般由以下四個(gè)步驟構(gòu)成： 1) 加載單據(jù)； 2) 在編輯界面上顯示； 3) 用戶(hù)修改單據(jù)字段； 4) 提交保存。這是 API 調(diào)用最常見(jiàn)的場(chǎng)景，只需按照 API 的接口規(guī)范構(gòu)造參數(shù)直接調(diào)用即可。請(qǐng)?jiān)谑褂迷摲椒ㄖ?，確保 DOM對(duì)象的正確性。 (domHead, domHead)。 例如： domHead = new ()。對(duì)字段進(jìn)行賦值時(shí)， 值可以是真實(shí)類(lèi)型，也可以是無(wú)類(lèi)型字符串 。 //制單時(shí)間， DateTime類(lèi)型 DomHead[0][cmodifytime] = 。 //訂單編號(hào)， string類(lèi)型 ?? /***************************** 以下是非必輸字段 ****************************/ DomHead[0][ipresent] = 。 //主關(guān)鍵字段， int類(lèi)型 DomHead[0][dpodate] = 。 //設(shè)置行數(shù) ，不設(shè)置也可 //給 BO對(duì)象的字段賦值，值可以是真實(shí)類(lèi)型，也可以是無(wú)類(lèi)型字符串 //以下代碼示例只設(shè)置第一行值。 例如： BusinessObject DomHead = (DomHead)。 對(duì) BO 參數(shù) ， 支持兩種方式傳入，一種傳 BO 對(duì)象，另一種傳 DOM 對(duì)象 。 ? BO 參數(shù)賦值 API 參數(shù)分兩種類(lèi)型： BO 參數(shù) 和 普通參數(shù) 。 總體上，對(duì) U8 API 的調(diào)用分成七個(gè)步驟： 1) 構(gòu)造 u8login 對(duì)象并登陸 ； 2) 構(gòu)造環(huán)境上下文對(duì)象，傳入 login，并按需設(shè)置其它上下文參數(shù) ； 3) 設(shè)置 API 地址標(biāo)識(shí) (Url)參數(shù) ； 4) 構(gòu)造 APIBroker； 5) API 參數(shù)賦值； 6) 調(diào)用 API； 7) 獲取返回結(jié)果 。 其中， %U8SOFT%表示 U8872 的安裝目錄。 (1) C： %U8SOFT%\Interop\、 %U8SOFT%\Interop\、 %U8SOFT%\UFMOM\U8APIFramework\、 %U8SOFT%\UFMOM\U8APIFramework\、 %U8SOFT%\UFMOM\U8APIFramework\UF 如下圖 、 、 所示。 以下代碼中均以 C為例， VB 語(yǔ)言請(qǐng)具體查看對(duì)應(yīng)的 VB 代碼示例部分。 利用這些代碼 示例時(shí)，請(qǐng)按照其中每一步驟的提示說(shuō)明正確操作，如添加必要的引用、按照自動(dòng)生成的代碼填入正確的參數(shù)等。在節(jié)點(diǎn)上右鍵單擊彈出“上下文菜單”，在“代碼示例”菜單項(xiàng)上彈出下一級(jí)子菜單，單擊它們，如單擊“ C代 碼示例”則可以看到調(diào)用該 API 的 C示例代碼，如下圖 所示。在左側(cè) “ U8API” 樹(shù)形節(jié)點(diǎn)下，找到 某某模塊，如 “庫(kù)存管理”模塊（可以看到下面列有很多個(gè)單據(jù)，如盤(pán)點(diǎn)單、采購(gòu)入庫(kù)單等），展開(kāi)要操作的單據(jù)，分兩個(gè)子節(jié)點(diǎn)：“事件”和“服務(wù)接口”，在“服務(wù)接口”下可以看到該單據(jù)提供的 API 接口，如“添加新單據(jù)”、“審核單據(jù)”等。 下面 主要介紹 如何使用 U8API 進(jìn)行 個(gè)性化 開(kāi)發(fā)， 如何對(duì) U8API 進(jìn)行調(diào)用 ， 同時(shí)給出 使用過(guò)程 中 需要 注意 的 內(nèi)容 。 在分類(lèi)體系上，本產(chǎn)品向外提供的 U8 API資源主要按照功能模塊以及各個(gè)單據(jù)進(jìn)行劃分，如庫(kù)存管理下的盤(pán)點(diǎn)單，提供“添加新 單據(jù)”、“審核單據(jù)”、“棄審單據(jù)”、“刪除單據(jù)”、“裝載單據(jù)”和“修改單據(jù)”這樣六個(gè)標(biāo)準(zhǔn)的 API 接口 ， 以 供客戶(hù) 調(diào)用 。 U8API 開(kāi)發(fā)手冊(cè) “ U8API 資源管理器”是一個(gè)為 U8 客戶(hù)化應(yīng)用開(kāi)發(fā)提供統(tǒng)一的 U8API 資源查詢(xún)、訪問(wèn)、調(diào)用規(guī)范等服務(wù)的平臺(tái)化工具產(chǎn)品。 本產(chǎn)品向外提供 一套完整統(tǒng)一的標(biāo)準(zhǔn) U8 API 調(diào)用接口，以便基于 U8 標(biāo)準(zhǔn) API 資源，采用統(tǒng)一編程模型和開(kāi)發(fā)規(guī)范，為企業(yè)提供應(yīng)用集成和個(gè)性化功能擴(kuò)展增值服務(wù)，打造量體合身的信息系統(tǒng)。 客戶(hù)可以在“ U8API 資源管理器”中查看要調(diào)用的 API 接口描述，同時(shí)可以獲取調(diào)用 該 API 的代碼示例（目前支持兩種語(yǔ)言 C和 VB）， 客戶(hù) 只需要 結(jié)合 API 接口描述并 按照代碼注釋中給出的提示 步驟 進(jìn)行操作就可以方便的使用 U8 API 資源。 用 . API總體應(yīng)用過(guò)程 API 查找發(fā)現(xiàn) 在 U8 產(chǎn)品中“ UAP”目錄下找到“ U8API 資源管理器”，單擊，登錄，進(jìn)入“ U8API 資源管理器”。雙擊這些節(jié)點(diǎn)出現(xiàn)該 API 的詳細(xì)描述，如下圖 所示。 直接拷貝這些代碼，然后在 集成開(kāi)發(fā)環(huán)境（ IDE） 中編輯 和編譯 這些代碼 ，即 能 實(shí)現(xiàn)調(diào)用 U8 標(biāo)準(zhǔn) API。正確使用則可以 調(diào)用 成功，否則會(huì)返回 詳細(xì)的 錯(cuò)誤信息。 圖 接口描述 圖 代碼示例 API 調(diào)用過(guò)程 ? 組件 引用 針對(duì)兩種語(yǔ)言 ，需要引用不同的組件。 （ 2） VB： %U8SOFT%\UFMOM\U8APIFramework\. tlb 、 %U8SOFT%\UFMOM\U8APIFramework\. tlb、 %U8SOFT%\UFMOM\U8APIFramework\. tlb、 添加 Microsoft XML 引用 如下圖 、 所示。 圖 添加 對(duì) 引用 圖 添加 對(duì) 引用 圖 添加 對(duì) U8API 框架類(lèi)庫(kù)引用 （ .dll） 圖 添加 對(duì) U8API 框架類(lèi)庫(kù)引用 (.tlb) 圖 添加 Microsoft XML 引用 ? API 調(diào)用 添加必要的引用后， 可以直接利用自動(dòng)生成的代碼示例（支持 C和 VB 兩種語(yǔ)言），結(jié)合 API 接口詳細(xì) 描述，填入必要的參數(shù)值，就可以調(diào)用 U8 API。 詳細(xì)的 API 調(diào)用過(guò)程請(qǐng)看下文“ API 內(nèi)容”中各個(gè)模塊中介紹的“開(kāi)發(fā)步驟”。 BO 參數(shù) 即單據(jù)表頭或表體類(lèi)型的參數(shù)， 普通參數(shù) 則是非表頭表頭類(lèi)型的參數(shù) 。 以下分別介紹： (1) 傳 BO對(duì)象 給 BO 表頭參數(shù) 或 表體參數(shù) 賦值，推薦使用 BO 對(duì)象（ BussinessObject）。 = 10。各字段定義詳見(jiàn) API服務(wù)接口定義 /****************************** 以下是必輸字段 ****************************/ DomHead[0][poid] = 。 //日期， DateTime類(lèi)型 DomHead[0][cpoid] = 。 //現(xiàn)存量， string類(lèi)型 DomHead[0][cmaketime] = 。 //修改時(shí)間， DateTime類(lèi)型 ?? 在此種情況下 U8 API框架會(huì)對(duì) BO對(duì)象各字段進(jìn)行參數(shù)校驗(yàn)。 (2) 傳 DOM 對(duì)象 給 BO 表頭參數(shù) 或 表體參數(shù) 賦值，也支持直接傳入 DOM 對(duì)象（ DOMDocument）。 ()。 但是 ，在此種情況下 U8 API框架不會(huì)對(duì) DOM對(duì)象進(jìn)行參數(shù)驗(yàn)證。 API 典型應(yīng)用場(chǎng)景 ? 執(zhí)行單一操作 單一操作指一項(xiàng)任務(wù)只需要一個(gè) API 完成，比如：?jiǎn)螕?jù)新增、 審核 /棄審、刪除等單一操作。 ? 執(zhí)行復(fù)合操作 復(fù)合操作， 即一項(xiàng)任務(wù)由多個(gè) API 的協(xié)作來(lái)完成。 以上步驟需要進(jìn)行兩次 API 調(diào)用： 1) 加載單據(jù)時(shí)候調(diào)用“加載 API”，以獲取單據(jù) BO 對(duì)象（或原始 DOM 對(duì)象）并在界面上展現(xiàn)； 2) 用戶(hù)在修改單據(jù)時(shí)其實(shí)就是在修改 BO 對(duì)象，用戶(hù)保存單據(jù)時(shí)調(diào)用“保存 API”，此時(shí)要將此 BO 對(duì)象傳給“ 保存 API”（而不用構(gòu)造新的 BO 對(duì)象）。 String sSubId = AS。 String sYear = 2020。 String sPassword = 。 String sServer = localhost。 if (!(ref sSubId, ref sAccID, ref sYear, ref sUserID, ref sPassword, ref sDate, ref sServer, ref sSerial)) { (登陸失敗，原因： + )。 return。 = u8Login。 //構(gòu)造 APIBroker U8ApiBroker broker = new U8ApiBroker(myApiAddress, envContext)。 ?? //調(diào)用 LOAD接口 API if (!()) { //錯(cuò)誤處理 Exception apiEx = ()。 (系統(tǒng)異常： + )。 (API異常： + )。 return。 接著， BO 對(duì)象經(jīng)用戶(hù)修改重新賦值 ,并傳遞給 UPDATE 接口提交保存； //修改獲取的 BO對(duì)象，對(duì)需要更改的字段重新賦值 DomRet[0][字段名 ] = 新的字段值 。 //重新構(gòu)造 APIBroker broker = new U8ApiBroker(myApiAddress, envContext)。 //API參數(shù)賦值 (參數(shù)名 , 參數(shù)值 )。 //獲取普通返回值 result = () as 。 . API內(nèi)容 采購(gòu) 管理 ? 功能介紹 為了支持 U8 二次開(kāi)發(fā)對(duì)業(yè)務(wù)單據(jù)的開(kāi)發(fā)，本功能提供了 實(shí)現(xiàn)采購(gòu)業(yè)務(wù)單據(jù)各種操作功能的編程接口。 ? 使用環(huán)境 必須安裝 .NET FrameWork ； 必須安裝 U8872 版本的 采購(gòu) 管理產(chǎn)品； 必須安裝 API 適配器組件 ? 接口 說(shuō)明 采購(gòu)管理二次開(kāi)發(fā)接口說(shuō)明： ? 審核單據(jù) ConfirmPO 方法 參數(shù)： domHead —— 單據(jù)表頭， DOM 對(duì)象，必輸 API 上下文： VoucherType —— 單據(jù)類(lèi)型， 具體類(lèi)型參看 API 上下文 描述 bPositive —— 紅藍(lán)標(biāo)識(shí)： True,藍(lán)字 ； False,紅字 sBillType —— 為空串 sBusType —— 業(yè)務(wù)類(lèi)型：普通采購(gòu) ,直運(yùn)采購(gòu) ,受托代銷(xiāo) ? 棄審單據(jù) CancelconfirmPO 方法 參數(shù)： domHead —— 單據(jù)表頭， DOM 對(duì)象，必輸 API 上下文： VoucherType —— 單據(jù)類(lèi)型， 具體類(lèi)型參看 API 上下文 描述 bPositive —— 紅藍(lán)標(biāo)識(shí)： True