POST /open/renderpluginresult


Controller	ApiController
Java-Methode	`renderPluginResult`
HTTP-Methode	POST
Pfad	`/open/renderpluginresult`
Erreichbarkeit	nur im Docker-Netzwerk
Request-Body	PluginRenderResultRequestDto
Response	PluginRenderDto

Beschreibung

Rendert das Plugin inklusive der Schülereingabe und korrekter Lösung

Es wird dabei entweder direkt ein HTML-Code oder LaTeX-Code erzeugt

Request

Body: PluginRenderResultRequestDto

Feld	Typ	ausgewertet	Bedeutung
`typ`	String	ja	Typ des Plugins
`name`	String	ja	Name des Plugins in der Frage
`config`	String	ja	Konfigurationsstring des Plugins
`tex`	boolean	ja	true für LaTeX-Code, false für html-Code
`pluginDto`	PluginDto	ja	Das PluginDto welches am Webserver an das JavaScript des Plugins zum Rendern gesandt wird
`antwort`	String	ja	Antwort die der Schüler eingegeben hat
`toleranz`	ToleranzDto	ja	Toleranz für die Lösung
`varsQuestion`	VarHashDto	ja	VarHash aller Variablen der Frage
`answerDto`	PluginAnswerDto	ja	korrekte Antwort und Informationen für den Scorer des Plugins
`grade`	double	ja	Maximale Punktanzahl für die richtige Antwort

Response

Typ: PluginRenderDto

HTML-Code oder LaTeX-Code mit Bildern

Ablauf im Service

Erzeugt über PluginConfiguration.createPluginService(typ, name, config) eine neue Plugin-Instanz und ruft auf: renderPluginResult.

Fehlerfälle

404 Not Found, wenn der Plugin-Typ nicht registriert ist oder das Plugin nicht erzeugt werden kann („Plugin vom Typ … kann nicht erzeugt werden”).

Beispiel-Request

JSON-Gerüst aus den Feldern des DTOs, Werte sind Platzhalter:

{
  "typ": "<typ>",
  "name": "<name>",
  "config": "<config>",
  "tex": false,
  "pluginDto": {
    "…": "PluginDto"
  },
  "antwort": "<antwort>",
  "toleranz": {
    "…": "ToleranzDto"
  },
  "varsQuestion": {
    "…": "VarHashDto"
  },
  "answerDto": {
    "…": "PluginAnswerDto"
  },
  "grade": 0
}

Siehe auch

POST /open/score – Prüft die Eingabe eines Schülers
POST /open/renderlatex – Rendert ein Plugin für den Fragedruck als LaTeX-Quelltext

ApiController · REST-Schnittstelle · Referenz-Plugin (Java)