List 类型 info 插入课堂。getPreParseFileName(info, suffix, callback)。info、suffix 发给业务服务端,服务端验证后返回对应产物的可访问完整 URL。callback.onFilePath(url);失败时传入 null。| 字段 | 用途 |
|---|---|
fileId | 业务文件 ID;资料中心与客户端 info 使用的稳定标识。 |
sourcePath | 原始文件的对象存储路径;仅服务端用于创建任务。 |
taskId | 伯索解析任务 ID,用于关联异步回调。 |
status | 至少包含 PENDING、COMPLETED、FAILED。 |
targetPath | 解析产物目录;仅保存在服务端。 |
totalPages | PDF、Word、Excel 的解析页数。 |
fileType | 原始文件类型,用于映射 SDK type。 |
PENDING 记录,并调用:POST https://www.plaso.cn/dataentry/document/parserappId、sourcePath、taskType、callbackUrl、validBegin、validTime 和 signature;任务类型为 PPT 4、Word/Excel 5、PDF 8。成功后保存返回的 taskId。callbackUrl 时,服务端必须按 taskId 幂等处理:taskStatus=100 更新为 COMPLETED 并保存 targetPath、convertPages;taskStatus=101 更新为 FAILED 并保存失败原因。资料中心仅展示 COMPLETED 的文件。fileId + suffix 的接口,例如:GET /api/files/{fileId}/parsed-url?suffix=<url-encoded-suffix>COMPLETED,且存在 targetPath;..、反斜杠、绝对路径、完整 URL 和不属于当前任务的产物;targetPath + suffix,返回可访问的完整 URL;onFilePath(null)。suffix 可为 /1.jpg、/index.html、/ispring.html、/info.json,也可能含图片处理查询参数。客户端不得收到 targetPath、OSS 长期凭证或对象存储路径规则。| 文件 | 类型 | 常见 suffix |
|---|---|---|
| iSpring PPT | TYPE_I_SPRING_PPT | /index.html、/ispring.html |
TYPE_PDF | /1.jpg、/info.json | |
| Word | TYPE_DOC | /1.jpg、/info.json |
| Excel | TYPE_XLS | /1.jpg、/info.json |
TYPE_I_SPRING_PPT,不传解析页数。SDK 会按需请求 HTML 入口和运行页;每次回调均使用同一个解析文件 ID 换取当前 suffix 的可访问完整 URL。PlasoUpimeBoard.getInstance().insertObject(
UpimeObject.TYPE_I_SPRING_PPT,
['parsed', { id: 'parsed-ppt-001' }],
'课件.pptx'
);TYPE_PDF、TYPE_DOC、TYPE_XLS,并且必须传入解析总页数;否则 SDK 无法正确构建分页资源。PlasoUpimeBoard.getInstance().insertObject(
UpimeObject.TYPE_PDF,
info,
'示例课件',
totalPages
);suffix | 用途 |
|---|---|
/1.jpg、/2.jpg | PDF/文档解析页图片。 |
/info.json | 解析文件元数据。 |
/1.jpg?x-oss-process=... | 带图片处理参数的解析页;查询参数也是 suffix 的一部分。 |
getPreParseFileName 不是创建解析 任务的入口,也不是客户端拼接 OSS 地址的位置。每次 SDK 请求都要将 info 中的业务文件 ID 与原始 suffix 发送到业务服务端,并且每次只完成一次回调:getPreParseFileName(
info: Object | null,
suffix: string | null,
callback: IResourceCallback
): void {
const fileId = extractFileId(info);
if (!fileId || !suffix) {
callback.onFilePath(null);
return;
}
requestParsedFileUrl(fileId, suffix)
.then((url: string) => callback.onFilePath(url || null))
.catch(() => callback.onFilePath(null));
}OPEN_FILE_MODE_WINDOW 时,SDK 按需请求解析页、HTML 入口和元数据。使用 OPEN_FILE_MODE_IMAGE 时,PDF、Word、Excel 还可能以 suffix == "?" 请求原始文件 URL;服务端应按验证后的文件 ID 返回可访问的完整原始文件 URL,不能将 ? 拼到解析产物路径。fileId 与 taskId,回调按 taskId 幂等落库。COMPLETED 的预解析文件,且包含正确页数。type;后 3 类传入总页数。fileId + suffix 请求进行鉴权、白名单校验并返回可访问的完整 URL。null。