文档说明

本文档为所有采用树形分类的编码窗口通用操作手册，后代业务窗口（物料分类、部门档案、会员等级、工序分类等）共享本套基础操作逻辑，仅业务专属字段、扩展功能在各自窗口单独补充说明，无需重复编写基础操作内容。

一、基础概述

1. 权限定义

本窗口默认支持3套个权限，所有后代窗口自动继承，无需重复配置：

权限名称	控制范围
修改	控制【编辑】按钮，无权限则无法进入编辑模式，新增/删除置灰
修改用过的编码	当编码已被业务单据引用时，弹出二次确认；无权限直接拦截修改
管理	控制【记录明细】、自定义表扩展、高级后台功能

二、界面布局

所有树形编码的后代窗口布局一致

窗口分为五大固定区域：

1. 顶部工具栏：退出、编辑、刷新、附件 通用按钮
2. 左侧树形编码区）：层级树列表，右键弹出树形操作菜单
3. 右侧属性面板：选中节点后展示全部字段，编辑模式下可修改字段值
4. 右侧辅助面板：业务说明/在线帮助富文本区域（各业务窗口填充专属说明）
5. 底部状态栏：附件数量提示、系统状态；左侧菜单栏：工作、常用、帮助

全局右键菜单

右键点击左侧树节点弹出菜单，内置功能：

1. 新增同级节点、新增下级子节点
2. 删除当前节点
3. 查看记录变更版本
4. 隐藏功能：节点排序、导出节点文本（基类默认不启用）

三、顶部工具栏按钮

1. 退出

关闭当前树形窗口；若当前处于编辑/新增状态，自动提交保存未完成修改，再关闭页面。

2. 编辑

• 权限控制：仅拥有【修改】权限时按钮可用；
• 编辑状态：此时我们切换选中其他节点、刷新、关闭窗口、手动保存均会自动保存当前编辑内容。

3. 刷新

1. 保存当前选中节点ID，重载全量树形数据；
2. 自动过滤 SignDelete=1 已删除数据；
3. 刷新后自动定位回刷新前选中的分类节点，无需重新查找；
4. 同步其他电脑终端新增/修改的编码数据（如果有多人同时在修改这个树）。

4. 附件

1. 打开通用附件管理器，给当前编码绑定图片、文档、Excel等附件；
2. 底部状态栏自动统计并展示当前节点附件总数；
3. 无附件时状态栏清空提示；只读权限下附件窗口仅查看，无法上传删除；
4. 系统参数关闭附件模块时，按钮自动隐藏。

四、树形节点通用操作

前置条件

所有树形操作必须先点击顶部【编辑】按钮解锁，未进入编辑模式时右键菜单、新增删除全部置灰禁用。

1. 新增同级节点（新增顶层/同层级分类）

操作方式：右键树 → 新增同级节点

1. 自动创建和当前选中节点同一层级的新项目，默认名称“新项目”；
2. 层级校验：无最大层级限制（层级上限由后代业务窗口单独控制，如物料分类限制7层）。

2. 新增下级子节点（子分类）

操作方式：右键树 → 新增下级子节点

1. 在当前选中节点下创建子节点，默认名称“下级项目”；
2. 父子关系自动绑定：新增节点 ParentID = 父节点主键ID，树形自动渲染层级缩进。

3. 删除节点（逻辑删除，无物理删除）

操作方式：右键树 → 删除当前记录，多重拦截校验：

1. 拦截1：节点存在子分类 → 提示「当前记录还有下级记录，请先删除下级记录」，禁止删除；
2. 拦截2：弹窗二次确认「确定要删除当前记录吗？」，取消则终止操作；
3. 删除底层逻辑（核心）：

• 不直接删除数据库数据，执行逻辑软删除；
• 自动赋值：SignDelete=1、DeleteMan=当前登录账号、DeleteDate=系统当前时间；
• 页面自动过滤已删除节点，刷新后树形不再展示；

4. 业务数据拦截（后代窗口扩展）：如物料分类绑定商品，则后代窗口重载删除事件，拦截已有业务数据的分类删除。

4. 查看记录变更版本（右键菜单）

打开编码版本追溯窗口，展示当前节点所有新增、修改操作历史，记录每一次修改前后字段对比、操作人、操作时间；用于数据溯源、核对误操作。

五、顶部菜单栏

5.1 工作菜单

1. 回收站​

• 打开已逻辑删除的编码列表，展示所有 SignDelete=1 的节点；
• 支持还原删除的编码，还原后刷新树形，节点重新显示；
• 若编码关联业务单据，还原逻辑由后代窗口自定义。

5.2 常用菜单

1. 记录明细（权限【管理】可见）
   查看当前数据集完整原始记录，包含隐藏字段、删除标记、操作人等底层数据库信息；供运维排查数据异常使用。
2. 查看SQL语句（开发调试用）
   按住 Ctrl 点击右侧图片图标快速打开；展示当前树形查询SQL、全部业务字段释义，用于开发调试、SQL报错排查。默认是没有这个菜单项目的，如果需要这个功能，需要通过定义特点来打开。
3. 扩展表设计（开启扩展字段参数后可见）
   自定义增加业务扩展字段，统一复用平台自定义表结构能力，无需修改底层表结构。大部分客户不应该使用这个功能，使用前需要咨询安仕达软件。

5.3 帮助菜单

通用平台帮助入口、当前窗口专属在线帮助。

六、数据底层通用机制

1. 自动过滤已删除数据

逻辑删除的数据默认是看不到的，回收站功能单独查询删除数据。

2. 已使用编码修改拦截机制

当当前编码/分类已被单据、商品、配方等业务引用（SignUsed=1）：

1. 无【修改用过的编码】权限：直接弹窗「编码已经使用，你没有修改权限！」，禁止编辑；
2. 拥有权限：弹出确认框「编码已经使用，是否继续修改？」；确认后记录本次修改到临时列表，不再重复弹窗。

3. 自动保存修改历史

每次执行Post保存数据时，自动将修改前完整记录存入编码历史表，支持后续【查看记录变更版本】回溯。

4. 附件自动计数

底部定时器实时读取当前节点附件数量，状态栏展示「附件 X 个」，切换节点自动刷新计数；无附件时清空状态栏文字。

七、公共报错与通用解决方案（所有树形窗口通用）

1. 提示：当前记录还有下级记录, 请先删除下级记录!
   原因：待删除节点存在子分类；处理：先删除所有子节点，再删除父节点。
2. 提示：编码已经使用，你没有修改权限！
   原因：编码被业务单据引用，账号缺少【修改用过的编码】权限；处理：管理员分配对应权限。
3. 提示：确定要删除当前记录吗？
   正常二次确认；取消=放弃删除，确认=执行逻辑删除。
4. 编辑按钮灰色不可点击
   两种情况：①账号无【修改】权限；②软件试用版到期；联系管理员分配权限或激活软件。
5. 树形不显示新增/还原的节点
   点击顶部【刷新】重载数据；确认未勾选过滤条件，回收站查看是否误删。