Upgraden van versie 6 naar 7

LimeSurvey 7 hoofdversie

Deze pagina geeft een overzicht van de belangrijkste wijzigingen in LimeSurvey 7 en verwijst naar de relevante documentatiepagina's.

  Deze informatie is vooral van toepassing op de LimeSurvey Community Edition (CE).

Belangrijkste wijzigingen in LimeSurvey 7

Gewijzigde structuur van antwoordtabellen en veldnamen

LimeSurvey 7 voert een structurele opschoning door in de manier waarop antwoordtabellen en veldnamen worden gegenereerd. Deze wijziging verbetert de consistentie en maakt het platform eenvoudiger te onderhouden en uit te breiden.

Meer details vindt u hier: Herstructurering van veldnamen en antwoordtabellen - LimeSurvey 7

Nieuwe vraageditor

LimeSurvey 7 introduceert ook een nieuwe vraageditor met een vernieuwde gebruikersinterface en verbeterde werkwijzen voor het maken en beheren van vragen.

Meer details vindt u hier: Nieuwe vraageditor in LimeSurvey 7

Wijzigingen in de RemoteControl API

De antwoorden van de RemoteControl 2 API zijn verbeterd: naast de foutmelding worden nu ook foutcodes teruggegeven. Raadpleeg de documentatie van de RemoteControl 2 API voor deze wijzigingen. Afhankelijk van hoe u met retourwaarden omgaat, is dit achterwaarts compatibel - het kan echter zijn dat uw implementatie dit niet correct afhandelt.

Meer details vindt u hier: RemoteControl 2 API

Wijzigingen in tijdzones

In versie 6 en eerder waren opgeslagen tijdstempels niet gekoppeld aan een tijdzone en hingen ze af van de datum/tijd van de server. Bij de migratie naar versie 7 wordt de oude instelling 'Tijdsverschil' indien mogelijk gemigreerd en worden alle nieuwe tijdstempels opgeslagen als UTC-tijdstempels. Oude tijdstempels worden niet gemigreerd. U kunt in de algemene instellingen een algemene tijdzone als standaard instellen en per gebruiker kan een individuele tijdzone worden ingesteld. Deze gelden alleen voor de weergave van gegevens. Export en de RemoteControl API accepteren/leveren alleen de ruwe tijdstempels.

Aangepaste enquêtethema's

Alle enquêtethema's die compatibel zijn met LS6 blijven daarna actief. Als het enquêtethema niet compatibel was met LS6, wordt het gedeïnstalleerd en worden de thema opties in de algemene instellingen, groepsinstellingen en enquête-instellingen gereset naar de nieuwe standaardwaarden.

Upgradestrategie:

1. Exporteer het enquêtethema uit de oude toepassing
2. Controleer voordat u het in de nieuwe toepassing importeert of de compatibiliteitstag correct is ingesteld: https://manual.limesurvey.org/Extension_compatibility#Survey_themes
3. Importeer het in de nieuwe toepassing
4. Controleer de code die u voor het enquêtethema heeft aangepast en werk deze bij volgens de nieuwe versie van de toepassing die u wilt gebruiken.
5. Exporteer uw bijgewerkte, aangepaste enquêtethema uit de nieuwe toepassing
6. Na de upgrade blijven uw enquêtethema's die compatibel zijn met LS6 actief, terwijl oudere thema's worden gedeïnstalleerd.
7. Als u een enquêtethema wilt bijwerken, kunt u het nu importeren. Nadat u heeft bevestigd dat het correct is bijgewerkt, kunt u het oude thema verwijderen.

Aangepaste beheerthema's

Het standaard beheerthema wordt standaard ingeschakeld. Aangepaste thema's blijven ongewijzigd, maar kunnen niet opnieuw worden geactiveerd tenzij ze worden bijgewerkt.

voor zelf gehoste toepassingen:

