Upgrade von Version 6 auf 7

LimeSurvey 7 Hauptversion

Diese Seite bietet einen Überblick über die wichtigsten Änderungen in LimeSurvey 7 und verlinkt zu den entsprechenden Dokumentationsseiten.

  Diese Informationen gelten hauptsächlich für die LimeSurvey Community Edition (CE).

Wesentliche Änderungen in LimeSurvey 7

Geänderte Struktur der Antworttabelle und Feldnamen

LimeSurvey 7 führt eine strukturelle Bereinigung der Generierung von Antworttabellen und Feldnamen ein. Diese Änderung verbessert die Konsistenz und erleichtert die Wartung und Erweiterung der Plattform.

Weitere Details finden Sie hier: Fieldname and response table refactor - LimeSurvey 7 (Nur in English)

Neuer Fragen-Editor

LimeSurvey 7 führt außerdem einen neuen Fragen-Editor mit aktualisierter Benutzeroberfläche und verbesserten Arbeitsabläufen zum Erstellen und Verwalten von Fragen ein.

Weitere Details finden Sie hier: Neuer Frageneditor in LimeSurvey 7 (nur in Englisch)

Änderungen an der RemoteControl-API

Die Antworten der RemoteControl 2-API wurden verbessert, indem zusätzlich zum Fehlertext nun auch Fehlercodes zurückgegeben werden. Weitere Informationen zu diesen Änderungen finden Sie in der RemoteControl 2-API-Dokumentation. Je nachdem, wie Sie Rückgabewerte verarbeiten, sollte dies abwärtskompatibel sein – es ist jedoch möglich, dass dies in Ihrer Implementierung nicht korrekt umgesetzt wird.

Weitere Details finden Sie hier: RemoteControl 2 API (nur in Englisch)

Benutzerdefinierte Umfragethemen

Alle mit LS6 kompatiblen Umfragethemen bleiben auch danach aktiv. Wenn das Umfragethema nicht mit LS6 kompatibel war, wird es deinstalliert, und die Themenoptionen in den globalen, Gruppen- und Umfrageeinstellungen werden auf die neuen Standardeinstellungen zurückgesetzt.

Upgrade-Strategie:

1. Exportieren Sie die Designvorlage aus der alten Anwendung
2. Stellen Sie vor dem Import in die neue Anwendung sicher, dass das Kompatibilitäts-Tag korrekt gesetzt ist: https://manual.limesurvey.org/Extension_compatibility#Survey_themes
3. Importieren Sie es in die neue Anwendung
4. Überprüfen Sie den Code, den Sie für das Designvorlage angepasst haben, und aktualisieren Sie ihn entsprechend der neuen Version der Anwendung, die Sie verwenden möchten
5. Exportieren Sie Ihr aktualisiertes, angepasstes Designvorlage aus der neuen Anwendung
6. Nach dem Upgrade bleiben Ihre mit LS6 kompatiblen Designvorlage aktiv, während ältere Designvorlagen deinstalliert werden.
7. Wenn Sie eine Designvorlage aktualisieren möchten, können Sie es jetzt importieren. Nachdem Sie bestätigt haben, dass es korrekt aktualisiert wurde, können Sie das alte Designvorlage löschen.

Benutzerdefinierte Admin-Themes

Die Standard-Admin-Designvorlage ist standardmäßig aktiviert. Benutzerdefinierte Designvorlage bleiben unverändert, können aber erst nach einem Update wieder aktiviert werden.

for self-hosted application:

1. Before copying the admin theme to the new application, make sure the compatibility tag is set correctly: https://manual.limesurvey.org/Extension_compatibility#Admin_themes
2. Copy the existing admin theme from the old application to the new application https://manual.limesurvey.org/Custom_Admin_Themes
3. Check the code you customized for the admin theme and update it in accordance with the new version of the application you want to use.
4. After upgrading your old application, our new admin theme is displayed by default. To update your previously installed admin theme, either:
   • Manually update the code of the admin theme currently marked as incompatible
   • Delete the old admin theme and install the new one you previously updated in your test environment.

