本文由AI翻译

Odoo

关于 ONLYOFFICE 和 Odoo 的集成

Odoo 是一款为资源规划设计的业务管理工具。ONLYOFFICE 提供了三个官方模块来与 Odoo 集成:

  1. ONLYOFFICE 是一个主要模块,其他模块需要依赖它才能工作,并允许附加文档。
  2. ONLYOFFICE 文档 是一个用于创建、编辑和附加文档的模块。
  3. ONLYOFFICE 模板 是一个用于创建和编辑可填写表单的模块。

集成模块在 LGPL-3 许可证下分发。

要了解更多关于其工作原理以及如何编译 ONLYOFFICE 连接器以用于 Odoo,请访问我们的 API 文档
主要功能
  • 编辑和查看文本文档、电子表格、演示文稿、PDF 和图表。
  • 实时协同编辑文档:两种协同编辑模式(快速和严格)、修订模式、评论和内置聊天。
  • JWT 支持,以保护您的流量,确保只有具有适当权限的用户才能访问您的文档。
支持的格式
  • 用于编辑:DOCM, DOCX, DOTM, DOTX, XLSB, XLSM, XLSX, XLTM, XLTX, POTM, POTX, PPSM, PPSX, PPTM, PPTX, PDF
  • 用于查看:
    • WORD:DOC, DOCM, DOCX, DOT, DOTM, DOTX, EPUB, FB2, FODT, HTM, HTML, HWP, HWPX, MD, MHT, MHTML, ODT, OTT, PAGES, RTF, STW, SXW, TXT, WPS, WPT, XML
    • CELL:CSV, ET, ETT, FODS, NUMBERS, ODS, OTS, SXC, XLS, XLSM, XLSX, XLT, XLTM, XLTX
    • SLIDE:DPS, DPT, FODP, KEY, ODG, ODP, OTP, POT, POTM, POTX, PPS, PPSM, PPSX, PPT, PPTM, PPTX, SXI
    • PDF:DJVU, DOCXF, OFORM, OXPS, PDF, XPS
    • DIAGRAM:VSDM, VSDX, VSSM, VSSX, VSTM, VSTX
版本 5.3.0 的新功能

新增

  • 禁用证书验证的选项
  • 支持在 ONLYOFFICE 编辑器中打开文档预览
  • 新增 关于 面板并更新设置中的描述
  • 支持查看 .vsdx, .vssx, .vstx, .vsdm, .vssm, .vstm 图表格式
  • 支持查看 .odg, .md 格式
  • 支持编辑 .xlsb 文件
  • 新增加泰罗尼亚语、丹麦语、匈牙利语、印尼语、罗马尼亚语的空白文件模板

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

连接 ONLYOFFICE 文档到 Odoo

要求
  • ONLYOFFICE 文档实例。请参考官方 文档页面 了解更多关于安装 ONLYOFFICE 文档的信息:
  • ONLYOFFICE 主要模块,其他模块需要依赖它才能工作。该模块无需付费许可证。
  • ONLYOFFICE 文档 模块需要 Odoo 企业版 才能正常工作。该模块将自动安装主要的 ONLYOFFICE 模块。
  • ONLYOFFICE 模板 模块需要具有自动化 API 的 ONLYOFFICE 许可证才能正常工作。该模块将自动安装主要的 ONLYOFFICE 模块。
  • 所有模块都需要 PyJWT。
安装 PyJWT 库

要安装 PyJWT 库,请在命令行中输入以下命令:

pip install pyjwt

要了解更多,请参考官方 PyJWT 安装指南

配置 Odoo 的 ONLYOFFICE 集成模块

ONLYOFFICE 模块

要安装 ONLYOFFICE 模块:

  1. 打开 应用
  2. 找到 ONLYOFFICE 并点击下面的 激活 按钮。

ONLYOFFICE 文档

要安装 ONLYOFFICE 文档 模块:

  1. 打开 应用
  2. 找到 ONLYOFFICE 文档 并点击下面的 激活 按钮。

ONLYOFFICE 模板

要安装 ONLYOFFICE 模板 模块:

  1. 打开 应用
  2. 找到 ONLYOFFICE 模板 并点击下面的 激活 按钮。

第一个安装的模块会自动建立与 文档服务器 的连接。

模块安装后,如有必要,请在您的 Odoo 中调整设置。要进行调整,请转到 主页菜单 > 设置 > ONLYOFFICE

文档服务器 URL 中,指定已安装的 ONLYOFFICE 文档 的 URL 或 ONLYOFFICE 文档云 的地址。要了解更多关于 JWT 配置的信息,请参考本指南的 相应部分

文档编辑服务的内部请求服务器地址 - 该字段会自动填写。

服务器的内部请求文档编辑服务地址 - 此字段应与 文档服务器 URL 具有相同的值。

如有需要,您可以通过激活 连接到演示 ONLYOFFICE 文档服务器 复选框来连接到 ONLYOFFICE 演示服务器。请注意,这是一个公共测试服务器,不应上传或处理敏感数据。

为 ONLYOFFICE 和 Odoo 集成配置 JWT

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

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

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

Odoo 中,JWT 默认启用

如果需要,请按照以下步骤手动配置

  1. 转到 主页 菜单 设置 > ONLYOFFICE
    ONLYOFFICE_OdooONLYOFFICE_Odoo
  2. 在以下字段中输入值:
    • 文档服务器 JWT 密钥:密钥会自动生成以限制对 ONLYOFFICE 文档 的访问。如果您希望在此字段中指定自己的密钥,也请在 ONLYOFFICE 文档配置文件 中指定相同的密钥以启用验证。
    • 文档服务器 JWT 头部:ONLYOFFICE 中使用的标准 JWT 头部是 Authorization。如果此头部与您的设置冲突,您可以将其更改为自定义头部。

