本页目录
概述
本篇说明记录列表的两种视图、搜索、状态筛选、分页与同步的使用方法，以及典型查询场景。
一、两种视图：卡片与列表
检索与筛选区右上角提供卡片视图与列表视图切换按钮。两者展示同一批会话，仅组织形式不同；切换视图不改变筛选条件与数据范围。
1. 卡片视图
每张卡片聚合一个会话的关键信息：
| 卡片元素 | 位置 | 业务含义 |
|---|---|---|
| 状态徽标 | 卡片右上角 | 当前状态（如处理中、已取消） |
| 名称 | 卡片中部 | 会话名称 |
| 唯一标识 | 名称下方 | 会话的 UUID 标识 |
| 来源与文件数 | 标识下方 | 如“本地上传 · 1 个文件” |
| 更新时间 | 卡片底部 | 最近一次状态更新的时间 |
卡片视图状态醒目、单条信息完整，适合日常值守时快速扫视各会话进展。
2. 列表视图
列表视图以表格形式组织同一批信息：
| 列名 | 包含内容 |
|---|---|
| 上传会话 | 名称、唯一标识、来源与文件数的组合展示 |
| 当前状态 | 会话当前状态徽标 |
| 更新时间 | 最近一次状态更新的时间 |
列表视图便于纵向对比多个会话的状态与时间，适合记录较多时按行核对、按标识排查。
3. 视图选择建议
-
只关心“有没有需要关注的会话”：用卡片视图扫状态；
-
需要对比多条会话、核对标识与时间：用列表视图；
-
两种视图信息等价，选择取决于核对习惯，不影响数据本身。
二、检索、筛选、分页与同步
1. 搜索：三类检索对象
搜索框占位提示为“搜索任务编号、名称或文件名...”，即支持三类检索对象：
| 检索对象 | 适用情形 |
|---|---|
| 任务编号 | 手中持有任务编号时 |
| 名称 | 会话名称带有可辨识特征时 |
| 文件名 | 只记得上传过的文件名时 |
输入后列表只保留命中的会话，底部总条数同步变为命中条数（如输入“11”后显示“共 3 条”），可用于确认检索范围是否符合预期。命中为 0 时，可更换关键词，或检查是否同时被状态筛选限制。
2. 状态筛选：按阶段切分数据
状态筛选的可选值即完整状态集合。日常高频用法：
-
看进行中的会话：待上传、上传中、校验中、等待处理、处理中；
-
看结果与异常：处理结束（含部分失败）、失败；
-
看取消情况：正在取消、已取消。
状态筛选与搜索可组合使用：先用状态圈定阶段，再用关键词定位具体会话。
3. 分页：控制单页展示规模
分页区展示三类信息：
| 元素 | 示例 | 含义 |
|---|---|---|
| 总条数 | 共 21 条 | 当前筛选条件下的记录总数 |
| 当前页码 | 第 1 / 2 页 | 当前页与总页数 |
| 翻页按钮 | 上一页 / 下一页 | 切换页码；处于边界时对应按钮置灰 |
分页只切换当前展示的记录，不改变筛选条件。跨页查找前建议先设置筛选条件，既减少人工翻页，也降低混淆同名会话的风险。
4. 同步：重新获取后台状态
同步用于向后台拉取最新状态与进度。建议使用时机：
-
新建上传完成后，确认会话已出现且状态正常；
-
状态长期不变时，确认后台是否仍在推进；
-
交接或反馈问题前，确保所见信息是最新的。
同步前后状态变化，通常表示后台流程仍在推进，而不是历史数据被修改；同步不会重新发起上传或处理。
三、典型查询与判断方法
场景1：确认刚发起的上传是否正常推进
- 点击同步刷新列表；
- 按更新时间找到最新的会话；
- 核对状态是否为待上传 / 上传中 / 校验中 / 等待处理 / 处理中之一；
- 核对文件数与发起上传时的规模一致。
判断重点：新会话应出现在列表中且状态随时间推进；若长期停留某一阶段，结合更新时间与同步结果判断是否卡滞。
场景2：查找失败或部分失败的会话
- 状态筛选选择失败，查看完全失败的会话；
- 再选择处理结束（含部分失败），查看存在个别文件失败的会话；
- 记录目标会话的名称与唯一标识，便于反馈与排查。
判断重点：“处理结束”不等于“全部成功”；当前无法查看哪些文件失败，含部分失败的会话暂按整会话失败处理。
场景3：查找被取消的上传
- 状态筛选选择已取消或正在取消；
- 结合更新时间确认取消发生的时间点；
- 如仍需该批数据，回到新建上传流程重新发起。
判断重点：已取消的会话不会继续推进，不能等待其自行恢复。
场景4：在大量记录中准确找到某一条
- 若已知状态阶段，先设置状态筛选缩小范围；
- 在搜索框输入任务编号、名称或文件名关键词；
- 核对底部命中条数是否符合预期；
- 在卡片或列表中核对目标会话的唯一标识与更新时间，确认没有认错记录。
判断重点：唯一标识是指认会话的可靠依据，名称只作辅助。
四、常见误区
-
把“会话存在”当作“数据处理完成” ：列表只投影当前阶段，处理是否完成以状态为准。
-
把“处理结束（含部分失败）”当作全部成功 ：其中可能包含个别文件失败，且当前无法查看哪些文件失败，应按整会话失败处理。
-
只凭名称指认会话 ：同名文件可能多次上传，应核对唯一标识与更新时间。
-
把同步当作重新上传 ：同步只刷新页面数据，不会重新发起上传或处理。
-
认为已取消会话还能继续 ：取消后即终止，需重新发起上传。
-
忽视文件数核对 ：文件数与发起时不一致，往往意味着选择数据阶段就有遗漏。
-
把视图切换当作筛选 ：卡片/列表切换只改变展示形态，不改变数据范围与筛选条件。
五、推荐工作方式
日常使用可以采用“先进行中、后异常、再历史”的顺序：
- 先看待上传 / 上传中 / 校验中 / 等待处理 / 处理中的会话，确认当前上传链路是否在推进；
- 再看失败 / 处理结束（含部分失败）/ 正在取消的会话，处理异常与收尾事项；
- 最后按需检索历史会话（已取消、处理结束）做核对与追溯；
- 交接或反馈问题时，记录会话的唯一标识、状态与更新时间，而不是只复制名称。
这种顺序把实时链路、异常处理与历史追溯分开，既避免只盯某一条记录，也避免在上传尚未完成时过早判断结果。