für Cloud-Nutzer:
Bitte kontaktieren Sie unseren Support.

Custom question themes

Custom question themes that do not match the current version cannot be installed, but will still be active after the upgrade. More information about question themes can be found here Question themes. Custom JavaScript inserted into the survey theme or any of the questions in a survey will likely not work anymore as well.

Upgrading your customized question theme:

1. Download the question theme from a website or export the current question theme
2. Before uploading, make sure the compatibility of your custom question theme is set correctly https://manual.limesurvey.org/Extension_compatibility#Question_themes
3. Try to upload your question theme into the new application.
4. If it is a self-created question theme, make the necessary adjustments
5. After successfully uploading, please check if the question theme is displayed and working as expected.

Upgrading a theme you do not own:
Try to see if an update is available from the website or developer that provided it

Benutzerdefinierte Plugins

Benutzerdefinierte Plugins, die nicht mit der aktuellen Version übereinstimmen, werden während des Aktualisierungsprozesses deaktiviert.

Für selbstgehostete Anwendungen:

1. Prüfen Sie, ob das Plugin in der neuen Version installiert werden kann.
2. Aktualisieren Sie das Plugin oder kontaktieren Sie den Plugin-Autor, um das Plugin aktualisieren zu lassen.
3. Überschreiben Sie das Plugin manuell mit neuen Dateien in Ihrer Anwendung, wodurch die Einstellungen erhalten bleiben, oder deinstallieren Sie die alte Version und installieren Sie die neue Version neu. In diesem Fall werden alle Einstellungen neu eingegeben.

Für Cloud-Nutzer: LimeSAML bleibt aktiv. Prüfen Sie, ob das Plugin in der neuen Version installiert werden kann. Aktualisieren Sie den Plugin-Code oder kontaktieren Sie den Plugin-Autor, um das Plugin zu aktualisieren. Installationsoptionen: * Deinstallieren Sie die alte Version und installieren Sie die neue Version (alle Einstellungen gehen verloren und müssen neu angewendet werden). * Kontaktieren Sie den Support, um das Plugin zu aktualisieren, ohne die Konfigurationsdaten zu verlieren.

Systemvoraussetzungen

	LimeSurvey 6	LimeSurvey 7
PHP	7.4 oder höher	8.1 oder höher (8.3 empfohlen)
MySQL	8.0 oder höher	8.0 oder höher
MariaDB	10.3.38 oder höher	10.3.38 oder höher
PostgreSQL	12 oder höher	14 oder höher
MSSQL	2016 oder höher	2019 oder höher
URL-Format	get oder path	path , erforderlich für den neuen Editor

Sie benötigen weder Node.js noch npm. Der neue Editor ist im LimeSurvey-Paket enthalten und sofort einsatzbereit.

Erstellen Sie vor Beginn des Upgrades eine vollständige Sicherung Ihrer Dateien und Ihrer Datenbank und testen Sie das Upgrade zunächst an einer Kopie Ihrer Installation. Nach dem Upgrade ist die Wiederherstellung der Sicherung die einzige Möglichkeit, den vorherigen Zustand wiederherzustellen.

Planen Sie ein Wartungsfenster ein. LimeSurvey schaltet die Website während des Datenbank-Upgrades in den Wartungsmodus, und bei Installationen mit vielen Antwortdaten kann dies einige Zeit dauern.

Empfohlen: Nutzen Sie unseren ComfortUpdate-Service

Die einfachste und sicherste Art des Upgrades ist die Nutzung unseres Comfortupdate-Dienstes. Dieser lädt die neue Version für Sie herunter und installiert sie, sodass Sie keine Dateien manuell ersetzen müssen.

Falls Sie das Upgrade lieber manuell durchführen möchten, befolgen Sie stattdessen die folgenden Schritte.

