Dokumentation

Formulare

In der Benutzeroberfläche "Meine Formulare" wird Ihre aktuelle Liste von Formularen angezeigt. Jedes Formular wird als Block dargestellt, der den Namen, eine kurze Liste von Einstellungen und eine Beschreibung enthält.

Durch Klicken auf einen Formularblock gelangen Sie zur Bearbeitungsoberfläche für dieses spezifische Formular.

Formularübersicht

Auf der Registerkarte "Details" des Formulars wird eine kurze Zusammenfassung der Formulareinstellungen angezeigt, einschließlich der Anzahl der Fragen, der Anzahl der ausgefüllten Benutzerantworten, des aktuellen Formularstatus und mehr.
Außerdem befindet sich auf dieser Registerkarte eine Schaltfläche zum Aktivieren/Deaktivieren des Formulars (Veröffentlichen/Aus der Veröffentlichung nehmen).

Fragen

Auf der Registerkarte "Fragen" des Formulars wird die Liste der bereits hinzugefügten Fragen angezeigt.
Jede Frage wird als Block dargestellt, der den Titel, eine kurze Liste von Einstellungen und die Schaltflächen Bearbeiten und Löschen enthält.
Wenn die Einstellung "Auf Seiten aufteilen" auf Für mehrere Fragen gesetzt ist, ist die Schaltfläche "Seite hinzufügen" verfügbar, um Seiten hinzuzufügen und Fragen darauf zu verteilen.
Links von jedem Frageblock befindet sich ein "Anker", der so aussieht: . Durch Klicken und Halten mit der Maus kann man Fragen neu anordnen oder zwischen Seiten verschieben.
Um eine neue Frage hinzuzufügen, klicken Sie oben im Formular auf die Schaltfläche "Frage hinzufügen". Danach öffnet sich das Konfigurationspanel für die Frage, in dem Sie die Frage einrichten, eine Beschreibung hinzufügen, Antwortoptionen festlegen und mehr tun können.

Neben der manuellen Erstellung gibt es weitere Workflows zum Aufbau des Fragenpools:
Fragenimport — über eine eigene Importoberfläche können Sie Fragen aus einer JSON-Datei hochladen oder JSON manuell einfügen. Beim Import lassen sich auch gemeinsame Parameter wie Schwierigkeitsgrad und Punkte festlegen, sofern diese für das aktuelle Formular gelten.
AskiumAI — der KI-basierte Fragengenerator kann anhand von Thema, Schwierigkeitsgrad und weiteren Parametern automatisch einen Satz von Fragen mit Antwortoptionen erstellen. Die generierten Fragen werden dem aktuellen Formular hinzugefügt.

Auf der Seite Fragenimport gibt es zwei Hilfsaktionen: "Beispiel für das erwartete JSON-Format" und "Prompt-Beispiel für die KI-Generierung". Die zweite öffnet eine fertige Prompt-Vorlage, in die Sie Thema, Anzahl der Fragen, Anzahl der Antwortoptionen, Schwierigkeitsgrad und Sprache der Generierung eintragen und anschließend zur Verwendung in einem externen KI-Dienst kopieren können.

Der Import unterstützt nicht nur das Hochladen einer lokalen JSON-Datei, sondern auch das manuelle Einfügen von raw JSON. Wenn das JSON von einer KI erzeugt wurde, können Sie entweder reines JSON oder den vollständigen json code block aus der Modellantwort einfügen. Nach dem Start läuft der Import als Hintergrundaufgabe: Die Seite zeigt den Verarbeitungsstatus an und öffnet nach erfolgreichem Abschluss die Liste der importierten Fragen.

Die Importoberfläche ist nur für Formulare vom Typ Quiz und Prüfung sowie nur in den Tarifen Plus oder Pro verfügbar. Wenn im Formular ein Punktesystem aktiviert ist, kann bei einem normalen Import ein gemeinsamer Punktewert manuell festgelegt werden; bei einer Prüfung mit aktivierter Schwierigkeitsstufe werden die Punkte für importierte Fragen automatisch anhand des gewählten Schwierigkeitsgrads vergeben.

Fragekonfiguration

Dem Benutzer stehen eine Reihe von Konfigurationsoptionen zur Verfügung, um die Frage einzurichten und zu bestimmen, wie die Antwort gegeben wird und welchen Einfluss sie auf das Ergebnis hat.
Bitte beachten Sie, dass einige Einstellungen von anderen abhängen und sich gegenseitig ausschließen können.

Vollständige Liste der Frageeinstellungen:

• Titel — Der Titel der Frage, der nur Ihnen in der Benutzeroberfläche und in der Liste der Fragen des Formulars oder der Prüfungsaufgabe angezeigt wird. Es wird empfohlen, ihn kurz (2-3 Wörter) zu halten. Pflichtfeld.
• Beschreibung — Die Beschreibung der Frage, die den Nutzern im Formular, Test oder in der Prüfung angezeigt wird. Pflichtfeld.
  Für Benutzer mit den Plänen "Plus" oder "Pro" ist ein erweiterter Editor verfügbar, mit dem Text mit komplexer Formatierung, z. B. Schriftgröße, Farbe, Listen, Bilder, Videos, Codeblöcke oder mathematische Formeln hinzugefügt werden können.
