数据字典系统接口文档.docVIP

数据字典 版本修订信息 版本号 完成日期 拟稿和修改人 发布日期 变更说明 V1.0.0 新建文档 目录 1 文档说明 4 1.1 功能描述 4 1.2 阅读对象 4 1.3 业务术语 4 2 ERP系统开发准备 4 2.1 技术资料获取及准备 4 2.1.1 确认调用系统信息 4 2.2 环境搭建 5 3 数据字典接口调用流程 5 3.1 数据字典接口调用流程图 5 3.2 数据字典接口调用步骤 5 3.2.1 构造请求数据 5 3.2.2 发送请求数据 5 3.2.3 请求字符集设置 6 3.2.4 数据字典系统对请求数据进行处理 6 3.2.5 返回处理的结果数据 6 4 接口说明 6 4.1 获取数据字典生效KEY 6 4.1.1 请求参数列表 6 4.1.2 应答参数 6 4.1.3 使用举例 7 5 常见问题及注意事项 7 5.1 调用方式 7 5.2 页面组件使用 7 6 附录 7 6.1 请求响应码 7 6.2 数据字典系统KEY列表 7 文档说明 功能描述 本文档从技术角度描述了使用字典系统的字典数据的使用方法与数据字典系统的 阅读对象 本文档是面向具有一定开发能力的开发者。 术语 解释 字典类目字典的分类描述 字典项 具体使用的字典数据编码和 字典关联配置类目间项的关联 ERP系统 技术资料获取及准备 确认调用系统信息 确认要的以及对应数据项的KEY 确系统使用的编码格式为UTF-8 确认拿到的是接口资料为要使用的版本 环境搭建 本机电脑的调试环境 开发工具： Eclipse 或 Myeclipse 等； 编辑工具：EditPlus、NotePad++、电脑自带的“记事本”等 环境配置：使用JAVA开发需要JAVA的环境配置。使用其他语言开发需要配置相对该语言的环境。 服务器的调试环境 硬件方面：由于网上支付平台提供的软件同商户的系统紧密集成，通常不需要额外的硬件投资。 软件方面：java语言的JDK1.5或以上，操作系统不限，服务器需要支持各开发语言对应的环境， 如果是pom工程引入： dependency groupIdcom.caissa.erp/groupId artifactIddict/artifactId version0.0.1/version /dependency ：号可能会随着升级发生变化以的系统的为。字典 数据字典字典 构造请求数据 系统开发人员确认要请求的接口，接口的主要数据，主要包括：的方法，接口的参数值。 将请求参数拼装成请求对象后， 发送请求数据 接口交互方式为dubbo。 服务注册中心 zookeeper地址如下： 测试环境地址： 数据字典系统 返回处理的结果数据 接口说明 为了方便接口的统一管理，以下接口都需要基础请求和基础应答。 请求参数 参数名称 类型 长度 必填 参数说明 version 版本号 字符串 16 是 Version=0.0.1 method 接口编码 字符串 64 是 reqSysCode 请求系统编码 8 是 Uic reqSysDate 请求系统时间 是 格式 yyyyMMddHH24mmss expandAttr 请求扩展字段 Json字符串应答参数 参数名称 类型 长度 必填 参数说明 respCode 应答编码 是 Succ 成功 其他未异常 应答描述 expandAttr 应答扩展属性 否 接口使用的dubbo 接口需要引入dict0.0.1.jar dubbo配置文件 dubbo:reference id=dictItemsService interface=com.caissa.dict.api.service.DictItemsService / 获取类目下的字典项 方法名称：getCatalogDownItem 参数 参数名称 类型 长度 必填 参数说明 类目编号catalogCode 字符串 是 根据此编码查找对应的和下级类目系统belongSys 字符串 12 否 字典项Level 数字 否 数字从，如果为当前类目的字典项，如果非level层级的字符串，如果实际层级小于穿过来的层级，则返回实际层级。不能超过 参数 参数名称 类型 长度 必填 参数说明 类目列表ItemList ListDictItem DictItem属性：编号catal