本文介绍了在使用文档转换和预览过程中可能遇到的问题。

文档转换支持那些文件类型?

支持的输入文件类型包含如下格式:
  • 文字文件: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格式:按文件样式每页生成一张JPG图片。
  • PNG格式:按文件样式每页生成一张PNG图片。
  • PDF格式:每个文件生成一个PDF文件。
  • TXT格式:每个文件生成一个TXT文件。
  • VECTOR向量格式:按文件样式每页生成一个VECTOR向量格式文件。

文档转换是否提供同步API?

产品已提供文档转换的同步请求API ConvertOfficeFormat

同步请求的文档转换时间依赖文件的大小和页数以及内容的复杂度,如果文档转换时间超过5秒,则请使用文档转换的异步请求API CreateOfficeConversionTask,使用异步请求API时,通过阿里云提供的预览引擎可以实现边转换边预览。

文档转换支持的文件大小和页数?

  • 支持的文件大小
    • 当使用按次计费的项目转换文档时,文件大小限制为100 MB。
    • 当使用按QPS计费的项目转换文档时,文件大小限制为200 MB。
  • 支持的页数

    无页数限制,默认转换页为200页。您可以通过设置EndPage转换更多页数,EndPage设置为-1时,转换所有页。

文档转换为vector格式时成功生成了meta.json,但是文档预览返回失败?

请首先检查存放meta.json的OSS Bucket是否设置了CORS,并允许放置预览引擎的域名访问。

为什么预览某个页面时一直显示等待中?

请检查OSS目标Bucket下该页面对应的文件是否存在或损坏。
  • 如果该页面对应的文件不存在或者损坏,请重新提交文件转换请求。
  • 如果该页面对应的文件存在且未损坏,请提交工单

预览时为什么只能显示200页?

文档转换时,转换的页数默认为200页,您可以通过设置EndPage转换更多页数,EndPage设置为-1时,转换所有页。

预览时如何支持OSS采用https协议?

请在渲染引擎的config.js文件中配置secure.location.proctocol=='https:',如下图所示。

oss-https

转换数据保存到OSS私有Bucket,预览时使用STS访问凭证访问时为什么仍不能访问?

请检查在预览的URL中是否对STS返回的stsToken进行了Encode处理。

某些客户端能预览,某客户端不能预览并返回“Request has expired”

该客户端返回如下403错误:

<?xml version="1.0" encoding="UTF-8"?>
<Error>
  <Code>AccessDenied</Code>
  <Message>Request has expired.</Message>
  <RequestId>5B3EDB6FDD5F2012EA1A811E</RequestId>
  <HostId>xxx.oss-cn-shenzhen.aliyuncs.com</HostId>
  <Expires>2018-07-03T03:38:51.000Z</Expires>
  <ServerTime>2018-07-06T03:01:03.000Z</ServerTime>
</Error>
            

原因是客户端时间和OSS服务端的时间间隔超过了15分钟。

当发送请求的时间与OSS收到请求的时间间隔超出了15分钟,OSS从安全考虑认为该请求是无效的,返回报错。请检查发送请求设备的系统时间,并根据时区调整到正确时间。更多信息,请参见OSS 403错误及排查