• Überspringbar — Einstellung, die bestimmt, ob der Benutzer die Frage überspringen oder sie beantworten muss.
  Wenn die Option "In Seiten unterteilen" auf "Eine Frage pro Seite" gesetzt ist, wird die Schaltfläche "Überspringen" verfügbar.
• Antworttyp — die Haupteinstellung, die festlegt, wie der Benutzer auf die Frage antwortet. Folgende Typen sind verfügbar:
  • Auswahlliste — der Benutzer wählt eine oder mehrere Optionen. Sie können eigene Antworten zulassen oder richtige/falsche Antworten festlegen.
  • Eingabefeld — der Benutzer gibt seine Antwort in ein Feld ein. Eigenschaften werden weiter unten konfiguriert.
  • Datumsauswahl — der Benutzer wählt ein Datum mit einem Kalender-Widget.
  • Bereich — der Benutzer stellt einen Wert mit einem Schieberegler ein. Die Änderung erfolgt sofort.
  • Bewertung — eine Symbolreihe (z. B. Sterne), in der durch Klicken ein Wert festgelegt wird.
  • Personenbezogene Daten — spezieller Typ zum Erfassen von Name, Nachname und E-Mail-Adresse. Diese Daten helfen dabei, sich in den Ergebnislisten zurechtzufinden und einzelne Nutzer anhand der in diesen Feldern eingegebenen Informationen zu identifizieren.
• Typ der Auswahlliste — Eine Untereinstellung der Auswahlliste, die bestimmt, wie viele der vorgeschlagenen Antworten der Benutzer auswählen kann. Es gibt 2 Typen:
  • Liste mit einer Option — Der Benutzer kann nur eine Antwort auswählen.
  • Liste mit mehreren Optionen — Der Benutzer kann eine oder mehrere Antworten auswählen.
• Richtigkeit — Eine Untereinstellung der Auswahlliste, die festlegt, ob Antworten in richtige und falsche unterteilt werden.
• Eigene Antwort — Eine Untereinstellung der Auswahlliste, die festlegt, ob der Benutzer eine eigene Antwort eingeben kann. Nicht verfügbar, wenn "Richtigkeit" aktiviert ist.
• Schwierigkeitsgrad — Eine Untereinstellung der Auswahlliste, wenn der Formulartyp "Prüfung" ist und die Option "Schwierigkeitsstufe" aktiviert ist. Pflichtfeld.
• Antwortoptionen — Eine Untereinstellung der Auswahlliste, die eine Liste der für den Benutzer verfügbaren Antworten enthält. Um eine neue Antwortoption hinzuzufügen, klicken Sie auf "Antwort hinzufügen", und sie wird am Ende der Liste hinzugefügt.
  Jede Antwort kann verschoben oder gelöscht werden.
  Wenn "Richtigkeit" aktiviert ist, wird für jede Antwortoption eine "Richtig"-Markierung verfügbar.
• Eingabetyp — Eine Untereinstellung des Eingabefelds, die die Eigenschaften des Feldes und die darin zulässigen Datentypen bestimmt. Es gibt 5 Typen:
  • Eine Zeile — Einfaches Textfeld ohne Zeilenumbruch.
  • Mehrzeilige Eingabe — Ein Textfeld, in dem Zeilenumbrüche möglich sind.
  • Zahl — Ein Zahlenfeld, in das nur ganze Zahlen eingegeben werden können.
  • Dezimalzahl — Ein Zahlenfeld, das ganze oder dezimale Zahlen zulässt.
  • E-Mail — Ein Feld zur Eingabe einer E-Mail-Adresse.
• Art der personenbezogenen Daten — eine Untereinstellung von Personenbezogene Daten, die festlegt, welche konkreten Daten in diesem Feld erwartet werden:
  • Vorname
  • Nachname
  • Email
• Min. Länge — Eine Untereinstellung des Eingabefelds, wenn der Typ "Eine Zeile" oder "Mehrzeilige Eingabe" ist. Gibt die minimale Zeichenanzahl an. Ganze Zahl ≥ 0.
• Max. Länge — Eine Untereinstellung des Eingabefelds, wenn der Typ "Eine Zeile" oder "Mehrzeilige Eingabe" ist. Gibt die maximale Zeichenanzahl an. Ganze Zahl ≥ 0.
• Min — Eine Untereinstellung des Eingabefelds, wenn der Typ "Zahl" oder "Dezimalzahl" ist. Legt den minimal zulässigen Wert fest.
• Max — Eine Untereinstellung des Eingabefelds, wenn der Typ "Zahl" oder "Dezimalzahl" ist. Legt den maximal zulässigen Wert fest.
• Schritt — Eine Untereinstellung des Eingabefelds, wenn der Typ "Zahl" oder "Dezimalzahl" ist. Gibt an, in welchen Schritten Werte eingegeben werden können.

Besonderheiten der Prüfung

Im Formulartyp "Prüfung" ist der Fragetyp immer "Auswahlliste" und kann nicht geändert werden. Zudem kann "Richtigkeit" nicht deaktiviert und "Eigene Antwort" nicht aktiviert werden.

