数据字典系统接口文档

《数据字典系统接口文档》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、数据字典接口文档数据字典接口文档（V0.0.1）2015年6月版本修订信息数据字典接口文档版本号完成日期拟稿和修改人发布日期变更说明V1.0.0新建文档数据字典接口文档目录1文档说明41.1功能描述41.2阅读对象41.3业务术语42ERP系统开发准备42.1技术资料获取及准备42.1.1确认调用系统信息42.2环境搭建53数据字典接口调用流程53.1数据字典接口调用流程图53.2数据字典接口调用步骤53.2.1构造请求数据53.2.2发送请求数据53.2.3请求字符集设置63.2.4数据字典系统对请求数据进行处理63.2.5返回处理的结果数据64接口说明64.1

2、获取数据字典生效KEY64.1.1请求参数列表64.1.2应答参数64.1.3使用举例75常见问题及注意事项75.1调用方式75.2页面组件使用76附录76.1请求响应码76.2数据字典系统KEY列表7数据字典接口文档1文档说明1.1功能描述本文档从技术角度描述了使用字典系统的字典数据的使用方法，进而指导系统开发者与数据字典系统的对接。1.2阅读对象本文档是面向具有一定开发能力的开发者。1.3业务术语术语解释字典类目类似字典的分类分组描述。字典项具体使用的字典数据包括编码名称和值。字典关联配置配置两个字典类目间字典项的关联2ERP系统开发准备2.1技术资料获取及准

3、备2.1.1确认调用系统信息u确认要调用的接口，以及对应数据项的KEY。u确系统使用的编码格式为UTF-8。u确认拿到的是接口资料为要使用的版本。数据字典接口文档1.1环境搭建u本机电脑的调试环境开发工具：Eclipse或Myeclipse等；编辑工具：EditPlus、NotePad++、电脑自带的“记事本”等环境配置：使用JAVA开发需要JAVA的环境配置。使用其他语言开发需要配置相对该语言的环境。u服务器的调试环境硬件方面：由于网上支付平台提供的软件同商户的系统紧密集成，通常不需要额外的硬件投资。软件方面：java语言的JDK1.5或以上，操作系统不限，服务

4、器需要支持各开发语言对应的环境，如果是pom工程需要引入：com.caissa.erpdict0.0.1备注：版本号可能会随着系统升级发生变化，以接入时的系统给出的为准。2数据字典接口调用流程2.1数据字典接口调用流程图2.2数据字典接口调用步骤2.2.1构造请求数据系统开发人员根据要需求确认要请求的接口，以及接口的主要数据，主要包括：接口的方法，接口的参数值。(1)请求参数如下：将请求参数

5、拼装成请求对象后，数据字典接口文档1.1.1发送请求数据接口交互方式为：dubbo。服务注册中心zookeeper地址如下：生产环境地址：测试环境地址：1.1.2数据字典系统对请求数据进行处理1.1.3返回处理的结果数据2接口说明为了方便接口的统一管理，以下接口都需要基于基础请求和基础应答。基础请求参数参数参数名称类型长度必填参数说明version版本号字符串16是Version=0.0.1method接口编码字符串64是reqSysCode请求系统编码字符串8是UicreqSysDate请求系统时间字符串是格式yyyyMMddHH24mmssexpandAttr

6、请求扩展字段Json字符串否请求数据需扩展时，使用此字段基础应答参数参数参数名称类型长度必填参数说明respCode应答编码字符串是Succ成功其他未异常respDesc应答描述字符串expandAttr应答扩展属性字符串否接口使用的dubbo接口接口需要引入dict0.0.1.jar数据字典接口文档在dubbo配置文件加入1.1获取类目下的字典项接口编号：DICT-002方法

7、名称：getCatalogDownItem1.1.1请求参数参数参数名称类型长度必填参数说明类目编号catalogCode字符串是根据此编码查找对应的本级和下级类目信息类目编码是多个串，用逗号隔开但是类目顺序是也是层级关系例如：省，市，县而且类目编码的数量和字典项深度是一致如何类目编码是俩个字典项深度是1会提示参数错误归属系统belongSys字符串12否字典项深度Level数字否数字从1开始，如果为1返回当前类目下的字典项，如果非0返回level层级的字典项字符串，如果实际层级小于穿过来的层级，则返回实际层级。最大级不能超过3.默认：1数据字典接口文档1.1.1

8、应答参数参