字段类型详解
11 种字段类型,覆盖村里台账能用到的所有数据形态——从姓名、身份证到附件材料、派生计算,挑对类型,后面录入、筛选、排序全自动。
1. 字段总览
在模块的"字段管理"里点"新增字段",弹窗"类型"下拉里就能看到这 11 种。下表按用途分组,方便你对照挑选。
| 分组 | 类型 | 典型用途 | 能筛选 | 能排序 |
|---|---|---|---|---|
| 文字 | 文本 | 姓名、户主、备注 | 是 | 是 |
| 数字 | 数字 | 家庭人口、低保金额 | 是(区间) | 是 |
| 时间 | 日期 | 出生日期、入党时间、登记时间 | 是(区间) | 是 |
| 选项 | 下拉单选 | 性别、民族、政治面貌 | 是 | 是 |
下拉多选 | 困难类别、技能特长 | 是 | 否(多值没法排序) | |
| 格式化 | 身份证号 | 身份证号 | 是 | 是 |
电话号码 | 手机号、固话 | 是 | 是 | |
| 二选一 | 是/否 | 是否党员、是否搬迁 | 是 | 是 |
| 地址 | 住址(逐级选择) | 家庭住址、工作单位地址 | 是(关键词) | 是 |
| 自动算 | 派生字段(自动计算) | 年龄、党龄、出生日期、性别 | 部分(见第 11 节) | 是 |
| 附件 | 附件(图片/PDF/Word) | 申请材料、扫描件、走访照片 | 否 | 否 |
2. 新增字段时能设置什么
在"字段管理"里点"新增字段",弹窗从上到下依次是:
- 领域快选(仅新增字段时有,编辑已有字段不显示):不选就是普通自定义字段;选一个(如"民族""政治面貌")会自动把字段名、类型、选项都填好,填完还能再改,省得每次手打"汉族、彝族、苗族……"这类枚举。
- 字段名:最多 20 个字符,同一模块内不能和已有字段重名,重名会被拒绝保存。
- 类型:上面 11 种里选一个。
- 选项(仅下拉单选/下拉多选出现):文本框里一行填一个,至少要填一项,不填保存不了。
- 派生内容 / 源字段(仅派生字段出现):见第 11 节。
- 必填:开关,开启后这个字段不填就保存不了(派生字段没有这项——它不用手填)。
- 不允许重复:开关,只有文本、数字、日期、身份证号、电话号码这 5 种类型能开,其余类型这个开关是灰的、点不了。
- 可筛选:开关,开启后数据页顶部会出现这个字段的筛选条件,系统同时给它建索引。
- 列表显示:开关,开启后这一列会出现在数据列表页,默认是开的。
目前字段本身不支持配默认值、单位后缀、小数位数或千分位显示——数字就是原样存、原样显示的数值,日期就是 YYYY-MM-DD。想标单位,写进字段名或者村里口头约定即可(参考第 12 节的命名建议)。
如果字段已经录了数据,现在才想开"不允许重复",系统会先扫一遍存量值,只要有重复就拒绝开启。要先去列表页把重复的清理掉,再回来开。
3. 文本字段
最常用的一种,存一行字。服务器端限制最长 500 个字符,前后多余的空格保存时会自动去掉,不用单独设置。姓名、户主、工作单位、备注都用它。
4. 数字字段
家庭人口、低保金额、耕地面积、补助标准都用数字字段。录入是一个数字输入框,支持小数。列表页按数值大小排序(不是按字符串),筛选支持填"最小值""最大值"做区间查询,比如找"低保金 ≥ 500"。
整数会原样存成整数,不会自动补成"5.00"这种。字段本身没有小数位数、单位、千分位这些显示设置(见第 2 节)。
5. 日期字段
出生日期、入党时间、登记日期、上报时间都用它。只精确到"日",没有精确到时分的选项。
录入时点输入框会弹日历,直接选。也能手敲 2024-03-15 这种 YYYY-MM-DD 格式。
筛选支持填开始/结束日期做区间查询。
从 Excel 导入时,日期列建议先在 Excel 里设成"文本"再导,格式写成 2024-03-15。Excel 自带的"日期"格式有时会变成数字序列号,导进来全是 1900 年附近的怪日期。
6. 下拉单选 / 下拉多选
固定选项就用这两种,不要用文本字段让大家自由填——自由填一定会出现"男/男/男的/M"这种垃圾数据。
- 新增字段时类型选"下拉单选"或"下拉多选"。
- 在"选项"文本框里一行填一个:例如性别填两行
男和女。
典型用法:性别(单选)、民族(单选)、政治面貌(单选)、困难类别(多选:低保/残疾/大病/独居)。目前选项没有单独配色,也没有"录入时现场新增选项"的开关——要加选项得回"字段管理"里编辑该字段、往选项框里加一行。
编辑下拉字段时,选项区下面有个"改了选项名?把老记录里的旧值同步改"链接。把选项从"支部书记"改成"党组织委员会书记"这类场景,点它能把所有历史记录里的旧值一次性同步成新值,不用一条条改。
7. 身份证号字段
录入时做两件事:
- 格式检查:必须 18 位,前 17 位是数字,末位是数字或 X(大小写都行,系统自动转大写)
- 去除内部空格、全角 Ｘ 转半角
格式不对会提示"身份证号格式不对(需 18 位,前 17 位是数字,末位是数字或 X)"。
系统只查长度和字符范围,不校验最后一位的国标校验码算法——村里有不少手抄的老身份证号、少数民族地区的历史遗留号,严格校验位会挡掉大量真实数据,所以有意放宽。
录入表单时有个自动回填:只要同一模块里还有一个日期类型、字段名带"出生"或"生日"的字段,以及一个下拉单选、字段名带"性别"且选项刚好是"男""女"的字段,填完身份证号会自动把这两个字段的空白处填上(已经手填过的不会被覆盖)。字段名不满足这个规律就不会自动回填。
添加身份证号字段时,建议开"不允许重复"。这样导入村民花名册时,系统会按身份证号判重,不会同一个人录两遍,也是"扫码填写"防重复提交的关键。
8. 电话号码字段
录入时校验格式,不符合不让保存:
| 规则 | 例子 |
|---|---|
| 11 位手机号,必须以 1 开头 | 13800138000 |
| 7-12 位座机号,可带连字符区号 | 010-12345678 |
9. 住址(逐级选择)字段
录入时是"省 → 市 → 区/县 → 乡/镇 → 村"五级联动下拉,选完自动拼成完整地址串;上面还有一个可编辑的文本框,能在选完的基础上手动补门牌号,或者电脑没联网时整段手输。地名数据由系统代理外部接口并缓存,局域网电脑不用能上网也能选(缓存过的地名)。
筛选按关键词模糊匹配,例如筛"住址"里含"上河村"的记录。
10. 附件(图片/PDF/Word)字段
存文件和图片用。低保申请表、残疾证扫描件、证明材料、走访照片都放这里。
| 限制项 | 数值 |
|---|---|
| 单个文件大小 | ≤ 5 MB |
| 该字段全部文件的总大小 | ≤ 20 MB |
| 单条记录该字段最多文件数 | 20 个 |
| 支持格式 | PNG / JPG / JPEG / GIF / WEBP / BMP、PDF、DOC/DOCX、XLS/XLSX |
点附件名能直接下载;图片会显示缩略图,点开能预览,PDF 也能在弹窗里直接预览。不支持 SVG(会被拒绝,防止内嵌脚本)和 ZIP 等其他格式。
上传的文件直接编码后存进 SQLite 数据库里,不是放在磁盘的某个文件夹。好处是"备份恢复"整体备份数据库时附件自动一起备走,不用单独拷文件夹;坏处是传的图片/文件越多,数据库文件本身会跟着变大。
11. 派生字段(自动计算)
系统按公式实时算出来的字段,不能手填,不能导入,每次打开模块都会重算一遍。目前支持 4 种:
| 派生内容 | 显示效果 | 源字段类型 | 能不能筛选 |
|---|---|---|---|
| 年龄 | 32 岁 | 身份证号 | 是(按范围) |
| 党龄 | 8 年 | 日期(如入党时间) | 是(按范围) |
| 出生日期 | 1990-05-12 | 身份证号 | 否 |
| 性别(按身份证) | 男 / 女 | 身份证号 | 否 |
新增时要先选"派生内容",再选模块里已有的、类型匹配的"源字段"(年龄、出生日期、性别都要绑身份证号字段;党龄要绑日期字段)。如果模块里还没有对应类型的字段,"派生字段"这个类型选项在下拉里根本不会出现。
党龄算出来直接展示为"X 年",党费缴纳模块就是用它对照档位算应缴;出生日期、性别(按身份证)分别从身份证号第 7-14 位、第 17 位解析,不用单独录一遍。
每次打开模块都按源字段实时重算,所以"年龄"不用每年手动改。批量编辑时派生字段列不可编辑。如果删除的字段有派生字段依赖它(比如删"身份证号"会连累"年龄""出生日期"),系统会先警告,确认后一并把依赖它的派生字段也删掉。
12. 字段命名规则与冲突避免
字段名直接影响后面的导入导出列头、证明模板占位符、派生字段公式,定下来别随便改。
- 用中文,不要拼音:写"姓名",不写"xingming"。证明模板里写
{{姓名}}才好对照绑定。 - 字段名长度限制是 1-20 个字符,系统没有强制禁止空格或符号,但为了导入导出列头、证明模板占位符对得整齐,建议还是别带空格和特殊符号
- 同一个模块里字段名不能重复,系统会拒绝保存(提示"字段名称已存在")
- 不同模块之间名字可以一样,互不影响
- 给字段加单位、说明,不要塞进字段名:字段名写
低保金,单位村里口头约定即可,不要把字段名写成"低保金(元/月)"(系统目前也没有单独的单位设置,见第 2 节)
命名想不好可以参考其他模块的现成字段——在"模块管理"里点开任意模块的"字段管理",抄一下别人的字段命名思路。改字段名是支持的(字段在数据库里的实际存储键不受影响),改完旧数据不丢,但用到这个字段的视图、派生字段、证明模板需要重新检查一遍。如果是普通用户看不到的某个模块,改名前先去 角色权限 里确认下哪些用户在用。