Fragenimport

Die Importseite kann im Fragenbereich des aktuellen Formulars geöffnet werden. Sie ist nur für Formulare vom Typ Quiz und Prüfung und nur in den Tarifen Plus oder Pro verfügbar. In der Oberfläche können Sie eine gemeinsame Schwierigkeitsstufe für alle importierten Fragen auswählen und, falls das aktuelle Formular ein Bewertungssystem außerhalb des Prüfungs-Schwierigkeitsmodus verwendet, zusätzlich einen gemeinsamen Punktewert manuell festlegen.

In die Seite sind zwei Hilfsaktionen eingebaut: "Beispiel für das erwartete JSON-Format" und "Prompt-Beispiel für die Generierung per AI". Die erste zeigt den genauen JSON-Vertrag mit den Schlüsseln question_short_title, question, options und correct_index. Die zweite öffnet eine fertige Prompt-Vorlage, in der Sie Thema, Anzahl der Fragen, Anzahl der Antwortoptionen, Schwierigkeit und Sprache eintragen und anschließend zur Nutzung in einem externen AI-Dienst kopieren können.

{
  "questions": [
    {
      "question_short_title": "HTTP status codes",
      "question": "Which status code means that the request was successful?",
      "options": [
        "200 OK",
        "301 Moved Permanently",
        "404 Not Found",
        "500 Internal Server Error"
      ],
      "correct_index": 0
    }
  ]
}

Fragen können auf zwei Arten importiert werden: durch Hochladen einer lokalen JSON-Datei oder durch manuelles Einfügen von raw JSON. Wurde der Inhalt von einem AI-Modell erzeugt, akzeptiert die Seite auch den vollständigen json code block aus der Antwort. Nach dem Absenden läuft der Import als Hintergrundaufgabe: Die Seite prüft den Aufgabenstatus automatisch und öffnet nach erfolgreichem Abschluss die Liste der importierten Fragen zur Kontrolle und weiteren Bearbeitung.

Wenn das Formular eine Prüfung mit aktiviertem Schwierigkeitsstufen-System ist, werden die Punkte für importierte Fragen automatisch entsprechend der gewählten Schwierigkeitsstufe vergeben. Dadurch bleibt derselbe Importablauf sowohl mit manuell bewerteten Quizzen als auch mit nach Schwierigkeit ausbalancierten Prüfungen kompatibel.

AskiumAI: Fragen-Generator

AskiumAI ist eine eigene Seite zur Generierung von Fragen direkt innerhalb des aktuellen Formulars. Die Oberfläche zeigt Ihr aktuelles AI-Token-Guthaben an und hilft dabei, den Fragenpool zu füllen, ohne die Anwendung zu verlassen. Die Fragengenerierung ist nur für Formulare vom Typ Quiz und Prüfung verfügbar; bei anderen Formulartypen zeigt die Oberfläche eine Warnung an und erlaubt keinen Start der Aufgabe.

Auf der Generator-Seite definieren Sie Fachbereich / Thema, Schwierigkeit, Anzahl der Fragen und Anzahl der Antwortoptionen. Falls das Formular ein Bewertungssystem außerhalb des Prüfungs-Schwierigkeitsmodus verwendet, können Sie zusätzlich die Punkte für eine richtige Antwort festlegen. Die Sprache der generierten Fragen richtet sich nach der für das Formular konfigurierten Lokalisierung und nicht nach der aktuellen Sprache der Oberfläche.

Nach dem Absenden prüft AskiumAI zunächst das Thema und startet anschließend die Generierung als Hintergrundaufgabe. Die Seite zeigt Zwischenzustände an, fragt den Aufgabenstatus automatisch ab und öffnet nach erfolgreichem Abschluss die Liste der generierten Fragen. Generierte Fragen und Antwortoptionen sollten vor der Veröffentlichung immer manuell geprüft werden, da AI weiterhin Fehler machen kann.

Nach Abschluss der Generierung können die entstandenen Fragen überprüft, bearbeitet, teilweise entfernt oder gezielt beibehalten werden, bevor Sie mit dem Formular weiterarbeiten.

Schwierigkeitsstufeneinstellungen

Wenn der Formular-Typ "Examen" gewählt und die Einstellung "Schwierigkeitsstufen-System" aktiviert ist, wird der Tab "Schwierigkeitsstufeneinstellungen" verfügbar.
In diesem Tab können Sie die durchschnittliche Schwierigkeit eines Prüfungsbogens festlegen.
Dazu müssen Sie angeben, wie viele Fragen welcher Schwierigkeit in jedem Prüfungsbogen enthalten sein sollen. Insgesamt gibt es 5 Schwierigkeitsstufen:

• Sehr einfach
• Einfach
• Mittel
• Schwierig
• Sehr schwierig

Während der automatischen Generierung von Prüfungsbögen wird die von Ihnen festgelegte Anzahl von Fragen der jeweiligen Schwierigkeitsstufe zufällig ausgewählt. Dadurch bleibt die Gesamtschwierigkeit der Bögen ausgewogen, während jeder Prüfungsbogen einzigartig bleibt.

