文檔格式轉(zhuǎn)換
使用文檔格式轉(zhuǎn)換功能,您可以將支持的輸入文檔類型轉(zhuǎn)換為指定的輸出文檔類型,便于上層應(yīng)用更好的使用文檔內(nèi)容。
此文檔已不再維護(hù),建議您使用新版智能媒體管理。
關(guān)于智能媒體管理新版與舊版的對比,請參見新舊版本使用指引。
關(guān)于新版智能媒體管理如何轉(zhuǎn)換文檔格式,請參見文檔格式轉(zhuǎn)換。
功能
將支持的輸入文檔類型轉(zhuǎn)換為指定的輸入文檔類型,格式轉(zhuǎn)換的輸出文檔保存在請求中指定的OSS路徑中。
目前支持的輸入文檔類型包含如下格式:
文字文檔:DOC、DOT、WPS、WPT、DOCX、DOTX、DOCM、DOTM
演示文檔:PPTX、PPT、POT、POTX、PPS、PPSX、DPS、DPT、PPTM、POTM、PPSM
表格文檔:XLS、XLT、ET、ETT、XLSX、XLTX、CSV、XLSB、XLSM、XLTM
其他格式文檔:PDF、LRC、C、CPP、H、ASM、S、JAVA、ASP、BAT、BAS、PRG、CMD、RTF、TXT、LOG、XML、HTM、HTML
目前支持的輸出文檔類型包含JPG、PNG、PDF、TXT、VECTOR格式。
根據(jù)請求中指定的輸出文檔類型會(huì)有不同的輸出內(nèi)容,輸出內(nèi)容示例的更多信息,請參見輸出內(nèi)容示例。
對于JPG、PNG和VECTOR格式的輸出文檔類型,根據(jù)輸入文檔類型是否為表格文檔,輸出內(nèi)容不同。
當(dāng)輸入文檔類型為表格文檔時(shí),按表格中的頁簽生成對應(yīng)數(shù)量的文件夾后,再按預(yù)覽頁面大小生成對應(yīng)數(shù)量的文件。
當(dāng)輸入文檔類型為非表格文檔(例如文字文檔、演示文檔)時(shí),按文檔樣式每頁生成一個(gè)文件。
對于PDF和TXT格式的輸出文檔類型,無論輸入文檔類型是否為表格文檔,直接生成一個(gè)文件。
使用
文檔格式轉(zhuǎn)換所需的時(shí)間依賴于文檔大小、文檔頁數(shù)、文檔字?jǐn)?shù)等因素,典型情況下在秒級(jí)可以完成請求,但是大文件、多頁數(shù)、多字?jǐn)?shù)的文檔可能需要幾十秒的時(shí)間。為了降低請求的應(yīng)用等待時(shí)間,文檔格式轉(zhuǎn)換目前提供了異步請求接口。
您可以通過同步請求或者異步請求方式進(jìn)行文檔格式轉(zhuǎn)換。
文檔格式轉(zhuǎn)換的同步請求接口為ConvertOfficeFormat。
文檔格式轉(zhuǎn)換的異步請求接口為CreateOfficeConversionTask。
輸出內(nèi)容示例
如下以請求中指定輸出到OSS路徑/bucket1/imm-format-convert-tgt/session123/為例說明轉(zhuǎn)換為不同輸出文檔類型時(shí)的輸出內(nèi)容。
輸出文檔類型為JPG格式
當(dāng)輸入文檔類型為表格文檔時(shí),輸出內(nèi)容示例如下所示。其中s1和s2為根據(jù)表格文檔中的頁簽名稱生成的文件夾。
/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
當(dāng)輸入文檔類型為非表格文檔時(shí),輸出內(nèi)容示例如下所示。
/bucket1/imm-format-convert-tgt/session123/1.jpg
/bucket1/imm-format-convert-tgt/session123/2.jpg
輸出文檔類型為PNG格式
當(dāng)輸入文檔類型為表格文檔時(shí),輸出內(nèi)容示例如下所示。其中s1和s2為根據(jù)表格文檔中的頁簽名稱生成的文件夾。
/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
當(dāng)輸入文檔類型為非表格文檔時(shí),輸出內(nèi)容示例如下所示。
/bucket1/imm-format-convert-tgt/session123/1.png
/bucket1/imm-format-convert-tgt/session123/2.png
輸出文檔類型為PDF格式,無論輸入文檔類型是否為表格文檔,輸出內(nèi)容均相同,輸出內(nèi)容示例為/bucket1/imm-format-convert-tgt/session123/1.pdf。
輸出文檔類型為TXT格式,無論輸入文檔類型是否為表格文檔,輸出內(nèi)容均相同,輸出內(nèi)容示例為/bucket1/imm-format-convert-tgt/session123/1.txt。
輸出文檔類型為VECTOR格式
當(dāng)輸入文檔類型為表格文檔時(shí),輸出內(nèi)容示例如下所示。其中meta.json文檔是元數(shù)據(jù),s1/meta.json是sheet1的元數(shù)據(jù),s1/fp1.json、s1/fp2.json等文檔是sheet1每頁的渲染信息。
/bucket1/imm-format-convert-tgt/session123/doc/meta.json
/bucket1/imm-format-convert-tgt/session123/doc/s1/meta.json
/bucket1/imm-format-convert-tgt/session123/doc/s1/fp1.json
/bucket1/imm-format-convert-tgt/session123/doc/s1/fp2.json
/bucket1/imm-format-convert-tgt/session123/doc/s1/fp[...].json
/bucket1/imm-format-convert-tgt/session123/doc/s2/meta.json
/bucket1/imm-format-convert-tgt/session123/doc/s2/fp1.json
/bucket1/imm-format-convert-tgt/session123/doc/s2/fp2.json
/bucket1/imm-format-convert-tgt/session123/doc/s2/fp[...].json
當(dāng)輸入文檔類型為非表格文檔時(shí),輸出內(nèi)容示例如下所示。其中meta.json文檔是元數(shù)據(jù),fp1.json、fp2.json等文檔是每頁的渲染信息,I/1、I/2等文檔是渲染使用的具體內(nèi)容。
/bucket1/imm-format-convert-tgt/session123/doc/meta.json
/bucket1/imm-format-convert-tgt/session123/doc/fp1.json
/bucket1/imm-format-convert-tgt/session123/doc/fp2.json
/bucket1/imm-format-convert-tgt/session123/doc/fp[...].json
/bucket1/imm-format-convert-tgt/session123/doc/I/1
/bucket1/imm-format-convert-tgt/session123/doc/I/2
/bucket1/imm-format-convert-tgt/session123/doc/I/[...]