字段级文件附件
把照片、扫描件、合同 PDF 直接挂在某条记录的某个字段下,点开人就看得到,不用再翻文件夹找。
字段级附件是什么
字段级附件,说白了就是:在一张表的某一列,允许每条记录挂若干个文件。比如"村民花名册"里加一列叫身份证扫描件,张三那一行挂张三的身份证正反面,李四那一行挂李四的,互不相干。点开张三的记录就只看到张三的两张图,干干净净。
它和普通文本字段的区别在于:填进去的不是一段文字,而是一组文件。文件内容会转成一段文字(Base64编码)直接存进这条记录里,跟着记录一起进数据库,不是另存一份到磁盘再挂引用。正因为文件是直接躺在数据库里的,系统才对单个文件的大小和数量卡得比较严(见下文),别指望拿它当网盘使。
与"文件管理"模块的区别
字段级附件是绑在某条记录的某个字段下的,适合身份证扫描件、走访照片、本人签的承诺书这种"属于某个人/某件事"的资料。
如果想专门管村规民约、上级红头文件这种公共资料,直接用左侧菜单的文件管理——那是一个独立的磁盘文件夹浏览器,不受字段附件的大小和数量限制,新建文件夹归类、上传、下载、搜索都能做,更适合存不属于某一条记录的公共资料。
简单记一句话:属于某个人/某件事的,用字段级附件;属于全村的公共资料,放"文件管理"里。
配置一个附件字段
只有 admin 能改模块结构。以"村民花名册"加一列身份证扫描件为例:
- 进入字段管理左侧菜单点"模块管理",找到"村民花名册",点右侧的"字段管理"。
- 新增字段点右上角"新增字段",字段名填
身份证扫描件。 - 选类型类型下拉里选"附件（图片/PDF/Word）",字段类型只有这一种,没有"图片"和"附件"的区分,能放图片也能放 PDF/Word/Excel。
- 保存点底部"保存"按钮。这一列立刻出现在花名册里,已有记录的这一列是空的,慢慢补就行。
附件字段没有"允许多文件""最多文件数""单文件大小"这些可调选项——每个附件字段天生就能挂多个文件,大小和数量上限是系统统一定死的(见下一节),不能针对某个字段单独放宽或收紧。
上传文件
配好字段以后,去花名册新增或编辑一条记录,会看到这一列有个"上传附件"按钮:
- 点"上传附件"弹出系统的文件选择器,挑一个文件点"打开"就加进列表,能看到文件名和大小。
- 按住 Ctrl 选多个同一个文件选择器里按住 Ctrl(或 Shift)多选,一次选完一起加进来。
- 保存记录才真正生效选好的文件先加在这条记录的编辑表单里,要点记录的"保存"按钮才会真的存进数据库;半路关掉表单不保存,刚选的文件不会留下。
目前不支持把文件从桌面直接拖进网页上传,只能点按钮走系统的文件选择器;也没有单独的上传进度条,选完读取一下(小图不会等太久)就出现在列表里了,超出限制的文件会弹提示直接跳过,不影响其他文件。
附件大小限制 / 类型限制
这些限制是系统统一写死的,所有附件字段都一样,admin 改不了:
| 限制项 | 限制值 | 说明 |
|---|---|---|
| 单文件最大 | 5 MB | 硬性上限,超过直接拒绝(选择时和保存记录时都会拦) |
| 单字段总大小 | 20 MB | 同一个字段里所有文件加起来不能超过 20MB,哪怕单个都不到 5MB |
| 单字段文件数 | 20 个 | 超过 20 个会被截断,多出的不会加进去 |
| 允许的类型 | 图片(png/jpg/jpeg/gif/webp/bmp)、PDF、Word(doc/docx)、Excel(xls/xlsx) | 固定白名单,不支持自定义扩展名,也不支持 SVG |
附件是直接存进数据库里的,不是单独的磁盘文件,所以上限卡得很死(单文件 5MB、单字段 20 个文件封顶)。证件扫描件、走访照片建议先压缩再传;高清原图、大文件归档请用"文件管理"或单位的网盘,不要硬塞进字段附件。
在列表中如何显示
回到花名册的列表页,身份证扫描件这一列长这样:
- 挂了文件的:显示一个标签
📎 2 个附件,只报数量,不显示缩略图或文件名——想看具体文件要点开详情。 - 没传文件的:显示一条灰色短横线
—,方便一眼看出谁还没补齐。
附件列不支持点列头排序,也没有"复制单元格"按钮(其它文字类字段有)。
在详情中展开查看
点列表里的某一行(不用点具体按钮,点这一行任意位置)会弹出这条记录的详情, 身份证扫描件这一项会列出该字段挂的所有文件:图片显示一个小缩略图、其它类型显示对应的文件图标,后面跟文件名和大小(如 1.2 MB)。系统不记录每个文件是谁、什么时候传的,所以详情里看不到"上传时间"或"上传人"。
点缩略图或图标能弹出预览:图片直接放大看,PDF 在弹窗里嵌入显示,其它类型(Word/Excel)没有内嵌预览,弹窗里只给一个"下载"按钮。详情页是只读的,每个文件只有一个下载按钮,要增删文件得回到"编辑"这条记录。
删除 / 更换附件
资料传错了、传旧了,按下面来,系统没有单独的"替换"按钮:
- 打开这条记录的编辑表单列表该行"操作"下拉里点"编辑",附件字段会列出当前已挂的文件,每个文件右侧有"下载"和红色"删除"按钮。
- 删掉旧的点红色"删除",文件从列表里摘掉(这一步只是从表单里去掉,还没真正生效)。
- 传新的、点保存用"上传附件"加上新文件,再点记录的"保存"按钮,这条记录才真正更新;不点保存的话,删除和新传的文件都不会生效。
目前只能逐条记录手动删,没有"一次性清空整列"的批量入口。
附件是记录数据的一部分,删掉某个文件再保存记录,这个文件就从数据库里彻底没了——它不会进"全局回收站"(回收站只能整条记录一起还原,不能单独找回某条记录里的一个附件)。要保留旧文件的话,删除前先点"下载"存到电脑。
附件存储位置
字段级附件不是单独的磁盘文件,内容直接编码进这条记录,存在本机的 SQLite 数据库文件里,不传任何外网。它跟着数据库走,数据库搬到哪附件就在哪,不存在"单独迁移附件路径"这回事,因为压根没有独立的附件文件夹。
备份是否包含附件
包含。因为附件本来就是数据库文件的一部分,每天的自动备份(备份的是整个数据库)天然就把附件一起备走了,不用为附件单独设置什么。反过来说,附件传得越多、越大,数据库文件和每天的备份也会跟着变大,这也是为什么系统把单文件、单字段的上限卡得比较紧。
常见用法
下面这几种是村里实际在用的搭法,照着抄就行,字段类型都是同一种"附件（图片/PDF/Word）",大小和数量上限是系统统一的(单文件 ≤5MB、单字段 ≤20 个文件、总量 ≤20MB),不能按场景单独调整:
| 场景 | 挂在哪个模块的哪个字段 | 建议 |
|---|---|---|
| 证件照(身份证、户口本) | 村民花名册 → 身份证扫描件 | 正反面两张就够,拍照后压缩一下,别顶着 5MB 上限传 |
| 走访照片 | 走访记录 → 现场照片 | 手机拍照单张一般在几百 KB,20 个文件的上限够存一次走访的照片 |
| 合同 PDF | 土地承包 → 承包合同 | 扫描件建议控制在 5MB 以内,太大的 PDF 先用工具压缩 |
| 银行流水 | 低保户 → 近三月流水 | 3 个月的流水通常几张就够,注意加起来别超 20MB 总量 |
| 本人签的承诺书 | 党员名册 → 承诺书 | 建议村民先用手机拍照,扫码填写页直接传 |
配合扫码填写更省事:把附件字段加进扫码填写表单,村民手机扫码,自己拍自己传,村干部只负责审核,同样受上面那套大小/数量上限约束。