| 项 | 说明 |
|---|---|
| SDK 版本 | @plasosdk/plaso-electron-sdk ≥ 1.3.18(预解析回调与 FILE_TYPE.ISPRINGPPT 自 1.3.8 起) |
| 接入性质 | 可选能力 |
| 适用文件 | PPT、PDF、Word、Excel 等需要分页/渲染的文件 |
| 客户端入口 | onGetPreParseFileNameFn |
info 中的稳定标识。| 字段 | 用途 |
|---|---|
fileId | 业务文件 ID;资料中心返回并写入 Electron info。 |
sourcePath | 原始文件在对象存储中的路径;创建解析任务时使用。 |
taskId | 伯索解析任务 ID;用于关联异步回调。 |
status | 至少区分 PENDING、COMPLETED、FAILED。 |
targetPath | 解析产物目录;只保存在服务端,不能下发给客户端。 |
totalPages | PDF、Word、Excel 等解析页数;资料中心返回后写入 Electron 的 totalPages。 |
fileType | 原始文件和解析资源类型;用于映射 FILE_TYPE。 |
PENDING。POST https://www.plaso.cn/dataentry/document/parserappId、sourcePath、taskType、callbackUrl、validBegin、validTime 和 signature。taskType 分别为:PPT 4、Word/Excel 5、PDF 8。taskId 并写入解析记录。callbackUrl。业务服务端应按 taskId 幂等处理回调:| 回调字段 | 处理要求 |
|---|---|
taskStatus=100 | 将记录更新为 COMPLETED,保存 targetPath 和 convertPages。 |
taskStatus=101 | 将记录更新为 FAILED,保存可定位的失败原因。 |
| 重复回调 | 不重复创建文件记录、资源目录或后续任务。 |
| 回调失败重试 | 接收端应能接受重复投递;解析服务的重试规则见服务端协议。 |
COMPLETED 的预解析文件。解析中或失败的文件应显示处理状态,不能作为可插入的预解析资源返回。fileId + suffix 并返回短时 URL。接口名称由业务方定义,处理逻辑必须满足:fileId 查询解析记录,并验证当前用户对该文件有访问权限。COMPLETED,且存在 targetPath。suffix 做规范化和白名单校验;拒绝 ..、反斜杠、绝对路径、完整 URL 及不属于该解析任务的资源。suffix 与 targetPath 组合,生成短时签名 URL。onGetPreParseFileNameFn 的 Promise。suffix 可能是 /index.html、/info.json、/1.jpg,也可能包含允许的图片处理查询参数(如 /1.jpg?x-oss-process=...)。不得将 targetPath、OSS 长期凭证或对象存储拼接规则下发给客户端。