全部产品
云市场

文档转换和预览问题

更新时间:2018-07-10 16:26:50

问题列表:

一、转换相关问题

二、预览相关问题

一、转换相关问题

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

目前支持的文件类型有:

  • 演示文件: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 种模式输出:

  • vector向量模式。按页输出 json 文件,可以使用阿里云提供的 js 渲染引擎进行预览
  • jpg模式。按页输出 jpg 文件,文件按页编号。
  • png模式。按页输出 png 文件,文件按页编号。
  • pdf模式。输出单个 pdf 文件。

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

目前提供 异步 API, 它可以通过阿里云提供的预览引擎实现边转边预览。未来也计划提供 同步 API ,但是同步请求的时延依赖文件的大小和页数、以及内容的复杂度,请合理设置超时时间,如果在前端的超时范围内没有返回,建议使用 异步 API

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

目前没有限制文档大小和页数,已经测试过 150 MB、1千页以上 的文档,建议测试大文件、长页数的文档时使用异步 API。

二、预览相关问题

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

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

预览过程中为什么查看某页一直等待?

请检查对应的 OSS 路径,是否有该页的文件不存在,或者该文件损坏。如果是,请重新提交文件转换请求;如果否,请提工单。

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

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

预览能否使用 CDN?

如果转换数据保存到 OSS 时采用公共读权限,可以采用CDN加速。如果转换数据保存到 OSS 时采用私有,目前不支持 CDN 加速。

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

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

预览支持https

转换数据保存到 OSS 私有桶,预览时使用 STS 三元组控制权限,为什么仍不能访问?

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

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

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

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

由于预览是基于 OSS 实现,所以该错误实际是 OSS 的错误,原因是 客户端时间 和 OSS服务端时间 间隔超过了15分钟。参考 OSS 403错误及排查 的如下解释。

原因:您发送请求的时间与OSS收到请求的时间,间隔超出了15分钟,OSS从安全考虑认为该请求是无效的,返回上述错误。请检查发送请求设备的系统时间,并根据时区调整到正确时间。