系统
检测历史导出
按时间范围、图像源、缺陷类型与判定等条件筛选检测记录，既可先预览结果集而不写盘，也可把缺陷实例级明细、图片、统计摘要与导出清单写入指定目录InspectionHistoryExport · v1.0 · by system
输入参数 17
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 模式 | mode | enum | preview | 否 | 选择本次调用的工作方式：preview 只查询并给出结果集不写盘，export 查询后把明细与图片写到磁盘，filter 不查库而是在上一次预览回传的结果集上零 IO 重算；留空或取其他值时按 preview 处理 |
| 开始时间 | startTime | string | （空） | 否 | 查询时间窗的起点，格式为 yyyy-MM-dd HH:mm:ss；留空时自动取当前时间往前七天，格式非法或起点晚于终点会导致本次调用失败并在状态信息里说明原因 |
| 结束时间 | endTime | string | （空） | 否 | 查询时间窗的终点，格式同为 yyyy-MM-dd HH:mm:ss；留空时自动取当前时间，若填写的时间早于起点或格式无法解析，工具将返回失败并在状态信息给出提示 |
| 图像源过滤 | sourceId | string | （空） | 否 | 按单个图像源标识缩小查询范围，留空表示不限定图像源；它与多选的图像源条件取并集，两者同时填写时任一命中都会被纳入结果 |
| 图像源多选 | sourceIds | string | （空） | 否 | 一次指定多个图像源标识，可用逗号分隔或写成 JSON 数组；与单选条件合并取并集，留空时不额外增加来源限制 |
| 纳入实时数据 | includeRealtime | bool | true | 否 | 开启时用实时馈送补齐尚未入库的产品记录，关闭后只按已入库数据口径统计，便于与数据库结果对账；默认开启 |
| 缺陷类型 | defectTypes | string | （空） | 否 | 按缺陷名称或标识筛选，多个取值用逗号分隔；一次检测含多种类型时只要命中其中任一类型即计入结果，留空表示全部类型 |
| 判定 | verdicts | string | （空） | 否 | 按判定结果筛选，可选合格、不合格或未合并，多个取值用逗号分隔；留空时不对判定做任何限制 |
| 置信度下限 | minConfidence | double | 0 | 否 | 只保留置信度不低于该值的缺陷实例，取值在 0 到 1 之间；设为 0 表示不限制置信度，也是留空时的默认行为 |
| 产品号 | productIds | string | （空） | 否 | 按产品号筛选，多个取值用逗号分隔并支持前缀通配；留空时纳入全部产品，命中任一所列条件的产品都会进入结果集 |
| 选中行 | rowIds | string | （空） | 否 | 在 export 模式下限定只导出这些行标识，应填入预览输出的行标识数组；在 filter 模式下回传上一次预览的行标识，留空或占位值不影响 preview 的查询结果 |
| 导出目录 | exportDir | string | （空） | 否 | export 模式下用于存放产物的父目录，工具会在其下自动创建带时间戳的子目录；留空时导出会因未指定目录而失败 |
| 导出原图 | includeOrigin | bool | false | 否 | 开启后把缺陷图连同其所属原图一起复制，关闭时只复制缺陷图；默认关闭，开启会增加复制的文件数与体积 |
| 回传数据行 | filterRows | string | （空） | 否 | filter 模式必填，用于把上一次 preview 输出的数据行原样回传，工具据此在不查库的前提下重算结果；缺失时无法完成重算 |
| 回传缺陷ID | filterRowDefectIds | string | （空） | 否 | filter 模式必填，回传上一次 preview 输出的逐行缺陷标识，供重算时保持行与缺陷的对应关系；缺失将导致重算失败 |
| 回传文件事实 | filterRowMeta | string | （空） | 否 | filter 模式可选，回传上一次 preview 的逐行文件事实；缺省时体积、缺失与原图数会退化为 0，但数据行本身不受影响 |
| 复检口径 | recheckMode | enum | effective | 否 | effective 为默认口径，按最新复检结论覆盖当前有效判定；original 完全按原始检测数据判定，用于复检前后对账。查询与导出必须传同一个值 |
输出参数 34
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 运行结果 | resultCode | int | — | 否 | 本次调用的执行结果，0 表示成功，失败时返回非零值并在状态信息里说明具体原因 |
| 运行信息 | resultInfo | string | — | 否 | 对执行结果的可读说明，成功时给出提示文字，失败或取消时写明具体原因，便于界面直接展示 |
| 表头 | headers | string | — | 否 | 明细表的表头，以 JSON 数组形式给出固定的列名集合，三种工作方式返回的表头保持一致 |
| 数据行 | rows | string | — | 否 | 按行粒度组织的二维数据 JSON 数组，每一行对应一条缺陷实例，是预览、过滤与导出共用的结果集主体 |
| 行标识 | rowIds | string | — | 否 | 与数据行逐行对应的行标识数组，用于在导出或重算时精确定位到具体记录 |
| 行缺陷ID | rowDefectIds | string | — | 否 | 与数据行逐行对应的缺陷标识数组，供对话框在不访问磁盘与数据库的情况下完成过滤 |
| 逐行文件事实 | rowMeta | string | — | 否 | 与数据行逐行对应的文件事实，记录原图标识、缺陷图字节数与文件是否存在，是重算时体积与缺失统计的口径来源 |
| 行标记 | rowFlags | string | — | 否 | 与数据行逐行对应的标记数组，判定为不合格的行会置为相应标记，其余行为空，界面据此高亮或选中 |
| 缺陷类型选项 | defectTypeOptions | string | — | 否 | 缺陷类型的下拉选项，以 JSON 数组给出每项的标识、名称、计数与是否在字典中，取字典与实际数据的并集 |
| 缺陷类型值数组 | defectTypeIds | string | — | 否 | 缺陷类型标识的 JSON 数组，顺序与类型选项一致，可直接作为下拉框的取值列表 |
| 缺陷类型名称数组 | defectTypeNames | string | — | 否 | 缺陷类型名称的 JSON 数组，与类型标识数组逐位对应，可直接作为下拉框的显示文本 |
| 图像源值数组 | sourceIds | string | — | 否 | 结果集中出现过的图像源标识 JSON 数组，按标识升序排列，可直接作为下拉框的取值列表 |
| 图像源名称数组 | sourceNames | string | — | 否 | 图像源名称的 JSON 数组，与图像源标识数组逐位对应，可直接作为下拉框的显示文本 |
| 统计摘要 | statsText | string | — | 否 | 一行可读的统计摘要，汇总命中行数、缺陷图张数、预估体积与缺失张数，三种工作方式都会输出 |
| 缺陷实例行数 | totalRows | int | — | 否 | 按当前过滤条件命中后的缺陷实例总行数，反映结果集在过滤之后的规模 |
| 已选行数 | selectedRows | int | — | 否 | 选中的行数，预览模式为全部命中行，导出模式为实际写入的行数 |
| 产品数 | productCount | int | — | 否 | 结果集中去重后的产品数量，用于概览本次命中的产品规模 |
| 原图数 | imageCount | int | — | 否 | 按过滤后结果集统计的去重原图数量，用于估算需要处理的原图规模 |
| 预估体积 | estimatedBytes | double | — | 否 | 按去重后的源文件实际字节数累加得到的预估导出体积，供写盘前评估磁盘空间 |
| 缺失行数 | missingCount | int | — | 否 | 源文件已不在磁盘上的数据行数，用于提示有多少行对应的图片无法复制 |
| 缺失文件数 | missingFileCount | int | — | 否 | 去重后统计到的缺失图片文件数量，比缺失行数更贴近实际需要补齐的文件数 |
| 去重缺陷图数 | distinctCropCount | int | — | 否 | 实际需要复制的缺陷图张数，因多行可能指向同一张图，该值通常不大于数据行数 |
| 行粒度 | rowGranularity | string | — | 否 | 标明结果集的行粒度，固定为按缺陷实例组织，即一行对应一条缺陷实例 |
| 导出目录 | exportDir | string | — | 否 | 本次导出实际使用的子目录路径，导出模式下为自动创建的带时间戳目录，其余模式为空 |
| 明细文件 | csvPath | string | — | 否 | 导出的明细 CSV 文件绝对路径，采用带 BOM 的 UTF-8 编码与 CRLF 换行，仅在导出成功后有效 |
| 摘要文件 | summaryPath | string | — | 否 | 统计摘要 CSV 文件的绝对路径，记录本次导出的汇总信息，仅在导出成功后有效 |
| 清单文件 | manifestPath | string | — | 否 | 导出清单 JSON 文件的绝对路径，记录过滤条件与产物构成，仅在导出成功后有效 |
| 导出行数 | exportedRows | int | — | 否 | 实际写入明细文件的行数，导出模式下等于被选中的目标行数 |
| 已复制缺陷图 | copiedFiles | int | — | 否 | 成功复制的缺陷图张数，已按文件去重，仅统计真正落盘的缺陷图 |
| 已复制原图 | copiedOriginFiles | int | — | 否 | 成功复制的原图张数，仅在选择了连同原图一起导出时才可能大于零 |
| 复制失败数 | failedFiles | int | — | 否 | 因源文件不存在或复制出错而未能写入的文件数量，用于核对产物是否完整 |
| 是否已取消 | canceled | bool | — | 否 | 标记用户是否中途取消了导出，取消时为 true，此时已创建的产物目录会被回滚清理 |
| 导出字节数 | totalBytes | double | — | 否 | 本次实际写入磁盘的图片总字节数，不含未成功复制的文件 |
| 耗时(ms) | elapsedMs | double | — | 否 | 本次调用的耗时，单位为毫秒，成功与失败分支都会给出该数值 |
接入方式
联系与反馈
获取安装包与技术反馈
安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。
- 安装包获取与部署说明
- 界面组态与工具配置
- 功能建议与问题反馈
微信扫码 · 安装包与问题反馈