避免页签系列问题的文档命名

当您在 ERPNext 中保存文档(如销售发票、库存录入、付款单等任何带有自动生成编号的内容)时,系统需要确定序列中的下一个编号(例如 0001、0002、0003 等)。

为了确保两个文档永远不会获得相同的编号,ERPNext 在名为 tabSeries 的表中为每个命名系列维护一个计数器。在分配下一个编号之前,它会锁定该计数器,防止其他操作同时访问,然后加 1,最后解锁。这个过程在瞬间完成,因此通常您不会察觉到。

如果同时创建数百个文档,并且它们都使用相同的命名系列,那么它们都需要同一个计数器。同一时间只能有一个操作持有锁,因此其他操作必须排队等待。

当排队等待的时间变长时,您可能会遇到以下情况:

  • 文档保存耗时较长
  • 批量导入或批量提交速度缓慢甚至卡住
  • 出现类似“Record has changed since last read in table ‘tabSeries’”的错误,或数据库锁/死锁超时
  • 后台任务在队列中堆积

在业务高峰期、月末或为应对负载而增加更多工作进程后,这个问题会变得更加严重,因为现在有更多的交易在争抢同一个计数器。

为什么定制化会加剧此问题

一个非常常见的原因是定制化配置强制大量交易使用单一、受限的命名系列。所有交易都汇聚到一个计数器上,导致该计数器成为整个操作的瓶颈。规模越大,这个单一计数器后面的排队就越长。

简单的解决方法:使用多个命名系列

计数器是按命名系列分别锁定的。因此解决方法很简单:

为不同的交易组分配各自的命名系列,这样它们就会使用不同的计数器,不再相互等待。

与其在一个计数器前排长队,不如开设多个计数器。每个队列独立并行运行。

拆分系列的好方法

选择任何能自然区分您交易的方式。例如:

按以下方式拆分 示例系列
分支机构 SINV-MUM-.YYYY.-.####, SINV-DEL-.YYYY.-.####
项目 SINV-PROJ-A-.####, SINV-PROJ-B-.####
成本中心 SINV-CC01-.####, SINV-CC02-.####
部门 SINV-SALES-.####, SINV-SUPPORT-.####

每种情况的核心思想都是一样的:同时运行的交易不应都挤在同一个计数器上。您将它们分散得越开,每个交易需要等待的时间就越短。

针对超大规模操作的额外建议

如果您经常一次性创建大量文档:

  • 将大批量导入分散到多个系列中,以分担负载,而不是将所有内容都导入到一个系列下。
  • 在导入/API 调用时尽可能自行提供名称。如果文档已有名称,ERPNext 将完全跳过计数器。无需锁定,无需等待。例如,客户 ID 是根据客户名称本身生成的。
  • 避免将所有内容强制归入一个狭窄系列的定制化配置。审查任何自定义命名逻辑,确保它不会将所有交易都汇聚到单个计数器上。
  • 如果流程允许,稍微错开超大型任务的启动时间,而不是在同一瞬间全部触发。

一个文档对应多行的报表

有时,报表中同一单据编号可能会出现在多行中。这通常并不意味着单据被重复了,而是表示该报表针对该单据显示了多条匹配的数据行。

这种情况在包含子表字段、链接记录或详细的会计和库存分录的报表中很常见。

最常见原因:选择了子表

许多 ERPNext 单据都有子表。例如:

  • 一张销售发票包含多个销售发票项目
  • 一张采购订单包含多个采购订单项目
  • 一个付款计划可以有多个到期日。
  • 一笔交易可以有多个税费、扣款或会计行。

当报表包含子表中的字段时,报表会为每个子表行显示一行。

例如,如果销售发票 SINV-0001 有 3 个项目行,并且报表包含销售发票项目中的字段,则报表可能会显示:

SINV-0001    Item A
SINV-0001    Item B
SINV-0001    Item C

该发票仍然是一个单据。报表只是针对每个项目行显示了一次该发票。

为什么会这样

报表是基于数据库行构建的。父单据和子表之间是一对多的关系。

一个父单据可以对应多个子表行:

