Files
dxdesigner-part-replacement/docs/user/v1.1.0-project-tasks.md

9.3 KiB
Raw Permalink Blame History

DxPartReplace V1.1.3 中文使用说明

保留原有任务视图和料号规则编辑,支持按工程拆分任务、按位号选择替换目标及可选 Excel 操作。

第一次使用请先看 README 逐步图文教程,按截图完成创建任务、BOM、替换和结果查看。以下内容用于补充查询各项规则。

日常流程

  1. 点击“新建”,填写或选择根目录,点击“读取工程”。勾选要处理的 .prj 后创建任务,每个工程对应一个任务。已存在未完成任务的工程不会重复创建。
  2. 在任务详情的“料号规则”页填写旧料号、新料号。新建任务只绑定一个工程;历史多工程任务仅供查看。
  3. 打开“位号计划”,点击“采集所有匹配位号”。采集读取工程中的器件 UID、位号、图页、旧料号和原 Value,不保存工程。
  4. 在表格中勾选需要替换的位号,其余行保持不勾选。查找框支持位号、UID、图页、料号和 Value,查找只过滤当前显示,不删除计划行。可逐行填写不同新料号、自定义 Value 和“同步 NC”,也可对可见行批量填写新料号。采集后的位号默认保留,避免误替换。
  5. 点击“保存位号计划”。有未保存的编辑时无法执行;切换任务会保留编辑草稿。重新采集会核对工程身份并保留已保存计划;有未保存编辑时会提示丢弃草稿。
  6. 点击“执行当前任务”只处理当前绑定工程,或点击“顺序执行本批任务”按任务顺序处理同批工程。上下移动按钮调整顺序。每次仅处理一个工程,暂停在当前步骤收尾后生效。

执行状态、失败重试和中断核验集中在底部操作区。界面不再维护当前任务的工程选择列表,避免工程范围和按钮范围混淆。

执行日志与修改明细

任务执行结束或暂停后,可以在“替换结果 / 日志”窗口查看修改明细。每个完成步骤按位号列出旧、新物料号,例如:图页 MAIN:1 · 已保存并核验 · 位号 R1:4100-CA0000-T7 → 4100-CA0000-T0;识别到 NC 并同步时另列说明。未命中、失败和保存后待核验分别显示状态,不计为成功修改。

明细来自执行器实际回读结果,不以勾选计划代替执行结果。同一工程的不同图页、规则分别保留记录;重新打开已完成任务时保留计划工作区,点击“替换结果 / 日志”按需查看。日志每页读取 200 条事件,可用“上一页日志”和“最新日志”翻页,包括保留的轮转记录;结果表最多显示当前页最近 500 条位号回读记录。详情窗口关闭后释放,重新打开读取最新页。历史版本未记录的中间步骤无法事后补全。

执行日志同时记录采集、图页枚举及队列准备、工程备份、每个“图页 × 规则”步骤、进度同步和任务合计的耗时及速率。一个步骤可能修改多个位号,步骤速率不等于器件替换速率;失败或暂停不会计为成功完成的任务。执行器的进度阶段耗时随该步骤证据保留,用于区分打开工程、原生替换、属性恢复、保存与回读的时间。任务合计包含子步骤,统计时不能重复相加。

可选 Excel 操作

无需导出也能完成全部编辑。读取工程创建任务后,点击“BOM 模板”会生成同批所有工程的一张表:工程名称和工程路径自动填写,每个工程预留一行,旧料号、新料号和位号留空,不要求先采集或填写规则。需要同一工程多条替换时复制该工程行;工程路径用于唯一分配任务,应保持原样。发布附件另提供通用空表;已创建任务时优先使用工具生成的本批模板。

表头批注包含中文填写说明,一行可以填写多个位号(逗号、分号、空格或顿号分隔),并填写替换开关、Value 和同步 NC。只填写工程信息的空白行会被忽略,未填写替换行的工程保留原计划。需要导出已采集的完整数据时,保存编辑后使用“导出位号计划”。

导入先核对所有工程归属,再按工程匹配位号;缺少清单时,按该工程 BOM 中的旧料号只读采集。不会执行替换。切换任务可查看、编辑各自预览,点击“保存本批位号计划”才一次写入所有受影响任务。保存失败全部回滚,预览期间不改已保存计划。工程、图页、UID、位号、旧料号及原 Value 用于身份校验,未知工程、重复器件或跨工程目标都会拒绝;不接受公式。布尔选项可使用 TRUE/FALSE 或 是/否。

