系统
检测历史查询
按时间区间与图像源、缺陷类型条件检索检测历史，输出产品级明细表、原图路径以及合格率、缺陷分布与趋势等统计InspectionHistoryQuery · v1.0 · by system
输入参数 7
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 开始时间 | startTime | string | （空） | 否 | 查询区间的起始时刻，格式为 yyyy-MM-dd HH:mm:ss，留空时默认取当前时间往前七天 |
| 结束时间 | endTime | string | （空） | 否 | 查询区间的结束时刻，格式与起始时刻一致，留空时默认取发起查询的当前时刻，且不能早于起始时刻 |
| 图像源过滤 | sourceId | string | （空） | 否 | 按单个图像源标识筛选记录，留空或填「全部」表示不限图像源；与多选图像源同时给出时以多选为准 |
| 纳入实时数据 | includeRealtime | bool | true | 否 | 是否用实时馈送补齐尚未入库的产品，默认开启；关闭后统计只按数据库口径，便于与入库数据对账 |
| 图像源过滤(多选) | sourceIds | string | （空） | 否 | 以逗号分隔的多个图像源标识，留空表示不限图像源，其中包含「全部」时会被剔除；与单选同时给出时以本项为准 |
| 缺陷类型过滤(多选) | defectTypes | string | （空） | 否 | 以逗号分隔的缺陷编号或名称，可写 3、划痕或缺陷3，留空或含「全部」表示不按缺陷类型过滤 |
| 复检口径 | recheckMode | enum | effective | 否 | effective 为默认口径，按最新复检结论覆盖当前有效判定；original 完全按原始检测数据判定，用于复检前后对账。查询与导出必须传同一个值 |
输出参数 33
| 名称 | keyId | 类型 | 默认值 | 可连接 | 说明 |
|---|---|---|---|---|---|
| 运行结果 | resultCode | int | — | 否 | 查询执行的结束状态，0 表示成功完成、-1 表示参数错误或查询失败，具体原因见状态信息 |
| 运行信息 | resultInfo | string | — | 否 | 本次查询的状态说明，成功时给出命中情况，失败时写明时间格式错误、区间倒置等具体原因 |
| 产品行数 | count | int | — | 否 | 明细表实际返回的产品行数，一行对应一个产品，按完成时间倒序排列并受内部行数上限约束 |
| 检测实例数 | instanceCount | int | — | 否 | 区间内合并结果的检测实例总数，一次检测记为一个实例，等于实例合格数与实例不合格数之和 |
| 原图数 | imageCount | int | — | 否 | 查询区间内命中的原图总数，参与平均每图缺陷数的计算 |
| 表头 | headers | string | — | 否 | 明细表的表头 JSON 数组，固定为完成时间、产品、图像源、图数、判定、缺陷类型、缺陷数、最高置信度八列 |
| 数据行 | rows | string | — | 否 | 明细数据的二维 JSON 数组，一行一个产品，每行八列的顺序与表头逐列对应 |
| 全部原图路径 | imagePaths | vec_string | — | 否 | 区间内全部原图的路径列表，按明细行顺序汇总同一产品的原图，数量可能很大，不宜直接绑定图像显示区 |
| 统计 | stats | string | — | 否 | 汇总统计的 JSON 串，包含产品级与实例级合格率、缺陷分布、趋势数组及口径说明 |
| 图像源列表 | sourceIds | vec_string | — | 否 | 区间内出现过的图像源标识列表，首项固定为「全部」，不受图像源筛选条件影响，供下拉框取值 |
| 图像源名称 | sourceNames | vec_string | — | 否 | 与图像源标识列表逐位对应的显示别名，取自项目配置，首项同样为「全部」 |
| 缺陷类型ID列表 | defectTypeIds | vec_string | — | 否 | 缺陷类型下拉选项的编号列表，与缺陷类型名称逐位对应，取自缺陷字典与区间出现类型的并集并按命中次数降序 |
| 缺陷类型名称 | defectTypeNames | vec_string | — | 否 | 与缺陷类型编号列表逐位对应的显示名称，字典中查不到的类型回落为「缺陷N」，首项为「全部」 |
| 产品合格数 | productPassCount | int | — | 否 | 按产品级口径判定为合格的产品个数，同一产品全部检测实例都合格才计入 |
| 产品不合格数 | productFailCount | int | — | 否 | 按产品级口径判定为不合格的产品个数，产品任一检测实例含缺陷即计入 |
| 未合并产品数 | productUnmergedCount | int | — | 否 | 缺少合并结果、判定不可知的产品个数，这类产品不计入产品合格率的分母 |
| 超时未合并产品数 | productTimeoutUnmergedCount | int | — | 否 | 未合并且距最后一张原图已超过等待上限的产品个数，超过该上限后基本不会再产生合并结果 |
| 实时补齐产品数 | realtimeSupplemented | int | — | 否 | 库中查不到、由实时馈送补齐的产品个数，仅在纳入实时数据开启时可能大于零 |
| 查询前挂起产品数 | unflushedCount | int | — | 否 | 本次查询前仍缓冲未落库、被强制写入库的产品个数，-1 表示宿主没有提供入库链路 |
| 产品合格率 | productPassRate | double | — | 否 | 产品级合格率百分比，取值 0 到 100，没有可判定的有效产品时返回 -1 |
| 产品合格率(整型) | productPassRateInt | int | — | 否 | 产品级合格率四舍五入取整后的整数百分比，无有效数据时为 0，供页面指标直接显示 |
| 实例合格数 | passCount | int | — | 否 | 合并结果中判为合格的检测实例数，按每次检测为一个实例统计 |
| 实例不合格数 | failCount | int | — | 否 | 合并结果中判为不合格的检测实例数，与实例合格数共同构成检测实例总数 |
| 实例合格率 | passRate | double | — | 否 | 实例级合格率百分比，取值 0 到 100，区间内没有任何检测实例时返回 -1 |
| 实例合格率(整型) | passRateInt | int | — | 否 | 实例级合格率四舍五入取整后的整数百分比，无检测实例时为 0 |
| 缺陷总数 | defectTotal | int | — | 否 | 产品级统计的缺陷实例数合计，按各产品下所有原图的缺陷累加 |
| 平均每图缺陷数 | avgDefectsPerImage | double | — | 否 | 缺陷总数除以原图数得到的平均每图缺陷数，区间内没有原图时为 0 |
| 缺陷分布标签 | defectLabels | vec_string | — | 否 | 缺陷分布中命中次数最多的前五类缺陷名称，取自缺陷字典，与缺陷分布次数逐位对应 |
| 缺陷分布次数 | defectCounts | vec_double | — | 否 | 缺陷分布中前五类缺陷各自的命中次数，与缺陷分布标签逐位对应 |
| 趋势日期 | trendLabels | vec_string | — | 否 | 合格率趋势的时间标签数组，跨度不足 48 小时按小时分桶显示，否则按天分桶显示 |
| 趋势合格率 | trendRates | vec_double | — | 否 | 各时间桶对应的产品级合格率数组，取值 0 到 100，与趋势日期逐位对应且顺序一致 |
| 统计说明 | statsNote | string | — | 否 | 统计口径与数据不完整的提示文字，例如存在未合并产品或启用了过滤条件，正常完整时为空 |
| 错误提示 | errorText | string | — | 否 | 专供页面绑定的错误提示，查询成功时为空字符串，失败时与状态信息内容相同 |
接入方式
联系与反馈
获取安装包与技术反馈
安装包通过微信二维码获取。安装部署、界面组态与工具配置过程中的问题，可通过同一渠道反馈，无需注册或填写表单。
- 安装包获取与部署说明
- 界面组态与工具配置
- 功能建议与问题反馈
微信扫码 · 安装包与问题反馈