Sales Invoice
  - Item 1
  - Item 2
  - Item 3

当报表包含子表数据时,Frappe 需要分别显示每个子表行,以便子表值可见。这是预期行为。

报表显示多行的其他原因

1. 包含了多个子表

如果报表包含多个子表中的字段,行数可能会进一步增加。

例如,如果一张发票有 3 个项目行和 2 个税行,一个结构不佳的自定义报表可能会显示比预期更多的行,因为两个子表被连接在一起了。

在这种情况下,请检查报表设计,只包含所需的子表。

2. 报表显示分类账或明细分录

有些报表本身就是明细级别的报表,并非设计为每个单据显示一行。

例如:

  • 总分类账样式的报表可能为每个会计分录显示一行。
  • 库存报表可能为每个库存分类账分录显示一行。
  • 应收或应付报表可能根据发票、付款或未结引用显示行。

同一个凭证号可能出现多次,因为一个单据可以生成多个分类账分录。

3. 报表包含具有多个匹配项的链接记录

一个单据可能连接到多个相关记录。例如,一张发票可以链接到多个付款分录、交货单、序列号、批次或会计引用。

如果报表包含来自这些链接记录的数据,则父单据可能会针对每个匹配的链接记录显示一次。

4. 自定义查询报表存在连接问题

在自定义查询报表中,如果 SQL 查询在没有正确条件的情况下连接表,则可能会出现重复行。

例如,连接父表和子表时,如果没有将子表行与其父单据匹配,可能会产生过多行。

请检查查询是否使用正确的父字段连接子表,例如:

child.parent = parent.name

当子表是共享的或查询需要更具体时,还要检查 parenttypeparentfield 等字段。

5. 报表未进行分组

如果目标是每个单据显示一行,则报表可能需要进行分组或聚合。

例如,报表可以不单独显示每个项目行,而是按销售发票分组并显示:

  • 总数量
  • 总金额
  • 项目行数
  • 首个或最后一个日期

这取决于您需要的是汇总报表还是明细报表。

如何检查行重复的原因

  1. 打开其中一个重复的单据。
  2. 检查其子表中是否有多行,例如项目、税费、付款计划或其他明细表。
  3. 在报表中,检查是否有任何选定的列来自子表。
  4. 如果是自定义报表,请检查连接和筛选条件。
  5. 确定报表应显示明细行还是每个单据一行汇总行。

如何实现每个单据显示一行

如果您希望每个单据显示一行,请尝试以下方法之一:

  • 从报表中移除子表列。
  • 仅使用父 DocType 中的字段。
  • 使用分组,例如按单据名称分组。
  • 使用聚合值,如求和、计数、最小值或最大值。
  • 构建一个自定义查询报表或脚本报表,使其每个父单据返回一行。

总结

当报表包含子表数据或其他明细级记录时,同一单据出现多行通常是预期行为。

关键问题是:报表应显示每一行明细,还是应将单据汇总为一行?

如果报表旨在回答项目级、税务级、分类账级或库存条目级的问题,则多行是正确的。如果旨在回答单据级的问题,请使用父字段、分组或自定义报表设计。

  • 报表
  • 报表生成器
  • 查询报表
  • 脚本报表
  • 子表 / 表格 DocType

帮助文章索引

以下是一些帮助文章,可帮助您根据需求配置系统。

系统

  • 文档版本管理
  • 在持续进行的消息中添加附件
  • 复制粘贴多条记录
  • 重命名文档
  • 批量重命名
  • 删除和恢复文档
  • 删除自定义报表
  • 恢复已删除的文档
  • 重复记录
  • 检查文档之间的链接
  • 选择字段中的筛选选项
  • 自动化分配
  • 发送和接收邮件时出错
  • 最大用户数限制问题
  • 权限级别错误
  • 权限错误问题
  • 使用预生成的报表
  • 未收到邮件
  • 表单中的最大字段数
  • 制作自定义报表
  • 删除自定义报表
  • 报表中一个文档显示多行
  • 在标准报表中添加列
  • 使用 Jinja 获取子表值
  • 创建字段后更改自定义字段的数据类型
  • 按公司设置命名系列
  • 使用 Web 表单请求反馈
  • 管理主数据的树形结构
  • 为任何字段设置默认值
  • 设置精度
  • 设置语言
  • 编辑已提交的文档
  • 删除已提交的文档
  • 设置命名系列的当前值
  • 设置工作流的简单步骤
  • 树形主数据重命名
  • 报表中的信头
  • 将文档类型与事件日历同步
  • 基于层级结构的用户权限
  • 在打印格式中添加/删除字段
  • 自定义打印格式中的表格
  • 自定义打印格式中的字段可见性
  • 移除打印格式中的描述
  • 以文字形式打印美元的“分”