Sie können selbst bestimmen, welche Schwierigkeitsstufen verwendet werden sollen und welche nicht. Es ist nicht erforderlich, das gesamte Spektrum zu nutzen. Üblicherweise werden 2–3 Stufen verwendet, zum Beispiel von Einfach bis Schwierig.

Falls die Einstellung "Punktesystem" aktiviert ist, können Sie in diesem Tab auch festlegen, wie viele Punkte für jede Schwierigkeitsstufe vergeben werden. Denn wenn "Punktesystem" und "Schwierigkeitsstufen-System" kombiniert werden, können die Punkte nicht mehr individuell für jede Frage festgelegt werden, sondern nur noch für die jeweiligen Schwierigkeitsstufen.

Einladungslinks

Dieser Tab ist verfügbar, wenn die Einstellung "Zugang – Nur auf Einladung" in den Formulareinstellungen aktiviert ist.

Im Tab "Einladungslinks" wird standardmäßig die aktuelle Liste der aktiven Einladungslinks angezeigt.
Jeder Link wird als Block mit folgenden Informationen dargestellt:

• Vollständige URL des Links
• Vor- und Nachname des eingeladenen Nutzers (falls angegeben)
• E-Mail-Adresse des eingeladenen Nutzers (falls angegeben)
• Anzahl der Fragen im Prüfungsbogen, wenn der Formular-Typ "Examen" ist

Zusätzlich enthält jeder Block einen Schalter zum Aktivieren/Deaktivieren des Links sowie eine Reihe von Schaltflächen zur Verwaltung des Links:

• Schaltfläche zum Versenden der Einladung per E-Mail (falls die E-Mail-Adresse im Link angegeben ist). Nicht verfügbar, wenn der Link bereits versendet, verwendet oder deaktiviert wurde.
• Schaltfläche zum Kopieren der URL in die Zwischenablage. Nicht verfügbar, wenn der Link deaktiviert wurde.
• Schaltfläche "Teilen", um den Link in sozialen Netzwerken, Messengern oder per E-Mail zu versenden. Nicht verfügbar, wenn der Link bereits verwendet oder deaktiviert wurde.
• Schaltfläche zur Generierung eines QR-Codes für den aktuellen Link. Nicht verfügbar, wenn der Link deaktiviert wurde.
• Schaltfläche zum Bearbeiten des Links. Nicht verfügbar, wenn der Link bereits verwendet wurde.
• Schaltfläche zum Löschen des Links. Nicht verfügbar, wenn der Link bereits verwendet wurde.
• Schaltfläche zum Aufrufen der Ergebnisse des Nutzers. Nur verfügbar, wenn der Link bereits verwendet wurde.

Durch Klicken auf einen Einladungslink gelangen Sie zur Verwaltung dieses speziellen Links.

Um einen neuen Einladungslink zu erstellen, klicken Sie auf "Hinzufügen". Anschließend gelangen Sie zur Oberfläche zur Erstellung eines neuen Einladungslinks.

Erstellung eines Einladungslinks

Beim Erstellen eines neuen Einladungslinks stehen folgende Felder zur Verfügung:

• Vorname
• Nachname
• E-Mail

Keines dieser Felder ist obligatorisch. Alle Felder können leer bleiben, aber es wird empfohlen, diese Informationen auszufüllen, da sonst die Identifizierung der Ergebnisse später schwierig sein kann.

Beim Erstellen eines Einladungslinks wird jedem Link ein einzigartiger Schlüssel zugewiesen, der der URL des Links hinzugefügt wird. Falls der Einladungslink anonym bleibt (ohne Vorname, Nachname und E-Mail), ist der einzige Identifikator der einzigartige Schlüssel.

Wenn Ihre Nutzer (Kunden/Mitarbeiter/Studenten/...) regelmäßige Teilnehmer sind, haben Sie die Möglichkeit, deren Daten in der Kontaktliste zu speichern, indem Sie auf "Kontakt speichern" klicken. Sie können auch Daten aus dieser Liste importieren, indem Sie auf "Importieren" klicken und den gewünschten Kontakt aus der Liste auswählen.

Wenn der aktuelle Formular-Typ "Examen" ist, gelangen Sie nach der Erstellung eines Einladungslinks direkt zur Verwaltung des Links, um den Prüfungsbogen mit Fragen zu füllen, da er zunächst leer ist.

Bearbeitung eines Einladungslinks

Die Oberfläche zur Bearbeitung eines Einladungslinks ähnelt der Erstellungsschnittstelle, enthält jedoch zusätzlich einen Schalter für den Status des Links (aktiviert/deaktiviert) und zeigt den einzigartigen Schlüssel an.

Prüfungsbogen

Wenn der Formular-Typ "Examen" gewählt ist, steht im Bearbeitungsbereich des Einladungslinks auch ein zweiter Abschnitt zur Verfügung, der für die Verwaltung des Prüfungsbogens und das Hinzufügen von Fragen vorgesehen ist.
Ein Prüfungsbogen kann auf zwei Arten mit Fragen gefüllt werden:

