Umfragestruktur mit tabulatorgetrennten Werten
From LimeSurvey Manual
Tabulatorgetrennter Werteimport und Export der Umfragestruktur
Diese Funktion soll die Verwendung einer Tabellenkalkulationssoftware wie LibreOffice, Excel oder Google Docs zum Erstellen und Bearbeiten von Umfragen vereinfachen. Dadurch entfällt die Notwendigkeit zur Nutzung von SGQA-Codes vollständig.
Diese Funktion unterstützt den Import aus ASCII- oder UTF-8-codierten TSV-Dateien (Tab Separated Value), die eine .txt-Erweiterung haben.
Erste Schritte
Der einfachste Weg besteht darin, eine vorhandene Umfrage zu übernehmen und sie im Format „Tabulatorgetrennte Werte“ zu exportieren. Verwenden Sie die normale Schaltfläche „Umfrage exportieren“ und wählen Sie anstelle des .lss-Formats „Tabulatorgetrenntes Werteformat (*.txt)“ aus. Es wird als tabulatorgetrennte Wertedatei im richtigen Format (tabulatorgetrennte Unicode-Datei) mit allen korrekten Spaltenüberschriften gespeichert.
Jede Tabellenkalkulationssoftware, die tabulatorgetrennte Werte unterstützt, ist verwendbar (z. B. OpenOffice oder LibreOffice). LimeSurvey ignoriert jegliche Formatierung innerhalb der Tabelle, Sie können jedoch gerne eine hinzufügen, wenn es Ihnen hilft.
Für jede Gruppe, Frage, Unterfrage und Antwort gibt es eine Zeile. Es gibt auch Zeilen für globale Umfragevariablen und für sprachspezifische Umfragevariablen. Die primäre Sprache wird zuerst aufgeführt, gefolgt von allen sekundären Sprachen. Wenn also mehrere Sprachen vorhanden sind, wird der gesamte Inhalt der Basissprache zuerst angezeigt (z. B. alle Gruppen, Fragen, Unterfragen und Antworten). Darauf folgt eine übersetzte Kopie für jede Sekundärsprache (mit genau der gleichen Anzahl und Reihenfolge der Zeilen wie im übersetzten Satz).
Beziehungen entstehen durch Nähe. Fragen, die einer Gruppe folgen, sind also Teil dieser Gruppe; Unterfragen, die einer Frage folgen, sind Teil dieser Frage, und Antworten, die einer Frage folgen, sind Teil dieser Frage. Daher müssen Sie bei Fragen nicht die IDs (gid, qid, sqid) kennen. Diese werden beim Import automatisch berechnet. Tatsächlich verwendet dieses Format überhaupt keine GID-, QiD- oder SQID-Codes (oder SGQA-Codes).
Tipps
Das Ziel des Imports/Exports tabulatorgetrennter Werte besteht darin, Ihnen die schnelle Gestaltung Ihrer Umfrage mithilfe einer Tabellenkalkulation zu ermöglichen. Wir gehen davon aus, dass Sie das Datenblatt häufig importieren, seine Gültigkeit mithilfe der Funktion „Umfragelogik anzeigen“ überprüfen und es testen. Bei jedem Import erhalten Sie eine neue Umfrage. Es kann also sein, dass Sie viele unvollständig entwickelte Umfragen erhalten, aber das ist kein Problem. Gewöhnen Sie sich einfach an, den Überblick darüber zu behalten, welches das aktuellste ist, oder löschen Sie das alte, nachdem Sie die neuen importiert haben. Da Sie im tabulatorgetrennten Wert niemals SGQA-Codes verwenden, müssen Sie sich keine Gedanken darüber machen, welche Codes LimeSurvey für die primären Umfrage-, Gruppen-, Frage- und Antwortschlüssel zuweist. Sie können also beliebig oft importieren und exportieren.
Hier sind einige praktische Dinge, die Sie mit diesem Ansatz zum Erstellen von Instrumenten tun können:
- Verwenden Sie für viele Fragen dieselben Antworten. Kopieren Sie einfach die „A“-Zeilen und fügen Sie sie nach jeder Frage ein, die denselben Satz haben soll.
- Verwenden Sie für viele Fragen dieselben Unterfragen. Kopieren Sie einfach die „SQ“-Zeilen und fügen Sie sie nach jeder Frage ein, die sie benötigt.
- "Looping" - dieselbe Gruppe viele Male verwenden. Nachdem die Gruppe Ihren Wünschen entspricht, kopieren Sie sie so oft wie nötig. Verwenden Sie die Excel-Filterung, um nur die „G“-Zeilen (für Gruppen) anzuzeigen, und verwenden Sie die Excel-Spaltenziehfunktion, um die Relevanzgleichungen für jede Gruppe zu aktualisieren (z. B. könnte bei einer Volkszählung die erste Relevanz „numPeople > 1“ sein). Als nächstes sollte „numPeople > 2“ lauten. Die Drag-Funktion aktualisiert die Zahl automatisch. Filtern Sie nach „Q“-Zeilen und stellen Sie sicher, dass jede Frage einen eindeutigen Wert hat (z. B. nennen Sie Ihre Variablen g1_q1, g1_q2, g1_qN, verwenden Sie Suchen/Ersetzen, um g1 in g2 für die zweite Gruppe umzuwandeln, g3 für die dritte Gruppe usw.). .
- Fragen/Gruppen neu anordnen. Ordnen Sie einfach die Zeilen der Tabellenkalkulationsdatei neu an.
- Umfragemodule testen. Bei langen Umfragen möchten Sie die Tests möglicherweise in Module aufteilen. Erstellen Sie einfach neue Tabellenkalkulationsdateien für jedes Modul und löschen Sie alle nicht benötigten Zeilen. Dadurch entfällt die Notwendigkeit, viele Daten einzugeben, um spätere Abschnitte der Umfrage zu testen.
- Testen von Pflichtfragen. Eine häufige Beschwerde ist nicht die Notwendigkeit, viele Fragen obligatorisch zu machen, sondern die Notwendigkeit, die obligatorische Funktion zum Testen zu deaktivieren. Erstellen Sie einfach die Master-Tabelle mit den obligatorischen Werten, die auf die endgültigen gewünschten Werte eingestellt sind. Um es dann zu testen, löschen Sie einfach die Spalte „Pflichtfeld“ und speichern Sie die Testversion der Tabelle. Wenn Sie diese Version importieren, ist keine der Fragen obligatorisch. Nachdem Sie Ihre Tests abgeschlossen haben, importieren Sie die Masterkopie.
- Standardeinstellungen festlegen. Anstatt die GUI zu verwenden, können Sie in der Standardspalte beliebige Standardwerte eingeben. Dies ist besonders hilfreich in Fällen, in denen die GUI die Eingabe des gewünschten Werts nicht zulässt, z. B. Ausdrücke zum Festlegen des Standardwerts für Listenelemente (z. B. das Auffüllen einer Liste aus einem [[Umfrageteilnehmer|Umfrageteilnehmer]). ]-Attribut.
- Übersetzung. Sie können Kopien Ihrer Tabelle erstellen – eine pro Sprache. Fügen Sie alle Zeilen für die Primärsprache ein, kopieren Sie sie, fügen Sie sie unten ein und ändern Sie das Sprachfeld durch Ziehen in die Zielsprache. Diese können an Ihre Übersetzer verteilt und nach Fertigstellung wieder in eine einzige Tabellendatei integriert werden.
- Masseneinstellung erweiterter Fragenattribute. Möglicherweise möchten Sie, dass zunächst alle Ihre Gleichungen sichtbar sind (damit Sie beim Sammeln von Daten ihre Werte sehen können), sie dann aber alle ausblenden, bevor Sie in die Produktion gehen. Filtern Sie die Tabelle einfach nach Klasse = „Q“ und Fragetyp = „*“ (Gleichung) und setzen Sie „always_hide“ für jede dieser Fragen auf 1. Ebenso entscheiden Sie, nachdem Sie die Umfrage erstellt haben, welche Fragen in der öffentlichen Statistik erscheinen sollen. Anstatt jede Frage über die GUI zu bearbeiten, filtern Sie nach Klasse = „Q“ und setzen Sie public_statistics = 1 für alle Fragen, die in der Statistik sichtbar sein sollen.
- Suchen und Ersetzen. Angenommen, Sie möchten die Formulierungen aller Ihrer Fragen ändern. Mit Excel können Sie diese Änderungen mithilfe der Funktion „Suchen und Ersetzen“ vornehmen. Angenommen, Sie entscheiden sich für eine Massenumbenennung Ihrer Variablen. Suchen und Ersetzen können Abhilfe schaffen. Wenn Sie eine auf regulären Ausdrücken basierende Suche und Ersetzung benötigen, können Sie die gewünschte Spalte auswählen, in einen Texteditor kopieren, die Suche und Ersetzung durchführen und die Spalte wieder in die Tabelle einfügen.
- 'Genehmigungen einholen '. Wenn Sie recherchieren, besteht möglicherweise ein Institutional Review Board, das darauf besteht, den Text der Fragen einzusehen. Dies kann eine bequeme Möglichkeit sein, es zu teilen. Ähnliches gilt für Gespräche mit einem Kunden.
- Teamkonsens. Wenn Sie versuchen, eine Gruppe dazu zu bringen, sich auf den Wortlaut oder das Erscheinungsbild einer Frage oder Gruppe zu einigen, können Sie die Tabelle schnell prototypisieren/bearbeiten, importieren und dem Team (per Frage- oder Gruppenvorschau) genau zeigen, was die Benutzer sehen werden . Auf diese Weise können Sie die Genehmigung des Teams einholen, bevor es den Raum verlässt, anstatt Anforderungen dokumentieren, erstellen und bei zukünftigen Besprechungen genehmigen zu müssen.
- Upgrade von anderen Umfrageformaten. Wenn Ihre Umfrage im XML-, Word- oder einem anderen Format vorliegt, können Sie einen Übersetzungsprozess erstellen, um sie diesem Format zuzuordnen. Obwohl Sie auch versuchen könnten, eine Zuordnung zum .lss-Format vorzunehmen, besteht der Vorteil dieses Formats darin, dass Sie keine Fremdschlüsselbeziehungen zwischen Gruppen, Fragen, Unterfragen, Antworten und Standardeinstellungen im Auge behalten müssen.
Einschränkungen
- Diese Funktion funktioniert konstruktionsbedingt nur ordnungsgemäß für Umfragen, die Qcode-Benennung (anstelle von SGQA) verwenden. Bei dieser Funktion wird davon ausgegangen, dass Variablennamen (Fragebezeichner) in der gesamten Umfrage eindeutig sind. Unterfragenamen können wiederholt werden, sofern sie im Rahmen einer bestimmten Frage eindeutig sind.
Dateiformat
Allgemeines
Wir verwenden dieselben Spaltenüberschriften für verschiedene Zwecke. Die ersten 14 Spalten dienen je nach Art der Entität (z. B. Gruppe, Frage, Antwort) unterschiedlichen Zwecken. Die übrigen Spalten sind eine alphabetische Liste der Datenbankfeldnamen für die erweiterten Fragecodes. Nachfolgend finden Sie die Syntax für jeden Entitätstyp
Die ersten 14 Spalten sind:
- id (New in 3.14.0 )
- related_id (New in 3.14.0 )
- class
- type/scale
- Name
- Relevanz
- Text
- Hilfe
- Sprache
- Validierung
- Pflichtfeld
- Andere
- Standard
- gleiche_Standardeinstellung
Globale Parameter der Umfrage
Es gibt eine Zeile pro Parameter in der Umfragetabelle.
- class => 'S'
- name => Datenbankfeldname
- text => Wert
Sprachspezifische Parameter der Umfrage
In der Tabelle „surveys_lingualsettings“ gibt es eine Zeile pro Feld und Sprache. Alle Einträge für eine bestimmte Sprache werden gesammelt, bevor die Einsetzung in diese Tabelle durchgeführt wird.
- class => 'SL'
- name => Datenbankfeldname
- text => Wert
- sprache => Sprache
Gruppen
Eine Gruppenzeile pro Umfragesprache (z. B. gäbe es drei Gruppenzeilen, wenn die Umfrage drei Sprachen umfasst).
- id => Eindeutiger numerischer Bezeichner für die Gruppe, beginnend mit Nummer 1. Verwenden Sie dieselbe ID für weitere Sprachen, die dazu gehören aktuelle Gruppe
- class => 'G'
- name => Gruppenname – der eindeutige Bezeichner für die Gruppe
- relevance => grelevance – die Relevanzgleichung auf Gruppenebene, ohne geschweifte Klammern!N !#text => Beschreibung – die sprachspezifische Beschreibung der Gruppe
- Sprache => Sprache – die Sprache für die Gruppe (z. B. „en“)
Fragetypen
Die verschiedenen Fragetypen, welche derzeit mit LimeSurvey möglich sind, findet man hier: Question types (in Englisch)
Jeder Umfrage muss zumindest eine Gruppe angehören, auch wenn die Fragen nicht in Gruppen unterteilt sein sollen.
Der Hauptbestandteil einer Umfrage sind natürlich die Fragen selber. Diese müssen wie oben erwähnt in Gruppen gepackt sein. Es gibt von technischer Seite her keine Vorgaben (Höchstzahl), wie viele Fragen eine Umfrage oder wie viele Fragen eine Gruppe enthalten darf.
Die Frage beinhaltet die Frage an sich sowie weitere Einstellungen über die Frage.
Zu jeder Frage kann ein (kleiner) Hilfetext verfasst werden und ob die Frage verpflichtend beantwortet werden muss oder nicht. Dies wird jedoch LimeSurvey automatisch tun, falls bei Erstellung oder Bearbeitung der Frage die Option "Pflichtangabe" auf "Ja" gesetzt wird.
Eine Fragenzeile pro Umfragesprache (z. B. wären es drei Fragenzeilen, wenn die Umfrage drei Sprachen hätte). Es wird davon ausgegangen, dass Fragen zu der Gruppe gehören, die ihnen vorangeht.
- id => Eindeutiger numerischer Bezeichner für die Frage, beginnend mit Nummer 1, dieselbe ID für weitere Sprachen verwenden, die zur aktuellen Frage gehören
- class => ' Q'
- type/scale => Typ – der (normalerweise ein Buchstabe) Fragetyp (z. B. „M“ ist Multiple Choice)
- name => Titel – der eindeutiger Fragename (die Wurzel des Qcode-Benennungssystems)
- relevance => Relevanz – die Relevanzgleichung für die Frage
- text => Frage – die Sprache -spezifischer Text der Frage
- help => Hilfe – der sprachspezifische Hilfetext
- Sprache => Sprache – die Sprache für die Gruppe (z. B. „en“)
- validation = > preg – das optionale Validierungskriterium für reguläre Ausdrücke für die Frage
- mandatory => obligatorisch – „Y“, wenn obligatorisch
- other => other – „Y“, wenn die Option „Andere“ verfügbar sein soll (nur für einige Fragetypen)
- default => default – wenn festgelegt, wird dieser Wert in die Standardwerttabelle für diese Frage eingefügt
- same_default => same_default – „Y“ für wahr, in diesem Fall Jeder für die Primärsprache festgelegte Standardwert gilt auch für andere Sprachen
Teilfragen
Eine Unterfragezeile pro Umfragesprache. Es wird davon ausgegangen, dass Unterfragen zur Frage gehören, die ihnen vorangeht.
- id => dieselbe eindeutige numerische Kennung, die für die Fragen verwendet wird. Unterfragen sollten den nächsten verfügbaren Wert verwenden, Frage- und Unterfrage-IDs sollten unterschiedlich sein (z. B. ID 1 für Frage und IDs 2, 3 und 4 für Unterfragen verwenden, die zu Frage 1 gehören, ID der nächsten Frage sollte 5 sein usw.). Verwenden Sie dieselbe Unterfrage-ID für zusätzliche Sprachen, die zu aktuellen Unterfragen gehören.
- class => 'SQ'
- type/scale => scale_id – 0 oder 1, je nach Fragetyp (z. B. Array-Text hat zwei Skalen).
- name => title – der „Name“ der Unterfrage, z. B. derjenige, der für „exclude_all_others
- relevance => relevant“ verwendet wird – (Zukunft), um Relevanz
- text auf Unterfrageebene zu unterstützen => Frage – der sprachspezifische Text der Unterfrage
- help => Hilfe – (Zukunft) zur Unterstützung von Hilfe auf Unterfrageebene
- Sprache => Sprache – die Sprache für die Unterfrage
#validation => preg – (Zukunft) zur Unterstützung der Validierung regulärer Ausdrücke auf Unterfrageebene (z. B. für Adressteile)
- mandatory => obligatorisch – (Zukunft) zur Unterstützung der obligatorischen Unterfrageebene (z. B. nur wenige obligatorische Unterfragen erstellen)
- default => Standard – wenn festgelegt, ist dies der Standardwert für die Unterfrage (in die Standardwerttabelle eingefügt)
- same_default => gleicher_Standard – wenn festgelegt, dann wird der Standardwert für die Primärsprache für alle anderen Sprachen verwendet
Antworten
Eine Antwortzeile pro Umfragesprache (z. B. wären es drei Antwortzeilen, wenn die Umfrage drei Sprachen hätte). Es wird davon ausgegangen, dass die Antworten zu der Frage gehören, die ihnen vorangeht, und in der gewünschten Sortierreihenfolge vorliegen.
- id => dieselbe ID wie die ID der Frage verwenden, zu der sie gehören
- class => 'A'
- type/scale => scale_id – 0 oder 1 (z. B. für Doppelskala)
- name => code – der eindeutige Antwortbezeichner
- relevance => Assessment_value – wenn die Bewertungsoption verwendet wird , das ist der Bewertungswert für die Antwort
- text => Antwort – der sprachspezifische Text der Antwort
- Sprache => Sprache – die Sprache für diese Antwort (z. B. „en“)
Bewertungen
Eine Bewertungszeile pro Umfragesprache (z. B. gäbe es drei Bewertungszeilen, wenn die Umfrage drei Sprachen umfasst). Bewertungen werden am Ende der Datei geschrieben.
- id => eindeutige numerische Kennung für die Bewertung, beginnend mit Nummer 1, dieselbe ID für weitere Sprachen verwenden, die zur aktuellen Bewertung gehören
- related_id => ID der Gruppe zu Zu welcher aktuellen Bewertung gehört
- class => 'AS'
- type/scale => Bewertungsumfang: T-Gesamt, G-Gruppe
- name => Name
- text => Nachricht
- min_num_value => Minimum
- max_num_value => Maximum
- sprache => Sprache – die Sprache für diese Antwort (z. B. „en“)
Umfrage Quoten
Eine Zeile pro Kontingent. Kontingente werden am Ende der Datei geschrieben.
- id => eindeutige numerische Kennung für das Kontingent, beginnend mit Nummer 1
- class => 'QTA'
- name => Kontingentname
- obligatorisch => limit
- other => Quotenaktion
- default => aktiv
- same_default => Autoload-URL
Quoten-Spracheinstellungen
Eine Quotenzeile pro Umfragesprache. Es wird davon ausgegangen, dass die Einstellungen der Kontingentsprache zu der ihnen vorangehenden Quote gehören.
- id => eindeutige numerische Kennung für die Einstellungen der Kontingentsprache, beginnend mit Nummer 1. Jede Zeile für verschiedene Umfragesprachen sollte unterschiedliche IDs haben
- related_id => Kontingent-ID des Kontingents, zu dem diese Einstellung gehört
- class => 'QTALS'
- relevance => message
- text => URL
- help => URL-Beschreibung
#Sprache => Sprache – die Sprache für dieses Kontingent (z. B. „en“)
Quotenmitglieder
Eine Zeile pro Quotenmitglied, keine Sprachabhängigkeit. Die Zeile mit den Quotenmitgliedern sollte unmittelbar nach der Frage platziert werden, auf die sie sich bezieht. Es wird davon ausgegangen, dass Quotenmitglieder zu der ihnen vorangehenden Frage gehören.
- id => eindeutige numerische Kennung für die Quotenmitglieder, beginnend mit Nummer 1
- related_id => Quoten-ID der Quote, zu der dieses Mitglied gehört
- class => 'QTAM'
- name => Antwortcode
Bedingungen
Eine Zeile pro Bedingung, nicht sprachabhängig. Die Bedingungszeile sollte unmittelbar nach der Frage platziert werden, auf die sie sich bezieht. Es wird davon ausgegangen, dass Bedingungen zu der Frage gehören, die ihnen vorausgeht.
- id => eindeutige numerische Kennung für die Bedingung, beginnend mit Nummer 1.
- related_id => Fragen-ID der zugehörigen Frage, falls zutreffend
- Klasse => 'C'
- Typ/Skala => Szenario
- Name => Antwortfeldname
- Relevanz => Vergleichsoperator
- Text => erwartete Antwort