一、功能概述

1. 模块入口与用途

入口：物料分类管理窗口 → 批量归类按钮。
核心作用：批量批量修改物料所属树形分类，一次性把大量物料移入/移出指定物料分类，替代单个物料档案手动修改分类，大幅提升建档、品类调整效率。
底层数据表：物料主表 PCode_Materiel，修改字段 fClassID，自动记录操作人、修改时间并留存变更日志。

2. 适用业务场景

1. 新店初始化：一次性批量导入面粉、奶油、包装等原料，统一归类到「02原材料」下级分类；
2. 品类重组调整：产品线拆分、合并，批量把一批蛋糕物料从旧分类迁移至新子分类；
3. 历史数据规整：早期未规范分类、未归类物料，批量统一归到对应大类；
4. 报表/权限前置处理：按分类统计库存、营收前，批量修正物料分类保证数据准确；
5. 门店分权管控：批量调整物料分类后，配合「类别权限管理」实现门店可视范围隔离。

3. 前置依赖规则

1. 物料分类树形必须提前在【物料分类】窗口建好；
2. 系统特点-物料分类特点已完成【启用物料设置】；
3. 仅支持未删除（SignDelete≠1） 的有效物料，作废物料不参与查询与归类；
4. 操作仅修改物料 fClassID 分类ID，不改动物料编码、名称、库存、价格等其他字段。

二、界面分区完整说明

顶部提示栏

必须点击【保存】按钮后才生效。
所有移入/移出操作仅为界面临时预览，不点保存不会写入数据库，关闭窗口直接丢弃所有调整。

左侧：查询条件面板（筛选待处理物料）

1. 筛选勾选框

• 物料编号：勾选后支持按物料编码模糊筛选；
• 物料名称：勾选后按物料名称模糊筛选（默认勾选）；
• 物料分类：指定树形分类筛选物料；
• 供应商/助记码/是否归类：扩展筛选维度，按需勾选启用；

2. 指定分类单选

• 指定：手动输入分类编号/名称精确匹配；
• 指定分类（默认选中）：下方树形下拉选择目标父分类，筛选该分类下全部物料；
  树形列表：加载系统全部物料分类树形，勾选后限定查询范围；

3. 快捷操作快捷键

• 全选[F11]：选中当前查询结果全部物料；
• 取消选择[F12]：清空所有选中条目；
• 满屏选择：框选列表连续多行物料；

4. 底部查询控制

• 查询[F3]：按上方条件执行筛选，刷新左右两侧物料列表；
• 只查未归类：勾选后仅显示 fClassID=0 无分类的空白物料，用于规整历史脏数据。

右上区域：属于该类的物料

标题展示格式：分类编号--分类名称（例：020101--高筋粉）
列表内条目前缀带 *，代表当前已归属本分类的物料；
展示字段：物料编号、物料名称、基本单位、原分类名称。

右下区域：不属于该类的物料

展示当前归属其他分类 / 无分类的全部物料，可移入上方目标分类。

中间操作按钮（物料左右迁移）

1. 全部移出：把上方「属于该类」所有物料批量移到下方列表，全部取消本分类归属；
2. 移入：选中下方多条物料，一键移入上方分类；
   双击下方单条物料 = 快速移入；
3. 移出：选中上方多条物料，一键移出本分类；
   双击上方带*单条物料 = 快速移出；
4. 全部移入：下方所有物料全部批量加入当前分类。

底部功能按钮

1. 保存：提交所有移入/移出变更，批量UPDATE物料表 fClassID，记录操作人、时间，写入变更日志；
2. 还原退出：放弃本次所有调整，恢复打开窗口初始状态后关闭；
3. 退出：直接关闭窗口，未保存修改全部丢弃；
4. 帮助：打开本在线帮助文档。

三、标准操作流程

场景1：批量将物料归入当前分类

1. 左侧查询条件勾选「物料名称」，树形选择参考分类缩小查询范围；
2. 点击【查询[F3]】加载物料；
3. 在右下「不属于该类」列表单选/多选目标物料：

• 少量物料：双击条目快速移入；
• 大批量：选中多条点【移入】，或直接【全部移入】；

4. 确认右上列表已包含需要归类的全部物料；
5. 点击【保存】完成批量归类。

场景2：批量移除物料，取消本分类归属

1. 查询加载后，右上「属于该类的物料」选中需移除物料；
2. 点【移出】/双击条目，物料移动至下方列表；
3. 如需清空本分类所有物料，直接点击【全部移出】；
4. 核对无误后点击【保存】提交变更。

场景3：批量规整无归类物料

1. 左下角勾选【只查未归类】；
2. 左侧树形选择目标分类，执行【查询】；
3. 全部移入至右上分类列表，保存即可统一分配分类。

四、常见问题与报错处理

1. 操作完关闭窗口，物料分类无变化
   原因：未点击【保存】直接退出，界面调整未落地数据库；
   解决：调整物料归属后必须点击底部【保存】。
2. 查询不到目标物料
   排查：①物料已标记删除SignDelete=1；②查询条件勾选过多过滤掉数据；③勾选「只查未归类」时物料已有分类；
   处理：取消多余筛选条件、取消只查未归类、核对物料是否作废。
3. 移入/移出按钮灰色无法点击
   排查：未选中列表内任意物料；对应列表无数据；
   处理：鼠标点选一条或多条物料条目后再操作。
4. 保存后报表分类统计数据不对
   排查：部分物料忘记移入、操作后未保存；存在多窗口同时修改物料分类冲突；
   处理：重新打开归类窗口核对归属，重新执行保存。
5. 新增子分类后无法批量归类物料
   排查：物料分类特点中「级别数」设置过小，新增层级超出限制；
   处理：进入【设置系统特点-物料分类特点】调大级别数。

五、功能限制与注意事项

1. 一次批量支持上千条物料处理，大批量操作保存会短暂卡顿，请勿中途关闭窗口；
2. 本窗口仅修改基础树形分类fClassID，不控制【扩展分类】字段；扩展分类需在物料档案单独维护；
3. 批量归类不可逆，保存前务必核对左右两侧物料清单，避免误批量移出；
4. 多用户同时操作同一批物料会产生数据覆盖，建议单门店同一时间仅一人操作批量归类；
5. 作废、已停用删除的物料不会加载到列表，无法通过本窗口修改分类；如需调整需先恢复物料。