OwnCloud / NextCloud Odoo Integration v.13

• Projects: have an own NextCloud / OwnCloud folder for each customer project.
• Customers: add all partner files in a single directory available both from Odoo and from NextCloud / OwnCloud. 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 NextCloud / OwnCloud alternatively.
• Opportunities: carefully store all specifications, requirements, any files which would let you make a good offer.
• Orders: keep all printings and contracts in NextCloud / OwnCloud with simple availability from Odoo.

Based on the scheduled job 'Synchronize attachments with cloud' Odoo regularly checks whether:

• Any new attachment should be forwarded to NextCloud / OwnCloud;
• Any new document type (e.g. Sale orders) is added / replaced / renamed as a sync model and, hence, whether a directory should be created / removed / renamed in NextCloud / OwnCloud;
• Any new document (e.g. Sale Order SO019) is generated / updated / unlinked and, hence, whether a NextCloud / OwnCloud folder should be created / moved or renamed / deleted.
• Any new attachment should be removed from NextCloud / OwnCloud if it has been deleted from Odoo.

Based on results of that checks, Odoo starts processing queue of changes, and makes sure that all items are located correctly. The final goal is to have the structure 'Odoo / Document Types / Documents / Files. For example, 'Odoo / Quotations / SO019 / commercial offer.pdf'.

During the synchronization 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.

Please take into account:

• 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 should be managed in NextCloud / OwnCloud: each backward sync would recover NextCloud / OwnCloud names, Odoo is here less important.

Based on the scheduled job 'Synchronize attachments from cloud' Odoo regularly checks whether:

• Any file is added / moved / removed in a NextCloud / OwnCloud document folder. If yes, Odoo would create a link to this file in a target object (e.g. a new attachment to SO019) or would move / delete such an attachment.
• Any file of a NextCloud / OwnCloud document folder is renamed. If yes, an attachment would be renamed in Odoo as well.

• In document 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.
• Each backward sync might take quite a long. It is not recommended to make sync too frequent: once an hour seems safe enough.

By default all links from Odoo to OwnCloud / NextCloud are internal. It means that only authorized users may access them and, after that, generate shared URLs for others.

It is possible to make them public using the option 'Use Public URLs'. In that case links will become 'shared', meaning that everybody may access those files by links. Although the links would 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 fast and might make the synchronization slower. Thus, be cautious if you decide to use shared links.

This tool is not in conflict with the 'documents' module provided under the Enterprise license. Attachments related to Enterprise folders would be synced as any other files: according to a document they relate to.

It is not always comfortable, and you might be interested in reflecting directories' structure introduced by the module 'Documents'. To this end the special extension is developed. This extension introduces the following features:

• The documents hierarchy is reflected within the folder 'Odoo / Odoo Docs'
• Each Odoo folder has a linked cloud 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 attachments within a paired directory
• Please do not name synced models as 'Odoo Docs'. This is the reserved name for Odoo Enterprise Documents

• Do not add folders inside root or document types' folders. If they have the same name as newly synced folders, the latter would not be uploaded
• Make sure your database has a proper SSL certificate which is required to use OwnCloud API
• 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.