ServerSync Google Calendar:guida alla migrazione Vediamo passo a passo la procedura da seguire per migrare dalla vecchia sincronizzazione ServerSync con Google Calendar alla nuova versione (quella che implementa le Google Calendar API v3 disponibile dalla versione 3.6.19 di Easylex Web Edition). 1) Per prima cosa bisogna effettuare un backup del Google Calendar esistente. Per fare questo aprire il proprio calendario Google in un browser, e cliccare su impostazioni (l'ingranaggio in alto a destra) e successivamente la voce Impostazioni : Nella schermata che si apre, cliccare sull'etichetta Calendari, sotto la voce Impostazioni Calendario :
Da questa schermata dove appare la lista dei calendari cliccare sulla voce Esporta Calendari :
Apparirà una finestra che chiederà di salvare il file zip contenente tutti i calendari.
Dopo avere salvato il file, se si estrae il contenuto del file zip si può notare che sono presenti sia i singoli calendari in formato.ics sia un file con estensione.ics contenente tutti i calendari in blocco. A questo punto bisogna andare a creare un calendario di Backup nel nostro Google Calendar. Per fare ciò dalla lista calendari cliccare sul pulsante Crea nuovo calendario. Creiamo ad esempio un calendario che chiamiamo Backup_10022015. A questo punto dobbiamo importare in Backup_10022015 il file.ics dei calendari che abbiamo esportato in precedenza. Per fare questo, sempre dalla lista dei Calendari che vediamo nella schermata sopra clicchiamo sulla voce Importa Calendario
Si apre una finestra dove alla voce File dovremo selezionare il file.ics che rappresenta tutti i calendari dell'account, e alla voce Calendario dovremo indicare Backup_10022015. Completato l'import apparirà questa finestra dove viene riportato il numero degli eventi inseriti:
Una volta completato l'import del backup possiamo vedere la copia degli eventi esistenti nel Google Calendar, come si vede nell'immagine:
A questo punto possiamo, facoltativamente, procedere ad eliminare tutti gli eventi dal calendario che è stato utilizzato in passato per la sincronizzazione. Attenzione: L'operazione è facoltativa perchè l'operazione di inizializzazione agenda con cancellazione degli eventi preesitenti, operazione con cui riprenderà la nostra sincronizzazione serversync, prevede già come prima operazione la cancellazione degli eventi preesistenti sul calendario, ma nel caso siano presenti molti eventi nel calendario effettuare una cancellazione manuale prima del riavvio della sincronizzazione iniziale può velocizzare di molto le operazioni. Ovviamente se per sincronizzare l'agenda si è utilizzato il calendario di default (sempre il primo tra I miei calendari nella schermata) bisognerà eliminare gli eventi da quel calendario, mentre se si è utilizzato un altro calendario, ad esempio un calendario chiamato Easylex diverso dal calendario di default bisognerà provvedere ad eliminare gli eventi da quello e non da quello di default. Per eliminare gli eventi da un calendario, selezionare il calendario facendo doppio clic sul nome nella lista dei calendari, poi nella schermata che si apre cliccare su Elimina tutti gli eventi di questo calendario nella parte bassa dello schermo.
Nella finestra che si apre, confermare la volontà di eliminare tutti gli eventi mettendo la spunta su Si voglio decisamente eliminare tutti gli eventi del mio calendario e poi cliccare sul pulsante Elimina tutti gli eventi
Se il calendario contiene un numero elevato di eventi, l'operazione potrebbe anche impiegare alcuni minuti. Per verificare la conclusione dell'operazione visualizzare l'interfaccia del calendario Google. 2) Prima di procedere vediamo un veloce ripasso di alcuni concetti base: I primi passi: inizializzazione dell'agenda La sincronizzazione ServerSync è una sincronizzazione bidirezionale, ovvero durante un ciclo standard di sincronizzazione l'inserimento e l'aggiornamento degli eventi avviene dal gestionale verso il calendar/mail server e viceversa. Quando si avvia la sincronizzazione per la prima volta però, bisogna partire da un punto di inizio, in modo da avere una situazione consistente su entrambi i calendari (gestionale e calendar server). Nel modulo ServerSync questo punto d'inizio, è chiamato Inizializzazione. Esistono due tipi di inizializzazione dell'agenda: Inizializzazione con cancellazione del calendario del calendar server e inizializzazione con importazione degli eventi preesistenti sul calendar server nell'agenda del gestionale. Inizializzazione con cancellazione calendario Nell'inizializzazione agenda con cancellazione del calendario del calendar/mail server vengono cancellati tutti gli eventi che si trovano sul calendario, e successivamente tutti gli eventi che si trovano nell'agenda del gestionale a partire dalla data selezionata vengono inseriti nel calendario del calendar server. Questo tipo di inizializzazione si può utilizzare quando si va ad operare su un calendario che è già
vuoto oppure contiene eventi di cui si è disposti a perdere traccia, è evidente infatti che tutte le informazioni preesistenti sul calendario vengono perse. (Possono essere recuperate dal backup che si deve aver provveduto a realizzare prima di procedere). Inizializzazione con import eventi preesistenti dal calendario Nell'inizializzazione agenda con import eventi preesistenti sul calendario, tutti gli eventi dell'agenda del gestionale a partire dalla data selezionata vengono inseriti nel calendar server, e tutti gli eventi preesistenti sul calendar server vengono inseriti nel gestionale. Attenzione che questo significa che se sul calendario sul server sono presenti eventi personali, questi vengono inseriti nel gestionale, e non è detto che questa cosa sia desiderata. Inoltre bisogna fare attenzione a non utilizzare questa opzione se in precedenza si era sincronizzata l'agenda del gestionale con la sincronizzazione locale, questo perchè comporterebbe come effetto la duplicazione degli eventi nel gestionale. 3) Si può ora procedere a configurare le preferenze di sincronizzazione e a inserire le credenziali dell'account Google sul server di Easylex Web Edition. Configurazione da Web Edition Per accedere al pannello di configurazione cliccare su Home-->Preferenze-->Sincronizzazione sulla colonna di sinistra dell'interfaccia della Web Edition del gestionale dopo aver fatto il login.
Configurazione da client/server Questa è la schermata che si presenta nel gestionale dopo aver premuto il pulsante Configura nell'area ServerSync della finestra Configurazione PDA. Significato delle impostazioni di configurazione Usiamo come esempio la schermata nella Web Edition del gestionale:
Per attivare/disattivare la sincronizzazione mettere/togliere la spunta su Sincronizza Agenda. Se il calendario da utilizzare è un Google Calendar selezionare Google dalla voce Tipo Server. Nel campo Nome Utente inserire il proprio indirizzo email dell'account Google Calendar, ad esempio pippo@gmail.com, oppure anche solo lo username ad esempio pippo. Attraverso l'impostazione Aggiungi Udienze di è possibile selezionare le risorse di cui si vogliono sincronizzare in sola visualizzazione le udienze. Attenzione che non è possibile apportare modifiche alle udienze. Il campo Data Ultima Sincronizzazione riporta la data dell'ultimo ciclo di sincronizzazione effettuato per la risorsa, e pemette quindi di individuare eventuali sincronizzazioni bloccate.nel client del gestionale il campo viene aggiornato soltanto all'apertura del gestionale. Sotto alla voce Sincronizzazione iniziale, A partire dal è possibile impostare la data a partire dalla quale si esportano gli eventi nella sincronizzazione iniziale. E' possibile selezionare date predefinite (esempio oggi, ieri, ultimo mese, ultimo anno, etc) oppure impostare una data a piacimento. Attenzione: ogni volta che si inserisce una data in questo campo si forza la procedura a compiere una inizializzazione dell'agenda. Ogni qual volta, quindi, si voglia rifare una inizializzazione dell'agenda perchè si sono riscontrati problemi alla sincronizzazione bisogna impostare una data in questo campo. Se si spunta la voce Inizializzazione importa eventi preesistenti si attiva una inizializzazione agenda che importa nel gestionale gli eventi preesistenti sul calendario della risorsa in Google Calendar, in caso contrario l'inizializzazione con cancellazione dell'agenda sul calendar server. Cartella personale del calendario : è possibile sincronizzare il calendario di default della risorsa oppure un calendario creato a propria discrezione. Per sincronizzare il calendario di default lasciare vuoto questo campo, per sincronizzare un calendario differente inserire il nome del calendario rispettando maiuscole e minuscole (ad esempio se il calendario si chiama Gestionale inserire la parola Gestionale ).
Attenzione che se si utilizza un calendario diverso dal calendario di default non verranno sincronizzati gli allarmi. Dopo aver concluso le impostazioni di configurazione bisogna premere il pulsante Salva nella Web Edition, oppure l'equivalente pulsante Salva Preferenze e a seguire Ritorna o Esci nel client del gestionale. Scelta del tipo di inizializzazione nella migrazione alla nuova sincronizzazione con Google Calendar La sincronizzazione con Google Calendar prevede ora anche l'opzione Inizializzazione importa eventi preesistenti. Tuttavia quando si deve effettuare il passaggio dalla sincronizzazione con la vecchia versione di ServerSync Google Calendar alla nuova versione(quella cui si riferisce questa guida) bisogna partire da un calendario Google pulito perciò non bisogna assolutamente selezionare l'impostazione Inizializzazione importa eventi preesistenti. Le inizializzazioni successive alla prima inizializzazione di migrazione da vecchia a nuova versione di ServerSync potranno utlizzare a propria scelta l'opzione Inizializzazione importa eventi preesistenti. Se una risorsa non ha mai utilizzato in precedenza la sincronizzazione con ServerSync allora può anche utilizzare l'opzione Inizializzazione importa eventi preesistenti perchè gli eventi presenti nel Google Calendar non sono mai stati sincronizzati con Easylex. Procedura per l'inserimento delle credenziali sincronizzazione Google Calendar Prima di procedere alla configurazione delle credenziali e all'invio di queste al server Tomcat, è consigliabile eliminare la spunta dalla voce Sincronizza Agenda e premere il pulsante Salva. Una volta che la sincronizzazione è disattivata si può procedere all'autenticazione dell'utente con le credenziali di Google e all'invio di queste al server Tomcat. Configurazione da versione Client/Server
Per configurare le credenziali dalla finestra delle preferenze della versione client/server premere il pulsante Invia Credenziali dopo aver inserito il Nome Utente. Configurazione da versione Web Edition E' possibile autenticare l'utente in due modi: attraverso il pulsante Configura Credenziali direttamente nella schermata delle preferenze di sincronizzazione oppure effettuando il download di un software stand-alone e la sua esecuzione in maniera autonoma dal pannello di preferenze. Per utilizzare quest'ultima modalità premere il pulsante Download software invio credenziali. (Web Edition) Caso 1: Pulsante Configura Credenziali Prima di premere il pulsante Configura credenziali inserire lo username nel campo Nome Utente. Se si utilizza la Web Edition da browser il pulsante Configura credenziali utilizza una applet java per eseguire le proprie operazioni. Questo significa che ovviamente nel browser dovranno essere abilitate le applet java, dovrà essere escluso il blocco delle finestre di pop-up etc... Allo stato attuale i browser compatibili con la configurazione delle credenziali attraverso applet java sono: Internet Explorer, Google Chrome e Safari. Non c'è compatibilità invece con Mozilla Firefox. Se si utilizza la versione Adobe AIR della Web Edition non ci sono invece problemi di compatibilità perchè non viene eseguita una applet, ma viene eseguito codice nativo AIR. (Web Edition) Caso2: Pulsante Download software invio credenziali Per effettuare il download del software stand-alone bisogna che la risorsa che effettua l'operazione acceda alla Web Edition attraverso una password, non è possibile effettuare l'operazione se la risorsa è priva di password. E' inoltre necessario specificare i dati del server Tomcat della Web Edition da cui effettuare il download nella sezione della finestra preferenze alla voce Dati Server WE. Ad esempio se per accedere alla Web Edition digito l'indirizzo http://94.82.180.69:8400/we nel campo Prot indicherò http (https se avessi utilizzato il protocollo https), nel campo Indirizzo indicherò 94.82.180.69 (potrei anche indicare un indirizzo ip interno se mi connetto dalla rete lan interna allo studio), e nel campo Porta indicherò 8400 (se non indico niente nel campo porta viene utilizzata di default la porta 80). Per chi utilizza Easylex Cloud nel campo indirizzo indicare elcloud.24oresoftware.com e nel campo porta non indicare niente. Il software che viene scaricato è contenuto in un pacchetto zip che contiene oltre al software vero e proprio gli script Windows e Macintosh per eseguirlo e le istruzioni delle operazioni da eseguire contenute nel file istruzioni.txt Inserimento delle credenziali Sia che si sia eseguita l'operazione utilizzando il pulsante Configura Credenziali (quindi attraverso Applet/AIR) sia che si sia utilizzato il software stand-alone, sia che si utilizzi la configurazione da versione client/server si aprirà una finestra nel browser come quella che segue:
dove bisognerà inserire la propria email e la propria password dell'account Google (Gmail). Dopo aver cliccato sul pulsante Accedi comparirà questa schermata:
dove si viene avvisati che ServerSync il sistema di sincronizzazione della Web Edition vuole accedere al proprio calendario. Una volta cliccato sul pulsante Accetto la procedura di configurazione credenziali è conclusa. Per verificare che le credenziali siano state inserite correttamente dalla finestra delle preferenze di
sincronizzazione : Premere il pulsante Verifica Inserimento Credenziali (solo da Web Edition). Se si è commesso un errore e si sono inserite credenziali errate o se per qualsiasi problema di sincronizzazione si ha necessità di rimuovere delle credenziali inserite (perchè ad esempio la risorsa non sincronizza più etc..) si possono eliminare le credenziali dal server Tomcat premendo il pulsante Elimina Credenziali Inserite (solo da Web Edition). 4) Avvio della sincronizzazione Una volta concluso il processo di inserimento delle credenziali sul server, si può avviare la sincronizzazione mettendo la spunta sulla voce Sincronizza Agenda, impostando una data di inizializzazione agenda (per l'opzione importa eventi preesistenti valgono le considerazioni fatte in precedenza nel paragrafo Scelta del tipo di inizializzazione nella migrazione alla nuova sincronizzazione con Google Calendar ) e cliccando poi sul pulsante Salva.
Schema riassuntivo e sintetico della procedura 1) creare backup del calendario Google esistente 2) dalle preferenze di sincronizzazione disattivare la voce sincronizza agenda, disattivare la voce inizializzazione importa eventi preesistenti, impostare username e salvare 3) configurare le credenziali dell'account Google 4) dalle preferenze di sincronizzazione impostare una data di inizializzazione agenda, verificare che non ci sia la spunta sulla voce inizializzazione importa eventi preesistenti, attivare la voce sincronizza agenda e salvare Requisiti di sistema Per poter utilizzare la sincronizzazione ServerSync con Google Calendar è necessario che sul server della Web Edition e sui client che devono effettuare la configurazione delle credenziali sia possibile installare Java versione 1.7 o superiore. Si ricorda che non è possibile installare Java versione 1.7 o superiore su sistemi operativi Mac Os X versione 10.6 e precedenti.