如何查找和使用U8的API.docx
《如何查找和使用U8的API.docx》由会员分享，可在线阅读，更多相关《如何查找和使用U8的API.docx（14页珍藏版）》请在冰豆网上搜索。
如何查找和使用U8的API
如何查找和使用U８的AＰＩ
————————————————————————————————作者：
————————————————————————————————日期：
ﻩ
如何查找和使用U８的AＰI
摘要
客户化开发中常常有将某些数据经过加工后存储至U8标准单据中的需求，通常客开人员是通过将数据插入物理表的方式进行，这时插入的数据未经系统的业务校验，为后续操作埋下诸多隐患。
U8的AＰＩ接口，则是提供给客开操作系统单据的一个接口，客开只需将数据组织好,系统校验、增、删、改等操作都有不同的AＰI接口来实现,调用相应API就可以完成操作。
如何使用API
a）AＰI位置
如下图所示:
b）AＰI接口描述
选择服务接口，右键,可以查看该接口的描述、代码示例，如下图所示：
c）API参考代码示例
实际应用
本文以Ｃ#代码为例,数据源采用系统中已存在单据做为数据源进行讲解。
调用ＡPＩ代码示例
///＜sumｍａry>
/// 销售订单（业务类型报错）
／／／
///
／//＜/ｐaram>
pｕbｌicstaｔicvoidAddＳＯ_SＯＭaiｎ（U8Lｏgｉn.cｌsLoginu８Logｉn,Stｒiｎｇｉd, ｒef sｔringvＮewIDRｅt）
{
//第二步:
构造环境上下文对象,传入loｇin，并按需设置其它上下文参数
U8EnvＣontｅxtenvＣoｎtext=newU8EnvContexｔ（）;
ｅｎvCｏntｅxt．Ｕ8Logｉｎ= u８Lｏgin;
//销售所有接口均支持内部独立事务和外部事务，默认内部事务
//如果是外部事务，则需要传递AＤO.Connectiｏn对象，并将IｓＩndｅｐeｎｄenｃeTransａctｉon属性设置为false
//ｅnvConteｘt.BizDbＣonｎeｃｔｉon ＝newADＯ.Cｏnnecｔｉoｎ（）;
／/ｅnvContｅxt．IｓIndependｅncｅTransacｔｉｏｎ= ｆａlｓe;
／/设置上下文参数
envＣontext.SeｔAｐｉＣｏntexｔ（"ＶｏuｃherType"，１2）；/／上下文数据类型：
int,含义:
单据类型:
１2
／/第三步:
设置API地址标识（Url）
/／当前ＡPＩ:
新增或修改的地址标识为:
Ｕ8API/SaleOrder/Savｅ
U8AｐｉAdｄｒesｓmyApiAdｄreｓs=newU8ApiAddress（"U8API/SalｅOｒder/Save"）;
//第四步：
构造AＰIBroker
U８ApiBroｋeｒbroker= ｎewU8ＡpiBrokeｒ（myＡpｉAddress，envContext）;
//第五步：
ＡPI参数赋值
/／给BO表头参数ｄomHeａd赋值，此BO参数的业务类型为销售订单，属表头参数。
ＢＯ参数均按引用传递
//提示：
给ＢＯ表头参数ｄomHeａd赋值有两种方法
//方法一是直接传入ＭＳXML2.ＤOMDｏcumenｔClass对象
//brokeｒ．AｓsignNoｒmalＶａlｕe（"dｏmHead", nｅｗ MＳXMＬ2.ＤＯＭDｏcumentCｌaｓs（））
ADＯDＢ.Connｅｃtiｏncｏｎｎ= ｎewADODB.ConｎeｃtionＣlass（）;
ADODB.Recordsｅｔrｓ = newADＯDB.RecoｒdsetＣlass（）；
MSXML2.DＯMDoｃumｅｎt domheａd =newＭSXML2.ＤOMＤocuｍｅｎtＣlasｓ（）;
stringstrＣoｎｎ= stｒinｇ.Formaｔ（"Provider＝ＳQLOLEDＢ;ＩnitialCatａlog={0};Daｔa Source={1}；＂，"ＵFDaｔa_"+ u8Lｏgiｎ.geｔ_cAcc_Iｄ（）+"_"+u8Lｏｇin.cIYｅaｒ，u８Login.ｄbServeｒNａme）;
conn.Oｐｅn（sｔｒConｎ,＂sａ", u8Logｉn.ＳysPaｓsworｄ,0）；
sｔrｉｎgｓql =＂ｓeｌｅｃｔｔop1*ｆrom SalｅOｒｄerＱｗｈｅrｅ id='＂＋id+"'＂;
rｓ.Open（ｓql,cｏｎn， AＤODB.ＣursｏrＴypeEnum．aｄＯｐenForｗardOｎly,AＤODB.LockTｙpeEｎum.adLockOptimistic,-1）；
ｒｓ．Ｓaｖe（domｈｅaｄ,ADＯDB.PersistFｏrmａｔEｎuｍ.aｄPersisｔXＭＬ）；
U８ＡＰＩHｅlper．FｏｒmatDom（ｒefｄｏｍｈeａd，＂A"）；
broｋer．AssigｎNormaｌVaｌue（＂DomHｅad＂，ｄomheaｄ）；
domhead.sｅlectＳｉngｌeＮode（"／/rs:
data／z:
ｒoｗ＂）.attriｂuteｓ．gｅtNａｍedItem（"iｄ"）.ｎodeVａluｅ ="";
ＭSXML２.DOMＤｏcumenｔdomＢodｙ＝ newMSXML2.ＤOＭDoｃumｅntClａss（）；
//domBody.RowＣｏuｎt=１;
ＡDOＤB.Ｃonnｅcｔｉoncoｎｎ１=newADODＢ．ConnectioｎClass（）;
ADＯDＢ.Ｒｅcordｓetrs1 = neｗADODB．ＲecｏｒdsetClａｓｓ（）;
sｔringstｒＣｏnｎ1= stｒｉng.Fｏrｍat（"Proviｄer=SＱＬOＬＥＤB;ＩnitiaｌCataｌoｇ={0};DataＳoｕｒce＝{1};＂，"UFData_＂ +u８Logｉｎ．gｅt＿cAcc_Id（）＋"_"+u８Login．ｃIYeaｒ,ｕ８Login.dbＳerverName）;
conn1.Open（stｒＣonn,"sa"，u8Login.ＳysPａｓｓｗord,０）;
sqｌ="ｓelｅｃtｔｏp 1*fromＳａleOｒdｅrＳＱwhｅre id＝'"+iｄ+ "＇"；
ｒs1．Opｅn（sql,conn,ＡDODB．CuｒsorTypeEnuｍ.aｄOpｅnＦorwardOnlｙ,ADODB.LoｃkTypeEnum．adLockＯpｔimistiｃ,－1）;
ｒs1.Saｖe（domBｏdy, AＤODB.PerｓistFormatEnum.adPeｒsiｓtＸＭＬ）;
Ｕ８AＰIＨelｐeｒ．ForｍaｔＤom（reｆｄomBｏdｙ， "A＂）;
ｂroker．ＡssiｇnNormalValｕｅ（"dｏmＢody",ｄoｍＢody）;
domBoｄy.sｅlｅctSingleNodｅ（"/／rs:
dａta/ｚ:
row＂）.attｒｉｂuｔes．gｅtNamｅdItｅm（"id"）.nodｅValｕe="＂；
ｄｏmBody.ｓeleｃtSinｇleNｏde（"/／rs:
daｔa/z:
row"）．atｔribｕtes.gｅｔNamedItem（"autoiｄ＂）.nｏdｅＶalue ＝ "";
／/给普通参数VｏucheｒＳｔａte赋值。
此参数的数据类型为iｎt,此参数按值传递,表示状态：
0增加;１修改
bｒokeｒ.AｓsiｇｎＮormalVａｌue（"ＶoｕchｅrStａte＂,0）;
／／该参数ｖNｅwＩＤ为IＮOＵＴ型普通参数。
此参数的数据类型为sｔｒiｎg，此参数按值传递。
在API调用返回时，可以通过ＧetReｓult（"vNｅwＩD"）获取其值
ｂrokｅr.AssignNoｒmａlＶａlue（"ｖＮｅwID"，＂"）;
//给普通参数DoｍConｆig赋值。
此参数的数据类型为MSXＭＬ2.IＸMLDOＭDocumｅｎt2,此参数按引用传递，表示ATO，ＰTO选配
ＭSXML2．IXMＬDOMDoｃumｅnt2 DoｍCoｎfig＝nｅwMSＸML2.ＤOMＤocumentClass（）;
broｋｅr.AssignＮｏｒmaｌVaｌue（＂DｏmCoｎfig＂,DomＣonfｉg）;
/／第六步:
调用AＰI
if（!
broker.Inｖoke（））
{
//错误处理
EｘcｅｐtionapiEx＝ｂrokｅr.GetExcｅption（）；
if （aｐiEx!
=null）
{
ｉｆ （aｐiEｘis MomSysＥxceptｉｏn）
{
MomSyｓExｃｅptiｏnｓysEx= apiEｘasMomＳｙsExｃepｔion;
Conｓole．ＷrｉtｅLiｎe（"系统异常:
＂ +sysEx.Ｍessaｇe）;
／/tｏdｏ:
异常处理
}
ｅlseif（ａpiExisＭomBiｚException）
｛
MomBizExceｐｔion biｚＥx = aｐiＥx asMoｍBizExceptｉon;
Console.ＷｒiｔeLine（"API异常：
"＋bizEx.Message）;
//todo:
异常处理
}
//异常原因
StｒingｅxRｅason=brｏkeｒ．GeｔExｃeｐtionStｒing（）;
if （eｘReason.Length!
= 0）
{
Coｎsoｌe.WriｔｅLiｎe（"异常原因:
"+ ｅxＲeason）；
}
｝
//结束本次调用，释放APＩ资源
ｂroker.Reｌeａse（）；
ｒｅturn;
}
／/第七步:
获取返回结果
//获取返回值
／/获取普通返回值。
此返回值数据类型为System.Sｔｒinｇ,此参数按值传递，表示成功为空串
stｒinｇreｓｕｌt = brｏkeｒ．GetReturnValue（）asSystem．Ｓtring;
/／获取oｕt/inｏut参数值
//获取普通INＯUＴ参数ｖNeｗID。
此返回值数据类型为string
升级会员 