跳转至

通用选择器过滤惯例

适用基线:测试环境目标 / dev 分支 / 2026-07-22。 用途:跨页复用的主数据 / 单据选择器通例。业务页只写本页差异并链接本页。 写法规范见页面数据字典规范

被引用锚点(供业务页摘要链接): 主数据选择通例 · 单据来源选择通例 · 库存余额选择与粒度 · P13 口径

本页解决什么问题

多个业务页都会选物料、供应商、来源单、库存余额——若每页复制一张空表,过滤口径很快漂移。本页沉淀 跨页复用的选择器通例(可选范围、依赖、选不到先查什么、证实程度),并强调:配了数据权限 ≠ 全站选择器自动变窄。

读完应能判断:业务页该链本页还是自写差异;「选不到」先查停用、权限、来源状态还是岗位库位;未闭合的 ❓ / GAP 不得改写成全站已确认规则。

如何使用本页

你的目的 建议做法
理解选择器通例 按对象读第 2~3 节表;库存类转第 5 节与粒度页
写业务页时引用 ≥3 页同类过滤:一句话摘要 + 链接本页;本页特有过滤与 P5 回填写业务页
排障「选不到」 先按表「选不到时先查什么」;P13 先确认对象是否挂接部门规则
验收写法 禁止只写「弹窗选择」;未证实项保留

1. 何时引用本页

当 ≥3 个业务页出现同类选择器过滤时,业务页用一句话摘要 + 链接本页,避免复制空表。

2. 主数据选择通例(P2 / P13)

通例 可选范围(默认期望) 常见依赖 选不到时先查什么 证实程度
仅可用主数据 状态可用 / 未停用的主数据 「是否可用」、启停动作 目标是否已停用 多数主数据页有启停;各业务选择器是否一律过滤 ❓ 待确认
按组织/工厂/货主裁剪 当前用户数据权限范围内的对象 登录组织、货主、部门等 权限与主数据归属 逐页实测矩阵未闭合(GAP-014
按角色部门五档裁剪列表/选择器 仅对已挂接部门数据权限的对象生效 角色 dataScope、用户部门 业务表是否挂接(GAP-070 System 用户/部门已挂;WMS 普遍未挂;其它模块清单未齐
按岗位库位裁剪 岗位关联库位范围内的任务/库位 岗位—库位 岗位配置,而非角色部门五档 机制已证实,与部门五档独立
物料用于采购场景 来源范围内物料,且宜满足可采购等用途 来源单、供应商、用途开关 不在来源明细、停用、用途关闭 用途开关过滤时点 ❓(见物料基本信息)
供应商 / 客户 可用供应商或客户;关系页再收窄到已绑定物料 可用性;关系表 未建主数据或关系 导入与页面校验可能不一致,见对应 GAP
包装规格 / 物料包装 可用包装规格;物料包装常按「物料 + 包装单位」唯一 先选物料再选包装(P4) 未维护物料包装、重复键 GAP-025/GAP-026

P13 口径: 配了角色数据范围 ≠ 全站选择器自动变窄。先确认目标对象是否接入部门规则;库位现场隔离优先查岗位库位。详见数据权限与决策权限

3. 单据来源选择通例(P2)

通例 可选范围 常见依赖 选不到时先查什么
采购订单作收货来源 已发布,且符合当前 ERP 订单类型 业务类型 / 订单类型 未发布、类型不符、无剩余可收
申请生成任务后的下游 通常不再从全量订单重选,而从来源申请/任务带出 申请/任务状态 上游未处理或已关闭

具体单据以各业务页选择器范围表为准;本表不替代采购收货等样板中的逐字段说明。

4. 业务页应保留的差异

  • 本页特有的额外过滤(例如仅某库存状态、仅某仓库)。
  • 选中后回填与锁定(P5)——通例不规定可改字段。
  • 未证实项必须在业务页保留 ❓ 待确认,不要因本页存在而改写成「已确认全站规则」。

5. 库存余额选择与粒度(P3 / P8)

业务键与采集要求见库存管理精度与唯一粒度。选择库存余额时必须写清过滤粒度与可用量口径;禁止只写「弹窗选库存」。

自检或验证点

  1. 业务页是否用「摘要 + 链接」复用本页,而不是复制空表?
  2. 「选不到」排查是否区分:停用、来源状态、部门数据权限、岗位库位?
  3. P13 是否仍按「先确认是否挂接」表述,而非写成全站自动裁剪?
  4. 库存选择器是否落到粒度页要求的过滤粒度与可用量口径?

6. 相关文档