# 设备履历报表

## 1. 功能概述

设备履历报表属于 MES 系统生产配置模块下的设备模型子模块，用于集中查看和管理所有设备的运行状态历史记录。系统会实时记录每台设备的状态变更（如工作中、异常中、空闲中、离线中等）及其持续时间，形成完整的设备运行履历，为设备管理、故障分析和生产排程提供数据支撑。

**核心功能：**

- 设备状态履历查询：按设备编码、设备类别、设备状态、时间范围等条件查询设备的状态变更记录
- 设备状态追踪：实时反映每台设备的状态变化，包括状态类型、异常代码、状态信息及状态持续时长
- 数据导出：支持将设备履历数据导出为 CSV 文件，通过系统下载任务进行下载

**功能对应截图** ：
![设备履历报表页面截图](/public/image/data_middleground//equipment_history_report/设备履历报表页面截图.png)

## 2. 术语说明

| 术语 | 定义 | 说明 |
|------|------|------|
| 设备履历报表 | Equipment History Report，记录设备状态变更历史的报表 | 属于生产配置→设备模型下的子模块 |
| 设备类别 | Device Category，对设备进行分类管理的单元 | 如SMT、分容、化成、OCV等设备类别 |
| 设备编码 | Device Code，设备在系统中的唯一标识 | 作为查询的筛选条件之一 |
| 设备状态 | Device Status，设备当前所处的运行状态 | 包括工作中、异常中、空闲中、手动中、已完成、离线中等 |
| 异常代码 | Error Code，设备发生异常时对应的错误编码 | 用于快速定位设备故障类型 |
| 设备状态信息 | Device Status Message，设备状态或异常的详细描述信息 | 展示设备当前状态的具体说明 |
| 设备其他信息 | Device Other Info，设备状态相关的补充信息 | 可能包含设备点位、通道等附加数据 |
| 状态时长 | Duration，设备在当前状态下持续的时间 | 单位为秒 |
| 状态解除时间 | Release Time，设备从当前状态解除的时间 | 当设备状态变更时记录新状态并解除旧状态 |

**设备状态说明：**

| 状态 | 英文标识 | 说明 |
|------|---------|------|
| 工作中 | RUN | 设备正在执行生产任务 |
| 异常中 | TROUBLE | 设备发生异常，需要人工介入处理 |
| 已完成 | FINISH | 设备已完成当前生产任务 |
| 空闲中 | IDLE | 设备处于空闲待机状态，等待生产任务 |
| 手动中 | PAUSE | 设备被手动暂停或人工接管操作 |
| 离线中 | OFFLINE | 设备与MES系统断开连接，无法通讯 |

## 3. 设备履历查询

### 3.1 查询条件说明

设备履历报表支持多条件组合查询，可按设备编码、设备类别、设备状态以及时间范围进行筛选。

**查询条件：**

| 查询条件 | 说明 | 必填 |
|---------|------|------|
| 设备编码 | 输入设备编码，精确匹配查询 | 否 |
| 设备类别 | 从下拉列表选择设备类别进行筛选 | 否 |
| 设备状态 | 选择设备状态进行筛选（空闲中/工作中/已完成/异常中/手动中/离线中） | 否 |
| 创建时间 | 选择日期时间范围，筛选状态记录的创建时间 | 否 |
| 状态解除时间 | 选择日期时间范围，筛选状态解除的时间 | 否 |

**【注意】** 所有查询条件均可选填，系统默认展示全部设备的最新状态记录。如需精确查询，建议至少填写一个条件。

**功能对应截图** ：
![图片：设备履历查询条件截图](/public/image/data_middleground/equipment_history_report/图片：设备履历查询条件截图.png)

### 3.2 查询结果字段说明

查询结果以设备状态记录为粒度展示，每条记录表示设备在某个时间段内的状态信息。

| 字段 | 说明 |
|------|------|
| ID | 设备履历记录的唯一标识 |
| 设备类别 | 设备所属的类别名称，如"SMT"、"分容"等 |
| 设备编码 | 设备的唯一标识编码 |
| 设备状态 | 设备当前所处的运行状态 |
| 异常代码 | 设备发生异常时对应的错误编码，正常状态时可能为空 |
| 设备状态信息 | 设备状态或异常的详细描述信息 |
| 设备其他信息 | 设备状态相关的补充数据 |
| 创建时间 | 该状态记录产生的时间 |
| 状态解除时间 | 该状态被解除的时间，即设备切换到新状态的时间 |
| 状态时长(秒) | 设备在该状态下持续的时长，单位为秒 |

**功能对应截图** ：
![图片：设备履历结果列表截图](/public/image/data_middleground/equipment_history_report/图片：设备履历结果列表截图.png)

### 3.3 查询操作步骤

1. 进入【生产配置】→【设备模型】→【设备履历报表】
2. 根据需要填写查询条件（设备编码、设备类别、设备状态、创建时间、状态解除时间）
3. 点击【查询】按钮，系统展示符合条件的设备履历记录
4. 如需清空所有查询条件，点击【重置】按钮
5. 查询结果支持分页浏览，可通过底部分页栏切换页码或调整每页显示条数

## 4. 数据导出

### 4.1 功能说明

设备履历报表支持将查询结果导出为 CSV 文件。导出操作采用异步任务机制——系统先创建导出任务，用户可在系统顶部的【系统下载任务】中查看任务进度并下载生成的文件。

**导出字段说明：**

| 导出字段 | 说明 |
|---------|------|
| 设备类别 | 设备所属的类别名称 |
| 设备名称 | 设备的编码 |
| 设备状态 | 设备所处的运行状态 |
| 异常代码 | 异常发生时对应的错误代码 |
| 设备状态信息 | 状态或异常的详细说明 |
| 设备其他信息 | 设备状态的补充数据 |
| 创建时间 | 状态记录的产生时间 |
| 状态解除时间 | 状态被解除的时间 |
| 状态时长(秒) | 状态持续的时长 |

### 4.2 操作步骤

1. 在设备履历报表页面，根据需要填写查询条件（导出范围与当前查询条件一致）
2. 点击表格上方的【导出】按钮
3. 系统弹出确认提示："数据导出需要先创建下载任务(可在系统顶部系统下载任务中查看下载进度并下载文件)，是否继续？"
4. 点击【确定】，系统创建导出任务
5. 创建成功后，系统提示"创建下载任务成功"并自动跳转到【系统下载任务】页面
6. 在下载任务页面等待任务完成，点击下载即可获取 CSV 文件

**【注意】** 如果当前查询条件范围内没有数据，系统会提示"没有下载数据，无法创建下载任务！"，请调整查询条件后重试。

**功能对应截图** ：
![图片：设备履历导出确认截图](/public/image/data_middleground/equipment_history_report/图片：设备履历导出确认截图.png)

## 5. 相关功能

| 功能 | 关系 | 说明 |
|------|------|------|
| 设备管理 | 上游数据 | 设备的基本信息（编码、类别等）在设备管理模块中维护，设备履历报表展示这些设备的运行状态历史 |
| 设备类别管理 | 上游数据 | 设备类别在设备类别管理模块中定义，用于设备履历报表中的分类筛选 |
| 系统下载任务 | 下游功能 | 设备履历报表的导出任务创建后，在系统下载任务中跟踪进度并下载文件 |