Manuelle Aktualisierung

1. Sichern Sie Ihre Dateien und Datenbank und versetzen Sie die Website in den Wartungsmodus.
2. Behalten Sie die folgenden Dateien und Ordner Ihrer alten Installation:
   • application/config/config.php
   • application/config/security.php
   • application/config/allowed_hosts.php
   • den Ordner upload/ , der Ihre hochgeladenen Dateien, Benutzer-Themes und Benutzer-Plugins enthält
   • den Ordner plugins/ , falls Sie Plugins manuell installiert haben
3. Laden Sie das LimeSurvey 7-Paket herunter und aktualisieren Sie die Installation mit einer der folgenden Methoden:
   1. Löschen Sie zuerst die alten Dateien. Verschieben Sie die oben genannten Dateien, löschen Sie alle anderen Dateien in Ihrem LimeSurvey-Verzeichnis, entpacken Sie das neue Paket darin und fügen Sie die behaltenen Dateien wieder ein.
   2. Oder kopieren Sie die neuen Dateien über die alten. Entpacken Sie das neue Paket über Ihre bestehende Installation und lassen Sie es die vorhandenen Dateien überschreiben. Die oben genannten Dateien bleiben erhalten. Unverändert
4. Verwenden Sie in beiden Fällen die neue .htaccess aus dem Paket, da die Version 6.x nicht mit dem neuen Editor kompatibel ist. Leeren Sie anschließend tmp/runtime/ damit keine zwischengespeicherten Daten aus Version 6 zurückbleiben.
5. Stellen Sie das URL-Format in application/config/config.php auf path ein.
6. Stellen Sie sicher, dass Ihr Webserver den Ordner /editor/ direkt ausliefert und den Authorization Header an PHP weiterleitet. Weitere Informationen: Neuer Fragen-Editor in LimeSurvey 7
7. Führen Sie das Datenbank-Upgrade durch. LimeSurvey erkennt die ältere Datenbankversion und bietet ein Upgrade an. Bestätigen Sie und lassen Sie den Vorgang ohne Unterbrechung abschließen.
8. Nach Abschluss des Upgrades deaktivieren Sie den Wartungsmodus und arbeiten die folgende Checkliste ab.

Nach dem Upgrade

• Überprüfen Sie die Versionsnummer in der Fußzeile der Admin-Seiten.

• Reaktivieren Sie die benötigten Plugins nacheinander.

• Öffnen Sie eine Umfrage und bestätigen Sie, dass der neue Editor geladen wird.

• Führen Sie für jede aktive Umfrage eine vollständige Testantwort durch, die Bedingungen, Quoten, E-Mails und die End-URL umfasst.

Fehlerbehebung

Meldung „Action needed“ bezüglich des URL-Formats. Das URL-Format ist noch get. Ändern Sie es in path und löschen Sie den tmp/runtime/ .

Der Editor wird geladen, bleibt aber leer. Der Authorization Header erreicht PHP nicht.

/editor/ zeigt eine LimeSurvey-Seite oder eine Fehlermeldung "Nicht gefunden". Überprüfen Sie Ihre Webserver-Konfiguration und stellen Sie sicher, dass der Ordner /editor/ direkt ausgeliefert wird und nicht über LimeSurvey geleitet wird.

Dieses Design ist mit dem neuen Frage-Editor nicht kompatibel. Die Umfrage verwendet ein Design, das nicht auf fruity_twentythree basiert. Wechseln Sie das Design oder fahren Sie im klassischen Editor fort.

Ein Plugin verursacht nach der Reaktivierung Fehler. Es ist nicht mit LimeSurvey 7 kompatibel. Deaktivieren Sie es und wenden Sie sich an den Entwickler.

Anmerkungen

Jede wichtige Änderung wird auf einer eigenen Seite dokumentiert. Dies sorgt für eine übersichtliche Dokumentation und erleichtert das Auffinden der für Ihre Konfiguration relevanten Informationen.