logologo
开始
手册
开发
插件
API
English
简体中文
开始
手册
开发
插件
API
English
简体中文
logologo
文件管理器
概述

存储引擎

概述
本地存储
AWS S3
阿里云 OSS
腾讯云 COS
S3 Pro
文件表
附件字段

文件预览

概述
Office 文件预览
HTTP API
扩展开发
Previous Page概述
Next PageHTTP API

#Office 文件预览 v1.8.11+

该功能由插件 «Office 文件预览» 提供

Office 文件预览插件用于在 NocoBase 应用中预览 Office 格式的文件,如 Word、Excel、PowerPoint 等。
它基于微软提供的公共在线服务,可将通过公开 URL 可访问的文件嵌入预览界面,用户可在浏览器中查看这些文件,无需下载或使用 Office 应用程序。

#使用手册

默认情况下该插件处于 未启用 状态。在插件管理器中启用后即可使用,无需额外配置。

插件启用界面

在数据表的文件字段中上传 Office 文件(Word / Excel / PowerPoint)成功后,点击对应文件图标或链接,即可在弹出的或嵌入的预览界面中查看文件内容。

预览操作示例

#实现原理

该插件嵌入的预览依赖微软的公共在线服务(Office Web Viewer),主要流程:

  • 前端将用户上传的文件生成可公开访问的 URL(包括 S3 带签名 URL);

  • 插件在 iframe 中使用如下地址加载文件预览:

    https://view.officeapps.live.com/op/embed.aspx?src=<公开文件 URL>
  • 微软服务会向该 URL 请求文件内容,加以渲染并返回可查看页面。

#注意事项

  • 由于该插件依赖于微软的在线服务,因此需要确保网络连接正常,并且能够访问微软的相关服务。
  • 微软会访问你提供的文件 URL,文件内容会被其服务器短暂缓存,用于渲染预览页面,因此存在一定隐私风险,如果你对此有顾虑,建议不要使用该插件提供预览功能1。
  • 需要预览的文件必须是公开可访问的 URL。通常情况下,上传到 NocoBase 的文件会自动生成可访问的公开链接(包括 S3-Pro 插件生成的带签名 URL),但如果文件设置了访问权限或存储在内网环境中,则无法预览2。
  • 该服务不支持登录验证或私有存储的资源。例如,仅在内网可访问或需登录才能访问的文件无法使用该预览功能。
  • 文件内容在被微软服务抓取后,可能在短时间内被缓存,即使源文件删除,预览内容也可能仍可访问一段时间。
  • 文件大小有推荐限制:Word 和 PowerPoint 文件建议不超过 10MB,Excel 文件建议不超过 5MB,以确保预览稳定性3。
  • 该服务目前无官方明确的商业使用许可说明,使用上请自行评估风险4。

#支持的文件格式

插件仅支持以下 Office 文件格式的预览,判断依据为文件的 MIME 类型:

  • Word 文档: application/vnd.openxmlformats-officedocument.wordprocessingml.document
  • Excel 表格: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet
  • PowerPoint 演示文稿: application/vnd.openxmlformats-officedocument.presentationml.presentation

其他格式的文件将不会启用该插件的预览功能。

#Footnotes

  1. What is the status of view.officeapps.live.com? ↩

  2. Microsoft Q&A - Access denied or non-public files cannot be previewed ↩

  3. Microsoft Q&A - File size limits for Office Web Viewer ↩

  4. Microsoft Q&A - Commercial use of Office Web Viewer ↩