跳到正文
观点文章/文章详情

后台数据导出,哪些规则应该提前确定?

核心结论

每一种导出都要事先写明使用人、记录范围、时间字段和区间、包含的列、敏感字段是否出现、文件格式,以及超过约定规模时是直接下载还是生成稍后领取的文件。导出是把数据带出系统,不能默认成“能看页面就能导出”。文件要有有效期和操作记录。

导出需求被拆成使用人、记录范围、日期口径和字段四项,没有这些项就不能导出全部数据

设想这样的业务场景:有人说后台缺一个导出。两周后按钮做好了,默认导出全部订单、全部年份、全部字段。财务拿到的文件里有内部成本和同事电话,页面等到超时。按钮有了,规则没有。

每一种导出都要在开发前写成一张小规格:谁来用、哪些行、按哪个时间、哪些列、敏感字段出不出现、文件什么格式、太大时怎么办、要不要留下操作记录。不能看页面,不等于可以把同样的内容带出系统。

先写七项,再做按钮

  1. 名称。 “导出”不够。写成“我的待发货”或“本月发货对账”。名称不同,范围就不同。
  2. 使用人。 哪个角色可以执行这一次导出。不要写“登录用户都可以”。
  3. 记录范围。 全部、只限自己负责、还是必须先套上筛选。没有筛选时不允许导出全部,通常是更稳的默认,除非这就是一份给管理员的备份。
  4. 时间口径。 写明用哪个日期字段,以及默认区间。下单日、发货日、状态变成“已发货”的时间,不是同一个月。
  5. 字段清单。 列出列名。不要写“相关字段都要”。内部成本、个人电话、证件号要么列入并说明理由,要么明确不出现。
  6. 格式与表头。 常见是表格文件。表头用业务同事认得出的名称,并注明金额单位和时区。单位不写,导出的数字就无法和页面核对。
  7. 超量与记录。 超过约定规模时,是继续让页面等着下载,还是生成一份稍后领取的文件。谁在什么时候导出了哪一种、范围是什么,要能查到。

这七项和“角色能不能进入订单菜单”不是同一件事。权限矩阵回答能不能做这个动作;导出规格回答这个动作拿出的文件里到底有什么。两份都要有。

时间口径不写,文件就对不上任何人的预期

“导出当前列表”看起来省事,列表却可能正按创建时间排序,财务要的却是本月实际发货。同一次点击,销售理解的本月是下单月,仓库理解的本月是出库月。

所以规格里写字段名,不写“按时间”。例如:发货对账使用发货日期,默认区间是本月 1 日到今天,时区按业务所在地。页面上的导出按钮旁重复这一句。文件名里带上日期区间,避免三份都叫“订单导出”的文件分不清。

汇总数字的定义,例如“销售额含不含已取消”,是指标口径问题。导出只要保证:文件里的每一行都说得清它为什么落在这个区间里。区间的规则和指标的规则要能对上,但不必在导出功能里重新发明一套指标。

能打开记录,不代表应该导出同样的字段

人在页面上查看一条订单,通常还有权限、页面环境和事后可追的访问。文件一旦下载,就可以被转发、放进邮件和私人表格。所以导出要单独授权,并且字段可以比页面更少。

销售可以打开自己的订单并看到收货电话,因为要联系客户。同一人导出“我的待发货”时,可以只保留收货人和地址,不带电话,如果发货单并不需要电话。财务对账需要金额,不需要客户手机号。管理员的备份可以包含更多字段,但不应做成大家随手点的那个按钮。

本文不判断某种个人信息能不能依法导出。那要按你们的业务和适用要求另作确认。这里只要求:文件里出现的敏感列是被点名同意的,而不是从数据库整行倒出来的。

文件变大以后,不要只让浏览器干等

小结果可以直接下载。大结果让页面一直转,用户会重复点击,系统就做了两遍。事先定一个规模门槛。例如超过 5,000 行就改为稍后领取。5,000 只是假设示例,不是通用上限。真正的数字取决于你们的服务器、列数和人们能不能接受等待。

稍后领取要写清四件小事:文件准备好之后在哪里取、多久失效、失效后是否删除、失败了页面上说什么。链接或按钮只给发起导出的那个人,不要发到一个谁打开都能下的地址。有效期由你们定,例如示例中的 24 小时,不要当成必须遵守的标准。

全量备份如果需要,就做成有权角色的单独动作,最好按计划生成,而不是谁都能点的“导出全部”。备份文件的存放和恢复是另一项交付,不要和日常对账共用一个按钮。

假设示例:同一批订单上的三种导出

下面是假设,不是某家公司的真实规格。订单是同一批,导出却不应该共用一份“所有列”。

名称

使用人

记录范围

时间口径

字段

敏感字段

超量时

我的待发货

销售专员

只限自己负责,且状态允许发货

不按月份截断;按承诺发货日从早到晚

订单号、收货人、地址、承诺发货日、品名、数量

不包含电话、内部成本

示例:超过 5,000 行改为稍后领取

本月发货对账

财务

全部已发货记录,不限负责人

发货日期在所选月份

订单号、客户名称、发货日、数量、应收金额、币种

不包含个人电话和内部成本

同上,并在文件名写明月份

全量备份

指定管理员

全部订单

不截断;文件内保留每条记录自己的日期字段

恢复业务所需的列,另行列表

可以包含,但必须在规格里逐列点名

不提供即时下载,只按约定计划生成

三行里最容易偷懒的是让财务使用销售那一份,或者让所有人使用备份那一份。字段一旦迁就最宽的需求,窄的需求就失去了边界。

导出和导入会碰上。有人导出后再改几个格子导回去。如果允许这条路,就要同时定下导入用的主键和覆盖规则。不允许这条路,就在导出说明里写一句:这份文件不能再导回系统。

导出需求核对清单

【导出需求核对清单】

一、这一种导出
- 名称:
- 谁可以执行:
- 记录范围;没有筛选时能否导出全部:

二、时间和字段
- 用哪个日期字段,默认区间是什么,时区是什么:
- 列名有哪些,金额单位是什么:
- 哪些敏感列明确不出现;哪些如果出现,由谁同意:

三、文件
- 格式和文件名里要带的范围信息:
- 超过多少规模就改为稍后领取(这个数字需你们自己测定):
- 稍后领取的文件哪里取、多久失效、失败时如何说明:

四、记录
- 是否记录导出人、时间、导出类型和范围:
- 这份文件是否允许再导入;若允许,主键和覆盖规则是什么:

每种导出填一行,比在页面上放一个导出全部有用。现有表格里人们已经在导出的那几份,可以先收进业务系统准备清单,再决定哪些值得做成系统里的正式动作。需要把范围和权限一起做进后台时,可以看业务系统开发。

选型时把“能不能把数据导出”当成一条原则,见小团队的工具栈原则。那篇文章帮你决定要不要用一个带不走数据的工具。它不代替上面这张规格表。AI 平台里谁能调用哪些数据和工具,见多部门共用 AI 平台的权限,那是另一次请求上的校验,不是订单文件怎么导出。

聊聊你的项目

网站 / 业务系统 / AI 应用

企业微信咨询