• Durch Klicken auf die Schaltfläche "Prüfungsbogen generieren" – der Bogen wird sofort mit Fragen gefüllt, basierend auf den Schwierigkeitsstufeneinstellungen (falls die Funktion "Schwierigkeitsstufen-System" aktiviert ist, die Schwierigkeitsstufeneinstellungen konfiguriert sind und das Formular eine ausreichende Anzahl an Fragen der jeweiligen Schwierigkeitsstufen enthält).
• Durch manuelles Hinzufügen von Fragen, indem Sie auf "Frage hinzufügen" klicken und die gewünschten Fragen aus der Liste auswählen (es können mehrere auf einmal hinzugefügt werden).

In einem bereits gefüllten Prüfungsbogen können die Fragen durch Ziehen des Ankers neu angeordnet und durch Drücken der entsprechenden Löschen-Schaltfläche entfernt werden.

Beim Formular-Typ "Examen" kann ein Einladungslink nicht aktiviert werden, wenn im Prüfungsbogen keine Fragen enthalten sind.

Kontaktliste

Dieser Tab ist verfügbar, wenn die Einstellung "Zugang – Nur auf Einladung" in den Formulareinstellungen aktiviert ist.

Hier wird die Kontaktliste Ihrer Nutzer (Kunden/Mitarbeiter/Studenten/...) angezeigt. Diese Liste dient dazu, später die Daten der Nutzer (Vorname, Nachname und E-Mail) in Einladungslinks zu importieren, um deren Erstellung zu erleichtern.

Um einen neuen Kontakt hinzuzufügen, klicken Sie auf "Hinzufügen". Danach gelangen Sie zur Oberfläche zur Erstellung eines neuen Kontakts.

Jeder Kontakt enthält drei Felder:

• Vorname
• Nachname
• E-Mail

Um einen Kontakt zu speichern, müssen alle Felder ausgefüllt sein. Zudem ist zu beachten, dass eine E-Mail-Adresse in der Kontaktliste nicht mehrfach vorkommen kann.

Ergebnisse

In diesem Tab wird die Liste der Ergebnisse der ausgefüllten Formulare durch Nutzer angezeigt. Jedes Ergebnis wird als Block mit folgenden Informationen dargestellt:

• Schlüssel – Einzigartiger Schlüssel jedes Ergebnisses;
• Status des Ergebnisses: In Bearbeitung oder Abgeschlossen;
• Datum und Uhrzeit des Abschlusses der Formularausfüllung;
• Vor- und Nachname des Nutzers, falls in den Formulareinstellungen "Zugang – Nur auf Einladung" aktiviert ist und die Einladungslinks Vor- und Nachnamen des Nutzers enthalten;
• E-Mail des Nutzers, falls in den Formulareinstellungen "Zugang – Nur auf Einladung" aktiviert ist und die Einladungslinks die E-Mail des Nutzers enthalten;
• Punkte, die der Nutzer für dieses Ergebnis erhalten hat, falls die Funktion "Punktesystem" aktiviert ist;
• Prozentsatz % der richtigen Antworten, falls der Formular-Typ "Quiz" oder "Examen" ist.

Durch Klicken auf einen Ergebnisblock gelangen Sie zur Detailansicht des aktuellen Ergebnisses:

• Allgemeine Übersicht;
• Protokoll unerwünschter Aktionen (falls die Funktion "Aktionsüberwachung" aktiviert wurde);
• Eine vollständige Liste der Antworten auf die Fragen des Formulars mit Angabe der Korrektheit der Antworten (falls zutreffend).

Analytik

Im Tab Analytik wird eine allgemeine Zusammenfassung aller Ergebnisse während der gesamten Existenz des aktuellen Formulars angezeigt.

Hier sind die folgenden Informationen enthalten:

• Ausfüllungsdiagramme – Diagramme, die die Dynamik der Formularausfüllung durch Benutzer zeigen:
  • Tägliches Diagramm – zeigt, wie oft das Formular pro Tag in den letzten 30 Tagen ausgefüllt wurde.
  • Monatliches Diagramm – zeigt, wie oft das Formular pro Monat in den letzten 12 Monaten ausgefüllt wurde.
• Ergebnisstatistik – zusammengefasste statistische Daten aller Ergebnisse:
  • Gesamtanzahl der Ergebnisse
  • Gesamtpunktzahl des Formulars
  • Durchschnittliche Punktzahl der Benutzer
  • Höchste erreichte Punktzahl
  • Niedrigste erreichte Punktzahl
  • Durchschnittlicher Prozentsatz richtiger Antworten
  • Höchster Prozentsatz richtiger Antworten
  • Niedrigster Prozentsatz richtiger Antworten
• Fragenstatistik – zusammengefasste statistische Daten für jede einzelne Frage über die gesamte Zeit hinweg.
  Falls es sich um eine Frage mit Antwortoptionen handelt:
  • Anzahl und relativer Prozentsatz der übersprungenen Fragen;
  • Anzahl und relativer Prozentsatz der richtigen Antworten auf die Frage;
  • Vergleichende statistische Tabelle für jede Antwortoption;
  • Vergleichendes Diagramm für jede Antwortoption;
  
  Falls es sich um eine Frage mit numerischer Eingabe handelt:
  • Anzahl und relativer Prozentsatz der übersprungenen Fragen;
  • Durchschnittlicher Antwortwert;
  • Höchster Antwortwert;
  • Niedrigster Antwortwert;
  
  Falls es sich um eine Frage mit Texteingabe oder Datum handelt, wird eine vollständige Liste der Antworten angezeigt.

