Einführung
Der Abschnitt Quizzes der Learn365 API ermöglicht es Ihnen, Daten zu Quizzen im Tenant abzurufen und herunterzuladen.
Abgerufene Daten werden im .JSON-Format bereitgestellt. Eine Erläuterung dazu finden Sie im Abschnitt Quiz Questions der API-Dokumentationsseite sowie in diesem Artikel.
In diesem Artikel zeigen wir Ihnen, wie Sie die Zeichenfolge Questions im Response body von GET-Anfragen lesen, die im Abschnitt Quizzes der Learn365 API ausgeführt werden.
Erläuterung der Questions-Zeichenfolge
Die Zeichenfolge Questions im Response body enthält sowohl allgemeine als auch spezifische Informationen zu Quizfragen.
Allgemeine Informationen
- Der Fragetyp wird durch eine Zahl gekennzeichnet. Deren Definition finden Sie im Abschnitt Quiz Questions > QuestionType der API-Dokumentationsseite.
- Die Frage-ID für jede Frage finden Sie in Id. Diese Eigenschaft folgt in der Regel auf die Eigenschaften QuestionType oder RandomizeAnswers, wie im folgenden Bild gezeigt.
- Title enthält den Titel der Frage. Diese Eigenschaft folgt auf die Frage-ID.
- Der Parameter Description enthält den Fragetext.
- Die Eigenschaft RandomizeAnswers zeigt true oder false an. Diese Eigenschaft bezieht sich auf die Option Randomize answer options in einer Quizfrage, die jeweils auf On oder Off gesetzt werden kann.
- Points zeigt die Anzahl der Punkte an, die Lernende/Lernender erhält, wenn sie/er die richtige Antwort auf diese Frage gibt, sofern das Feld Points awarded für die Frage ausgefüllt wurde. Wenn die Anzahl der Punkte nicht angegeben ist, sehen Sie \"Points\":0.
- PointsPercentage gibt den Punkteprozentsatz an, den Lernende/Lernender für eine Antwort auf eine Frage des Typs ShortAnswer erhält.
- PositiveFeedback, NegativeFeedback und SemiPositiveFeedback zeigen den Text des Feedbacks an, das Lernende/Lernender für richtige, falsche und teilweise richtige Antworten auf eine Frage erhält (sofern der Feedbacktext in den Frageneinstellungen angegeben ist). Wenn kein Feedback-Text angegeben ist, wird ":null" angezeigt.
- Tags enthalten die Frage-Tags, sofern sie für diese Frage angegeben sind.
Antworten und ihre IDs
Antworten und richtige Antworten werden mit ihren IDs entsprechend dem Fragetyp dargestellt:
- Der Fragetyp Freitextantwort enthält keine Antwort.
- Die richtige Antwort auf einen Wahr oder falsch Fragetyp wird im RightAnswer Parameter als true oder false angezeigt und enthält keine ID der richtigen Antwort.
- Beim Fragetyp Multiple Choice enthält der Parameter Answers jede Antwort mit ihrer Id und zeigt den Antworttext an. RightAnswerId enthält die ID der richtigen Antwort für diese Frage.
- Beim Fragetyp Mehrfachantwort enthält der Parameter Answers jede Antwort mit ihrer ID und zeigt den Antworttext an. RightAnswerIds enthält die IDs der richtigen Antworten für diese Frage.
- Beim Fragetyp Sortieren gibt der Parameter Answers die Antworten und ihre IDs in der richtigen Reihenfolge wieder.
- Die Antwort auf eine Hotspot-Frage befindet sich in der Eigenschaft ImageUrl, die die URL des Fragenbildes enthält, sowie in den Daten Position X und Y der richtigen Antwortposition im Bild.
- Die Eigenschaft Answers des Fragetyps Kurzantwort enthält die Antwort-ID und den Antworttext, gefolgt von der Eigenschaft IsRegExp für alle verfügbaren Antworten.
- Für den Fragetyp Lückentext:
- Der Parameter Text enthält den Antworttext mit Lücken, gefolgt vom Parameter Gaps mit allen möglichen Optionen in jeder Lücke.
- CorrectResponse zeigt die richtige Antwort für jede Lücke in der Frage an.
- Beim Fragetyp Zuordnen enthält der Parameter Antworten die korrekten Zuordnungen mit den IDs und dem Text. Jedes Zuordnungspaar in eckigen Klammern, durch ein Komma getrennt.