OneDrive / SharePoint Odoo Integration v.8
The tool to automatically synchronize Odoo attachments with OneDrive files in both ways
Synchronization is bilateral. All Odoo attachments are put in OneDrive regularly. OneDrive files create attachments in Odoo in case they are placed in a correct folder
Integration is automatic. Based on scheduled jobs Odoo would send attachments to OneDrive and retrieve files from there
Synchronization works for SharePoint sites, OneDrive for business, and personal OneDrive. In the first case the files are kept in preselected documents library, in the latter two - in a user' documents library
Odoo attachments, which are put in OneDrive, receive the URL type. It means that a file is not any more kept in Odoo server space, but now it is in OneDrive. Until sync is done, Odoo attachment remains binary and stores actual file
When you click on a synced attachment, Odoo automatically redirects you to a file previewer. Among others it might be Word or Excel editor (if Office365 is set up)
OneDrive files synced from Odoo has the structure to provide the backward sync: Odoo / Model / Object / files (e.g 'Odoo / Quotation / SO019 7 / commercial offer.png').
If you add a file to an Object folder (e.g. inside 'SO019 7'), that file will create an attachment in Odoo (e.g. for the sales order SO019) with a link to real file in OneDrive. You can put in object folders not only files but also child folders. In that case in attachments a link for this folder is kept (not its content)
You can rename/move folders or files in OneDrive without a harm for Odoo attachments. The only thing you should not do is to delete folders
If an attachment is removed from Odoo, a related OneDrive file will be deleted as well. Files removal from OneDrive leads to related Odoo attachments unlink
Synchronization is based on a single user endpoint. It means that you should login in OneDrive only once. Afterwards for integrations Odoo would use that credentials disregarding an actual Odoo user. Make sure, however, that real Odoo users have an access to OneDrive to open URLs linked to their attachments
Contents
- Preliminary steps
- SharePoint sites
- Personal Onedrive and Onedrive for business
- Reconnection (also in case of migration from this app's versions under 1.2.0)
- Scheduled jobs
SharePoint sites
- Go to your Azure Portal and prepare a new application:
- Grant the app full permissions for Office365 SharePoint online
- Assign the reply url as [YOURODOOSITENAME]/one_drive_token (e.g. https://odootools.com/one_drive_token)
- Generate a new key. Keep it safely somewhere for the future use
- Go to your SharePoint site and prepare a new documents' library (drive). You might use one of the existing ones, e.g. 'Documents'. Odoo folder would be put there afterwards, and it would be impossible to move it for another library
- Go to the OneDrive configuration menu:
- Copy 'Application ID' to 'App client_id'
- Put a previously generated key to the field 'App secret key'
- Enter the 'Redirect URL' as you entered 'Reply url' in Azure Portal
- Check the boxes 'OneDrive for business' and 'Use sharepoint sites'
- The SharePoint URL should be of the type https://[URL]/. The last '/' is required, sitename should not be included into. For example, https://odootools.sharepoint.com/
- SharePoint site should be either my_site_name (in that case it is considered as sites/my_site_name) or sites/my_site_name (instead of 'sites' it might be 'teams' and so on). There should be no '/' at the beginning or at the end. For example, sites/odootools
- As Documents Library use one created in SharePoint
- Press 'Save'
- Press 'Login and Confirm'. Odoo redirects you to Microsoft login page. Check in and grant permissions asked.
- After login, Microsoft redirects you back to Odoo. OneDrive - Odoo synchronization is ready to be done.
Create application in your Azure Portal
App's permissions
App's permissions
Redirect url should be https://[yourodoosite]/one_drive_token
Generate a secret key
Create a new SharePoint Documents Library
Create a new SharePoint Documents Library
Enter configuration keys in Odoo
Odoo attachments are ready for sync with Onedrive files. Press 'Sync to Onedrive' for the files upload
Personal OneDrive and OneDrive for business
- Go to https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade
- Click 'New registration'
- Introduce a new name for the application and assign the redirect URI as [YOURODOOSITENAME]/one_drive_token (e.g. https://odootools.com/one_drive_token)
- Copy the Application Client ID to the Odoo field 'App client_id'
- Go to Certificates & secrets > Click 'New Client Secret'. Copy the secret value to the Odoo field 'App Secret Key'
- Press Save on the Odoo configuration Page
- Press 'Login and Confirm'. Odoo redirects you to Microsoft login page. Check in and grant permissions asked
- After login, Microsoft redirects you back to Odoo. OneDrive - Odoo synchronization is ready to be done.
Create OneDrive application
New OneDrive Web platform and redirect url
Generate new secret for your application
Enter configuration keys in Odoo
Reconnection
- You use this tool with version prior to 1.2.0. In that case you should also install the library 'microsoftgraph'. Look above
- You have not used the sync tool for more than 6 months
- Press the button 'Reconnect'
- Press the button 'Login and confirm'
Scheduled jobs
- Turn on debug mode
- Go to technical settings > Automation > Scheduled jobs
- Find the jobs 'Synchronize attachments with cloud' and 'Synchronize attachments from OneDrive'
Domande frequenti su OneDrive / SharePoint Odoo Integration Odoo v.8
Compare un errore quando clicco sul link cloud dell'immagine sincronizzata
L'errore «This item might have been deleted, expired, or you might not have permission to access it. Contact the owner of this item for more information.» indica che non avete effettuato l'accesso al servizio photos.onedrive.com.
Posso modificare la frequenza dei job di sincronizzazione?
Sì, è possibile. Per farlo:
Attivate la modalità debug
Andate in impostazioni tecniche > Automazione > Azioni pianificate
Trovate i job «Synchronize attachments with cloud» e «Update attachments from cloud».
Non renderli troppo frequenti. È preferibile che un job finisca prima che ne parta un altro. La configurazione dipende da quanti elementi dovete sincronizzare. Di solito la frequenza è tra 15 minuti e 4 ore.
Impostate anche limiti di tempo sufficienti nel file di configurazione Odoo. LIMIT_TIME_CPU e LIMIT_TIME_REAL devono essere uguali o maggiori del tempo cron previsto. Dalla versione 13 considerate anche LIMIT_TIME_REAL_CRON.
Nota importante per i clienti Odoo.sh: il tempo massimo di un job cron può essere limitato a 15 minuti.
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, questa funzione è disponibile solo dalla versione 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.
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 Google Drive in entrambi i sensi
Lo strumento per sincronizzare gli allegati Odoo con ownCloud/Nextcloud in entrambi i sensi
Lo strumento per sincronizzare gli allegati Odoo con DropBox in entrambi i sensi