本文由AI翻译

Strapi

关于 ONLYOFFICE 和 Strapi 的集成

Strapi 是一个用于构建 API 的开源内容管理系统。ONLYOFFICE 提供了一个官方连接器,可以将 ONLYOFFICE 文档Strapi 集成,并在 Strapi 媒体库中编辑办公文档。您可以从 npm 库或 GitHub 页面获取 ONLYOFFICE 集成插件。该连接器以 Apache-2.0 许可证分发。

要了解有关 ONLYOFFICE 连接器如何与 Strapi 协作的更多信息,请访问我们的 API 文档 页面。
主要功能
  • 编辑和查看文本文档、电子表格和演示文稿。
  • 实时协同编辑文档:两种协同编辑模式(快速和严格)、修订模式、评论和内置聊天。
  • JWT 支持以保护您的流量,确保只有具有适当权限的用户才能访问您的文档。
支持的格式
  • 用于查看和编辑:DOCX、XLSX、PPTX
  • 仅用于查看:DOC、DOCX、DOCM、DOT、DOTX、DOTM、ODT、FODT、OTT、RTF、TXT、HTML、HTM、MHT、XML、PDF、DJVU、FB2、EPUB、XPS、XLS、XLSX、XLSM、XLT、XLTX、XLTM、ODS、FODS、OTS、CSV、PPS、PPSX、PPSM、PPT、PPTX、PPTM、POT、POTX、POTM、ODP、FODP、OTP
版本 2.0.1 的新功能

更改

  • 引擎依赖项已更新

完整的更改日志可在 此处查看。

将 ONLYOFFICE 文档连接到 Strapi

要求
  • ONLYOFFICE 文档服务器 v7.1(服务器版本)或更高版本

    您需要一个 ONLYOFFICE 文档 实例,该实例可以从 Strapi 和任何终端客户端解析和连接。它必须能够直接向 Strapi 发送 POST 请求。

    请参阅官方 文档页面 以了解有关安装 ONLYOFFICE 文档的更多信息。
  • Strapi v4.2.0 或更高版本
  • ONLYOFFICE Connector v1.1.0 for Strapi
为 Strapi 安装 ONLYOFFICE 集成插件
  1. 为了允许插入带有编辑器的框架并加载 api.js,请将 strapi::security 行替换为 strapi/config/middlewares.js 文件中的以下配置:
    
                            {
                                name: "strapi::security",
                            config: {
                                contentSecurityPolicy: {
                                useDefaults: true,
                            directives: {
                                "script-src": ["'self'", "https:", "http:"],
                            "frame-src": ["'self'", "https:", "http:"],
          },
        },
      }
    },
                        

    如果此类配置已存在,您只需添加 directives

  2. 在您的 Strapi 项目中安装插件:
    npm install onlyoffice-strapi --save
  3. 重建并重启 Strapi 以将 ONLYOFFICE 插件包含到管理界面中。运行:
    
                            # 使用 yarn
                            yarn build
                            yarn develop
    
                            # 使用 npm
                            npm run build
                            npm run develop
                        

    现在,ONLYOFFICE 集成插件已安装并准备好进行配置。可以通过左侧面板的 插件 部分下的 ONLYOFFICE 名称访问该插件。

    ONLYOFFICE 已安装ONLYOFFICE 已安装
配置 ONLYOFFICE 集成插件以用于 Strapi

要在 Strapi 中配置 ONLYOFFICE 集成插件:

  1. 打开左侧面板中的 设置 部分。
  2. 全局设置 部分,点击 ONLYOFFICE 菜单项。
  3. ONLYOFFICE 设置页面,输入 文档服务器地址,即已安装的 ONLYOFFICE 文档 的 URL。
    ONLYOFFICE 文档的地址必须能够从 Strapi 访问,同时 Strapi 的地址也必须能够从 ONLYOFFICE 文档访问。
工作原理

用户与文档的交互在客户端和服务器端同时进行。

当前文档中使用的主要概念如下所述。

客户端包括:

  • 文档管理器 - 显示在用户浏览器中的文档列表,用户可以选择所需的文档并对其执行某些操作(根据提供的权限,用户可以打开文档进行查看或编辑,与其他用户共享文档)。
  • 文档编辑器 - 文档查看和编辑界面,提供所有最常用的文档编辑功能,作为用户与 文档编辑服务 之间的媒介。

