地区管理
地区管理主要实现地区数据的添加、编辑、查看、启用、禁用等功能,另外还包含地区选择控件封装。
业务功能点:
- 地区数据查看:地区列表树状展现,列表增加省、市、区、县、乡图标。
- 地区选择控件:选择控件为多级联动,支持呈现级别,支持筛选,支持客户端数据版本比对。
接口设计
地区列表
界面:
筛选:模糊搜索(SearchControl),包含下级组(CheckBox)
操作:查看、新建、编辑、删除、启用(停用)、数据↓(修复数据)、列宽↓(自动、最优)
删除为逻辑删除,States附加移除状态。
新建、编辑,新建后选中新行、编辑后只刷新编辑行数据、刷新则重新加载列表数据。
启用、停用按钮为一个,依据数据行具体状态切换显示。
修复数据,点击后修复数据RegionLevel、QuanPin、JianPin、MergeName、MergeShortName,通过业务层计算获得数据后回写数据库。
列头: ChildKeys、ParentKeys、SortKeys暂时不用
列表 | |||||
显示 | 详情页附加显示 | 不显示 | |||
Code 编码 | Name 名称 | Code 编码 | Name 名称 | Code 编码 | Name 名称 |
RegionName | 名称 | MergeName | 合称 | RegionKey | 区域标识 |
ShortName | 简称 | MergeShortName | 合并简称 | ParentKey | 上级标识 |
OriginName | 原名 | Longitude | 经度 | ChildKeys | 所有直属子级 |
RegionLevel | 层级 | Latitude | 纬度 | ParentKeys | 所有父级 |
ParentRegion (ParentKey得到) | 父级 | Remark | 备注 | SortCode | 排序码 |
CityCode | 区号 | CreateTime | 创建日期 | TenantId | 租户Id |
ZipCode | 邮编 | CreateUser CreateUserKey | 创建用户 | ||
QuanPin | 拼音 | ModifyTime | 修改日期 | ||
JianPin | 简拼 | ModifyUser ModifyUserKey | 修改用户 | ||
Tags | 标签 | ||||
States 包含启用、停用 | 状态 | ||||
其它:
|
地区选择控件
控件说明:
- 选择控件支持定义选择级别(省、市、区县、镇乡、街道)。
- 选择控件支持地区说明,如上图。
选择控件支持最近选择,在省份前增加最近分组,默认选中最近分组。
地区表(Basics.RegionArea)
Code 编码 | Name 名称 | Description 说明 |
RegionKey | 区域标识 | 非自增,便于添加和同步 |
RegionName | 区域名称 | 比如:成都市 |
MergeName | 合称 | 省市区聚合,比如:四川省,成都市,高新区 |
ShortName | 简称 | 比如:成都 |
MergeShortName | 合并简称 | 比如:四川,成都 |
OriginName | 原名称 | 比如:郫都区 原名 郫县,在更名不是很久的时候特别有用,可以用于界面提示 |
ParentKey | 上级标识 | 顶级ParentKey为空,为中国 |
RegionLevel | 区域层级 | 比如:国家1,省2,市3,区县4,乡镇5,村6……,在整个数据中可依据情况考虑是否加入中国作为根节点 |
ChildKeys | 所有直属子级 | 排序使用,逗号分隔的Id字符串列表 |
ParentKeys | 所有父级 | 包含关系使用,逗号分隔的Id字符串列表 |
SortCode | 排序码 | 排序使用,热度等同级排序使用 |
CityCode | 区号 | 比如 成都028 |
ZipCode | 邮编 | 邮编 比如成都610000 |
QuanPin | 拼音 | 比如:sichuansheng |
JianPin | 简拼 | 四川省=SCS |
Longitude | 经度 | |
Latitude | 纬度 | |
Tags | 标签 | 预留,可以作为特定组使用 |
TenantId | 租户Id | 暂不使用此字段,地区信息作为全局统一使用。独立部署标识,租户Id=0标识平台通用数据 |
Remark | 备注 | 区划ID-父亲ID-全称-简称-级别-邮编-区号-拼音-简拼-首字母-经纬度-省市区聚合 |
CreateTime | 创建日期 | |
CreateUserKey | 创建用户主键 | |
ModifyTime | 修改日期 | |
ModifyUserKey | 修改用户主键 | |
States | 状态集 | 在用、停用、逻辑删除 |
地区数据
地区数据:需要手动导入地区数据(可网上查找导入往年地区数据,新的行政区划变更不大,有变更的地方手动调整)
文章作者:花生(OutMan) 发布地址:http://www.cnblogs.com/WangHuaiSheng/ 发布时间:2018年1月24日 本文版权归作者和博客园共有,欢迎转载, 但未经作者同意必须保留此段声明, 且在文章页面明显位置给出原文连接。 |