1 总述

目前数据字典分三类:静态字典、动态字典、动态搜索

分类 业务场景 备注
静态字典 字典项固定不怎么变化,数量有限 纯手动录入
动态字典 跟静态字典类似,但是取数来源是数据库或者接口 SQL读取或者接口读取,不用手动录入
动态搜索 需要模糊搜索,数据量不定,或者较大,字典项变化大,需要动态带入条件参数等 接口读取,不用手动录入

2 配置说明

2.1 静态字典

  • 静态字典与之前方式一样,只需要设置【应用类型】字段即可,然后手动录入字典项就可以使用
  • 也可以直接在低代码端添加维护,就不用设置【应用类型】字段,自动处理
  • 适用的组件范围有:下拉、单选框、复选框、树形等

2.1.1 低代码直接维护

1. 字典分类

2. 字典项

2.2 动态字典

支持写SQL和接口

2.2.1 SQL方式

  1. 案例说明
    #pg_admin#select cdd.code item_code, cdd.description item_name from table_name cdd where cdd.lookup_type ='XXSRM_1610_TRANSPORT' and cdd.is_deleted ='0'#item_code|item_name

以#分隔

项目 作用 备注
第一项 数据源配置中的数据源编码
第二项 具体的查询SQL
第三项 字典编码和字典名称字段映射配置 以|分隔,第一个为编码,第二个为名称

2.2.2 接口方式

  1. 支持get请求,返回字典项清单列表,支持iac鉴权,默认会传
  • 低代码端集成效果

  • 在csb-legox端效果

  1. 返回格式
  • 非树形返回

    {
      "status": "0",
      "message": "success",
      "data": [
          {
              "dictionaryTypeCode": "DMS_PSI_WEEK_TIMES",
              "name": "2023年 第1周 01月02日-01月08日",
              "itemValue": "2023年 第1周 01月02日-01月08日"
          },
          {
              "dictionaryTypeCode": "DMS_PSI_WEEK_TIMES",
              "name": "2023年 第2周 01月09日-01月15日",
              "itemValue": "2023年 第2周 01月09日-01月15日"
          }
      ]
    }
  • 树形返回

    {
      "status": "0",
      "message": "success",
      "data": [{
              "id": "1111",
              "dictionaryTypeCode": "DMS_PSI_WEEK_TIMES",
              "name": "2023年 第1周 01月02日-01月08日",
              "itemValue": "2023年 第1周 01月02日-01月08日",
              "itemParentId": "",
              "children": [{
                  "id": "1111-1",
                  "dictionaryTypeCode": "DMS_PSI_WEEK_TIMES",
                  "name": "2023年 第2周 01月09日-01月15日",
                  "itemValue": "2023年 第2周 01月09日-01月15日",
                   "itemParentId": "1111",
                  "children": [{
                      "id": "1111-1-1",
                      "dictionaryTypeCode": "DMS_PSI_WEEK_TIMES",
                      "name": "2023年 第2周 01月09日-01月15日",
                      "itemValue": "2023年 第2周 01月09日-01月15日",
                      "itemParentId": "1111-1",
                  }]
              }]
          }
      ]
    }

2.3 动态搜索

支持 POST JSON格式请求

  • 建议统一封装一个接口,通过不同参数执行不同的逻辑
  • 可以使用通用选择器作为底座,封装一个接口,这样就只需要写SQL了

动态搜索数据字典接口规范的文档地址:动态搜索数据字典接口文档

2.3.1 低代码集成效果(推荐)


2.3.2 在csb-legox端效果

作者:聂维  创建时间:2023-04-14 09:44
最后编辑:黄泽彬  更新时间:2024-12-11 10:09