Aggiornamento dalla versione 6 alla 7

Versione principale LimeSurvey 7

Questa pagina offre una panoramica delle principali novità introdotte con LimeSurvey 7 e rimanda alle relative pagine della documentazione.

  Queste informazioni valgono principalmente per LimeSurvey Community Edition (CE).

Principali novità di LimeSurvey 7

Struttura modificata delle tabelle delle risposte e dei nomi dei campi

LimeSurvey 7 introduce una riorganizzazione strutturale del modo in cui vengono generate le tabelle delle risposte e i nomi dei campi. Questa modifica migliora la coerenza e rende la piattaforma più semplice da gestire ed estendere.

Maggiori dettagli qui: Refactoring dei nomi dei campi e della tabella delle risposte - LimeSurvey 7

Nuovo editor delle domande

LimeSurvey 7 introduce anche un nuovo editor delle domande, con un'interfaccia utente aggiornata e flussi di lavoro migliorati per creare e gestire le domande.

Maggiori dettagli qui: Nuovo editor delle domande in LimeSurvey 7

Modifiche all'API RemoteControl

Le risposte dell'API RemoteControl 2 sono state migliorate: oltre al testo dell'errore, ora viene restituito anche un codice di errore. Per queste modifiche consulti la documentazione API RemoteControl 2. A seconda di come gestisce i valori restituiti, la modifica dovrebbe essere retrocompatibile, ma potrebbe non essere gestita correttamente nella Sua implementazione.

Maggiori dettagli qui: API RemoteControl 2

Modifiche al fuso orario

Nella versione 6 e precedenti, i timestamp registrati non avevano un fuso orario definito e dipendevano dalla data/ora del server. Con la migrazione alla versione 7, la vecchia impostazione 'Differenza di orario' viene migrata, se possibile, e tutti i timestamp successivi vengono registrati come timestamp UTC. I vecchi timestamp non vengono migrati. È possibile impostare un fuso orario predefinito globale nelle impostazioni generali e uno individuale per ciascun utente. Queste impostazioni influiscono solo sulla visualizzazione dei dati. L'esportazione e l'API RemoteControl accettano/forniscono solo i timestamp originali.

Temi dell'indagine personalizzati

Tutti i temi dell'indagine compatibili con LS6 rimarranno attivi dopo l'aggiornamento. Se un tema dell'indagine non era compatibile con LS6, verrà disinstallato e le opzioni del tema nelle impostazioni generali, di gruppo e di indagine verranno reimpostate ai nuovi valori predefiniti.

Strategia di aggiornamento:

1. Esporti il tema dell'indagine dalla vecchia applicazione
2. Prima di importarlo nella nuova applicazione, verifichi che il tag di compatibilità sia impostato correttamente: https://manual.limesurvey.org/Extension_compatibility#Survey_themes
3. Lo importi nella nuova applicazione
4. Controlli il codice personalizzato del tema dell'indagine e lo aggiorni in base alla nuova versione dell'applicazione che intende usare.
5. Esporti dalla nuova applicazione il tema dell'indagine personalizzato aggiornato
6. Dopo l'aggiornamento, i temi dell'indagine compatibili con LS6 rimarranno attivi, mentre quelli più vecchi verranno disinstallati.
7. Se decide di aggiornare un tema dell'indagine, ora può importarlo. Dopo aver confermato che è stato aggiornato correttamente, può scegliere di eliminare quello vecchio.

Temi di amministrazione personalizzati

Il tema di amministrazione predefinito sarà attivato per impostazione predefinita. I temi personalizzati rimarranno invariati, ma non potranno essere riattivati a meno che non vengano aggiornati.

per le applicazioni self-hosted:

1. Prima di copiare il tema di amministrazione nella nuova applicazione, verifichi che il tag di compatibilità sia impostato correttamente: https://manual.limesurvey.org/Extension_compatibility#Admin_themes
2. Copi il tema di amministrazione esistente dalla vecchia applicazione alla nuova https://manual.limesurvey.org/Custom_Admin_Themes
3. Controlli il codice personalizzato del tema di amministrazione e lo aggiorni in base alla nuova versione dell'applicazione che intende usare.
4. Dopo l'aggiornamento della vecchia applicazione, il nuovo tema di amministrazione viene visualizzato per impostazione predefinita. Per aggiornare il tema di amministrazione installato in precedenza, può:
   • Aggiornare manualmente il codice del tema di amministrazione attualmente contrassegnato come incompatibile
   • Eliminare il vecchio tema di amministrazione e installare quello nuovo, aggiornato in precedenza nel Suo ambiente di test.

per gli utenti Cloud:
Contatti il nostro supporto.

Temi di domanda personalizzati

I temi di domanda personalizzati che non corrispondono alla versione corrente non possono essere installati, ma rimarranno comunque attivi dopo l'aggiornamento. Maggiori informazioni sui temi di domanda sono disponibili qui: Temi di domanda. È probabile che anche il codice JavaScript personalizzato inserito nel tema dell'indagine o in una qualsiasi delle domande di un'indagine non funzioni più.

Aggiornamento del tema di domanda personalizzato:

1. Scarichi il tema di domanda da un sito web oppure esporti il tema di domanda attuale
2. Prima di caricarlo, verifichi che la compatibilità del tema di domanda personalizzato sia impostata correttamente
3. Provi a caricare il tema di domanda nella nuova applicazione.
4. Se si tratta di un tema di domanda creato da Lei, apporti le modifiche necessarie
5. Dopo il caricamento, verifichi che il tema di domanda venga visualizzato e funzioni come previsto.

Aggiornamento di un tema di cui non è l'autore:
Verifichi se è disponibile un aggiornamento sul sito web o presso lo sviluppatore che lo ha fornito