V1.1.3 已包含原生采集:本机有兼容的 icdb2ascii.exe 时,BOM 校验和位号采集优先在临时数据库副本中一次导出真实 UID、位号及物料属性,不必逐条启动 CAD 查找。工具不可用或报告不受支持且已安全清理时,自动使用原 CAD 采集。源工程变化或后台清理不确定时停止并保留诊断;完整图页查询和实际替换仍沿用原执行链。运行前请保存并关闭目标工程。详情见 原生采集接入记录。

首次采集中未被 BOM 列为替换目标的位号默认“不替换”;已有计划中未列出的行保留原勾选和编辑状态,不会因后续 BOM 省略而自动停用。如果本次仅执行 BOM 列出的目标,请在预览中检查并取消其他启用行,或在 BOM 中显式填写对应的 enabled=FALSE 行。每个填写的位号须在当前工程清单中唯一匹配;同名位号跨图页时应填写图页或 UID。导入失败不会改变已保存计划。

“同步 NC”默认勾选,可以按行关闭;仅按原规则识别独立 /NC 标记。Value 复制选项和每行自定义 Value 延续原工具的处理方式。替换计划不允许旧、新料号相同,也不允许同批链式或循环替换。

保存、恢复及旧任务

执行前保留原工具的备份流程,替换后保存、关闭并重新打开核验。执行证据按任务存放。目标 UID、位号、原 Value 或旧料号变化时会停止校验,绝不会退回替换全部同料号器件。保存结果不确定时停止队列,先使用核验恢复入口处理。

旧数据库自动升级并保留任务、状态、规则。未采集位号计划的历史任务沿用旧流程;采集后,即使没有勾选位号,也不会触发全量替换。建议首次使用新版本前自行复制原工具的 data 文件夹;不同版本不要同时打开同一数据目录。

验证范围

快速测试覆盖任务拆分、SQLite 迁移、位号筛选、Excel 往返、串行调度和界面编辑;发布构建另检查执行保护及冻结程序启动。测试不会修改生产 CAD 工程。

本机 7.9.5 的真实 TypeLib 没有可直接调用的 ReplacePart 方法,生产替换仍沿用原生对话框及 Library Wins。详见 docs/research/v1.1.0-native-interface-probe.md。实际中央库、器件替换和保存回读仍需用工程副本现场验收。

后台运行与释放(1.1.1)

任务中心的自动采集、替换和中断核验恢复已默认接入私有 Windows 桌面。工具显式启动并持有自己的 CAD,通过私有桌面、会话 GUID 和活动图页窗口所属 PID 校验连接,不接管主桌面已有 CAD,也不自动退回主桌面执行。

主桌面可以继续查看其他文件。开始前仍须保存并关闭本次目标工程,运行中不要在其他软件内打开或修改同一工程;共享的许可证、CPU、磁盘和中央库资源仍会影响速度。本机不同轮次的私有 CAD 启动约 22~67 秒,也曾出现启动阻塞;1.1.2 的启动等待有 120 秒上限和取消检查,超时后收尾并保留诊断,不把增加等待上限视为已修复阻塞根因。

同一工程连续步骤复用后台会话,任务仍顺序执行。界面显示“启动后台 CAD”和“关闭 CAD 并释放后台会话”。任务完成或在步骤检查点暂停后,工具关闭自有工程、正常退出 CAD,确认进程退出,再清理自有 Job 子进程及句柄,并确认私有桌面消失。每次会话的启动、退出和清理证据单独保留在 private-desktop-sessions 下。

单步入口也执行备份、保存、重开核验和关闭。恢复成功会显示属性已保存并重开回读,无需用户另开后台工程手动保存。启动阶段尚未进入工程执行且清理成功时可以重试;执行超时、状态不确定或清理失败仍保留保护状态,由核验恢复入口处理。

该后端已在独立真实副本上完成替换、保存回读、暂停、恢复、启动取消及超时退出验证,详见 验证记录。1.1.1 发布包已包含此更新,详见 版本说明。

1.1.2 增加执行证据长路径兼容:系统没有可用短文件名时,程序自动通过内部短目录入口访问,原任务数据、备份和日志仍在原目录;正常退出后清理入口。无需为了执行证据路径过长而先搬动工具目录。该兼容不代表旧版 CAD 支持任意长度的工程文件或中央库路径,相关路径仍受 CAD 本身限制。冻结 EXE 的长路径及 BOM 流程详见 成品验收。