格式转换_文档型实例管理_用户指南_智能媒体管理_阿里云技术文档

文档格式转换，是把支持的输入文档类型，转换为指定的输出文档类型，便于上层应用更好的使用文档内容。

文档格式转换的时间，依赖于 文档大小、文档页数、文档字数 等因素，典型情况下在秒级可以完成请求，但是 大文件、多页数、多字数 的文档可能需要 几十秒 的时间。

为了降低请求的应用等待时间，文档格式转换目前提供了异步调用接口，如下是格式转换提供的能力介绍。

输入文档类型

目前支持的 输入文件类型 包含如下 48 种格式：

演示文件：pptx、ppt、pot、potx、pps、ppsx、dps、dpt、pptm、potm、ppsm。
表格文件：xls、xlt、et、ett、xlsx、xltx、csv、xlsb、xlsm、xltm。
文字文件：doc、dot、wps、wpt、docx、dotx、docm、dotm。
其他格式文件： pdf、 lrc、 c、 cpp、 h、 asm、 s、 java、 asp、 bat、 bas、 prg、 cmd、 rtf、 txt、 log、 xml、 htm、 html。

目前支持的 输出文件类型 有如下 4 种：

格式转换的输出文档保存在请求指定的 OSS 路径中，比如请求指定输出到如下的 OSS 路径 /bucket1/imm-format-convert-tgt/session123/，根据请求指定的输出类型，会有不同的命名规则。

对于 非 excel 文档 和 excel 文档 有不同的输出内容，关键差别在于 excel 文档 文档需要分 sheet 显示，而 非 excel 文档 则是按页显示，输出示例如下所示：

其中 meta.json 文档是元数据，fp1.json、 fp2.json、… 文档是每页的渲染信息，I/1、 I/2、… 文档是渲染使用的具体类容。

其中 meta.json 文档是元数据，s1/meta.json 是 sheet1 的元数据，s1/fp1.json、 s1/fp2.json、… 文档是 sheet1 每页的渲染信息。

注意：vector 模式需要使用智能媒体管理提供的前端渲染引擎。

输入文档为非 excel 类型（例如 ppt 或 doc 文档）的输出内容
- /bucket1/imm-format-convert-tgt/session123/1.jpg
- /bucket1/imm-format-convert-tgt/session123/2.jpg
- /bucket1/imm-format-convert-tgt/session123/[…].jpg
输入文档为 excel 类型的输出内容
- /bucket1/imm-format-convert-tgt/session123/s1/1.jpg
- /bucket1/imm-format-convert-tgt/session123/s1/2.jpg
- /bucket1/imm-format-convert-tgt/session123/s1/[…].jpg
- /bucket1/imm-format-convert-tgt/session123/s2/1.jpg
- /bucket1/imm-format-convert-tgt/session123/s2/2.jpg
- /bucket1/imm-format-convert-tgt/session123/s2/[…].jpg
- /bucket1/imm-format-convert-tgt/session123/s[…]/1.jpg
- /bucket1/imm-format-convert-tgt/session123/s[…]/2.jpg
- /bucket1/imm-format-convert-tgt/session123/s[…]/[…].jpg

注意：输入文档为 excel 类型时，会先根据 excel 的表格数，生成对应数量的文件夹，再在对应的文件夹下，按照预览页面大小生成对应数量的 jpg 文件。

输入文档为非 excel 类型（例如 ppt 或 doc 文档）的输出内容
- /bucket1/imm-format-convert-tgt/session123/1.png
- /bucket1/imm-format-convert-tgt/session123/2.png
- /bucket1/imm-format-convert-tgt/session123/[…].png
输入文档为 excel 类型的输出内容
- /bucket1/imm-format-convert-tgt/session123/s1/1.png
- /bucket1/imm-format-convert-tgt/session123/s1/2.png
- /bucket1/imm-format-convert-tgt/session123/s1/[…].png
- /bucket1/imm-format-convert-tgt/session123/s2/1.png
- /bucket1/imm-format-convert-tgt/session123/s2/2.png
- /bucket1/imm-format-convert-tgt/session123/s2/[…].png
- /bucket1/imm-format-convert-tgt/session123/s[…]/1.png
- /bucket1/imm-format-convert-tgt/session123/s[…]/2.png
- /bucket1/imm-format-convert-tgt/session123/s[…]/[…].png

注意：输入文档为 excel 类型时，会先根据 excel 的表格数，生产对应数量的文件夹，再在对应的文件夹下，按照预览页面大小生成对应数量的 png 文件。

直接生成 pdf 文档，例如:

注意：转换 pdf 时，无论源文件是什么类型，都只会生成一个 pdf 文件。

详细的 API 接口请参考 CreateOfficeConversionTask 。