1. Controleer voordat u het beheerthema naar de nieuwe toepassing kopieert of de compatibiliteitstag correct is ingesteld: https://manual.limesurvey.org/Extension_compatibility#Admin_themes
2. Kopieer het bestaande beheerthema van de oude toepassing naar de nieuwe toepassing https://manual.limesurvey.org/Custom_Admin_Themes
3. Controleer de code die u voor het beheerthema heeft aangepast en werk deze bij volgens de nieuwe versie van de toepassing die u wilt gebruiken.
4. Na het upgraden van uw oude toepassing wordt ons nieuwe beheerthema standaard weergegeven. Om uw eerder geïnstalleerde beheerthema bij te werken, kunt u:
   • De code van het beheerthema dat nu als incompatibel is gemarkeerd handmatig bijwerken
   • Het oude beheerthema verwijderen en het nieuwe thema installeren dat u eerder in uw testomgeving heeft bijgewerkt.

voor Cloud-gebruikers:
Neem contact op met onze support.

Aangepaste vraagthema's

Aangepaste vraagthema's die niet overeenkomen met de huidige versie kunnen niet worden geïnstalleerd, maar blijven na de upgrade wel actief. Meer informatie over vraagthema's vindt u hier: Vraagthema's. Aangepaste JavaScript die in het enquêtethema of in vragen van een enquête is ingevoegd, werkt waarschijnlijk ook niet meer.

Uw aangepaste vraagthema upgraden:

1. Download het vraagthema van een website of exporteer het huidige vraagthema
2. Controleer voordat u uploadt of de compatibiliteit van uw aangepaste vraagthema correct is ingesteld
3. Probeer uw vraagthema te uploaden naar de nieuwe toepassing.
4. Als het een zelfgemaakt vraagthema is, voer dan de nodige aanpassingen door
5. Controleer na het succesvol uploaden of het vraagthema wordt weergegeven en werkt zoals verwacht.

Een thema upgraden dat u niet zelf beheert:
Controleer of er een update beschikbaar is op de website of bij de ontwikkelaar die het thema heeft geleverd.

Aangepaste plugins

Aangepaste plugins die niet overeenkomen met de huidige versie worden tijdens het upgradeproces gedeactiveerd.

voor zelf gehoste toepassingen:

1. Controleer of de plugin op de nieuwe versie kan worden geïnstalleerd.
2. Werk de plugin bij of neem contact op met de auteur van de plugin om deze bij te werken.
3. Overschrijf de plugin handmatig met nieuwe bestanden in uw toepassing, waarbij de instellingen behouden blijven, of verwijder de oude versie en installeer de nieuwe versie opnieuw. In dat geval moeten alle instellingen opnieuw worden ingevoerd.

voor Cloud-gebruikers:

1. LimeSAML blijft actief
2. Controleer of de plugin op de nieuwe versie kan worden geïnstalleerd.
3. Werk de code van de plugin bij of neem contact op met de auteur van de plugin om deze bij te werken.
4. Installatieopties:
   • Verwijder de oude versie en installeer de nieuwe versie opnieuw (alle instellingen gaan verloren en moeten opnieuw worden toegepast)
   • Neem contact op met support om de plugin bij te laten werken zonder verlies van configuratiegegevens

Vereisten

	LimeSurvey 6	LimeSurvey 7
PHP	7.4 of hoger	8.1 of hoger (8.3 aanbevolen)
MySQL	8.0 of hoger	8.0 of hoger
MariaDB	10.3.38 of hoger	10.3.38 of hoger
PostgreSQL	12 of hoger	14 of hoger
MSSQL	2016 of hoger	2019 of hoger
URL-indeling	get of path	path, vereist voor de nieuwe editor

U hebt Node.js of npm niet nodig. De nieuwe editor is opgenomen in het LimeSurvey-pakket en is direct klaar voor gebruik.

Maak een volledige back-up van uw bestanden en uw database voordat u begint, en test de upgrade eerst op een kopie van uw installatie. Zodra de upgrade is uitgevoerd, kunt u alleen nog terug door die back-up te herstellen.

