跳到主要内容

SuiteCRM

关于 ONLYOFFICE 和 SuiteCRM 集成​

SuiteCRM 是一个客户关系管理系统。ONLYOFFICE 提供了一个官方模块，可以将 ONLYOFFICE 文档 与 SuiteCRM 集成，并在您的 SuiteCRM 空间中编辑办公文档。您可以从 GitHub 页面获取 ONLYOFFICE 集成模块。该模块基于 AGPL-3 许可证分发。

备注

要详细了解适用于 SuiteCRM 的 ONLYOFFICE 连接器的工作原理，请访问我们的 API 文档页面。

主要功能​

  • 编辑和查看文本文档、电子表格和演示文稿。

  • 实时共同编辑文档：两种共同编辑模式（快速和严格）、跟踪更改 模式、批注和内置聊天。

  • 创建和编辑表单模板。

    备注

    要了解有关表单的更多信息，请阅读相应的创建和填写表单文章。

  • JWT 支持，保护您的流量，除具有适当权限的用户外，任何人都无法访问您的文档。

支持的格式​

  • 查看和编辑：DOCX、XLSX、PPTX。
  • 仅查看：PDF、ODT、ODS、ODP、DOC、XLS、PPT、PPS、EPUB、RTF、HTML、HTM、TXT、CSV。

将 ONLYOFFICE 文档连接到 SuiteCRM​

要求​

  • ONLYOFFICE 文档服务器 v7.1（服务器版）或更高版本

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

    备注

    要了解有关安装 ONLYOFFICE 文档的更多信息，请参阅官方文档页面。

  • SuiteCRM 7（所有 7.x 版本）

  • 适用于 SuiteCRM 的 ONLYOFFICE 连接器 v1.0.0 及更高版本

安装适用于 SuiteCRM 的 ONLYOFFICE 集成模块​

要安装 ONLYOFFICE 应用程序：

  1. 从 GitHub 页面获取 ONLYOFFICE 集成插件 的最新已编译软件包文件。

  2. 启动 SuiteCRM，切换到 Admin（管理员）> Admin Tools（管理工具）> Module Loader（模块加载器）。

    ONLYOFFICE SuiteCRM 管理员

  3. 上传 ONLYOFFICE 插件归档文件。

  4. 点击 Install（安装）按钮安装已上传的模块。

  5. 切换到 Admin（管理员）> Admin Tools（管理工具）> Repair（修复）。

  6. 运行 Quick Repair and Rebuild（快速修复和重建）。

    ONLYOFFICE SuiteCRM 修复和构建

工作原理​

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

下面解释本文档中使用的关键术语。

客户端包括：

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

服务器端包括：

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

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

为 ONLYOFFICE 和 SuiteCRM 集成配置 JWT​

JWT 即 JSON Web 令牌，是在 HTTP 请求中从客户端发送到服务器、用于验证客户端真实性的字符串。JWT 仅保存在客户端，因此各方之间的传输受到保护并经过数字签名。

令牌使用 JWT（JSON Web 令牌）标准生成。令牌由服务器的密钥签名，因此客户端能够验证令牌是否合法。

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

在 ONLYOFFICE 文档中，从 7.2 版本开始，JWT 默认 启用。

如需 手动 配置，请按照以下步骤操作：

  1. 转到 Admin（管理员）> ONLYOFFICE > ONLYOFFICE Settings（ONLYOFFICE 设置）。

    ONLYOFFICE SuiteCRM OO 设置

  2. 在以下字段中输入值：

    • Document Editing Service Address（文档编辑服务地址）：指定安装 ONLYOFFICE 文档的 URL 地址（例如 https://documentserver）。
    • Secret key（密钥）（留空则禁用）：密钥会自动生成，用于限制对 ONLYOFFICE 文档 的访问。如果您想在此字段中指定自己的密钥，还需要在 ONLYOFFICE 文档配置文件中指定相同的密钥以启用验证。
    • Authorization header（授权标头）（留空则使用默认标头）：ONLYOFFICE 中使用的标准 JWT 标头是 Authorization。如果此标头与您的设置冲突，您可以将其更改为自定义标头。

    ONLYOFFICE SuiteCRM JWT 设置

在 SuiteCRM 中开始使用 ONLYOFFICE 文档​

要编辑办公文件并进行协作：

  • 转到 Documents（文档）模块。
  • 点击文件名打开 Detail View（详细视图）页面。
  • 在 Detail View（详细视图）页面上，点击 ACTIONS（操作）下拉菜单中的 Open in ONLYOFFICE（在 ONLYOFFICE 中打开），文件将在同一标签页中打开。

ONLYOFFICE SuiteCRM 在 OO 中编辑

备注

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