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

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

支持的输入文件类型包含如下格式：
  • 文字文件：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。

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

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

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

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

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

文档转换时，转换的页数默认为200页，您可以通过设置EndPage转换更多页数，EndPage可以设置为比实际页数更大的值，转换引擎会按照实际的页数进行转换。

预览时如何支持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错误及排查。