Die Analytik kann außerdem nach PDF und Excel exportiert werden. Der Export wird im Hintergrund vorbereitet, danach steht die erzeugte Datei zum Download bereit.

Branding und Stilgestaltung

Auf dieser Registerkarte können Sie den visuellen Stil Ihres Formulars in einer Echtzeit-Vorschau konfigurieren. Neben den grundlegenden Farb- und Schrift-Einstellungen umfasst der Branding-Bereich jetzt auch Einstellungen für den Fortschrittsbalken sowie Branding-Presets.

• Seitenhintergrundfarbe, Textfarbe und Hauptschriftart
• Header-Hintergrund, Titel, Titelschriftart, Logo und die Möglichkeit, den Header vollständig auszublenden
• Farbe des Fortschrittsbalken-Hintergrunds, Fortschrittsfarbe und Höhe der Leiste
• Button-Farben, Hover-Farben, Schriftart des Button-Textes, Innenabstände und Button-Form
• Gestaltung des Seitentitel-Blocks, Timer-Farben, Stil der Antwortoptionen und Ergebnis-Icons

Wenn das Formular einen Fortschrittsbalken verwendet, können Sie ihn hier anpassen. Wenn er gar nicht angezeigt werden soll, kann er in den Haupteinstellungen des Formulars vollständig deaktiviert werden.

Außerdem können Sie das aktuelle Styling als Branding-Preset speichern und später ein vorhandenes Preset laden und auf ein anderes Formular anwenden. Das ist nützlich, wenn derselbe visuelle Stil in mehreren Formularen wiederverwendet werden soll.

Alle Branding-Änderungen werden sofort in der Live-Vorschau angezeigt.

Integration externer Dienste

Die Anwendung unterstützt zwei Hauptszenarien für Integrationen: Ergebnis-Webhooks und LMS / LTI-Integrationen.

Ergebnis-Webhooks

Jedes Formular besitzt einen eigenen Tab Webhooks, in dem der automatische Versand von Ergebnissen nach Abschluss des Formulars konfiguriert werden kann.

In Askium funktioniert der Webhook nach dem Schema "Formular beendet -> Ergebnis berechnet -> Nutzlast automatisch an Ihre URL gesendet".

• Status — aktiviert oder deaktiviert den Webhook-Versand;
• URL address — vollständige URL Ihres Endpunkts;
• Format — JSON oder XML;
• Authorization — fügt einen zusätzlichen HTTP-Header hinzu;
• Header — Name des Headers, z. B. Authorization;
• Value (Token) — Wert des Headers, z. B. Bearer your-secret-token.

Die Webhook-Nutzlast enthält die Bereiche form, result, score, user und answers. Bei Fragen mit erweitertem HTML-Editor wird statt des Roh-HTML der Wert advanced_html gesendet.

{
  "form": {
    "id": "frm-php-exam",
    "name": "PHP Certification Exam",
    "type": "exam"
  },
  "result": {
    "id": "res-8f2d1a",
    "started_at": "2026-03-01 10:00:00",
    "finished_at": "2026-03-01 10:42:15"
  },
  "score": {
    "max_points": 50,
    "total_points": 42,
    "percent": 84
  },
  "user": {
    "link_id": "link-abc123",
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com"
  },
  "answers": [
    {
      "question": {
        "id": "q-http-001",
        "title": "HTTP code",
        "text": "Which status code means success?"
      },
      "answer": "200 OK",
      "correct": true
    },
    {
      "question": {
        "id": "q-rich-002",
        "title": "Rich text question",
        "text": "advanced_html"
      },
      "answer": "Custom answer",
      "correct": false
    }
  ]
}

<result>
  <form>
    <id>frm-php-exam</id>
    <name>PHP Certification Exam</name>
    <type>exam</type>
  </form>
  <details>
    <id>res-8f2d1a</id>
    <started_at>2026-03-01 10:00:00</started_at>
    <finished_at>2026-03-01 10:42:15</finished_at>
  </details>
  <score>
    <max_points>50</max_points>
    <total_points>42</total_points>
    <percent>84</percent>
  </score>
  <user>
    <link_id>link-abc123</link_id>
    <first_name>John</first_name>
    <last_name>Doe</last_name>
    <email>john.doe@example.com</email>
  </user>
  <answers>
    <answer>
      <question>
        <id>q-http-001</id>
        <title>HTTP code</title>
        <text>Which status code means success?</text>
      </question>
      <answer_text>200 OK</answer_text>
      <correct>true</correct>
    </answer>
  </answers>
</result>

LMS / LTI-Integrationen

Der LMS / LTI-Workflow besteht aus zwei getrennten Schritten: Zuerst wird im Benutzermenü eine LMS-Integration als gemeinsame Verbindung gespeichert, danach wird ein bestimmtes Formular über den Bildschirm Integrationsverknüpfungen an diese Integration gebunden.

Die Integration wird also nicht „im Formular“ erstellt, sondern einmal konfiguriert und danach für mehrere Formulare wiederverwendet.

