通用选择器过滤惯例¶
适用基线:测试环境目标 /
dev分支 / 2026-07-22。 用途:跨页复用的主数据 / 单据选择器通例。业务页只写本页差异并链接本页。 写法规范见页面数据字典规范。
本页解决什么问题¶
多个业务页都会选物料、供应商、来源单、库存余额——若每页复制一张空表,过滤口径很快漂移。本页沉淀 跨页复用的选择器通例(可选范围、依赖、选不到先查什么、证实程度),并强调:配了数据权限 ≠ 全站选择器自动变窄。
读完应能判断:业务页该链本页还是自写差异;「选不到」先查停用、权限、来源状态还是岗位库位;未闭合的 ❓ / 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)¶
业务键与采集要求见库存管理精度与唯一粒度。选择库存余额时必须写清过滤粒度与可用量口径;禁止只写「弹窗选库存」。
自检或验证点¶
- 业务页是否用「摘要 + 链接」复用本页,而不是复制空表?
- 「选不到」排查是否区分:停用、来源状态、部门数据权限、岗位库位?
- P13 是否仍按「先确认是否挂接」表述,而非写成全站自动裁剪?
- 库存选择器是否落到粒度页要求的过滤粒度与可用量口径?