Plugin personalizzati

I plugin personalizzati che non corrispondono alla versione corrente verranno disattivati durante il processo di aggiornamento.

per le applicazioni self-hosted:

1. Verifichi se il plugin può essere installato nella nuova versione.
2. Aggiorni il plugin o contatti l'autore del plugin per farlo aggiornare.
3. Sovrascriva manualmente il plugin con i nuovi file nella Sua applicazione, in modo da conservare le impostazioni, oppure disinstalli la vecchia versione e reinstalli quella nuova; in questo caso tutte le impostazioni dovranno essere reinserite.

per gli utenti Cloud:

1. LimeSAML rimarrà attivo
2. Verifichi se il plugin può essere installato nella nuova versione.
3. Aggiorni il codice del plugin o contatti l'autore del plugin per farlo aggiornare.
4. Opzioni di installazione:
   • Disinstalli la vecchia versione e reinstalli quella nuova (tutte le impostazioni andranno perse e dovranno essere riapplicate)
   • Contatti il supporto per far aggiornare il plugin senza perdere i dati di configurazione

Requisiti

	LimeSurvey 6	LimeSurvey 7
PHP	7.4 o superiore	8.1 o superiore (consigliata 8.3)
MySQL	8.0 o superiore	8.0 o superiore
MariaDB	10.3.38 o superiore	10.3.38 o superiore
PostgreSQL	12 o superiore	14 o superiore
MSSQL	2016 o superiore	2019 o superiore
Formato URL	get o path	path, necessario per il nuovo editor

Non è necessario Node.js né npm. Il nuovo editor è incluso nel pacchetto di LimeSurvey ed è pronto all'uso.

Prima di iniziare, eseguite un backup completo dei file e del database e testate prima l'aggiornamento su una copia della vostra installazione. Una volta eseguito l'aggiornamento, l'unico modo per tornare indietro è ripristinare quel backup.

Pianificate una finestra di manutenzione. LimeSurvey porta il sito in modalità di manutenzione durante l'aggiornamento del database e, nelle installazioni con molti dati delle risposte, l'operazione può richiedere del tempo.

Consigliato: usare il servizio ComfortUpdate

Il modo più semplice e sicuro per eseguire l'aggiornamento è utilizzare il nostro servizio ComfortUpdate. Scarica e installa la nuova versione al posto vostro, quindi non dovrete sostituire alcun file manualmente.

Se preferite eseguire l'aggiornamento manualmente, seguite invece i passaggi riportati di seguito.

Aggiornamento manuale

1. Eseguite un backup dei file e del database e portate il sito in modalità di manutenzione.
2. Conservate i seguenti file e cartelle della vostra vecchia installazione:
   • application/config/config.php
   • application/config/security.php
   • application/config/allowed_hosts.php
   • la cartella upload/, che contiene i file caricati, i temi utente e i plugin utente
   • la cartella plugins/, se avete installato dei plugin al suo interno manualmente
3. Scaricate il pacchetto di LimeSurvey 7 e aggiornate l'installazione utilizzando uno dei seguenti metodi:
   1. Eliminare prima i vecchi file. Spostate altrove i file elencati sopra, eliminate tutto il resto nella directory di LimeSurvey, decomprimete al suo interno il nuovo pacchetto e rimettete al loro posto i file conservati.
   2. Oppure copiare i nuovi file sopra quelli vecchi. Decomprimete il nuovo pacchetto sopra l'installazione esistente e lasciate che sovrascriva ciò che è già presente, senza toccare i file elencati sopra.
4. Con entrambe le opzioni, utilizzate il nuovo file .htaccess del pacchetto, poiché quello della versione 6.x non funziona con il nuovo editor. Successivamente, svuotate tmp/runtime/ in modo che non rimangano dati in cache della versione 6.
5. Impostate il formato URL su path in application/config/config.php.
6. Assicuratevi che il vostro web server serva direttamente la cartella /editor/ e passi l'intestazione Authorization a PHP. Maggiori dettagli: Nuovo editor delle domande in LimeSurvey 7
7. Eseguite l'aggiornamento del database. LimeSurvey rileva la versione precedente del database e propone di aggiornarla. Confermate e lasciate che l'operazione si concluda senza interromperla.
8. Al termine, disattivate la modalità di manutenzione e completate la checklist riportata di seguito.

Dopo l'aggiornamento

• Controllate il numero di versione nel piè di pagina delle pagine di amministrazione.

• Riattivate i plugin di cui avete bisogno, uno alla volta.

• Aprite un'indagine e verificate che il nuovo editor venga caricato.

• Eseguite una risposta di prova completa in ogni indagine attiva, verificando condizioni, quote, e-mail e URL finale.

Risoluzione dei problemi

Messaggio "È necessario intervenire" relativo al formato URL. Il formato URL è ancora get. Impostatelo su path e svuotate tmp/runtime/.

L'editor viene caricato ma rimane vuoto. L'intestazione Authorization non raggiunge PHP.

/editor/ mostra una pagina di LimeSurvey o un errore "Non trovato". Controllate la configurazione del web server e assicuratevi che la cartella /editor/ sia servita direttamente invece di essere instradata tramite LimeSurvey.

"Non è possibile utilizzare questo tema con il nuovo editor delle domande". L'indagine utilizza un tema che non è basato su fruity_twentythree. Cambiate tema oppure continuate con l'editor classico.

Un plugin causa errori dopo essere stato riattivato. Non è compatibile con LimeSurvey 7. Disattivatelo e rivolgetevi al suo responsabile.

Note

Ogni modifica importante è documentata in una pagina dedicata. Questo aiuta a mantenere la documentazione mirata e rende più semplice trovare le informazioni rilevanti per la vostra configurazione.