inf-schule | Interaktive Elemente

Umfrage

Das interaktive Element ermöglicht es, vorgefertigte Umfragen im Schulbuch einzubinden und anzubieten. Der Lehrer kann eine solche Umfrage per Button starten, die Schüler nehmen anschließend über ein Codewort an der Umfrage teil. Danach kann der Lehrer über das gleiche Codewort in Verbindung mit einem Admin-Passwort die Ergebnisse abfragen.

Das Modul einbinden

Um die interaktiven Elemente nutzen zu können, muss die Einbindung über den Meta-Tag features erfolgen:

----
Features: umfrage
----

Umfrage als Autor vorbereiten

Ausführliche Dokumentation zur Konfiguration des Elementes

Überblick

Das Attribut dataconfig erwartet einen JSON-String mit einem Array von Fragenobjekten. Jede Frage hat mindestens die Felder type und question. Je nach Fragetyp sind weitere Felder erforderlich oder optional.

<umfrage-erstellen dataconfig='[
            { "type": "text", "question": "Wie heißt du?" },
            { "type": "number", "question": "Wie alt bist du?", "min": 5, "max": 99 },
            { "type": "select", "question": "Lieblingsjahreszeit?", "answers": ["Frühling", "Sommer", "Herbst", "Winter"] },
            { "type": "checkbox", "question": "Welche Sprachen kennst du?", "answers": ["Python", "JavaScript", "Java"] }
            ]'></umfrage-erstellen>

Gemeinsame Felder

Diese Felder gelten für jeden Fragetyp:

Feld	Typ	Pflicht	Beschreibung
`type`	`string`	Pflicht	Fragetyp: `text`, `number`, `select` oder `checkbox`
`question`	`string`	Pflicht	Der angezeigte Fragetext

Fragetypen

text – Freitext

Der Teilnehmer gibt eine beliebige Texteingabe ein. Keine zusätzlichen Felder erforderlich.

number – Zahl

Der Teilnehmer gibt eine Zahl ein. Eingaben außerhalb des Bereichs werden abgelehnt.

Feld	Typ	Pflicht	Beschreibung
`min`	`number`	Optional	kleinster erlaubter Wert
`max`	`number`	Optional	größter erlaubter Wert

select – Einfachauswahl (Radio)

Der Teilnehmer wählt genau eine Antwort aus einer Liste.

Feld	Typ	Pflicht	Beschreibung
`answers`	`string[]`	Pflicht	Array mit den auswählbaren Antwortoptionen

checkbox – Mehrfachauswahl

Der Teilnehmer kann beliebig viele Antworten auswählen.

Feld	Typ	Pflicht	Beschreibung
`answers`	`string[]`	Pflicht	Array mit den auswählbaren Antwortoptionen

Hinweise

Der JSON-String muss gültig sein. Ungültige Konfigurationen werden ignoriert – es werden dann keine Fragen angezeigt.
Die Reihenfolge der Fragen im Array bestimmt die Anzeigereihenfolge.
Bei select und checkbox muss answers mindestens einen Eintrag enthalten.
Bei number können min und max unabhängig voneinander weggelassen werden.
Leere oder nicht ausgefüllte Felder werden beim Speichern als leer übermittelt und in der Auswertung nicht gezählt.

too long, didn't read - Hilfs Tool zur schnellen Konfiguration des Elementes

Dieses Hilf-Tool erstellt die dataconfig für das HTML-Element. Hier werden Fragen und ggf. mögliche Antworten für die Umfrage festgelegt.

Beispiel: Umfrage im Schulbuch einbinden

<umfrage-erstellen dataconfig='[
  { "type": "text", "question": "Wie heißt du?" },
  { "type": "number", "question": "Wie alt bist du?", "min": 5, "max": 99 },
  { "type": "select", "question": "Lieblingsjahreszeit?", "answers": ["Frühling", "Sommer", "Herbst", "Winter"] },
  { "type": "checkbox", "question": "Welche Sprachen kennst du?", "answers": ["Python", "JavaScript", "Java"] }
]'></umfrage-erstellen>

Beispiel: Umfrage durchführen

Schüler können über das Codewort an der Umfrage teilnehmen, dies können sie an die URL anhängen, auf der Toolübersichts-Seite oder im Tool Umfrage eingeben. Nach dem Start einer Umfrage durch den Lehrer wird der Link als auch ein QR-Code für den direkten Zugriff angeboten. Alternativ kann auch an der entsprechenden Stellen im Schulbuch eine Möglichkeit für die Durchführung geschaffen werden.

<umfrage-durchfuehren></umfrage-durchfuehren>

Beispiel: Umfrageergebnisse

Er ist nicht empfohlen, dieses Element in Kapiteln einzubinden. Der Weg über das Tool bzw. den Admin-Link sollte ausreichen, da Schüler mit dem Element nichts machen können.

Lehrer können über den Admin-Link auf die Umfrageergebnisse zugreifen. Alternativ auch über das Tool Umfrage, dort findet der Lehrer eine Eingabemöglichkeit für Codewort und Admin-Passwort. Alternativ kann auch an der entsprechenden Stellen im Schulbuch eine Möglichkeit für die Abfrage geschaffen werden.

<umfrage-abfragen></umfrage-abfragen>