在 Odoo 中开始使用 ONLYOFFICE 文档

ONLYOFFICE 模块

要附加文件:

  1. 转到 讨论 模块。
  2. 选择一个频道或讨论。
  3. 点击聊天框中的 附加文件 按钮。
  4. 选择您需要附加的文件并点击 确定
  5. 附加的文件将如下所示:
    ONLYOFFICE_OdooONLYOFFICE_Odoo
ONLYOFFICE 文档模块

要创建文件:

  1. 打开 文档 模块。
  2. 点击顶部面板左上角 新建 下拉菜单中的 使用 ONLYOFFICE 创建 按钮。
  3. 选择以下选项之一:
    • 空白 - 创建一个空白文档、电子表格、演示文稿或 PDF 表单。

      如有必要,请在 标题 字段中输入文件名。

      ONLYOFFICE_OdooONLYOFFICE_Odoo

      点击 创建 按钮创建文件,或点击 创建并设置权限 按钮为文件设置访问权限。

      ONLYOFFICE_OdooONLYOFFICE_Odoo
      • 添加人员或电子邮件地址 在相应的字段中。
      • 具有访问权限的人员面板 中查看具有访问文档的用户列表。
      • 为所有内部用户和通过链接的第三方访问设置 通用访问 参数。
    • 从模板 - 基于可用模板之一创建文档。按 类别类型语言 排序模板列表,或使用 搜索 字段。

      点击模板查看其预览,或通过点击模板右上角的单选按钮选择它。点击 创建 按钮继续。

您可以编辑附加到 Odoo 活动并由 ONLYOFFICE 支持的任何文件(完整列表请见 此处)。

要编辑或查看文件,请点击右侧扩展面板上的 在 ONLYOFFICE 中打开 按钮,例如:

ONLYOFFICE_OdooONLYOFFICE_Odoo
ONLYOFFICE 模板模块

您可以使用模块主页上提供的预制模板。

ONLYOFFICE_OdooONLYOFFICE_Odoo

请注意,可用模板的数量取决于已安装的模块,例如,销售发票日历招聘等。ONLYOFFICE 演示模板只会添加到已安装的 Odoo 模块中。强烈建议在安装其他 Odoo 模块后安装 ONLYOFFICE 模板。

要创建表单:

  1. 建议切换到开发者模式。
    • 转到 设置
    • 打开 常规设置 选项卡。
    • 滚动到 开发者工具
    • 点击 激活开发者模式 菜单选项。
  2. 打开 主页菜单 并选择 ONLYOFFICE 模板 选项。
  3. 点击 创建或上传 按钮创建新表单。
  4. 输入 模板名称
  5. 选择模型 字段中输入 Odoo 模型。
    ONLYOFFICE_OdooONLYOFFICE_Odoo
    • 要了解模型名称,请打开所需模块。
    • 转到任何具有 ONLYOFFICE 发送和打印 按钮的条目。
    • 查看页面 URL。model-xxx 是您在 选择模型 字段中需要的 Odoo 模型名称。将其粘贴到此字段中并按 Enter。
      ONLYOFFICE_OdooONLYOFFICE_Odoo
    • 您还可以通过点击 上传您的文件 按钮上传现有模板。
  6. 模板应已创建并可供编辑。如果没有,请在创建模板时点击屏幕左上角的 手动保存 按钮。

    如果您需要创建多个模板,请填写所需字段并点击屏幕右上角的 新建 按钮。当前模板将被保存,字段将再次为空,您可以继续创建另一个模板。

  7. 处理模板字段

    切换到 ONLYOFFICE 模板 模块并点击所需模板以打开它进行进一步编辑。如果您需要编辑模板的属性,请点击所需模块右上角的 更多 按钮并选择 编辑 选项。

  8. 每个模块中的每个字段旁边都有一个问号。那里提供的信息对于填写字段是必要的。
    ONLYOFFICE_OdooONLYOFFICE_Odoo

    如果字段没有问号,请尝试暂时删除其内容。字段名称可能会出现。这类名称也可以在编辑表单时左侧面板的根部分找到。

  9. ONLYOFFICE 模板 连接器中搜索需要 字段模块 字段的信息。
  10. 如果字段具有 one2many/many2many/many2one 关系,子部分将具有相应的名称。

    子部分名称

  11. 如果 模型 字段包含的名称与 URL 中给出的名称不一致(例如,URL 中的 model-account.move模型 字段中的 account.move.line),请在子部分中查找。

    如果是 one2many/many2many/many2one 关系,子部分键将与 字段 字段同名。例如,如果是 partner_id,键将具有相同的名称。

  12. 请注意,如果字段的模型与 URL 中的名称不一致,部分键将与 模型 字段同名。
  13. 由于连接器集成在所有 Odoo 模块中,可以在 操作 菜单 > 使用 ONLYOFFICE 打印 中打印填写的表单。
  14. 所选模块的所有可用模板将显示在打开的菜单中。选择所需的模板,以便用与所选模块项对应的数据填充它。
  15. 表单将下载到您的设备。字段根据您下载表单的页面自动填写。
  16. 要将数据集添加到表单中
    • 在表单中创建一个表,该表将与数据集字段名称相同的列;
    • 在相应字段中输入 Odoo 问号中给出的信息;
    • 表格的其余部分将在页面打印期间自动填充。

      目前,无法在表单中插入 HTML 元素。

  17. 要管理访问权限,
    • 转到用户配置文件;
    • 选择他们是 用户 还是 管理员
      • 用户 只能打印和查看模板。
      • 管理员 可以创建、编辑、查看、删除和打印模板。
    • 所有用户默认具有用户访问权限。
要了解更多关于最常见问题及其解决方法的信息,请访问我们的 故障排除指南

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

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