[用友资料]u8api开发手册

[用友资料]u8api开发手册内容摘要：

以通过 GetResult(参数名 )获取其值 ；当不 必传入一个参数变量时，在 API调用返回时，可以直接引用 该参数。 4) 给“ INOUT 型 ” 参数赋值 对“ INOUT 型 ”型参数，则不论是否是一般值类型，都需要传入参数变量。 其他与“ OUT型 ” 参数 一样。 6． 调用 API //示例调用如下： if (!()) { //错误处理 Exception apiEx = ()。 if (apiEx != null) { if (apiEx is MomSysException) { MomSysException sysEx = apiEx as MomSysException。 (系统异常 ： + )。 //todo:异常处理 } else if (apiEx is MomBizException) { MomBizException bizEx = apiEx as MomBizException。 (API异常 ： + )。 //todo:异常处理 } } //结束本次调用 ， 释放 API资源 ()。 return。 } 注意： 对调用失败，可以获取出错信息，如果是 API 框架的原因，则报告 MomSysException 异常，如果是业务组件的原因，则报告 MomBizException 异常。 7． 获取返 回结果 1) 获取 BO 对象 在 “ 装载单据 ” 时，通过 GetBoParam 方法获取表头或表体参数 BusinessObject DomHeadRet = (DomHead)。 (BO对象行数为： + )。 //获取 BO对象的行数 注意： 如果要取原始的 XMLDOM对象结果，请使用 GetResult(DomHead) as DomHeadRet = broker. GetResult(DomHead) as。 以上获取的行数是 BO对象的实际行数。 //获取 BO 对象各字段的值。 以下代码示例只取第一行。 字段定义详见 API 服务接口定义 /****************************** 以下是必输字段 ****************************/ int poid = (DomHeadRet[0][poid])。 //主关键字段 ， int类型 DateTime dpodate = (DomHeadRet[0][dpodate])。 //日期， DateTime类型 string cpoid = (DomHeadRet[0][cpoid])。 //订单编号， string类型 „„ /***************************** 以下是非必输字段 ****************************/ string ipresent = (DomHeadRet[0][ipresent])。 //现存量， string类型 DateTime cmaketime = (DomHeadRet[0][cmaketime])。 //制单时间， DateTime类型 „„ 2) 获取 普通返回值 代码如下： //获取普通返回值。 此返回值数据类型为 ，此参数按值传递，具体请参考服务接口定义 result = () as。 3) 获取 普通 “ OUT 型”或 “ INOUT 型” 返回值 如前所述 ， 对普通 “ OUT型 ” 或 “ INOUT 型” 参数，如果是一般值类型，则通过 GetResult 方法获取其返回值，否则直接使用该 引用。 如， //获取普通 OUT参数 curID。 此返回值数据类型为 string，在使用该参数之前，请判断是否为空 string curIDRet = (curID) as string。 //获取普通 OUT参数 CurDom。 此返回值数据类型为 ，前面已定义该参数，请直接使用 „„ 销售 管理  功能介绍 为了支持 U8 二次开发对业务单据的开发，本功能提供了实现销售业务单据各种操作功能的编程接口。 使用销售管理 API 开发接口，可以完成销售管理的销售报价单、销售订单、销售发货单、销售退货单、销售普通发票、销售专用发票、委托代销发货单、委托代销结算单、销售调拨单等单据的 审核、弃审、 获取、 新增、 修改、删除。  使用环境 必须安装 .NET FrameWork ； 必须安装 U8872 版本的销售管理产品； 必须安装 API 适配器组件 ；  接口 说明 销售管理二次开发接口及参数说明：  审核或弃审单据 Audit 方法 参数： domHead —— 单据表头， DOM 对象，必输 bVerify —— 审核 /弃审标志，必输。 true 表 审核 ； false 表 弃审 API 上下文： VoucherType —— 单据类型，必输。 具体类型参看 API 上下文 描述  删除单据 Delete 方法 参数： domHead —— 单据表头， DOM 对象，必输 API 上下文： VoucherType —— 单据类型，必输。 具体类型参看 API 上下文 描述  装载单据 Load 方法 参数： domHead —— 单据表头， DOM 对象，必输 domBody —— 单据表体， DOM 对象，必输 VouchID —— 需要装载的单据号，可选 blnAuth —— 是否控制权限： true API 上下文： VoucherType —— 单据类型，必输。 具体类型参看 API 上下文 描述  新增或 修改单据 Save 方法 参数： domHead —— 单据表头， DOM 对象，必输 domBody —— 单据表体， DOM 对象，必输 VoucherState —— 保存状态，必输。 0 增加； 1 修改 VNewID —— 单据的 id，可选 DomConfig —— ATO,PTO 选配配置，必输，可设置为 nothing API 上下文： VoucherType —— 单据类型，必输。 具体类型参看 API 上下文 描述  开发步骤 实现 销售 单据某一功能，主要有以下七个步骤： 1． 构造 u8login 对象并登陆 声明和创建 u8login 类对象前应该先 引用 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。 } 如果当前环境中有 login 对象则可以省去第一步。 2． 构造环境上下文对象，传入 login，并按需设置其它上下文参数 U8EnvContext envContext = new U8EnvContext()。 //构造环境上下文对象 = u8Login。 //传入 login //设置上下文参数 (VoucherType, new int())。 //上下文数据类型 ： int， 含义 ： 单据类型 如果是外部事务，则需要传递 ，并将 IsIndependenceTransaction设置为 true： = new ()。 = true。 3． 设置 API 地址标识 (Url)参数 //如当前 API“ 新增或修改 ” 的地址标识为： U8API/SaleOrder/Save U8ApiAddress myApiAddress = new U8ApiAddress(U8API/SaleOrder/Save)。 4． 构造 APIBroker U8ApiBroker broker = new U8ApiBroker(myApiAddress, envContext)。 5． API 对象参数赋值 1) 给 BO 表头参数 DomHead 和表体参数 domBody 赋值 有两种方法，如下 ： 方法一是直接传入 ，代码如下 domHead = new ()。 ()。 (domHead, domHead)。 方法二是构造 BusinessObject对象，具体方法如下： //首先通过 GetBoParam方法获取表头表体参数 BusinessObject DomHead = (DomHead)。 = 10。 //设置行数 //其中，给 BO对象的字段赋值，值可以是真实类型，也可以是无类型字符串 //以下代码示例只设置第一行值。 各字段定义详见 API服务接口定义 注意： 设置行数为某个值， 行数 并不限定 为 该最大值，可以一直顺序添加至任意行，但 有 一个规则 ：例如当设置为 10时，可以对第 0、 „„ 9行赋值，当对第 10行赋值时候，则会顺序添加一个新行，但此时是不能对第 11行赋值的，当添加一个新行 （第 10行） 后，又可以对第 11行进行赋值。 /****************************** 以下是必输字段 ****************************/ domHead[0][id] =。 //主关键字段， int类型 domHead[0][csocode] =。 //订 单 号， string类型 domHead[0][ddate] =。 //订单日期， DateTime类型 domHead[0][cbustype] =。 //业务类型， string类型 „„ /***************************** 以下是非必输字段 ****************************/ domHead[0][fstockquanO] =。 //现存件数， double类型 domHead[0][fcanusequanO] =。 //可用件数， double类型 domHead[0][dpredatebt] =。 //预发货日期， DateTime类型 domHead[0][dpremodatebt]。