Attivazione e configurazione¶
Capitolo per il partner Odoo
Questa pagina è scritta per chi amministra l'istanza Odoo dell'organizzazione. Se non è il tuo caso, ti basta sapere che l'attivazione la fa il vostro partner Odoo con il supporto di AppToMe: torna a Cosa si sincronizza.
Il connettore è un modulo Odoo che si installa nell'istanza del cliente. Non è un servizio ospitato da AppToMe: gira dentro Odoo, sotto il controllo di chi amministra Odoo.
Prerequisiti¶
- Odoo 18, Community o Enterprise, anche vanilla.
- I moduli standard di cui il connettore ha bisogno vengono installati come dipendenze: contatti, risorse umane e presenze, fogli ore, flotta, progetti, prodotti e autenticazione OAuth.
- Odoo dev'essere raggiungibile da internet in HTTPS, con il reverse proxy configurato correttamente per l'inoltro degli header di protocollo e host — altrimenti l'accesso con account AppToMe non funziona.
- L'organizzazione dev'essere abilitata alla sincronizzazione lato AppToMe.
Il connettore non richiede moduli specifici per la localizzazione italiana: restano una scelta del cliente, da installare separatamente se servono per gli adempimenti fiscali.
Le cinque fasi¶
1. Installare il modulo¶
Il modulo si ottiene dal repository pubblico di AppToMe e si colloca fra gli addon dell'istanza. Dopo il riavvio del server, dalla sezione App si aggiorna l'elenco, si cerca Apptome Connector e si installa.
2. Chiedere le credenziali¶
Le credenziali di collegamento sono specifiche dell'organizzazione e le rilascia l'assistenza AppToMe. Comprendono gli indirizzi dei servizi AppToMe e le chiavi per l'accesso e per la sincronizzazione.
Trattale come password
Le credenziali valgono per l'intera organizzazione. Non vanno inserite in ticket, chat o repository, e in Odoo l'accesso ai parametri di sistema va limitato ai soli amministratori. Se sospetti che siano state esposte, chiedi subito la rotazione all'assistenza.
3. Configurare il connettore¶
Da Impostazioni → Impostazioni generali → Apptome si compilano gli indirizzi e le chiavi ricevute, si attiva l'accesso con account AppToMe e si attiva la sincronizzazione dei dati. Al salvataggio il connettore aggiorna da solo il provider di accesso e le azioni pianificate.
Se una stessa istanza Odoo serve più organizzazioni, la configurazione della sincronizzazione è per azienda: ogni azienda Odoo ha i suoi indirizzi e le sue chiavi, che devono essere diverse fra loro.
4. Primo allineamento¶
È la fase che richiede attenzione, e l'unica in cui serve qualcuno dell'organizzazione: solo chi conosce le persone sa dire se due schede simili sono la stessa persona.
Anagrafiche — da Impostazioni → Apptome → Bootstrap da Apptome il modulo scarica i volontari e li confronta con i contatti già presenti in Odoo, usando codice fiscale, email e nome completo. Per ogni riga si sceglie:
| Scelta | Quando usarla |
|---|---|
| Collega a partner esistente | la persona è già in Odoo — è il caso più frequente |
| Crea nuovo partner | la persona non esiste ancora in Odoo |
| Salta | la riga va rivista prima di decidere |
Poi si conferma. Le righe saltate si possono riprendere in un secondo passaggio.
Tutto il resto — da Apptome → Sincronizza da Apptome → Sincronizzazione completa si avvia il caricamento di competenze, calendari, mezzi, brevetti, corsi, turni, attività, checklist e ore. Il caricamento rispetta l'ordine di dipendenza fra i dati, quindi va lanciato dopo l'allineamento delle anagrafiche: le ore hanno bisogno delle persone già collegate.
Su un'organizzazione con anni di storico il caricamento completo può durare a lungo: mettilo in un momento di basso utilizzo.
5. Verificare¶
Controlli rapidi che dicono se l'attivazione è riuscita:
- Contatti → Volontari Apptome elenca i volontari, senza doppioni;
- la pagina di accesso di Odoo mostra il pulsante Accedi con Apptome (si vede da disconnessi);
- Apptome → Formazione → Brevetti acquisiti mostra i brevetti con le scadenze;
- l'azione pianificata Apptome — Sincronizza contatti (orario) è attiva;
- certificando le ore di un turno in AppToMe, entro pochi minuti compare la presenza corrispondente in Odoo.
L'ultimo controllo è quello che conta: se funziona, funziona la catena intera.
Abilitare l'accesso con account AppToMe¶
Il connettore non crea utenti Odoo da solo, ed è una scelta voluta: un gestionale non deve riempirsi di utenti perché qualcuno ha premuto un pulsante.
I volontari sincronizzati diventano contatti, non utenti che possono entrare in Odoo. Chi deve accedere al gestionale va abilitato uno per uno, collegando il suo utente Odoo all'account AppToMe. Di norma riguarda poche persone: staff e amministrazione.
Un account non collegato che prova ad accedere riceve un messaggio di invito scaduto. Non è un guasto: è il rifiuto corretto di un accesso non previsto.
Aggiornamenti¶
Il connettore e AppToMe evolvono insieme. Dopo un aggiornamento importante dell'uno conviene aggiornare anche l'altro: alcuni errori di sincronizzazione nascono da versioni disallineate fra i due lati.
Manutenzione ordinaria¶
- Tieni attiva l'azione pianificata che rimanda le anagrafiche verso AppToMe.
- Controlla ogni tanto la diagnostica: è lì che si vede se qualcosa si è fermato.
- Dopo una fermata prolungata di Odoo, rilancia la sincronizzazione completa (o quella della singola voce interessata) per recuperare quello che è passato nel frattempo.