ERP中的地区管理

地区管理

地区管理主要实现地区数据的添加、编辑、查看、启用、禁用等功能，另外还包含地区选择控件封装。

业务功能点：

地区数据查看：地区列表树状展现，列表增加省、市、区、县、乡图标。
地区选择控件：选择控件为多级联动，支持呈现级别，支持筛选，支持客户端数据版本比对。

接口设计

地区列表

界面：

筛选：模糊搜索(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日

本文版权归作者和博客园共有，欢迎转载，

但未经作者同意必须保留此段声明，

且在文章页面明显位置给出原文连接。