• Für LTI 1.0 / 1.1 werden OAuth Consumer Key und OAuth Shared Key angegeben;
• Für LTI 1.3 werden Platform ID / iss, Client ID, OIDC login initiation URL, Access token URL und JWKS endpoint URL angegeben.

Die Verknüpfung ist für Quiz und Prüfung verfügbar, nicht jedoch für Fragebogen, und erfordert einen Tarif oberhalb von Basic.

API

Die Anwendung enthält einen eigenen Bereich für API-Einstellungen, der für die sichere Arbeit mit externen Systemen und für Automatisierung über Ihren privaten API-Schlüssel vorgesehen ist.

• API-Zugriff aktivieren oder deaktivieren;
• neuen privaten API-Schlüssel generieren;
• aktuellen Schlüssel kopieren;
• zusätzliche IP-Beschränkung für die API aktivieren;
• eine einzige erlaubte IP-Adresse festlegen.

Grundregeln für die API

• Base URL: https://askium.org/api
• Authorization: Authorization: Bearer YOUR_PRIVATE_API_KEY
• Content-Type: application/json
• Wenn eine IP-Beschränkung aktiviert ist, werden Anfragen nur von der erlaubten IP angenommen
• POST /api/results/verify ist öffentlich und benötigt keinen privaten API-Schlüssel

Verfügbare Routen

• POST /api/forms/{form_key}/invitation-links
• DELETE /api/forms/{form_key}/invitation-links/{link_key}
• GET /api/forms/{form_key}/invitation-links/active
• POST /api/forms/{form_key}/questions/import
• POST /api/results/{result_key}/verification-key
• POST /api/results/verify

curl -X POST "https://askium.org/api/forms/exam-api-001/invitation-links" \
  -H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com"
  }'

{
  "status": "ok",
  "link": {
    "key": "link-abc123",
    "url": "https://askium.org/f/exam-api-001?t=link-abc123",
    "is_active": true
  },
  "ticket_questions_count": 2
}

curl -X DELETE "https://askium.org/api/forms/exam-api-001/invitation-links/link-abc123" \
  -H "Authorization: Bearer YOUR_PRIVATE_API_KEY"

{
  "status": "ok",
  "message": "Invitation link deleted."
}

curl -X GET "https://askium.org/api/forms/exam-api-001/invitation-links/active" \
  -H "Authorization: Bearer YOUR_PRIVATE_API_KEY"

{
  "status": "ok",
  "links": [
    {
      "key": "link-active-unused",
      "url": "https://askium.org/f/exam-api-list-001?t=link-active-unused",
      "is_active": true,
      "first_name": "Alice",
      "last_name": "Green",
      "email": "alice@example.com",
      "created_at": "2026-03-01 10:00:00"
    }
  ]
}

curl -X POST "https://askium.org/api/forms/quiz-import-001/questions/import" \
  -H "Authorization: Bearer YOUR_PRIVATE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "difficulty": "medium",
    "points_num": 2,
    "questions": [
      {
        "question_short_title": "HTTP code",
        "question": "Which status code means success?",
        "options": ["200 OK", "301", "404", "500"],
        "correct_index": 0
      },
      {
        "question_short_title": "TCP port",
        "question": "Which port is typically used by HTTPS?",
        "options": ["21", "25", "80", "443"],
        "correct_index": 3
      }
    ]
  }'

{
  "status": "ok",
  "message": "Die Fragen wurden erfolgreich importiert.",
  "imported_count": 2,
  "import_key": "imp_3f9b84d1"
}

curl -X POST "https://askium.org/api/results/res-8f2d1a/verification-key" \
  -H "Authorization: Bearer YOUR_PRIVATE_API_KEY"

{
  "verification_key": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "JWT",
  "expires_at": "2026-03-01 10:05:00",
  "ttl_seconds": 300
}

curl -X POST "https://askium.org/api/results/verify" \
  -H "Content-Type: application/json" \
  -d '{
    "verification_key": "YOUR_ONE_TIME_VERIFICATION_KEY"
  }'

{
  "key": "res-8f2d1a",
  "is_finished": true,
  "started_at": "2026-03-01 10:00:00",
  "finished_at": "2026-03-01 10:42:15",
  "created_at": "2026-03-01 10:00:00",
  "correct_percent": 84,
  "total_points": 42,
  "max_points": 50,
  "correct_answers": 2,
  "wrong_answers": 1,
  "answers_total": 3,
  "unchecked_answers": 1,
  "timer_expires_at": "2026-03-01 11:00:00",
  "is_terminated": false,
  "is_timer_up": false,
  "invitation_link_key": null,
  "personal_data": {
    "first_name": "John",
    "last_name": "Doe",
    "email": "john.doe@example.com"
  },
  "unwanted_events_count": 1,
  "form": {
    "key": "frm-php-exam",
    "name": "PHP Certification Exam",
    "type": "exam",
    "locale": "de"
  }
}

IP-Zugriffskontrolle

IP-Zugriffskontrolle ist eine Funktion, die nur für die Formate "Quiz" und "Prüfung" verfügbar ist. Sie ermöglicht es, den Zugriff auf das Formular auf bestimmte IP-Adressen oder Masken zu beschränken.
Wenn der Zugriff auf das Formular ausschließlich über Einladungslinks eingeschränkt ist, können Sie zusätzlich eine IP-Adresse oder Maske angeben, die nur für ein bestimmtes Prüfungs-Ticket gilt.

