DropBox Odoo Integration v.14
The tool to automatically synchronize Odoo attachments with DropBox files in both ways
This is the tool to integrate DropBox features into your Odoo business work flow. The app automatically stores Odoo attachments in DropBox, and it provides an instant access to them via web links. In such a way users work with files comfortably in the cloud storage, while the results are fully available in Odoo.
- the technical core which provides basic mechanics of auto synchronization. This is a required module for integration.
Его цена
398€
358€.
- the connector itself which introduces links between Odoo and DropBox.
Его цена
89€
80€.
- an optional add-on to sync Odoo documents (introduced by the enterprise app 'Documents') with clouds. The features assumed by this add-on are marked by the icon .
Его цена
44€
39€.
Automatic regular sync
Synchronization between Odoo and DropBox is based on scheduled jobs. No manual interaction is required
Bilateral DropBox sync
Odoo sends attachments to DropBox and retrieves files from there. Binary content is kept in clouds, while Odoo provides direct access to synced items
Any Odoo document types for sync
Decide which Odoo document types should be synced. Customers, opportunities, sale or purchase orders, tasks or issues, employees or users, etc. Custom models are also supported
Instant access for DropBox
The tool redefines Odoo attachments boxes to make work comfortable: download files locally without login, open files and folders in DropBox, use standard Odoo previewers
Compatible with Odoo Enterprise documents
Reflect Odoo Enterprise Documents' structure and items in DropBox. All features (including sharing, downloading, and signing) would anyway work
All DropBox tariffs
Synchronization works for any DropBox tariff, including Personal DropBox (Basic, Plus, Family) and business DropBox (Professional, Standard, Advanced)
DropBox sync history
Sync activities might be logged. Control over files and folders creations, moves, name changes and removals. Just turn on the option 'Log sync activities', and you would be able to observe the history through the button 'Sync logs'
Default folders
The tool let generate default directories' structure for this document type during the very first sync of a related object. For example, for all employees you may have pre-defined folders 'Scans', 'Scans/Official', 'Photos', etc.
Sync any documents you like
Configuring models to sync
-
To sync a specific document type, you should add it as a model to sync. Any Odoo model might be chosen
-
The app let split models into a few folders based on selected filters. Use any document storable field to distinguish a directory. Have a separate folder for individuals and companies, for European and American opportunities, for quotations and confirmed orders, for each project, etc.
-
Limit also documents by relative periods through using date fields of linked documents. For example, leads registered in the last 3 months or invoices updated the last week
-
Define name expressions to specify titles of documents' DropBox folders. For instance, to include project name to a task directory
-
Prepare hierarchy of default folders to be created when a document directory is synced to DropBox for the first time
Typical use cases
-
Projects: have an own DropBox folder for each customer project
-
Customers: add all partner files in a single directory available both from Odoo and from DropBox. Modify those using default cloud editors and access them when working in Odoo
-
Employees: gather all files by this employee in a single cloud folder: photos, document scans, contracts. Access and upload those from Odoo and DropBox alternatively
-
Opportunities: carefully store all specifications, requirements, any files which would let you make a good offer
-
Orders: keep all printings and contracts in DropBox with instant availability from Odoo
-
Picking operations: save warehouse docs to DropBox.
How synchronization works
Direct Sync
-
Direct synchronization is based on the scheduled job 'Synchronize attachments with cloud'
-
Direct sync make all synced Odoo attachments change their type to a link (URL), while binary content is removed with a next Odoo cleaner. So, no actual files would be stored on your Odoo server
-
Direct sync checks whether attachments are added or deleted for synced documents. If so, they would be created or removed in DropBox
-
Direct sync checks whether a new document type (e.g. sale orders) is added / renamed / replaced in the to-sync-models configurations. If so, this should be reflected in DropBox
-
Direct sync checks whether a new document (e.g. quotation SO-001) related to a synced document type is generated / updated / unlinked. If so, the connector would make the same changes in DropBox
-
The final goal of direct DropBox integration is to have the structure 'Odoo / Document Types / Documents / Files. For example, 'Odoo / Quotations / SO019 / commercial offer.pdf'
Backward Sync
-
Backward synchronization is based on the scheduled job 'Synchronize attachments from cloud'
-
Backward sync checks whether any items are added to a DropBox document folder. If so, the app would create URL attachments for that items in a linked Odoo object
-
Backward sync checks whether any items are deleted / moved in a cloud document folder. If so, a linked Odoo attachment would be also unlinked or moved
-
Backward sync checks whether any item is renamed in DropBox. If so, a chained Odoo attachment should be also renamed
-
In DropBox folders you can put not only files but also child folders. In that case a link for this folder (not its content) would be kept in Odoo attachments
-
If you deleted a folder related to this document type or this document, their child files would be deleted as well. Thus, Odoo would remove related attachments. The folders, however, will be recovered with a next direct sync
DropBox URLs
-
DropBox has a specific way to generate links for existing files and folders. In particular, there are no concepts of internal or private URLs. Instead, each DropBox item might get so-called shared URLs. Such shared links are either public or team-only. Moreover, the latter feature is available only for DropBox business account
-
This tool relies upon share links' mechanics. It means, that each attachment link is either public (all personal DropBox accounts) or team-only (all business DropBox accounts)
-
Sometimes it is considered to be not fully safe. Although website URLs will be hardly known by external users, there is a slight chance that they become available as a result of some user actions. Besides, sharing links generation is not super fast and might make a sync process slower. That is why the feature to switch off sharing urls is introduced
-
If checked, all DropBox urls in Odoo will be of type https://www.dropbox.com/home/Odoo/[PATH]. Such links will not work in quite a many cases. Thus, if you need to open DropBox files / folders from Odoo, be careful with the setting 'No links to DropBox from Odoo'
Misc notes
-
The connector works on a queue (first in - first out) principle: it tries to firstly reflect the oldest changes
-
Each sync, especially the very first one, might take quite a long. It is not recommended to make sync too frequent: once an hour seems reasonable frequency
-
File names and content should be managed in DropBox: each backward sync would recover DropBox names, Odoo is here less important
-
Try to avoid the following symbols in folders' and files' names: *, ?, ", ', :, <, >, /, +, %, !, @, \, /,. Direct sync will replace such symbols with '-'. It is done to avoid conflicts with file systems.
Odoo Enterprise Documents
-
The special add-on 'Cloud Sync for Enterprise documents' is introduced to synchronize DropBox with the Odoo app 'Documents' (the latter is distributed under the Odoo Enterprise license)
-
Based on that add-on the Odoo documents' hierarchy would be reflected within the folder 'Odoo / Odoo Docs'
-
Each Odoo folder would have a linked DropBox folder. Take into account that folders created in the cloud storage will be synced as Odoo attachments. The key principle is: folders are managed by Odoo, files are managed by the cloud client
-
All files are synced with the same logic as usual attachments. Files created in Odoo will be added to the cloud storage and will be replaced with links in Odoo. Files created in cloud storage will generate URL attachments within a paired documents directory
-
Standard DropBox sync and integration with Enterprise Documents are done within the same jobs. Avoid the scenarios when a single file is synced as a simple Odoo attachment and as an Odoo document simultaneously
-
Odoo spread sheet files are not synced by the connector: so, they are still manageable in Odoo
-
Please do not name synced models as 'Odoo Docs'. This is the reserved name for Odoo Enterprise Documents.
Советы по настройке и установке для DropBox Odoo Integration Odoo v.14
Python dependency
The tool depends on external libraries 'dropbox'. Install this library for your Odoo server through the command:
pip3 install dropboxConfiguration and log in
- Follow the url https://www.dropbox.com/developers/apps/create
- Choose an API as 'Scoped access'
- Choose the type of access as 'Full Dropbox'
- Select any suitable name for the app and push the button 'Create app'
- Add the redirect URI as [YOURODOOSITENAME]/dropbox_token (e.g. https://faotools.com/dropbox_token). A valid SSL certificate (https) is required
- Grant permissions to the app: 'Account Info (Read)', 'Files and folders Metadata (Write)', 'Files Content (Write)', 'Collaboration (Write)'. For team DropBox assign also 'Team Data Members', 'Members (Read)'. Make sure no other permissions are assigned.
- Submit App
- Go to Odoo general settings - DropBox
- Copy App Key, App secret, and redirect URI to the Odoo configuration page
-
For team DropBoxes only
- Check the box 'DropBox Team'
- Set an email of DropBox user. Inside this user folder all Odoo related items would be created and only after that they are shared to all other users. Under this user all files and folders are created, changed, moved, and deleted
- Choose a suitable name for the root Odoo folder, e.g. 'Odoo' or 'ERP'
- Press Save
- Press 'Login and Confirm'
Create a DropBox app
Set up DropBox App: redirection URL
DropBox permissions for personal accounts
DropBox permissions for business accounts
Set up Odoo for DropBox integration
Odoo server configuration and cron job configuration
To make sure the synchronization works correctly apply proper timeouts to the Odoo configuration file: LIMIT_TIME_CPU, LIMIT_TIME_REAL, LIMIT_TIME_REAL_CRON should be more than 900 seconds.
For Odoo.sh this should not be done, since timeouts are predefined and are not configurable.
Then, timeout should be entered to your Odoo. To that goal find the section 'Settings' on the app configuration page and copy the number there.
Afterwards, it is needed to make the cron jobs suit the applied timeouts. In the debug mode go to the Settings > Technical > Automation > Scheduled Jobs:
- Set up the job 'Synchronize attachments with cloud' as (a) frequency - 2*timeout; (b) the next execution as the next hour +timeout. For example, for 900seconds timeout: frequency - as 30minutes; the next execution - at 08:15
- Set up the job 'Synchronize attachments from cloud' as (a) frequency - 2*timeout; (b) the next execution as the next hour + timeout*2. For example, for 900seconds timeout: frequency - as 30minutes; the next execution- at 08:30.
Reconnection
Reconnection might be required for the case a refresh token is expired and when you migrate the app from previous versions. In such a case:
- Press the button 'Reconnect'
- Press the button 'Login and confirm'
Часто задаваемые вопросы о DropBox Odoo Integration Odoo v.14
Можно ли изменить частоту заданий синхронизации?
Yes, you can. To this end:
Turn on debug mode
Go to technical settings > Automation > Scheduled jobs
Find the jobs 'Synchronize attachments with cloud' and 'Update attachments from cloud'.
Take into account that you should not make them too frequent. It is preferable this job is finished until a new one is started. Thus, the configuration should depend on how many items you to sync you have. Usually, the frequency is set up between 15 minutes to 4 hours.
Make also sure that you have set up enough time limits in your Odoo configuration file. Thus, LIMIT_TIME_CPU and LIMIT_TIME_REAL parameters should be equal or bigger than planned cron job time. Starting from the version 13 consider also the parameter LIMIT_TIME_REAL_CRON.
An import notice for Odoo.sh clients: the maximum time for cron job might be set up as 15 minutes only.
Можно ли настроить другую структуру синхронизируемых каталогов, не ту, что задаёт синхронизация?
Нет, эта возможность есть только с версии 15. До неё модуль работает с заранее заданной структурой папок:
Odoo — корневая папка синхронизации
Модели — папки для каждого типа документов Odoo. Например, «Projects», «Partners». По домену могут быть более узкие папки: «Customer 1 Projects», «Projects of the Customer 2», «Internal Projects» и т. д.
Объекты — папки для каждого документа, например «Project 1» или «Customer 1»
Файлы и папки, связанные с этим документом Odoo и подлежащие синхронизации.
В итоге может получиться, например:
Odoo / Projects / Project 1 / файлы и папки проекта 1
Odoo / Customer 1 Projects / Project 1; Odoo / Customer 2 Projects / Project 3, ...
Odoo / Customers / Customer 1 / файлы и папки клиента 1
Структура всегда плоская: только эти уровни иерархии. Разные типы документов нельзя держать в одной ветке. В папке «Customer 1» нельзя хранить файлы и заказов, и счетов, и проектов. У каждого типа документа своя папка (или несколько). Иначе обратная синхронизация будет невозможна: не на что опереться.
Нужно ли настраивать отдельные права пользователей в Odoo?
Нет, инструмент работает через одну пользовательскую конечную точку. Все процессы синхронизации идут от имени одного облачного администратора (приложения). Права на созданные папки и файлы не назначаются автоматически. Настройте их в своём облачном хранилище.
Где хранятся синхронизированные файлы? Дублируются ли они в Odoo и в облаках?
Приложение предполагает, что двоичное содержимое вложений хранится в Cloud Client, а не на сервере Odoo. Такие вложения в Odoo становятся типа URL, и к ним можно в любой момент обратиться из блока вложений или из Cloud Client.
После настройки ручные действия не нужны: синхронизация полностью автоматическая. Решите, какие типы документов Odoo синхронизировать, и настройте связанную модель для каждого из них (клиенты, заказы на продажу или закупку, задачи, проекты и т. д.).
Можно ли создать несколько папок для одного типа документов? Например, внутренние проекты и клиентские проекты?
Да, можно. Для этого подготовьте правило для каждой папки и задайте фильтры: например, по типу проекта.
Сделайте фильтры взаимоисключающими, чтобы документ однозначно попадал в одну папку. Например: «клиент, но не поставщик», «поставщик, но не клиент». Иначе папка документа будет перескакивать с одной модели на другую.
Достаточно ли только приложения Cloud Storage Solution?
Нет, инструмент — только техническое ядро. Нужен ещё коннектор вашего облачного клиента.
Нормально ли, если нужно синхронизировать много объектов, например 10000?
Да, хотя при большом числе папок и вложений процесс может быть медленным. При этом клиенты сообщали о средах с >10 тыс. партнёров и ~5 тыс. вариантов продуктов — процессы оставались приемлемыми.
Несколько важных моментов:
- Синхронизация устроена так, что любой элемент будет синхронизирован и не потеряется, хотя это может быть небыстро. Это гарантируют очереди FIFO и фиксация каждого задания.
- Число объектов можно ограничить логически. Настройка моделей позволяет не синхронизировать устаревшие записи (например, нет смысла синхронизировать архивных партнёров или заказы двухлетней давности).
Можно ли сделать синхронизацию в реальном времени?
Нет. Есть веские причины не делать синхронизацию в реальном времени:
Производительность. При синхронизации в реальном времени каждая загрузка файла приводит к экрану ожидания.
Конфликты. Если двое одновременно меняют элемент, ситуация может стать неразрешимой. При регулярных заданиях это можно исправить позже; в реальном времени пришлось бы ставить изменения в очередь, что ещё сильнее запутает пользователей.
Функциональность. В частности, переименование и перестройка элементов. Обратная синхронизация строго опирается на логику каталогов, и при каждом запуске проверяется 100% элементов. Если делать это после каждого обновления, будут тысячи запросов в секунду. Если нет — изменения потеряются.
Можно ли изменить имена папок по умолчанию в облаках?
Вы можете задать своё имя каталогам моделей (заказы на продажу, возможности, поставщики и т. д.) для любого типа документа.
Для папок объектов (SO-001, John Smith и т. д.) инструмент использует метод Odoo для отображаемого имени этого типа документа. Это можно изменить выражением имени. Используется тот же синтаксис, что и в шаблонах писем Odoo.
Можно ли синхронизировать вложения с несколькими облачными клиентами
No, this feature becomes available only from version 15.
Мы используем специальный редактор в облаках (например OnlyOffice, Office 365 и т. д.). Будут ли файлы открываться в этом редакторе?
Да, в зависимости от конфигурации облачного клиента.
Какова политика обновлений ваших инструментов?
По текущим правилам Odoo Apps Store:
- Модуль, купленный для версии 12.0 и ниже, даёт доступ ко всем версиям до 12.0 включительно.
- С версии 13.0 каждую версию модуля нужно покупать отдельно.
- Независимо от версии покупка даёт право на все обновления и исправления в рамках этой мажорной версии.
Команда faOtools эти правила не задаёт. Вопросы направляйте напрямую представителям Odoo Apps Store.
Как установить приложение на Odoo.sh?
Самый прямой способ - встроенный сценарий магазина Odoo:
1. Откройте страницу модуля и нажмите Deploy on odoo.sh
2. Вас перенаправит на GitHub. Войдите в аккаунт и нажмите Create a new repo или выберите существующий. Репозиторий должен быть закрытым: публиковать приложения по лицензии OPL-1 нельзя. При необходимости создайте новый репозиторий для проекта Odoo.sh
3. Затем в odoo.sh нажмите Deploy, подтвердите решение и нажмите Continue. Так запустится установка.
Эти шаги ставят приложение на production-ветку проекта. Для других веток или обновления модуля:
1. Скачайте исходный код из магазина Odoo
2. Закоммитьте модуль в нужный репозиторий GitHub. Ни одна папка или файл приложения не должны попасть в .gitignore. Репозитории, которые создаёт odoo.sh, по умолчанию могут игнорировать важные пути (например /lib). Загрузите все каталоги и файлы модуля без исключений
3. Разверните целевую ветку проекта odoo.sh или дождитесь автоматической сборки, если так настроено.
Как установить приложение на свой сервер?
2. Перезапустите сервер Odoo;
3. Включите режим разработчика (технические настройки);
4. Обновите список приложений (меню приложений);
5. Найдите приложение и нажмите Activate/Install;
6. Следуйте рекомендациям на странице приложения, если они есть.
У приложения есть дополнительные модули. Можно купить их позже?
Да. При этом Odoo сам кладёт все зависимости в корзину: исключите уже купленные инструменты, чтобы не заплатить дважды.
Я развернул приложение на Odoo.sh и вижу предупреждение или ошибку в тестах
Odoo Красное или оранжевое предупреждение не влияет на функции приложения. Иногда наши модули не проходят стандартные автотесты, потому что те ждут поведение, которое противоречит целям приложения. Например, мы меняем расчёт цены, а тесты ядра сравнивают итог со стандартным алгоритмом.
Сначала проверьте саму развёрнутую базу: всё ли работает?
Если всё же считаете, что предупреждение ломает функции, напишите нам и пришлите полные логи установки и полный список установленных модулей (ядро и сторонние).
Можно ли купить приложение напрямую у вас?
Нет, мы распространяем инструменты только через официальный магазин приложений Odoo.
Я хочу получить скидку
К сожалению, у нас нет технической возможности давать индивидуальные цены.
Можно ли поставить приложение на базу Odoo Online (SaaS)?
Нет, сторонние приложения нельзя использовать на Odoo Online. Odoo SaaS это блокирует.
У инструмента есть зависимости. Нужно ли их покупать?
Да, для корректной работы нужны все модули из зависимостей. Цена на странице приложения уже включает необходимые зависимости.
Какова цена модуля в долларах США? Почему она меняется?
Цены на наши модули заданы в евро. Магазин Odoo пересчитывает их в другие валюты по своему внутреннему курсу. Поэтому цена в долларах США может меняться при обновлении курса.
Тексты приложения и веб-сайта на языках, отличных от английского, переведены с помощью ИИ и согласованы с официальными переводами Odoo. Если вы заметили ошибку, отправьте тикет о переводе и мы исправим его.
Отправка отчетов об ошибках
Если вы столкнулись с ошибками или непоследовательным поведением, не стесняйтесь обращаться к нам. Мы гарантируем предоставление исправлений в течение 60 дней с момента покупки и очень заинтересованы в улучшении наших инструментов даже по истечении этого периода.
Чтобы связаться с нами, вам не нужен номер телефона или кредитная карта. Вам нужно всего лишь пройти короткую регистрацию по электронной почте, которая займет не более 30 секунд.
Укажите в запросе как можно больше сведений: снимки экрана, журналы сервера Odoo, полное описание воспроизведения проблемы и так далее. Обычно подготовка рабочего плана по проблеме (если ошибка подтверждена) или рекомендаций по необходимым действиям (в противном случае) занимает несколько рабочих дней.
Запросы на публичные функции и идеи модулей (бесплатная разработка)
Мы очень заинтересованы в улучшении наших инструментов и будем благодарны за любые отзывы. Если ваши требования общедоступны и могут быть эффективно реализованы, команда включит их в наш список дел.
Такой список дел обрабатывается регулярно и не предполагает дополнительных комиссий. Хотя мы не можем обещать сроки и окончательный дизайн, это может быть хорошим способом получить желаемые функции без вложений и рисков.
Чтобы связаться с нами, вам не нужен номер телефона или кредитная карта. Вам нужно всего лишь пройти короткую регистрацию по электронной почте, которая займет не более 30 секунд.
Инструмент, чтобы безопасно хранить пароли в Odoo для совместной работы. Общие хранилища
198€
Инструмент, чтобы задавать цели KPI и контролировать выполнение по периодам. Дашборды KPI. Конструктор. Графики
198€
Инструмент, чтобы строить глубокую базу знаний для своих и внешних. Knowledge System. KMS. Правки как в вики
398€
Инструмент для услуг по записи: от бронирования до продаж и отзывов
Инструмент, чтобы управлять Odoo из любимых AI-чатов через MCP. Claude. Любой AI с MCP.
198€
Инструмент, чтобы раскладывать вложения Odoo по папкам и синхронизировать каталоги с Google Drive, OneDrive/SharePoint, Nextcloud/ownCloud, Dropbox, Amazon S3, Box и NAS. Файловый менеджер. DMS
Инструмент для двусторонней синхронизации вложений Odoo с OneDrive
Инструмент для двусторонней синхронизации вложений Odoo с Google Drive
Инструмент для двусторонней синхронизации вложений Odoo с ownCloud/Nextcloud