会计

  • 合并科目
  • 更改上级科目
  • 冻结科目
  • 冻结会计凭证
  • 通用应收科目
  • 销售退货管理
  • 从销售发票交货
  • 默认应收/应付科目
  • 资本科目的付款凭证
  • 登记备用金凭证
  • 坏账处理
  • 采购发票科目类型错误
  • 分别登记允许和收到的折扣
  • 为日记账凭证添加参考
  • 付款凭证中的发票折扣
  • 从所有者权益科目中提取工资
  • 买一赠一定价规则
  • 无金额调整
  • 远期支票凭证
  • 差额凭证
  • 设置税费
  • 未对账
  • 期末结账凭证
  • ERPNext QuickBooks 迁移工具
  • 处理对账单
  • 付款条款状态报表
  • 公司间日记账凭证
  • 在单独往来单位科目中预付款
  • 会计年度错误
  • 舍入科目验证消息
  • 删除与总账凭证关联的凭证
  • 发票舍入问题
  • 自定义现金流量表
  • 导出特定年份或筛选条件的数据
  • 分配贷项通知单和付款
  • 核对供应商预付款
  • 临时科目余额
  • 计算运费税费
  • 已收货但未开票的目的
  • 期末结账

采购

  • 服务采购发票
  • 价格调整的借项通知单
  • 采购跟踪报表
  • 提交后修改采购订单

销售

  • 销售人员目标分配
  • 在销售周期中更改项目费率
  • 销售交易中的销售人员
  • 记录销售合作伙伴的佣金
  • 批量提前关闭订单
  • 关闭销售订单
  • 提交后修改销售订单
  • 应用折扣
  • 从销售订单请求原材料
  • 设置公司销售目标
  • 无项目的销售发票
  • 子公司之间的直运
  • POS 中的忠诚度积分兑换
  • 以不同计量单位销售

资产

  • 将资产从库存项目转换为固定资产项目

客户关系管理

  • 自动化潜在客户创建
  • 潜在客户、联系人和客户之间的区别

库存

  • 使用条形码跟踪项目
  • 项目估值设置和交易
  • 原材料估值
  • 退回拒收项目
  • 重新包装凭证
  • 国际贸易术语和指定地点
  • 快速库存余额
  • 质量检验摘要
  • 迁移到永续盘存制
  • 先进先出和移动平均法
  • 非库存项目的永续盘存
  • 预计数量
  • 序列化和批次项目的期初库存余额凭证
  • 关联库存仓库和科目
  • 在项目主数据中维护供应商项目代码
  • 以不同计量单位采购
  • 生产废料管理
  • 客户提供的项目
  • 单一原材料生产多种成品
  • 不创建物料清单进行生产
  • 物料消耗
  • 生产分析
  • 未结工单报表
  • 需求驱动预测
  • 产品计划报表
  • 停机分析
  • 工单消耗物料
  • 针对工单退回的物料
  • 针对工单发出的项目
  • 从交货单和采购收货单进行物料转移
  • 允许超额交货/开票
  • 物料编码

项目

  • 制作彩色甘特图
  • 在项目中批量分配任务
  • 项目盈利报告
  • 项目管理与费用控制
  • 从客户门户创建项目

网站

  • 在ERPNext网站中禁用注册功能
  • 网站首页设置
  • 网站横幅尺寸调整
  • ERPNext的SEO优化
  • ERPNext中的301重定向