OwnCloud / NextCloud Odoo Integration v.10
The tool to automatically synchronize Odoo attachments with OwnCloud / NextCloud files in both ways
Synchronization is bilateral. All Odoo attachments are put in OwnCloud / NextCloud regularly. OwnCloud / NextCloud files create attachments in Odoo in case they are placed in a correct folder. Look at the sections From Odoo to OwnCloud / NextCloud and From OwnCloud / NextCloud to Odoo
Integration is automatic in both ways. Based on scheduled jobs, Odoo send attachments to OwnCloud / NextCloud and retrieve files from there
Any Odoo document might be synced: customers, opportunities, sale or purchase orders, tasks or issues, employees or users, etc. You decide by your own which records should be in OwnCloud / NextCloud, and which should be left in Odoo
Synchronization equally works for OwnCloud and NextCloud
All synced files are easily accessible though clicking on an attachment. You might also open a whole document folder by clicking on 'Open folder' on the attachment widget
All 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 access history through the button 'Sync logs'
The tool is compatible with Odoo reporting and mailing apps. If such an app faces a synced file, it retrieves a real content from OwnCloud / NextCloud. In particular, the reports 'always reload' feature and messages & mass mailing attachments work properly
Integration is based on a single user endpoint. It means that a single user login/password of OwnCloud / NextCloud is used. Afterwards for integrations Odoo would use that credentials disregarding an actual Odoo user. Make sure, however, that real Odoo users have an access to OwnCloud / NextCloud to open URLs linked to their attachments
- Prepare and keep updated folders' structure in OwnCloud / NextCloud
- Upload new attachments to a correct folder
Odoo creates a convenient directory structure in OwnCloud / NextCloud: Odoo / Document type name / Document name / Files, where:
- Odoo is a central directory for Odoo Sync in your cloud storage.
- Document type is a synced Odoo model, for example, 'Sale orders', 'Opportunities', 'Customers'
- You select document types by yourself. It might be any document type
- Moreover, you might have a few folders for a single document type. Use Odoo domains to have not global 'Partners, but 'Customers' and 'Suppliers', not just 'Sale orders' but 'Commercial offers', 'To deliver', and 'Done orders'
- With each sync Odoo would try to update document types' folders. Add a new document type at any moment. It will appear in OwnCloud / NextCloud with a next sync
- You are welcome to introduce or change document types folder names at any moment in Odoo. Take into account: renaming in OwnCloud / NextCloud will be recovered to Odoo names
- If you remove a model from integration, it will not be deleted from OwnCloud / NextCloud to keep already synced files safe. However, new documents of this type would not be synced
- In case you removed a directory in OwnCloud / NextCloud, but it is still configured in Odoo, with a next sync a folder structure is going to be recovered (not files, surely).
- Document is an exact object to sync. For instance, 'Agrolait' or 'SO019'
- Documents are synced in case they relate to a synced document type and satisfy its filters. For example, you are not obliged to sync all partners, you may integrate only 'Customers' and 'Vendors' or only 'Companies', not 'Contacts'
- Odoo would generate a folder in OwnCloud / NextCloud for each suitable document even for documents without attachments. It is needed for a backward sync to easily add new files
- OwnCloud / NextCloud folder name equals a real document name. It relies upon Odoo name_get method. Thus, Odoo 'Michael Fletcher' (a contact of 'Agrolait') would be OwnCloud / NextCloud 'Agrolait, Michael Fletcher'
- If an exact document changes its document type (e.g. a quotation is now confirmed), Odoo will automatically relocate its related folder to a proper parent directory (in the example: from 'Commercial offers' to 'To deliver')
- In case a document relates to a few types (for instance, you have 'Vendors' and 'Customers', while Agrolait is both), this document folder would be put into the most prioritized document type. A document type priority is higher as closer to the top in Odoo interfaces it is
- If an Odoo document is removed, the next sync will remove a corresponding OwnCloud / NextCloud directory
- In case you remove a directory in OwnCloud / NextCloud, but it still exists in Odoo, OwnCloud / NextCloud folder structure would be recovered (while files would be unlinked in both Odoo and OwnCloud / NextCloud)
- Folders renaming in OwnCloud / NextCloud will be replaced with Odoo names, Odoo document names are more important
- Files are real files taken from Odoo attachments
The resulted path would be, for example, 'Odoo / Quotations / SO019 / commercial offer.png'.
The only exclusion of the rule are stand alone attachments which do not relate to any Odoo documents (their document type is 'ir.attachment'). Such attachments' path is 'Odoo / Stand Alone Attachments / image.png'.
The direct sync might take quite a long, since a lot of folders should be created. It is not recommended to make sync too frequent: once an hour or two hours is fine.
FilesWith each direct sync, Odoo tries to find not yet synced attachments. If such attachments suit any document type to sync, a file will be uploaded to OwnCloud / NextCloud to a proper folder. In Odoo such attachments will become of 'url' type. It means that a file is not any more kept in Odoo server space, but now it is in OwnCloud / NextCloud. Until sync is done, Odoo attachment remains binary and stores an actual file. Such approach helps Odoo to work faster.
If you unlinked an attachment from Odoo, it would be deleted in OwnCloud / NextCloud as well.
Take into account that file names should be managed in OwnCloud / NextCloud: each backward sync would recover OwnCloud / NextCloud names, Odoo is here less important.
- If a new file is added to a proper document folder (e.g. to 'Odoo / Customers / Agrolait'), the same attachment will be added to Odoo document (in the example - to 'Agrolait')
- In document folders you can put not only files but also child folders. In that case a link for this folder (not its content) is kept in attachments
- In case you rename a file in OwnCloud / NextCloud, it will be renamed in Odoo as well
- Files' removal from OwnCloud / NextCloud leads to related Odoo attachments' removal
- If you move a file to another document folder, in Odoo a related attachment would be re-attached to this new document. Take into account: if you move a file for a not document folder, in Odoo attachment will be deleted as it has been removed from OwnCloud / NextCloud
- If you deleted a document type or document folder, their child files are deleted as well. Thus, Odoo would remove related attachments. The folders, however, will be recovered with a next direct sync. Folders' move to another directory is also considered as a removal. Avoid such situations by following the simple rule: folders are managed mostly by Odoo, files - mostly by OwnCloud / NextCloud.
Backward OwnCloud / NextCloud might take quite much time, since each folder should be checked (the more folders, the more time the backward sync requires). It is recommended to make frequency oftener than once an hour or two hours.
- 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 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.
Log in
- Enter your cloud storage full url
- Select an OwnCloud / NextCloud, which has full rights to read, create, write and delete files and folders within a root directory
- Enter login and password of this user
- Introduce the title for OwnCloud / NextCloud folder, e.g. Odoo
- Push the button 'Login and Confirm'
- If everything is fine, push the button 'Sync'
- Make sure that the root directory or its children are shared with your colleagues
Enter OwnCloud / NextCloud credentials
Confirmed credentials to start sync
Migration from the versions prior to the version 1.3.0
- Push the button 'Backward sync' (to make sure recent OwnCloud / NextCloud changes are synced)
- Push the button 'Migrate from the version under 3.0'
- Check / update synced models
- Push the button 'Sync' to apply changes
Domande frequenti su OwnCloud / NextCloud Odoo Integration Odoo v.10
Posso modificare la frequenza dei job di sincronizzazione?
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.
Posso configurare una struttura delle directory sincronizzate diversa da quella prevista dalla sincronizzazione?
No, questa funzione esiste solo dalla versione 15. Prima il modulo usa una struttura di cartelle predefinita:
Odoo - cartella radice della sync
Modelli - cartelle per ogni tipo di documento Odoo. Ad esempio «Projects», «Partners». Per dominio possono esserci cartelle più specifiche: «Customer 1 Projects», «Projects of the Customer 2», «Internal Projects», ecc.
Oggetti - cartelle per ogni documento, es. «Project 1» o «Customer 1»
File e cartelle di questo documento Odoo da sincronizzare.
Potete così avere ad esempio:
Odoo / Projects / Project 1 / file e cartelle del progetto 1
Odoo / Customer 1 Projects / Project 1; Odoo / Customer 2 Projects / Project 3, ...
Odoo / Customers / Customer 1 / file e cartelle del cliente 1
La struttura è sempre piatta: solo questi livelli. Tipi di documento diversi non stanno nello stesso ramo. Nella cartella «Customer 1» non si tengono insieme ordini, fatture e progetti. Ogni tipo ha la/e propria/e cartella/e. Altrimenti la sync inversa non avrebbe un criterio.
Devo impostare accessi utente specifici in Odoo?
No, lo strumento usa un unico endpoint utente. Tutti i processi di sync avvengono sotto un solo admin cloud (app). I diritti delle cartelle / file creati non sono automatizzati. Gestiteli nella vostra soluzione di storage cloud.
Dove vengono salvati i file sincronizzati? Sono duplicati in Odoo e nei cloud?
L'app presuppone che il contenuto binario degli allegati sia conservato nel Cloud Client e non sul server Odoo. Tali allegati in Odoo diventano di tipo URL e potete accedervi in qualsiasi momento dalla casella allegati o dal Cloud Client.
Dopo la configurazione non servono azioni manuali: la sincronizzazione è completamente automatica. Decidete quali tipi di documento Odoo sincronizzare e impostate un modello correlato per ciascuno (clienti, ordini di vendita o acquisto, attività, progetti, ecc.).
Posso avere più cartelle per lo stesso tipo di documento? Ad esempio, progetti interni e progetti cliente?
Sì, è possibile. Preparate una regola per ciascuna e applicate dei filtri: ad esempio per tipo di progetto.
Rendete i filtri mutuamente esclusivi così un documento viene assegnato in modo certo. Ad esempio: «cliente ma non fornitore», «fornitore ma non cliente». Altrimenti la cartella del documento passerebbe da un modello all'altro.
Mi basta solo l'app Cloud Storage Solution?
No, lo strumento è solo un nucleo tecnico. Serve anche il connettore del vostro client cloud.
Va bene se ho molti oggetti da sincronizzare, ad esempio 10000?
Sì, anche se con molte cartelle/allegati il processo può essere lento. I clienti hanno comunque segnalato ambienti con >10k partner e ~5k varianti prodotto, e i processi erano accettabili.
Alcuni punti:
- La sync è costruita perché ogni elemento venga sincronizzato e non perso, anche se non è veloce. Code FIFO e il commit di ogni job lo garantiscono.
- Il numero di oggetti può essere limitato logicamente. La configurazione dei modelli consente di escludere elementi obsoleti (es. partner archiviati o ordini di 2 anni fa).
È possibile rendere la sincronizzazione in tempo reale?
No. Abbiamo ragioni solide per evitare la sincronizzazione in tempo reale:
Prestazioni. Se la sync è in tempo reale, ogni caricamento file mostra la schermata di attesa.
Conflitti. Se 2 utenti modificano un elemento insieme, la situazione può restare irrisolta. Con job regolari si può correggere dopo; in tempo reale servirebbe una coda, ancora più fuorviante.
Funzionalità. In particolare rinomina e ristrutturazione. La sync inversa si basa strettamente sulla logica delle directory e a ogni sync controlla il 100 % degli elementi. Dopo ogni aggiornamento sarebbero migliaia di richieste al secondo. Altrimenti le modifiche andrebbero perse.
Posso sincronizzare gli allegati con più client cloud
No, this feature becomes available only from version 15.
Usiamo un editor speciale nei nostri cloud (ad es. OnlyOffice, Office 365, ecc.). I file si aprirebbero in quell'editor?
Sì, in base alla configurazione del client cloud.
Posso aggiornare i tag OwnCloud con il connettore?
No, i tag non sono sincronizzati. Avevamo considerato questa funzione, ma abbiamo deciso di non introdurla per diversi motivi:
La libreria del connettore non supporta la lettura o l'aggiornamento dei tag OwnCloud
Gli allegati Odoo non hanno l'attributo «tags» e non è chiaro quando tali tag verrebbero assegnati agli utenti.
Poiché l'app offre sync bilaterale, potrebbero nascere conflitti critici difficili da risolvere.
Quali sono le politiche di aggiornamento dei vostri strumenti?
Secondo le politiche attuali dell'Odoo Apps Store:
- Ogni modulo acquistato per la versione 12.0 o precedente da accesso a tutte le versioni fino alla 12.0.
- Dalla versione 13.0 ogni versione del modulo va acquistata separatamente.
- Indipendentemente dalla versione, l'acquisto da diritto a tutti gli aggiornamenti e le correzioni entro una major version.
Il team faOtools non controlla queste politiche. Per qualsiasi domanda, contattate direttamente i rappresentanti dell'Odoo Apps Store.
Come installo l'app su Odoo.sh?
L'approccio piu diretto e il flusso integrato dello store Odoo:
1. Apri la pagina del modulo e fai clic su Deploy on odoo.sh
2. Verrai reindirizzato a GitHub. Accedi e fai clic su Create a new repo o usa uno esistente. Il repository deve essere privato. Non e consentito pubblicare le app con licenza OPL-1. Se serve, crea un nuovo repo per il progetto Odoo.sh
3. Poi, in odoo.sh, fai clic su Deploy, conferma e fai clic su Continue. Parte l'installazione.
Questi passaggi installano l'app sul branch di produzione. Per altri branch o per aggiornare:
1. Scarica il codice sorgente dallo store Odoo
2. Esegui il commit del modulo nel repository GitHub. Nessuna cartella/file dell'app deve essere in .gitignore. I repo creati da odoo.sh a volte ignorano percorsi importanti (es. /lib). Carica tutte le directory e i file del modulo
3. Esegui il deploy del branch di destinazione del progetto odoo.sh oppure attendi la build automatica se previsto.
Come installo l'app sul mio server?
2. Riavvia il server Odoo;
3. Attiva la modalita sviluppatore (impostazioni tecniche);
4. Aggiorna l'elenco delle app (menu Applicazioni);
5. Trova l'app e premi Activate/Install;
6. Segui le linee guida nella pagina dell'app, se ci sono.
L'app ha componenti extra. Posso acquistarli dopo?
Si. Odoo aggiunge automaticamente le dipendenze al carrello: escludi gli strumenti gia acquistati per non pagare due volte.
Ho distribuito l'app su Odoo.sh e vedo un avviso/errore nei test
Un avviso rosso/arancione non influisce sulle funzioni dell'app. A volte i nostri moduli non superano i test automatici standard perche questi assumono un comportamento in conflitto con gli obiettivi dell'app. Ad esempio cambiamo il calcolo del prezzo, mentre i test Odoo confrontano il prezzo finale con l'algoritmo standard.
Controllate prima le funzioni del database distribuito. Funziona tutto?
Se pensate ancora che l'avviso influisca sulle funzioni reali, contattateci e inviate i log di installazione completi e l'elenco completo dei moduli distribuiti (core e di terze parti).
Posso acquistare l'app direttamente da voi?
No, distribuiamo gli strumenti solo tramite lo store ufficiale delle app Odoo.
Vorrei uno sconto
Purtroppo non abbiamo i mezzi tecnici per prezzi individuali.
Posso installare l'app sul database Odoo Online (SaaS)?
No, le app di terze parti non si possono usare su Odoo Online. Odoo SaaS blocca questa possibilita.
Lo strumento dipende da altre app. Devo acquistarle?
Si, lo strumento richiede tutti i moduli indicati nelle dipendenze. Il prezzo sulla pagina dell'app le include gia.
Qual e il prezzo del modulo in dollari USA? Perche e cambiato?
Il prezzo dei nostri moduli e in euro. Lo store Odoo converte le valute secondo il proprio tasso interno. Quindi il prezzo in dollari USA puo cambiare quando il tasso viene aggiornato.
I testi dell'app e del sito web in lingue diverse dall'inglese sono realizzati con l'assistenza dell'IA e allineati alle traduzioni ufficiali di Odoo. Se noti un errore, invia un ticket di traduzione e lo correggeremo.
Segnalazione degli errori
Se riscontri bug o comportamenti incoerenti, non esitare a contattarci. Garantiamo di fornire soluzioni entro 60 giorni dall'acquisto e siamo fortemente interessati a migliorare i nostri strumenti anche dopo questo periodo.
Non hai bisogno di un numero di telefono o di una carta di credito per contattarci. Dovresti solo effettuare una breve registrazione via e-mail, che non richiede più di 30 secondi.
Includi nella richiesta il maggior numero possibile di dettagli: schermate, registri del server Odoo, una descrizione completa di come riprodurre il problema e cosi via. In genere sono necessari alcuni giorni lavorativi per preparare un piano operativo relativo a un problema (se viene confermato un bug) o fornire indicazioni su cosa fare (in caso contrario).
Richieste di funzionalità pubbliche e idee per moduli (sviluppo gratuito)
Siamo fortemente motivati a migliorare i nostri strumenti e saremmo grati per qualsiasi feedback. Se le tue esigenze sono di uso pubblico e possono essere implementate in modo efficiente, il team le includerà nella nostra lista di cose da fare.
Tale elenco di cose da fare viene elaborato regolarmente e non prevede costi aggiuntivi. Sebbene non possiamo garantire scadenze e progettazione finale, potrebbe essere un buon modo per ottenere le funzionalità desiderate senza investimenti e rischi.
Non hai bisogno di un numero di telefono o di una carta di credito per contattarci. Dovresti solo effettuare una breve registrazione via e-mail, che non richiede più di 30 secondi.
Lo strumento per conservare le password in Odoo in modo sicuro e condiviso. Vault
198€
Lo strumento per impostare target KPI e controllarne il raggiungimento per periodo. Dashboard. Grafici
198€
Lo strumento per una knowledge base strutturata, interna ed esterna. KMS. Revisioni tipo wiki
398€
Lo strumento per servizi su appuntamento, dalla prenotazione a vendite e recensioni
Lo strumento per gestire Odoo dalle chat IA tramite MCP. Claude. Qualsiasi IA con MCP.
198€
Lo strumento per strutturare gli allegati Odoo in cartelle e sincronizzare con Google Drive, OneDrive/SharePoint, Nextcloud/ownCloud, Dropbox, Amazon S3, Box e NAS. Gestione file. DMS
Lo strumento per sincronizzare gli allegati Odoo con OneDrive in entrambi i sensi
Lo strumento per sincronizzare gli allegati Odoo con Google Drive in entrambi i sensi
Lo strumento per sincronizzare gli allegati Odoo con DropBox in entrambi i sensi