Erläuterung der Zeichenfolge „Questions“ im Abschnitt „Learn365 API Quizzes“

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.