服务器端包括:

  • 文档存储服务 - 存储所有可供具有适当访问权限的用户使用的文档的服务器服务。它向用户在浏览器中看到的 文档管理器 提供文档 ID 和这些文档的链接。
  • 文档编辑服务 - 允许执行文档查看和编辑的服务器服务(如果用户有相应的权限)。文档编辑器 界面用于访问所有 文档编辑服务 功能。
  • 文档命令服务 - 允许使用 文档编辑服务 执行附加命令的服务器服务。
  • 文档转换服务 - 允许将文档文件转换为适当的 Office Open XML 格式(docx 用于文本文档,xlsx 用于电子表格,pptx 用于演示文稿)以进行编辑或下载的服务器服务。
  • 文档生成服务 - 允许轻松构建文档而无需实际运行文档处理编辑器的服务器服务。

请注意,ONLYOFFICE 文档服务器 包括 文档编辑器文档编辑服务文档命令服务文档转换服务文档生成服务文档管理器文档存储服务 要么包含在 社区服务器 中,要么必须由使用 ONLYOFFICE 文档服务器 的软件集成商在其自己的服务器上实现。

为 ONLYOFFICE 和 Strapi 集成启用 JWT

JWT 或 JSON Web Token 是在 HTTP 请求中从客户端发送到服务器的字符串,用于验证客户端的真实性。JWT 仅保存在客户端,因此各方之间的传输是受保护和数字签名的。

令牌是使用 JWT(JSON Web Tokens)标准生成的。令牌由服务器的密钥签名,因此客户端可以验证令牌的合法性。

ONLYOFFICE 文档 验证令牌。有效载荷中的数据被视为有效,并用于替代主要参数中的相应数据。如果令牌无效,则命令不会执行。要了解更多,请阅读 API 安全 指南。

要使用 JWT 保护您的文档,

  1. 打开左侧面板中的 设置 部分。
  2. 全局设置 部分,点击 ONLYOFFICE 菜单项。
  3. ONLYOFFICE 设置页面,在 文档服务器 JWT 密钥 字段中输入密钥。更多信息可以在 此处找到。
    ONLYOFFICE 插件ONLYOFFICE 插件

    现在,ONLYOFFICE 集成插件已配置完毕,您可以开始使用它。

开始在 Strapi 中使用 ONLYOFFICE 文档

为了让用户在 ONLYOFFICE 文档 编辑器中编辑来自 Strapi 的办公文档并将更改保存回 Strapi,请上传文件并设置相应的访问权限。

将文件上传到 Strapi
  1. 在左侧面板的 插件 部分,打开 媒体库 页面。
  2. 点击右上角的 添加新资产 按钮。
    媒体库媒体库
  3. 添加新资产 窗口打开。选择您是要从 计算机 上传文件还是从 URL 上传文件,点击顶部面板中的相应选项卡。
    添加新资产添加新资产
在 Strapi 中查看、编辑和管理文件

要查看、编辑和共同创作添加到 Strapi 媒体库 的文档,

  1. 在左侧面板的 插件 部分,打开 Strapi 中的 ONLYOFFICE 文件页面。
  2. 要在 ONLYOFFICE 编辑器中打开文件,请点击文件名或点击右侧的 在 ONLYOFFICE 中编辑 按钮。
    在 ONLYOFFICE 中查看和编辑在 ONLYOFFICE 中查看和编辑

要在编辑器中以所需格式保存文件,

  1. 转到 文件 选项卡。
  2. 点击 下载为... 选项并选择所需格式。

要在编辑器中将文件标记为收藏,请点击顶部工具栏中的 标记为收藏 标记为收藏 图标。

要返回文件列表,

  1. 转到 文件 选项卡。
  2. 点击右侧菜单中的 打开文件位置 选项。
访问权限

要管理添加到 Strapi 媒体库 的文件的访问权限:

  1. 转到左侧面板的 常规 部分中的 设置 选项卡。
  2. 管理面板 部分,转到 角色 选项卡。
  3. 点击角色名称右侧的 编辑 图标以编辑角色。

要允许用户 编辑 文件,请为所需的用户角色设置 更新 + 删除 访问权限。

要仅允许用户 查看 文件,请为所需的用户角色设置 访问媒体库 访问权限。

要了解有关最常见问题及其解决方法的更多信息,请访问我们的 故障排除指南

在您自己的服务器上托管 ONLYOFFICE 文档,或在云端使用

文章: 标签:
浏览所有标签