鼎捷ERP集成知识点集成接口定义.pptx

集成开发;;整合概念_报文;整合概念_报文;整合概念_中间库;设计标准;集成接口需求关注要素;常见集成接口（第三方系统）;;T100API开发介绍;;2.T100RESTful接口;JSON是由道格拉斯构想设计、轻量级的资料交换语言，以文字为基础，且让人易于阅读。尽管JSON是Javascript的一个子集，新版的Genero2.5以上版本开始纳入标准支持JSON。

JSON用于描述数据结构，有以下形式

使用对象（object）：一个物件以{}为开始及结束

名称／值（collection）的集合

例如：

{name:value,

prod:T100}

名称和值之间使用「：」隔开

每个名称／值对之间使用「,」分割

参考网站：/

;{

key:f5458f5c0f9022db743a7c0710145903,

type:sync,

host:{

prod:APP,

ip:1,

lang:zh_TW,

acct:tiptop,

timestamp:20151211123204361

},

service:{

prod:T100,

name:.get,

ip:8,

id:topprd

},

datakey:{

EntId:99,

CompanyId:DSCTC

},

payload:{

std_data:{

parameter:{

employee_no:07375

}

}

}

};RESTfulAPI是一种设计风格，这种风格使API设计具有整体一致性，

易于维护、扩展，并且充份利用HTTP协定的特点

RESTful透过HTTP协议进行数据传送

RESTful交换数据的格式由双方自行定义

RESTful传送的内容可以是XML或JSON格式

RESTful可透过GET,POST…方式请求不同的服务

T100结合RESTful及Webservice的优点

使用单一的Restful整合接口awsp920，client端无需因为使用不同的服务去变换网址

T100支持POST请求服务，目的是为了交换ERP的数据内容

使用JSON在数据处理上较为简洁且轻量化

;;T100定义服务名称-azzi700;定义Record字段必需按照传入JSON字段的顺序

双档采由下而上的方式建立，先定义单身字段身再定义单头字段

;使用cl_aws_json_getParam函式读取JSON请求内容

JSON内容字段与Record的字段顺序需为一致

;6.T100RESTfulAPI测试与除错_??拟客户端工具配置—webservice(XML);整合Log檔by年月日期记录

T100Log范例说明:

-记录双方传递的XML(requestresponse)

$TEMPDIR/aws-YYYYMMDD.log

ex.awslog

-Server端服务程序的执行过程

$LOGDIR/webrun_YYYYMMDD_awsp920.log

ex.webrunawsp920.log;依服务执行的记录，搜寻『(debugcmdrun)』字符串并复制r.dg指令

透过LOG纪录在背景还境下进行DEBUG(查找关键字:r.dg)

方式1.透过adzq710查找DEBUG指令(如下图)

方式2.登入T100AP透过整合LOG档查询DEBUG指令(如下图)

(1)XMLLOG路径：$LOGDIR/webrun_日期yyyymmdd_awsp900.log

(2)RestfulLOG路径：$LOGDIR/webrun_日期yyyymmdd_awsp920.log

切换至$WSS/4gl目录下，执行r.dgwssp955指令开始进行程序除错（如右图）

自行设置断点自行设置断点(breakpoint);6.T100RESTfulAPI测试与除错_方式2.工具azzq990启动d