Um diese Funktion zu aktivieren, schalten Sie den entsprechenden Schalter in der Formularkonfiguration ein: "IP-Zugriffskontrolle"

Auf der Registerkarte IP-Zugriffskontrolle müssen Sie die IP-Adressen hinzufügen, die Zugriff auf das Formular haben sollen.

Eine zusätzliche persönliche IP-Adresse für jeden Link kann direkt in den Einstellungen des Einladungslinks hinzugefügt werden.

Arbeitsgruppen

Arbeitsgruppe — ein Bereich zur gemeinsamen Arbeit mit Formularen und Ergebnissen. In jeder Arbeitsgruppe gibt es:

• Administrator — der Benutzer, der die Arbeitsgruppe erstellt hat und ihr Eigentümer ist. Er/Sie kann:
  • Mitglieder einladen und entfernen
  • Individuelle Rechte für jedes Mitglied festlegen
  • Formulare auswählen, die für die Gruppe verfügbar sind
  • Die Arbeitsgruppe aktivieren oder deaktivieren
  • Die Gruppe bei Bedarf löschen
• Mitglieder — Benutzer, die vom Administrator eingeladen wurden. Sie können:
  • Mit Formularen arbeiten, die der Administrator freigegeben hat, im Rahmen der vergebenen Rechte
  • Die Einstellung „Kontakte teilen“ aktivieren oder deaktivieren — jede Person entscheidet selbst
  • Die Gruppe jederzeit verlassen

Individuelle Rechte der Mitglieder

Der Administrator kann flexibel festlegen, welche Aktionen jedem Mitglied erlaubt sind.
Liste der verfügbaren Rechte:

• Formularkonfiguration — grundlegende Formulareinstellungen ändern;
• Schwierigkeits-Einstellungen — Verteilung der Schwierigkeitsgrade verwalten;
• Fragenverwaltung — Fragen erstellen, bearbeiten und löschen;
• Linkverwaltung — Einladungslinks verwalten;
• Ergebnisse ansehen — alle Ergebnisse der Formularausfüllung sehen;
• Analytik ansehen — Zugriff auf Statistiken und Analysen der Formulare;
• Integrationseinstellungen — Verbindungen zu LMS, Webhooks und anderen Integrationen verwalten;
• Styling und Branding — Design der Formulare anpassen (Farben, Logo, Schriften);

Zugriff auf Formulare

Um ein Formular zu einer Arbeitsgruppe hinzuzufügen, wählen Sie in der Hauptkonfiguration des Formulars den Punkt „Arbeitsgruppe“ und geben Sie die gewünschte Gruppe an.

Nach dem Speichern sehen alle Mitglieder der Gruppe das Formular auf der Seite der verfügbaren Gruppen, in einer separaten Liste, gruppiert nach dem Namen der Gruppe.

Beim Öffnen des Formulars sieht ein Mitglied nur die Menüpunkte, zu denen der Administrator Zugriff gewährt hat.

Benutzermenü

Um das Benutzermenü aufzurufen, klicken Sie auf das Symbol mit den Initialen des Benutzers in der oberen rechten Ecke der Benutzeroberfläche. In diesem Menü stehen folgende Optionen zur Verfügung:

• Meine Formulare – zur Liste Ihrer Formulare wechseln;
• Meine Einladungen – zur Kundenoberfläche wechseln, wo sich die Einladungen zum Ausfüllen von Formularen befinden, die Ihnen gesendet wurden;
• Konto – zur Seite mit den Kontoeinstellungen wechseln;
• Einstellungen – zur Seite mit den Anwendungseinstellungen wechseln;
• Abmelden – sich aus der Anwendung abmelden; für eine erneute Anmeldung ist eine Authentifizierung erforderlich;

Kontoeinstellungen

Sie können zur Seite mit den Kontoeinstellungen gelangen, indem Sie das Benutzermenü in der oberen rechten Ecke des Bildschirms aufrufen und den Menüpunkt "Konto" auswählen.

Hier werden Ihre persönlichen Daten, verknüpfte soziale Netzwerke, der aktive Abonnementplan und die Schnittstelle zum Ändern des Anmeldepassworts angezeigt.

Anwendungseinstellungen

Sie können zur Seite mit den Anwendungseinstellungen gelangen, indem Sie das Benutzermenü in der oberen rechten Ecke des Bildschirms aufrufen und den Menüpunkt "Einstellungen" auswählen.

Hier können Sie die Sprache der Benutzeroberfläche ändern und zwischen dem hellen und dunklen Design der Anwendung wechseln.

Kundenoberfläche

Hier werden die Einladungen zum Ausfüllen von Formularen angezeigt, die Ihnen gesendet wurden. Damit eine Einladung in dieser Liste erscheint, muss in der Einladungslink dieselbe Email-Adresse angegeben sein, die in Ihrem Konto hinterlegt ist (diese kann auf der Seite Kontoeinstellungen im Abschnitt Persönliche Daten eingesehen werden).