Skip to content

设置、流程与结果的导入导出边界 ​

按要保存、迁移或交付的对象选择入口:配置备份、流程包、图像、客户报表和协议输出分别由所属模块处理。本页提供入口与核对方法;单项导出只覆盖该对象的内容。

导出可能包含客户和设备数据,共享前须脱敏。导入可能覆盖配置、创建模板或改数据库,执行前确认精确目标及可用备份;仅查询方法不授权实际导入、运行流程或发送 Socket/MES 消息。

按对象定位入口 ​

对象当前入口与实现能力边界
软件配置与备份“配置”中的“配置恢复点”提供创建备份和打开备份文件夹;配置服务另有滚动备份与重载接口两种备份独立,均不等于全部数据库与结果图的备份
单流程及关联模板 .cvflowTemplateFlow 调用 FlowPackageHelper带关联模板及引用处理;包兼容与导入规则见模板与 Flow 链路
多选流程TemplateFlow 多选导出当前是 zip 内多个 .stn,不能等同于多个完整 .cvflow 包
数据库记录所属业务结果页或实体通用查询用于确认源记录和范围,不能据此推断存在通用数据库迁移向导
CSV、Excel、报告对应业务窗口或项目 exporter字段、单位、判定与格式版本由具体业务实现决定
原图与带 overlay 的结果图ImageEditor / 结果窗口;ImageView.Snapshot.cs区分原始像素导出和渲染快照,核对是否包含叠加层、尺寸与格式;见ImageEditor
.cvraw / .cvcie 原生图像原生导出窗口或命令行 -e / -o通道、位深、命名和覆盖规则见CVRAW / CVCIE 图像导出
已有文件的网页传送与分享Web“文件中转”(/transfer)传送已有文件,不生成业务导出或导入内容;上传、续传与分享保留期见文件中转
Socket/MES 响应项目 handler 和 ColorVision.SocketProtocol属于协议输出,不是文件导出;项目结果与关联字段见结果链路

配置文件与备份 ​

在配置页的“配置恢复点”中,管理员可创建备份或打开 MaintenanceBackups 文件夹。创建备份先保存当前设置,再备份完整主文件;该目录不参与配置服务的 Backup 滚动备份自动回退。

ConfigHandler.SaveConfigs(fileName) 仍是底层保存接口:序列化当前已实例化的配置对象,并合并目标文件已有节。新目标可能缺少从未实例化的节,已有目标也可能保留其它旧节;该接口不构成全项目备份。保存校验、备份回退、重载通知与旧对象引用的边界统一见配置持久化与重载。

按对象核对导出结果 ​

先记录对象、来源入口、输出位置和预期格式,再用适用于该对象的检查判断是否完成。使用已有获授权样例即可;另跑流程、写入数据库或向外部系统发送消息有各自的执行前提。

对象核对内容
软件设置文件内容可解析,包含所需配置节;需要迁移时另核对目标模块的重载结果
流程包或多选 zip文件可读取,流程名称、条目数和关联模板符合所选范围;导入成功与运行时引用可用分别核对
CSV、Excel、项目报告对应同一 SN、批次或时间范围的源记录;检查格式版本、字段顺序、单位、判定与时间,空文件不能代替源数据证据
图像原图或渲染图模式、尺寸、位深、所需通道和 overlay;原生导出另按其主题检查命名碰撞和部分通道成功
Socket/MES 输出对应项目的最终结果、响应字段及外部接收结果;本地文件存在不证明协议交付
网页文件中转各项上传完成状态和实际分享/下载内容;传送完成不验证文件内部业务字段

保留足以复核本次交付的脱敏样例与来源信息;数据库记录、截图或外部响应按对应对象的需要收集。

故障分流 ​

现象第一检查点
找不到导出按钮对象属于设置、流程、图像还是具体业务窗口;不要寻找不存在的总导出菜单
文件为空或字段不对源数据、选定批次/SN、项目 exporter 与客户格式版本
图片/overlay 不对齐原图与结果图是否同一轮、坐标空间及导出模式;按三条结果链定位
外部系统收不到项目是否已生成最终结果、协议与端口、项目 handler 和响应关联字段
导入后行为变化实际被替换的配置与重载结果;流程模板、数据库及图片是否仍是原环境数据

源码与验证边界 ​

配置加载在 UI/ColorVision.UI/ConfigHandler.cs,保存在 ConfigHandler.Save.cs,默认值与备份在 ConfigHandler.Backup.cs;流程入口在 Engine/ColorVision.Engine/Templates/Flow/TemplateFlow.cs;图像快照与原图保存入口在 UI/ColorVision.ImageEditor/ImageView.Snapshot.cs。

迁移后按模块验证配置重载、流程包和模板引用。项目报表字段与 Socket/MES 对接需用现场对应样例验证。

基于 MIT License 发布。