Visualizza wikitesto di Odoo

{{TOC|align=right}}
<div align="justify">
[[Immagine:Odoo Logo.png|left|300px]] <br><br><br><br> <br><br><br>
== Cos'è Odoo? ==
(la pronuncia corretta del nome è "oduu")<br>
Dal sito https://www.odoo.com/ l'applicativo viene descritto come un: <blockquote>''All-in-one management software''</blockquote>

OpenERP, ora Odoo, nacque nel 2005 ad opera di Fabien Pinckaers con il nome [http://freecode.com/projects/tinyerp| TinyERP] e con il proposito di rivoluzionare il mondo del software per le imprese. Dal maggio del 2014 ha cambiato nome in Odoo.<br>
Odoo (già OpenERP) ora deve definitivamente considerarsi una suite di prodotti software attivamente supportato da una community internazionale e da una italiana ai fini della localizzazione.<br>
Il software è open source ed è rilasciato secondo i termini della [https://it.wikipedia.org/wiki/GNU_Lesser_General_Public_License| GNU Lesser General Public License].<br>
Riguardo Odoo sono stati scritti diversi libri, alcuni dedicati ad aree funzionali specifiche come la contabilità, altri all'ambiente di sviluppo.<br>
(Rif. [https://it.wikipedia.org/wiki/Odoo Wikipedia] )

L'obiettivo che desideriamo raggiungere forse vi sembrerà ambizioso, ma sono le sfide difficili quelle più belle da vincere!
<br>

== Come funziona? ==
Inserisci una sola volta il dato nel database del gestionale e lo utilizzerai per tutte le tue necessità gestionali.
<br>

== A che cosa serve? ==
A raggruppare le informazioni, uniformare le interfacce, migliorare l'efficienza. Il tutto, aprendo le porte all'open source.
<br>

== A chi serve? ==
A chiunque desideri mettere ordine e avere il controllo completo dei dati, in qualsiasi attività, aumentando così l'efficienza e semplificando i processi.
<br>

== Da dove proviene? ==
* Viene sviluppato da Odoo S.A. in Brussels. https://www.odoo.com/page/about-us
* Anche la Odoo Comunity Association (OCA) ha un ruolo fondamentale nello sviluppo e promozione del programma. https://odoo-community.org/
* Sul sito della Associazione Odoo Italia c'è un forum attivo sull'argomento. https://www.odoo-italia.org/index.php/kunena/home
* Esiste anche un gruppo d'imprese italiane che lavorano allo sviluppo e alla localizzazione di Odoo, con i quali abbiamo il piacere di essere in contatto. http://openerpitalia.net/
<br>

== Un po' di storia ==
OpenERP, ora Odoo, nacque nel 2005 ad opera di Fabien Pinckaers con il nome TinyERP e con il proposito di rivoluzionare il mondo del software per le imprese. Nel maggio del 2014 ha cambiato nome in Odoo.
<br>

Odoo (già OpenERP) ora deve definitivamente considerarsi una suite di prodotti software attivamente supportata da una community internazionale e da una italiana ai fini della localizzazione.

Il software è open source ed è rilasciato secondo i termini della GNU Lesser General Public License.

Riguardo Odoo sono stati scritti diversi libri,[1] alcuni dedicati ad aree funzionali specifiche come la contabilità,[2] altri all'ambiente di sviluppo.

Fonte: https://it.wikipedia.org/wiki/Odoo
<br><br>

== Perché ci piace Odoo? ==
* perché è un software open-source
* perché è stato scritto quasi totalmente in Python / JavaScript / XML
* perché utilizza database PostgreSQL
* perché c'è una comunità di sviluppo e assistenza
* perché è web-based
* perché posso ottimizzarlo e svilupparci ciò di cui ho bisogno
* perché è semplice e intuitivo
* perché ha un obiettivo ambizioso
<br>

== Da migliorare ==
* il supporto verso la localizzazione contabile italiana è insufficiente o comunque disomogeneo, ma ci sono degli add-on che risolvono il problema
* il flusso documentale del ciclo attivo e passivo è semplificato ma insufficiente per la realtà amministrativa italiana; il supporto ai DDT e alle evasioni parziali è ancora carente.
<br>

== Lista dei desideri ==
Odoo è in continuo e rapido sviluppo. Esistono centinaia di moduli sviluppati dalla comunità e dalla casa madre
liberamente utilizzabili, quindi a volte le cose che non riusciamo a trovare forse sono disponibili facendo
le ricerche giuste. Però ci sono cose che proprio sembrano assenti. <br>
Ad esempio, la '''Gestione documentale intrinseca'''.

Sarebbe bene che ci fosse un sistema di documentazione integrato che per ogni elemento 
della interfaccia utente fornisse la guida contestuale, ad esempio ogni form dovrebbe 
avere un pulsante di "help", la documentazione dei campi dovrebbe essere inserita 
direttamente a livello di "plugin" in modo che se si scriverà un plugin che espande una
certa form, anche la documentazione verrà aggiornata di conseguenza.

A questo punto non sarebbe impossibile produrre automaticamente un manuale in PDF
personalizzato per ogni installazione, semplicemente leggendo e seguendo i moduli già installati.

Resta aperto il problema della traduzione dei messaggi. Forse si potrebbe attivare
nel "plugin" una cartella separata per ogni lingua, dove i contributori potrebbero
fornire al produttore le versioni localizzate nella lingua desiderata.
<br><br>

== Posso provare Odoo subito? ==
'''Sì, certamente.'''<br><br>
Puoi:

* utilizzare, successivamente alla registrazione dell'utente di prova, la versione DEMO presente nel portale di Odoo: https://www.odoo.com/trial

* ''oppure'', utilizzare la nostra versione ''community'', già on-line (ancora in via di sperimentazione e senza alcuna garanzia di stabilità giornaliera)<br><br>

Per poter accedere (come utente base) sul nostro gestionale [http://odoo.pnlug.it odoo.pnlug.it] sono prima necessarie due operazioni:
# l'iscrizione alla nostra Associazione, con la successiva collaborazione con il gruppo di lavoro Odoo;
# attendere che il responsabile del gruppo di lavoro ti fornisca l'account di accesso personale; 
<br>
'''Nota''': se sei un docente e vuoi utilizzare Odoo per le tue attività didattiche, (creando e condividendo dei corsi...) potrebbe interessarti l'[https://www.odoo.com/page/education-program education program] di Odoo.
<br><br>

== Quali modalità d'utilizzo sono previste? ==
* versione locale, COMMUNITY (free)
* versione locale, FREE PLAN (gratuito per una applicazione, ma con < 50 utenti)
* ON LINE (25,00 € al mese per un numero complessivo < di 50 utenti + il costo delle App richieste. Contratto con '''Hosting incluso''')
* ENTERPRISE (25,00 € al mese per utente, ma con un numero > di 50 utenti; include tutte le App. Contratto con '''Hosting NON incluso''')
<br><br>

== Documentazione ==
* Nel sito internazionale di Odoo trovate tutta la documentazione on-line su i tutorial, le configurazioni, i servizi web API, i riferimenti e le note per la ver. 10, sia per gli [https://www.odoo.com/documentation/user/10.0/index.html utenti] che per gli [https://www.odoo.com/documentation/10.0/index.html sviluppatori]
* Forum ufficiale: [https://www.odoo.com/forum/help-1 https://www.odoo.com/forum/]
* Video dal sito ufficiale: [https://www.odoo.com/page/tour https://www.odoo.com/page/tour]
* Sviluppo: [https://media.readthedocs.org/pdf/odoo-development/latest/odoo-development.pdf  odoo-development.pdf]
* Recensioni e comparazioni delle diverse App: [https://www.odoo.com/page/odoo-white-paper  odoo-white-paper] 
* Per conoscere tutte le opzioni di avvio di Odoo da riga di comando, da terminale digitate:  '''odoo --help'''

** In [http://www.odoo.com/documentation/10.0/reference/cmdline.html questa pagina della documentazione ufficiale] di Odoo, trovate le descrizioni delle diverse opzioni di avvio da server, tramite l'utilizzo della linea di comando.
<br><br>

== Licenze d'uso del codice utilizzato ==
Software Libero non vuol dire assenza di regole: raccomandazione fondamentale se è la prima volta che vi avvicinate ad un progetto aperto.

Software Libero non vuol dire assenza di regole, tutti i software citati vengono rilasciati con una licenza che accettate di rispettare nel momento stesso in cui usate il software.

'''Odoo''', ad esempio, viene rilasciato con la licenza d'uso [https://www.gnu.org/licenses/lgpl-3.0.en.html GNU Lesser General Public License (LGPL) v3.0], mentre '''PostgreSQL''' con la [https://www.postgresql.org/about/licence/ PostgreSQL Licence].

L'editor collaborativo interno '''Etherpad''' viene invece rilasciato con la licenza d'uso di [http://www.apache.org/licenses/LICENSE-2.0 Apache v2.0]. 

Ricordiamo le licenze di distribuzione dei principali sistemi operativi open source utilizzati da noi in versione server e client: [https://www.ubuntu.com/about/about-ubuntu/licensing '''Ubuntu'''] e [https://www.debian.org/legal/licenses/ '''Debian''']. 

Nulla di preoccupante, il software libero se ne avete le competenze è realmente utilizzabile gratuitamente anche per fini commerciali, ma ricordatevi di controllare ad esempio se la licenza d’uso vi chiede di rilasciare gratuitamente il codice che modificate.

Esistono poi una serie di regole non scritte che vi permetteranno di essere accettati e benvoluti dalla comunità.

Ricordate che il rispetto e l’ammirazione di una comunità open source nel lungo periodo porta più vantaggi che una politica di egoismo di breve periodo.
<br><br>

== Traduzione ==
La traduzione in lingua italiana (localizzazione) originaria che viene caricata su Odoo v.10 è ancora un pò carente. Questo problema è comunque risolvibile, attraverso diversi metodi, che tratteremo nei nostri Talk associativi.<br>

La localizzazione delle versioni 9 e 10 sono ancora da completare, in quanto attualmente la versione di riferimento completa risulta ancora essere la 8.<br>
Per iniziare a tradurre in modo corretto, consigliamo di leggere e seguire quanto indicato nelle ''Linee guida e strumenti per una buona traduzione'', che trovate descritte nei seguenti siti:
* http://tp.linux.it/
* http://wiki.ubuntu-it.org/GruppoTraduzione/Strumenti
... da leggere con molta attenzione :)<br>

Per collaborare alla traduzione in lingua italiana della piattaforma Odoo (per le varie versioni mantenute), è necessario iscriversi al servizio di localizzazione sul [https://www.transifex.com/odoo/odoo-10/ sito Transifex] e seguire quanto indicato nell'[https://docs.transifex.com/getting-started/translators area tecnica] interna e nel relativo [https://docs.transifex.com/translation/using-the-glossary glossario].<br>

Dall'interno della propria installazione di Odoo, è sempre possibile tradurre '''localmente''' la maggior parte dei termini utilizzati nelle varie maschere di gestione e presenti nelle pagine web pubbliche della propria installazione.  
<br><br>

== Installazione di Odoo ver. 10 ==
Installazione del gestionale su PC con S.O. '''Ubuntu 16.04 LTS''' seguendo le informazioni presenti nelle nostre slide di presentazione:
# [http://odoo.pnlug.it/slides/slide/odoo-installazione-da-interfaccia-grafica-12 Installazione da interfaccia grafica]
# [http://odoo.pnlug.it/slides/slide/odoo-installazione-da-riga-di-terminale-10 Installazione da riga di comando] 

=== Installazione semplificata con pacchetto .deb ===
La procedura viene descritta in [http://wiki.pnlug.it/index.php?title=Odoo_Installazione_pacchetto_deb questa pagina] del wiki.  '''NON INDICATA PER LO SVILUPPO'''
<br><br>

=== Installazione da file sorgenti con Git usata per le lezioni ===
La procedura viene descritta in [http://wiki.pnlug.it/index.php?title=Odoo_devinst questa pagina] del wiki.
<br><br>

=== Installazione da file sorgenti con Git ===
La procedura viene descritta in [http://wiki.pnlug.it/index.php?title=Odoo_Installazione_da_file_sorgenti questa pagina] del wiki. '''INDICATA PER LO SVILUPPO DI NUOVO CODICE'''
<br><br>

=== Installazione "rapida" da Git come sviluppatore ===
La procedura viene descritta in [http://wiki.pnlug.it/index.php?title=Odoo_Installazione_da_Git_come_sviluppatore questa pagina] del wiki, ma '''non è la configurazione utilizzata per i nostri corsi'''.
<br><br>

=== Installazione su Windows con file installer ===
*Scaricate l'installer Windows dalla [https://www.odoo.com/page/download pagina di Download del sito di Odoo] (versione Community e/o Enterprise).
*Avviate il file scaricato<br>

'''Attenzione''': con Windows 8, potete vedere visualizzato un messaggio di avviso che indica ''"Windows sta proteggendo il tuo PC"''. Selezionate ''More Info'' per continuare ed eseguire ugualmente il file<br>

*Accettare le regole del prompt UAC
*Avanzare attraverso tutti gli step di installazione, fino alla fine; Odoo verrà avviato automaticamente al termine dell'installazione
<br>
'''Configurazione'''<br>
Il file di configurazione è posizionato in ''%PROGRAMFILES%\Odoo 10.0-id\server\odoo.conf''<br>
Il file di configurazione DEVE essere editato per connettere Odoo a Postgresql, per indicare la posizione dei diversi file e configurare il dbfilter.<br>
Per ricaricare il file di configurazione, riavviare il servizio Odoo attraverso il menu '''Servizi > odoo server''' del sistema operativo.<br>

<br><br>

=== Creazione di istanze multiple di Odoo su un unico server ===
Con Odoo è possibile attivare diverse istanze separate ed isolate tra loro, condividendo gli stessi sorgenti e lo stesso motore di database;<br> per riuscire a realizzare questo, trovate tutte le istruzioni e i comandi da terminale [[Odoo_Installazione_multipla_unico_server|in questa nostra pagina]].
<br>
Se invece desiderate installare '''due istanze diverse utilizzando anche due versioni diverse di Odoo''' su un singolo server, seguite le semplici informazioni descritte in [https://www.rosehosting.com/blog/install-multiple-odoo-instances-on-a-single-machine/ questo post su www.rosehosting.com].
<br><br>

=== Uso dell' Interfaccia di Programmazione delle Applicazioni (API) ===
Odoo si estende normalmente tramite l'uso dei moduli, ma molte delle sue applicazioni e tutti i suoi dati possono anche essere disponibili esternamente, per effettuare delle analisi esterne o per essere integrati con altri programmi o applicazioni diverse.<br> Diversi modelli di riferimento API sono facilmente disponibili in formato XML-RPC e resi accessibili in diversi linguaggi.<br> Per ulteriori informazioni, consultate [http://www.odoo.com/documentation/10.0/api_integration.html  la pagina della documentazione di Odoo per sviluppatori].
<br><br>

=== Variabili di avvio da CLI ===
Utilizzo della Command-Line Interface (Terminale) per la configurazione e la scelta delle variabili di avvio da ''odoo-bin''. <br>
In [http://www.odoo.com/documentation/10.0/reference/cmdline.html questa pagina] trovate descritte tutte le variabili utilizzabili per personalizzare uno sript di avvio dell'applicazione Odoo.
<br><br>

== Installazione e configurazione del server Etherpad per Odoo  ==
Il gestionale Odoo permette l'utilizzo condiviso di documenti di testo interni tra i vari utenti, attraverso l'uso di un server [http://etherpad.org/ Etherpad].<br> '''L'installazione del server Etherpad non è compresa nel pacchetto di installazione di Odoo''', ma deve essere effettuata successivamente, per poi collegarlo al gestionale Odoo desiderato.<br>
Per far questo, il nostro gruppo di lavoro ha seguito le istruzioni presenti nella pagina [http://www.emiprotechnologies.com/technical_notes/odoo-technical-notes-59/post/install-configure-and-setting-up-etherpad-server-for-odoo-253 di questo sito esterno].   <br>
Per controllare il funzionamento del server Etherpad, una volta terminata l'installazione, aprire un browser e digitare il seguente URL:
 http://localhost:9001
<br>

== Installazione e configurazione dell'applicazione Git  ==

Per installare Odoo da file sorgenti, avremo la necessità di utilizzare ''git''. L'installazione su ''Ubuntu 16.04 LTS'' è molto semplice e veloce.<br>
L'installazione avviene in modo rapido e veloce, utilizzando il terminale, digitando:

<pre>
sudo apt-get update
sudo apt-get install git
</pre>

L'applicazione è ora installata sul vostro sistema.  Per conoscere i suoi comandi, è possibile digitare ''man git'' in un terminale. 
<br><br>

== Installazione e configurazione di PyCharm-community per Odoo  ==
PyCharm è un ''Integrated Development Environment'' che permette di sviluppare in modo molto agevole in python. Permette la gestione di progetti ed è integrato con i principali tool di versioning (chi ha detto Git?).

Ciò che ci ha colpito principalmente di PyCharm è la velocità con cui permette l'editing del testo. Pur basandosi su una JVM non soffre dei fastidiosissimi lag della GUI di cui possono "vantarsi" altri IDE (come Eclipse e soprattutto NetBeans).<br>
Permette di effettuare i debug delle applicazioni in modo molto comodo fornendo uno snapshot dell'applicazione al breakpoint corrente e includendo tutte le informazioni delle applixazioni che della VM python. Utilizzandolo un pò più spesso, si è anche potuto apprezzare il supporto al linguaggio C e HTML ed XML in generale.

Sul [http://www.jetbrains.com/pycharm/ sito ufficiale] il software viene rilasciato in due versioni: 
# la versione '''Community edition''', che è completamente gratuita e che ha funzioni minime per la programmazione in python;
# la versione '''Professional''', che ha un supporto esteso anche ad altri framework e ad altri linguaggi (usandola come versione di prova, '''ha durata 30 giorni''').

Per il nostro utilizzo iniziale la versione ''Community edition'' soddisfa appieno le nostre esigenze e la consigliamo a tutti coloro che desiderano sviluppare in Python ma non hanno ancora trovato lo strumento che fa al caso loro.<br>

Seguendo quanto descritto [http://ubuntuhandbook.org/index.php/2016/07/latest-pycharm-ubuntu-16-04-ppa/ questo veloce tutorial per principianti], potremo installare su '''Ubuntu 16.04 LTS''' l'ultima versione di PyCharm Python IDE, semplicemente aggiungendo un repository supplementare via PPA.<br>


==== Configurazione e debug di Odoo con PyCharm-community  ====

In [http://wiki.pnlug.it/index.php?title=Odoo_PyCharm_install_debug questa pagina] del nostro wiki, trovate un breve tutorial da seguire per creare e configurare un progetto Odoo con PyCharm.<br><br>

'''Nota''':<br>
Python è un linguaggio dinamico che permette di modificare gli oggetti a runtime. Odoo utilizza questa potenzialità per attivare un particolare sistema
non standard di ereditarietà degli oggetti. Questo limita un po' le grandi potenzialità di PyCharm in fatto di auto completamento in fase di scrittura
del codice, ma è un problema con cui si può e si deve convivere.
<br><br>

== Le ''App'' ==

Odoo ha una struttura modulare, basata su delle ''app'' che si trovano già installate e pronte all'uso, alle quali se ne possono aggiungere altre (reperite in rete o sviluppate autonomamente).

=== Le ''App'' già pronte ===
In questa pagina descriviamo quali sono le [[Odoo_bestapp|App pronte all'uso già presenti nella versione 10]], che andremo ad utilizzare successivamente.
<br>

=== Le migliori ''App'' da aggiungere ===
In questa pagina descriviamo quali sono le [[Odoo_addapp|migliori App che consigliamo di aggiungere / installare]] successivamente all'installazione di base della versione 10.<br>

=== Sviluppo di applicazioni sul nostro Repo Github ===
Il nostro gruppo di lavoro ha iniziato a sviluppare del codice per rendere più fruibile l'uso di Odoo ver. 10 .<br>
Se desiderate collaborare con noi, visitate il [https://github.com/PNLUG/ nostro Repository presente sul sito di Github], associatevi al PN LUG e unitevi al nostro gruppo di lavoro Odoo per sviluppare assieme del codice nuovo.<br>
<br>
Se desiderate installare e utilizzare Git su un PC con Sistema Operativo Linux Ubuntu 14.04 LTS, seguite quanto trovate descritto in [https://www.howtoforge.com/tutorial/install-git-and-github-on-ubuntu-14.04/ questo sito]. <br><br>

== Alcuni utili suggerimenti per chi inizia ==
# ''' Documentazione ufficiale:''' [https://www.odoo.com/documentation/10.0/ Sito di Odoo.com]
# ''' Video tutorial di base:''' [https://www.youtube.com/playlist?list=PLy4zAn8b-FF0oiv_LGBXhKsDno1JXxGJb YouTube - Odoo (Open ERP) Basics Video Tutorials ]
## Questi video fanno parte di un video corso di base di 7 ore e 30 min., realizzato su Odoo versione 8. Questi video servono per avere un'idea iniziale su come funzioni un ERP Odoo su un sistema e possa servire per educare successivamente altre persone al suo utilizzo. È possibile trovare in rete e su YouTube altri filmati che riguardano altri tipi di installazioni e uso condiviso con altri sistemi informatici aziendali.
<br><br>

== Informazioni per gli sviluppatori ==
# '''Repository italiano ufficiale:''' https://github.com/OCA/l10n-italy
# '''QWeb reports:''' http://www.odoo.yenthevg.com/category/odoo-8/reports/
# '''ERPpeek or XML-RPC:''' http://www.odoo.yenthevg.com/creating-and-managing-databases-with-erppeek-or-xml-rpc/
# '''Immagini free a volontà: ''' https://pixabay.com/it/
# '''Esempio di configurazione per l'uso dinamico dei dati tra Odoo e Power BI(non open source):''' http://www.odoo.yenthevg.com/
# '''canale IRC Italia''':  #odoo-it su freenode
# '''canale IRC OCA''': #oca su freenode

<br>

== Il browser web consigliato ==
Abbiamo testato in modo approfondito e verificato che la piattaforma Odoo può funzionare correttamente con la maggior parte dei browser più comunemente utilizzati; noi comunque suggeriamo di utilizzare:
* Su sistemi operativi per client PC desktop: [https://www.chromium.org/Home '''chromium''']
* Con i dispositivi mobili:  [https://www.google.it/chrome/browser/desktop/ ''' chrome''']
<br>

== La VM Virtualbox a Vs disposizione ==
Per coloro che partecipano alle nostre serate informative viene data a disposizione una macchina virtuale con Odoo 10 installato con tutte le applicazioni necessarie per iniziare a sviluppare. Chiunque lo desideri può fare una copia del contenuto della chiavetta, chiedendo ai responsabili presenti in sede del PNLUG.<br>

L’installazione effettuata dai sorgenti di Odoo non è rigida e può variare per molti dettagli che spesso sono equivalenti; quindi se si trovano altri sorgenti da altre fonti diverse anche le configurazioni possono essere diverse e non è detto che siano migliori o peggiori, sono semplicemente diverse.<br>
Nel nostro caso, l’installazione proposta nel libro di riferimento è leggermente diversa da quella utilizzata da noi.<br>

La macchina virtuale che viene fornita ha le seguenti caratteristiche:

Piattaforma: VirtuaBox<br>
Sistema Operativo: Ubuntu Mate 16.04<br>
Dimensione disco della VM: 32GB<br>
Memoria RAM: 1GB<br>
Memoria video: 12MB<br>
Rete: Scheda con bridge<br>
Dimensione file vdi: 8,7GB circa

Scarica il [http://wiki.pnlug.it/images/OdooVirtualBoxdeveloper.pdf Documento descrittivo della VM]

<br>

== Chi siamo? ==
Noi abbiamo formato un gruppo di lavoro interno, formato da soci dell'Associazione PNLUG, tutti appassionati di tecnologia e di applicazioni Open Source.<br>

<big> E TU cosa aspetti? Entra anche te a fare parte del gruppo Odoo-PNLUG! </big><br>
Se ti abbiamo incuriosito almeno un poco, non essere timido e vieni a trovarci in Sede il martedì sera.<br>
Ti stiamo aspettando!
</div>