数据字典系统接口文档

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

2、数据 64 接口说明 64.1 获取数据字典生效 KEY 错误！未定义书签。4.1.1 请求参数列表 错误！未定义书签。4.1.2 应答参数 错误！未定义书签。4.1.3 使用举例 错误！未定义书签。5 常见问题及注意事项 105.1 调用方式 105.2 页面组件使用 错误！未定义书签。6 附录 106.1 请求响应码 106.2 数据字典系统KEY列表 111 文档说明1.1 功能描述本文档从技术角度描述了使用字典系统的字典数据的使用方法， 进而指导系统开发者与 数据字典系统的对接。1.2 阅读对象本文档是面向具有一定开发能力的开发者。1.3 业务术语术语解释字典类目类似字典的分类 分组描

3、述。字典项具体使用的字典数据 包括编码 名称和值。字典关联配置配置两个字典类目间字典项的关联2 ERP系统开发准备2.1 技术资料获取及准备2.1.1 确认调用系统信息确认要调用的接口，以及对应数据项的 KEY。 确系统使用的编码格式为 UTF-8 。确认拿到的是接口资料为要使用的版本2.2 环境搭建本机电脑的调试环境开发工具： Eclipse 或 Myeclipse 等；编辑工具： EditPlus 、NotePad+、电脑自带的“记事本”等 环境配置：使用 JAVA开发需要 JAVA的环境配置。 使用其他语言开发需要配 置相对该语言的环境。服务器的调试环境 硬件方面：由于网上支付平台提供的

4、软件同商户的系统紧密集成， 通常不需 要额外的硬件投资。软件方面： java 语言的 JDK1.5或以上，操作系统不限，服务器需要支持各 开发语言对应的环境，如果是 pom工程 需要引入：com.caissa.erpdict 0.0.1 备注：版本号可能会随着系统升级发生变化，以接入时的系统给出的为准。3 数据字典接口调用流程3.1 数据字典接口调用流程图3.2 数据字典接口调用步骤3.2.1 构造请求数据系统开发人员根据要需求确认要请求的接口，以及接口的主要数据，主要包 括：接口的方法，接口的参数值。(1) 请求参数如下：将请求参数拼装成请求对象后，3.2.2 发送请求数据接口交互方式为：

5、dubbo。 服务注册中心 zookeeper 地址如下： 生产环境地址： 测试环境地址：3.2.3 数据字典系统对请求数据进行处理3.2.4 返回处理的结果数据4 接口说明为了方便接口的统一管理，以下接口都需要基于基础请求和基础应答基础请求参数参数参数名称类型长度必填参数说明version版本号字符串16是Version=0.0.1method接口编码字符串64是reqSysCode请求系统编码字符串8是UicreqSysDate请求系统时间字符串是格式yyyyMMddHH24mmssexpandAttr请求扩展字段Json 字 符串否请求数据需扩展时，使用此字段基础应答参数参数参数名称类型

6、长度必填参数说明respCode应答编码字符串是Succ 成功 其他未异常respDesc应答描述字符串expandAttr应答扩展属性字符串否接口使用的 dubbo 接口接口需要引入 dict0.0.1.jar在 dubbo 配置文件 加入4.1 获取类目下的字典项接口编号： DICT-002方法名称： getCatalogDownItem4.1.1 请求参数参数参数名称类型长度必填参数说明类目编号catalogCode字符串是根据此编码查找对应的本级 和下级类目信息 类目编码是多个串，用逗号 隔开 但是类目顺序是 也是 层级关系 例如：省，市，县 而且类目编码的数量和字典 项深度是一致 如

7、何类目编 码是俩个 字典项深度是 1 会提示参数错误归属系统belongSys字符串12否字典项深度Level数字否数字从 1 开始，如果为 1 返 回当前类目下的字典项，如 果非 0 返回 level 层级的字 典项字符串，如果实际层级 小于穿过来的层级，则返回 实际层级。最大级不能超过 3. 默认： 14.1.2 应答参数参数参数名称类型长度必填参数说明类目列表：ItemListListDictItem 属性：类目编号catalogCode字符串6是类目名称catalogName字符串32是字典项编码itemCode字符串6否字典项名称itemName字典项值itemValue字典排序Se

8、quenceNum数字是否启用isEnable字符串扩展属性extendAttr字符串生效时间起startDate字符串格式yyyyMMddHH24mmss生效时间止endDate字符串格式yyyyMMddHH24mmss4.1.3 使用举例在使用类里需要注入进来，和使用 service 是一样调用 Resource (name = dictItemsService ) private DictItemsService dictItemsService ;4.2 获取字典项下的字典项接口编号： DICT-003方法名称： getCatalogAndItemDownItem4.2.1 请求参数参

9、数参数名称类型长度必填参数说明类目编号catalogCode字符串6是根据此编码查找对应的本级 和下级类目信息 类目编码是多个串，用逗号 隔开 但是类目顺序是 也是 层级关系 例如：省，市，县 而且类目编码的数量和字典 项深度是一致 如何类目编 码是俩个 字典项深度是 1 会提示参数错误字典项编码itemCode字符串8是这个就是一个编码归属系统belongSys字符串12否字典项深度Level数字否数字从 1 开始，如果为 1 返 回当前类目下的字典项，如 果非 0 返回 level 层级的字 典项字符串，如果实际层级 小于穿过来的层级，则返回 实际层级。最大级不能超过 3. 默认： 14.2.2 应答参数参数参数名称类型长度必填参数说明类目列表：ItemListListDictItem 属性：类目编号catalogCode字符串6是类目名称catalogName字符串32是字典项编码itemCode字符串6否字典项名称itemName字典项值itemValue字典排序SequenceNum数字是否启用isEnable字符串扩展属性extendAttr字符串生效时间起startDate字符串格式yyyyMMddHH24mmss生效时间止endDate字符串格式yyyyMMddHH24mmss4.2.3 使用举例和上面的使用方式一样5 常