Plan een onderhoudsvenster. LimeSurvey zet de site in de onderhoudsmodus terwijl de database wordt geüpgraded, en bij installaties met veel responsgegevens kan dit enige tijd duren.

Aanbevolen: gebruik onze ComfortUpdate-service

De eenvoudigste en veiligste manier om te upgraden is onze ComfortUpdate-service te gebruiken. Deze downloadt en installeert de nieuwe versie voor u, zodat u geen bestanden handmatig hoeft te vervangen.

Als u liever handmatig upgradet, volgt u in plaats daarvan de onderstaande stappen.

Handmatig upgraden

1. Maak een back-up van uw bestanden en database en zet de site in de onderhoudsmodus.
2. Bewaar de volgende bestanden en mappen van uw oude installatie:
   • application/config/config.php
   • application/config/security.php
   • application/config/allowed_hosts.php
   • de map upload/, die uw geüploade bestanden, gebruikersthema's en gebruikersplugins bevat
   • de map plugins/, als u daar handmatig plugins in hebt geïnstalleerd
3. Download het LimeSurvey 7-pakket en werk de installatie bij met een van de volgende methoden:
   1. Verwijder eerst de oude bestanden. Verplaats de hierboven genoemde bestanden naar een andere locatie, verwijder al het andere in uw LimeSurvey-map, pak het nieuwe pakket erin uit en plaats de bewaarde bestanden terug.
   2. Of kopieer de nieuwe bestanden over de oude. Pak het nieuwe pakket uit over uw bestaande installatie en laat bestaande bestanden overschrijven, waarbij u de hierboven genoemde bestanden ongemoeid laat.
4. Gebruik bij beide opties de nieuwe .htaccess uit het pakket, want die van 6.x werkt niet met de nieuwe editor. Maak daarna tmp/runtime/ leeg, zodat er geen gecachete gegevens van versie 6 achterblijven.
5. Stel de URL-indeling in op path in application/config/config.php.
6. Zorg ervoor dat uw webserver de map /editor/ rechtstreeks serveert en de Authorization-koptekst doorgeeft aan PHP. Meer details: Nieuwe vrageneditor in LimeSurvey 7
7. Voer de database-upgrade uit. LimeSurvey detecteert de oudere databaseversie en biedt aan deze te upgraden. Bevestig dit en laat het proces zonder onderbreking voltooien.
8. Wanneer het klaar is, schakelt u de onderhoudsmodus uit en loopt u de onderstaande checklist door.

Na de upgrade

• Controleer het versienummer in de voettekst van de beheerpagina's.

• Activeer de plugins die u nodig hebt opnieuw, een voor een.

• Open een enquête en controleer of de nieuwe editor wordt geladen.

• Voer in elke actieve enquête één volledige testrespons uit, waarbij u voorwaarden, quota, e-mails en de afsluiting-URL controleert.

Probleemoplossing

Melding "Actie vereist" over de URL-indeling. De URL-indeling is nog steeds get. Wijzig deze naar path en maak tmp/runtime/ leeg.

De editor wordt geladen maar blijft leeg. De Authorization-koptekst bereikt PHP niet.

/editor/ toont een LimeSurvey-pagina of de foutmelding "Niet gevonden". Controleer de configuratie van uw webserver en zorg ervoor dat de map /editor/ rechtstreeks wordt geserveerd in plaats van via LimeSurvey te worden gerouteerd.

"U kunt dit thema niet gebruiken met de nieuwe vrageneditor". De enquête gebruikt een thema dat niet op fruity_twentythree is gebaseerd. Wijzig het thema of ga verder in de klassieke editor.

Een plugin veroorzaakt fouten nadat deze opnieuw is geactiveerd. Deze is niet compatibel met LimeSurvey 7. Schakel de plugin uit en neem contact op met de beheerder ervan.

Opmerkingen

Elke belangrijke wijziging is gedocumenteerd op een eigen pagina. Zo blijft de documentatie gefocust en vindt u gemakkelijker de informatie die relevant is voor uw situatie.