跳到主要内容

Odoo integration

该应用程序允许用户在 Odoo 的“文档”模块中，借助 ONLYOFFICE 文档进行办公文档的编辑与协作。

功能特性​

  • 目前，可使用此应用程序打开和编辑的文档格式有：DOCM、DOCX、DOTM、DOTX、PDF、POTM、POTX、PPSM、PPSX、PPTM、PPTX、XLSB、XLSM、XLSX、XLTM、XLTX。
  • 仅支持查看的文档格式如下：CSV、DJVU、DOC、DOCXF、DOT、DPS、DPT、EPUB、ET、ETT、FB2、FODP、FODS、FODT、HTM、HTML、HWP、HWPX、KEY、MD、MHT、MHTML、NUMBERS、ODG、ODP、ODS、ODT、OFORM、OTP、OTS、OTT、OXPS、PAGES、POT、PPS、PPT、RTF、STW、SXC、SXI、SXW、TXT、VSDM、VSDX、VSSM、VSSX、VSTM、VSTX、WPS、WPT、XLS、XLT、XML、XPS。
  • 该应用程序会在文档库中为 Office 文档创建一个新的在 ONLYOFFICE 中打开菜单项。这使得多个用户能够实时协作，并将更改保存回 Odoo。

安装 ONLYOFFICE 文档​

您需要一个 ONLYOFFICE 文档（文档服务器）实例，该实例必须能从 Odoo 和任何终端客户端解析并连接。如果无法满足此条件，请使用官方的 ONLYOFFICE 文档安装指南。ONLYOFFICE 文档还必须能够直接向 Odoo 发送 POST 请求。

使用 Docker 是启动 ONLYOFFICE 文档实例的最简单方法。

安装 Odoo ONLYOFFICE 集成应用程序​

要在 Odoo 中使用 ONLYOFFICE 文档，必须执行以下步骤：

方法 1：从管理面板安装

  1. 登录您现有的 Odoo 账户，或者注册一个新账户。
  2. 进入 Odoo 管理面板，点击顶部菜单栏中的应用。
  3. 在应用目录中搜索 ONLYOFFICE。
  4. 点击安装按钮。

方法 2：手动安装

  1. 访问 Odoo 应用目录，选择您已安装的 Odoo 版本。

  2. 搜索 ONLYOFFICE 并下载。您也可以从官方 GitHub 仓库下载应用程序的最新版本。

  3. 将 ONLYOFFICE 应用程序放入*/path/to/odoo/addons* 目录。确保 ONLYOFFICE 文件夹命名为onlyoffice_odoo。

    或者，您可以在*/path/to/odoo/config/odoo.conf* 文件中添加以下内容，指定您存放apps/addons文件夹的路径：

    [options]
    addons_path = /mnt/extra-addons

  4. 安装 pyjwt 包：

    pip install pyjwt

  5. 将 Odoo 切换到开发者模式，点击应用->更新应用列表，或者直接重启您的 Odoo 实例。

备注

ONLYOFFICE 演示模板仅会添加到已安装的 Odoo 模块中（指 ONLYOFFICE 模板应用）。因此，我们强烈建议在安装 CRM、销售、日历等其他 Odoo 模块之后再安装 ONLYOFFICE 模板。

配置 Odoo ONLYOFFICE 集成应用程序​

要配置该应用程序，进入设置。在左侧边栏找到 ONLYOFFICE 并点击。指定已安装的 ONLYOFFICE 文档的 URL：

https://<documentserver>/

其中，文档服务器地址是安装了 ONLYOFFICE 文档的服务器名称。该地址必须能被用户浏览器和 Odoo 服务器访问。Odoo 服务器地址也必须能被 ONLYOFFICE 文档访问，以确保正常工作。您可以注册一个免费的 ONLYOFFICE 云，并使用其公共 IP 地址或公共 DNS，这些地址或 DNS 可以在云控制台的实例部分找到。

警告

从 7.2 版本开始，JWT 默认启用，并且会自动生成密钥，用于限制对 ONLYOFFICE 文档的访问，保障安全性和数据完整性。在 Odoo 配置页面指定您自己的密钥。在 ONLYOFFICE 文档的配置文件中，指定相同的密钥并启用验证。

工作原理​

ONLYOFFICE 集成遵循此处记录的 API 规范。

使用表单​

您可以在 Odoo 的 ONLYOFFICE 模板模块中创建、上传和使用可填写的表单模板。该模块允许您生成带有字段的文档，这些字段可以自动填充来自 Odoo 记录的数据。

要求​

  • 支持可填写表单的 ONLYOFFICE 文档实例。
  • 启用了 Automation API 选项的有效 ONLYOFFICE 许可证。
  • Odoo 中的 ONLYOFFICE 模板模块（会自动安装主 ONLYOFFICE 模块）。
信息

有关 Odoo 集成的详细信息，请参阅 ONLYOFFICE Odoo 连接器指南。

备注

如果您计划在 Odoo 中部署可填写表单工作流，请确保您的 ONLYOFFICE 文档版本支持 PDF 表单。有关您环境（社区版、企业版、云版）中支持的最低版本，请查看 ONLYOFFICE 发布说明或联系支持团队。

在此处下载 Odoo 的 ONLYOFFICE 应用程序。