简要
Box Odoo Integration 是 Odoo 19 文档管理 应用。将 Odoo 附件与 Box 文件双向自动同步的工具.
Box Odoo Integration 将 Cloud Storage Solutions 与 Box 云存储连接。它在两个方向同步 Odoo 文件夹和附件与 Box，用 URL 附件替换 Odoo 中已同步的二进制文件，并让用户从 Odoo 记录和文件管理器快速访问 Box 文件。
适合
基于 Box 的文档团队
用 Box 做存储层，Odoo 仍是文件和文件夹的业务工作区。
结构化 Box 文件夹
根据 Odoo 对象、文件夹规则和手动文件夹生成 Box 文件夹树，无需改变用户习惯。
快速访问 Box
从 Odoo 打开已同步的 Box 项目，同时保留 Odoo 记录上下文、搜索和文件管理器导航。
团队为何选择它
深入细节前的关键益处
将 Box 用作文件存储
同步后的二进制以文件和文件夹形式放在 Box，同时保留 Odoo 业务上下文。
由 Odoo 驱动的文件夹树
根据 Odoo 文件夹规则、手动文件夹和记录相关附件框生成 Box 目录。
双向同步处理
将 Odoo 附件推送到 Box，并把 Box 侧的文件或文件夹作为链接项带回 Odoo。
Odoo 文件管理器
从 Odoo 浏览、上传、移动、打标签、下载并搜索已与 Box 同步的附件。
Box 网页链接
当用户需要在 Box 界面继续工作时，从 Odoo 打开已同步的 Box 文件和文件夹。
队列与日志
从 Odoo 中的 Cloud Storage 日志监控 Box 同步作业、重试和客户端状态。
Box 同步如何工作
计划作业使 Odoo 文件夹与 Box 文件夹双向保持一致。
Odoo 到 Box
- 直接同步根据 Odoo 文件夹规则和手工目录创建 Box 文件夹。
- Odoo 附件会上传到 Box，并在 Odoo 中替换为 URL 附件。
- 文件夹和文件的更改会排队，并由计划同步作业处理。
从 Box 到 Odoo
- 反向同步会为新的 Box 项目创建 Odoo URL 附件和子文件夹。
- 云端的移动、更新和删除会在可能时反映到已关联的 Odoo 文件夹。
- Box 连接重置或更改时，反向同步可将文件带回 Odoo。
Box 的 URL
只要用户需要 Box 界面，就从 Odoo 打开已同步的 Box 文件和文件夹。
从Odoo直接访问
- 已同步的 Odoo 附件会变成指向对应 Box 文件的 URL 记录。
- 用户可从文件管理器和附件框打开已关联的 Box 文件夹。
- 即使文件本身存在 Box，Odoo 仍保留记录、文件夹和标签上下文。
Box 权限留在 Box
- 扩展同步链接和文件；Box 侧的访问策略仍在 Box 中管理。
- Odoo 管理员在 Cloud Storage 设置中管理同步范围、日志和连接。
- 这种分离让 Odoo 文档导航保持清晰，同时保留公司的 Box 治理模型。
准备好评估了吗？
从免费演示申请开始，或在 Odoo Apps Store 购买。
免费个性化演示数据库。无需电话或信用卡。在所购 Odoo 主要版本期内提供终身免费更新和专家支持。
配置与安装提示： Box Odoo Integration Odoo v.19
Python 依赖项
该工具依赖外部库 'box_sdk_gen'。请用以下命令为 Odoo 服务器安装：
pip3 install boxsdk配置与登录
- 打开选项 'Box Sync'（cloud Storage > 配置 > 配置）。需要可选插件 Box Odoo Integration
- 创建或打开Box开发者帐户并转到Box Developer Console： https://app.box.com/developers/console
- 创建 Custom App，并将身份验证方法选为 OAuth 2.0 (Authorization Code Grant)
- Add the redirect URI as [YOURODOOSITENAME]/box_token (e.g. https://faotools.com/box_token). A valid SSL certificate (https) is required
- 授予应用读写文件和文件夹的权限。避免分配无关权限
- 转到 Odoo Cloud Storage > Configuration > Cloud Clients 并按 'Create'
- 作为参考，请填写所有用户都能看懂的名称
- 作为 Cloud 客户端，选择“Box”
- 在 Root folder 名称中输入标题，作为所有同步文件夹的父级Box directory。例如 'Odoo' 或 'OdooERP'
- 将Box Client ID复制到“Client ID”字段
- 将Box Client Secret复制到“Client Secret”字段
- 插入先前生成的重定向 URL
- 点击 “Confirm”。Odoo 将你转到 Box 登录页。在系统中核对、同意全部条件，并授予所请求的全部权限
- 登录后，Box 会将您重定向回 Odoo。Box - Odoo 同步已就绪
- 将新创建的 cloud client 应用到应同步到该 Box 账户的文件夹规则和/或手动文件夹
- 等待同步计划作业启动。仅供测试：从 Cloud Storage > 配置 > 配置 > “Launch sync”按钮手动触发集成。
创建新的Box开发者应用
复制Box OAuth凭据
在Odoo中配置Box云客户端
向 Odoo 授予 Box 访问权限
相关常见问题 Box Odoo Integration Odoo v.19
同步字段存储在哪里？会复制到 Odoo 和云端吗？
本应用假定附件的二进制内容保存在 Cloud Client 中，而不是 Odoo 服务器上。因此，Odoo 中的此类附件变为 URL 类型，您可随时从附件框或 Cloud Client 访问它们。
设置完成后无需手动操作，同步完全自动。只需决定要同步哪些 Odoo 单据类型，并为每一种设置关联模型（客户、销售或采购订单、任务、项目等）。
同一单据类型可以有多个文件夹吗？例如内部项目和客户项目？
可以。请为每一种准备规则，然后应用筛选：例如按项目类型。
尽量让筛选互斥，以便单据能被明确归类。例如“是客户但不是供应商”、“是供应商但不是客户”。否则某个单据文件夹会在模型之间跳动。
可以将同步做成实时的吗？
不可以。我们有充分理由避免实时同步：
性能问题。若同步是实时的，每次上传文件都会出现加载屏幕。
冲突问题。若 2 位用户同时更改一项，可能出现无法解决的情况。定期作业可以事后修复；实时同步则必须存成队列，对用户更加费解。
功能问题。尤其是重命名和调整结构。反向同步严格依赖目录逻辑，每次同步都会检查 100% 的项目。若每次更新都做，将是每秒数千次请求。若不做：更改会丢失。
我可以更改云中默认文件夹的名称吗？
可为任何单据类型给模型目录（销售订单、商机、供应商等）指定自己的名称。
对象文件夹（SO-001、John Smith 等）依赖 Odoo 为该单据类型构造显示名称的方法。不过可通过定义名称表达式来更改。使用的正是 Odoo 电子邮件模板的语法。
我可以更改同步作业的频率吗？
不可以。从版本 15 起不应再改计划作业。它们已优化为每 15 分钟运行，以保证最稳定、最快的连接。
请确保 Odoo 服务器超时至少为 15 分钟（900 秒）。
若需暂时停止同步，请在相应的 cloud client 表单上进行。
我可以将附件同步到几个云客户端吗
可以，从版本 15 起可设置多个连接。这样一部分文件夹同步到一个 cloud client，另一部分同步到另一个。
请注意，同一文件夹无法同时同步到多个 cloud storages。
我们在云中使用专用编辑器（例如 OnlyOffice、Office 365 等）。文件会在该编辑器中打开吗？
可以，取决于您的 cloud client 配置。
我是否只需要Cloud Storage Solution应用？
从版本 15 起，应用可单独用来把附件按文件夹整理，并提供文件管理器界面。
不过，若要与某个云客户端建立连接，则需要 至少安装一个可选的客户端相关应用。
更改文件夹规则时会发生什么？
文件夹规则一变，文件夹列表也会变。不再符合规则条件的文件夹会被移除。若文件已同步，反向同步会将其退回 Odoo 并从 Cloud Client 删除。
若文档对象不符合文件夹规则的条件，则不会创建其文件夹。之后若符合条件，将生成相关文件夹。
非英语的应用和网站措辞由 AI 辅助 并与官方 Odoo 翻译对齐。若发现错误， 发送翻译正确性工单 我们会修好。
Odoo 演示数据库（在线预览）
对于此应用，我们可能提供免费个性化演示数据库。
联系我们无需电话号码或信用卡。只需完成不超过 30 秒的简短电子邮件注册。
按您的申请，我们将准备独立的在线预览数据库，约两周内可进行任意测试并核验假设。
缺陷反馈
如遇缺陷或不一致行为，请随时联系我们。我们保证在购买后 60 天内提供修复，并在此期限后仍积极改进工具。
联系我们无需电话号码或信用卡。只需完成不超过 30 秒的简短电子邮件注册。
请在请求中尽可能提供详细信息：截图、Odoo 服务器日志、完整的问题复现说明等。通常需要几个工作日来准备问题的工作计划（若确认是缺陷）或提供应采取的指引（否则）。
公开功能请求与模块构想（免费开发）
我们非常希望改进工具，并感谢任何反馈。若您的需求具有普遍价值且能高效实现，团队会将其列入待办清单。
此类待办清单会定期处理，不产生额外费用。虽然我们无法承诺截止日期和最终设计，但这可能是在无投入、无风险的情况下获得所需功能的好办法。
联系我们无需电话号码或信用卡。只需完成不超过 30 秒的简短电子邮件注册。
通过 MCP 从常用 AI 聊天管理 Odoo 的工具。Claude。任何支持 MCP 的 AI。
198€
用于将 Odoo 附件灵活归入文件夹并将目录与云客户端同步的工具：Google Drive、OneDrive/SharePoint、Nextcloud/ownCloud、Dropbox、Amazon S3、Box 和 NAS。DMS。文件管理器。文档管理系统
