【正文】 TE接口 API if (!()) { ?? } 最后，獲取返回結(jié)果 。 //獲取普通返回值 result = () as 。 //獲取 out/inout 參數(shù)值 ?? //結(jié)束本次調(diào)用，釋放 API資源 ()。 . API內(nèi)容 采購 管理 ? 功能介紹 為了支持 U8 二次開發(fā)對業(yè)務(wù)單據(jù)的開發(fā)，本功能提供了 實(shí)現(xiàn)采購業(yè)務(wù)單據(jù)各種操作功能的編程接口。 使用采購管理的 API 開發(fā)接口，可以對庫存管理中的采購到貨單、采購普通發(fā)票、采購專用發(fā)票、采購訂單、請購單、采購運(yùn)費(fèi)發(fā)票等 單據(jù)進(jìn)行 審核、棄審、 獲取（或裝載）、新增、 修改、刪除。 ? 使用環(huán)境 必須安裝 .NET FrameWork ； 必須安裝 U8872 版本的 采購 管理產(chǎn)品； 必須安裝 API 適配器組件 ? 接口 說明 采購管理二次開發(fā)接口說明： ? 審核單據(jù) ConfirmPO 方法 參數(shù)： domHead —— 單據(jù)表頭， DOM 對象，必輸 API 上下文： VoucherType —— 單據(jù)類型， 具體類型參看 API 上下文 描述 bPositive —— 紅藍(lán)標(biāo)識： True,藍(lán)字 ； False,紅字 sBillType —— 為空串 sBusType —— 業(yè)務(wù)類型：普通采購 ,直運(yùn)采購 ,受托代銷 ? 棄審單據(jù) CancelconfirmPO 方法 參數(shù)： domHead —— 單據(jù)表頭， DOM 對象，必輸 API 上下文： VoucherType —— 單據(jù)類型， 具體類型參看 API 上下文 描述 bPositive —— 紅藍(lán)標(biāo)識： True,藍(lán)字 ； False,紅字 sBillType —— 為空串 sBusType —— 業(yè)務(wù)類型：普通采購 ,直運(yùn)采購 ,受托代銷 ? 裝載單據(jù) Load 方法 參數(shù)： DomHead —— 表頭 DOM 對象 domBody —— 表體 DOM 對象 strWhere —— 過濾條件串 varVoucherID —— 單據(jù)主表 ID strLocateWhere —— 定位條件串 API 上下文： VoucherType —— 單據(jù)類型， 具體類型參看 API 上下文 描述 bPositive —— 紅藍(lán)標(biāo)識： True,藍(lán)字 ； False,紅字 sBillType —— 為空串 sBusType —— 業(yè)務(wù)類型：普通采購 ,直運(yùn)采購 ,受托代銷 ? 刪除單據(jù) Delete 方法 參數(shù)： DomHead —— 表頭 DOM 對象 domBody —— 表體 DOM 對象 CurDom —— 返回 DOM 格式錯(cuò)誤信息 API 上下文： VoucherType —— 單據(jù)類型， 具體類型參看 API 上下文 描述 bPositive —— 紅藍(lán)標(biāo)識： True,藍(lán)字 ； False,紅字 sBillType —— 為空串 sBusType —— 業(yè)務(wù)類型：普通采購 ,直運(yùn)采購 ,受托代銷 ? 新增或修改 新單據(jù) VoucherSave 方法 參數(shù)： DomHead —— 單據(jù)表頭， DOM 對象，必輸 domBody —— 單據(jù)表體， DOM 對象，必輸 VoucherState —— 保存狀態(tài)，必輸。 2 增加； 1 修改 ； 0 非編輯 curID —— 返回單據(jù)頭 ID CurDom —— 返回 DOM 格式錯(cuò)誤信息 UserMode —— 使用模式 ， 0： CS； 1:BS API 上下文： VoucherType —— 單據(jù)類型， 具體類型參看 API 上下文 描述 bPositive —— 紅藍(lán)標(biāo)識： True,藍(lán)字 ； False,紅字 sBillType —— 為空串 sBusType —— 業(yè)務(wù)類型：普通采購 ,直運(yùn)采購 ,受托代銷 ? 開發(fā)步驟 實(shí)現(xiàn)采購單據(jù)某 一功能，主要有以下 七 個(gè)步驟： 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，并按需設(shè)置其它上下文參數(shù) U8EnvContext envContext = new U8EnvContext()。 //構(gòu)造環(huán)境上下文對象 = u8Login。 //傳入 login //設(shè) 置上下文參數(shù) (VoucherType, new int())。 //上下文數(shù)據(jù)類型 ： int， 含義 ： 單據(jù)類型 (bPositive, new bool())。 //上下文數(shù)據(jù)類型 ： bool， 含義 ： 紅藍(lán)標(biāo)識 ： True,藍(lán)字 (sBillType, new string())。 //上下文數(shù)據(jù)類型 ： string， 含義 ： 為空串 (sBusType, new string())。 //上下文數(shù)據(jù)類型 ： string， 含義 ： 業(yè)務(wù)類型 ： 普通采購 ,直運(yùn)采購 ,受托代銷 如果是外部事務(wù)，則需要傳遞 ，并將 IsIndependenceTransaction設(shè)置為 true： = new ()。 = true。 3． 設(shè)置 API 地址標(biāo)識 (Url)參數(shù) //如當(dāng)前 API“ 新增或修改 ” 的地址標(biāo)識為： U8API/PurchaseOrder/VoucherSave U8ApiAddress myApiAddress = new U8ApiAddress(U8API/PurchaseOrder/VoucherSave)。 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í)類型，也可以是無類型字符串 //以下代碼示例只設(shè)置第一行值。各字段定義詳見 API服務(wù)接口定義 注意： 設(shè)置行數(shù)為某個(gè)值， 行數(shù) 并不限定 為 該最大值，可以一直順序添加至任意行，但 有 一個(gè)規(guī)則 ：例如當(dāng)設(shè)置為 10時(shí)，可以對第 0、 ?? 9行賦值，當(dāng)對第 10行賦值時(shí)候，則會順序添加一個(gè)新行，但此時(shí)是不能 對第 11行賦值的 ，當(dāng)添加一個(gè)新行 （第 10行） 后，又可以對第 11行進(jìn)行賦值。 /****************************** 以下是必輸字段 ****************************/ DomHead[0][poid] = 。 //主關(guān)鍵字段， int類型 DomHead[0][dpodate] = 。 //日期， DateTime類型 DomHead[0][cpoid] = 。 //訂單編號， string類型 DomHead[0][cvenabbname] = 。 //供貨單位， string類型 DomHead[0][cexch_name] = 。 //幣種， string類型 DomHead[0][nflat] = 。 //匯率， double類型 ?? /***************************** 以下是非必輸字段 ****************************/ DomHead[0][ipresent] = 。 //現(xiàn)存量， string類型 DomHead[0][cmaketime] = 。 //制單時(shí)間， DateTime類型 DomHead[0][cmodifytime] = 。 //修改時(shí)間， DateTime類型 DomHead[0][caudittime] = 。 //審核時(shí)間， DateTime類型 DomHead[0][cauditdate] = 。 //審核日期， DateTime類型 DomHead[0][cmodifydate] = 。 //修改日期， DateTime類型 ?? 2) 給 普通參數(shù)賦值 例如， //給普通參數(shù) VoucherState（參數(shù)名） 賦值。此參數(shù)的數(shù)據(jù)類型為 int，此參數(shù)按值傳遞，具體請參考服務(wù)接口定義 (VoucherState, new int())。 注意： 所有 參數(shù)名不限大小寫 。 3) 給“ OUT 型 ” 參數(shù)賦值 為方便用戶使用 U8API， 如果 參數(shù) 數(shù)據(jù)類型為一般值類型， 如 String、 Integer、 Long、Single、 Double、 Boolean、 Date， 則 不必傳入一個(gè)參數(shù)變量 （傳入也可）；否則，則必須 一個(gè)參數(shù)變量。 如： ?? //該參數(shù) curID為 OUT型參數(shù)，由于其數(shù)據(jù)類型為 string，為一般值類型，因此不必傳入一個(gè)參數(shù)變量。在 API調(diào)用返回時(shí)，可以通過 GetResult(curID)獲取其值 //該參數(shù) CurDom為 OUT型參數(shù)，由于其數(shù)據(jù)類型為 ，非一般值類型，因此必須傳入一個(gè)參數(shù)變量。在 API調(diào)用返回時(shí)，可以直接使用該參數(shù) CurDom = new ()。 (CurDom, CurDom)。 ?? 當(dāng)不 傳入一個(gè)參數(shù)變量 時(shí)， 在 API調(diào)用返回時(shí)，可