Änderungen von Dokument 07 Schnittstelle ONYX Player

Zuletzt geändert von Carina Enke am 26.11.2025

Von 204.1 nach 205.1 Von 212.1 nach 213.1

Von Version 205.1

bearbeitet von Carina Enke
am 01.10.2020

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Auf Version 212.1

bearbeitet von Carina Enke
am 28.09.2020

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
Objekte (1 geändert, 0 hinzugefügt, 0 gelöscht)
- Confluence.Code.ConfluencePageClass[0]

Details

Seiteneigenschaften

Inhalt

@@ -174,137 +174,36 @@
  )))|(((
  (% class="content-wrapper" %)
  (((
--Liste von Parametern zur Teststeuerung. Weitere Parameter können für den einzelnen Teilnehmer festgelegt werden (registerStudent).
++Liste von Parametern zur Teststeuerung. Weitere Parameter können für den einzelnen Teilnehmer festgelegt werden ([[registerStudent>>doc:ONYXintern.\.ONYX Player Interface v8\.12||anchor="AnmeldungeinesStudenten"]]).
  Alle Parameter sind optional. Die Standardeinstellung ist fett gedruckt.
--(% class="wrapped" %)
--|=(((
--Parameter
--)))|=(((
--Beschreibung
++{{info title="Hinweis"}}
++Seit der ONYX Version 5.15 lässt sich die Feedback- und Auswertungsanzeige für den Teilnehmer während der Testdurchführung genauer steuern. Für diese Funktionalität wurde die Schnittstelle angepasst. Eine detaillierte Beschreibung der Funktionalität aus Anwendersicht bietet der Abschnitt "[[doc:Konfiguration der Testdurchfuehrung]]"(% class="error" %) (%%).
++{{/info}}
++
++* showSolution [true|**false**] Soll dem Nutzer die korrekte Antwort anzeigbar sein?
++* isSynchronized [true|**false**] Handelt es sich um einen Test im Prüfungsmodus, bei dem der Start des Tests über alle Teilnehmer synchronisiert wird?
++* (((
++continuationAllowed [true|**false**] Ist es erlaubt, die Testsession jederzeit fortzusetzen? Wenn nicht, muss jeder Teststart über die Lernplattform durchgeführt werden.
  )))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--showSolution [true|**false**]
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Soll dem Nutzer die korrekte Antwort anzeigbar sein?
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--isSynchronized [true|**false**]
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Handelt es sich um einen Test im Prüfungsmodus, bei dem der Start des Tests über alle Teilnehmer synchronisiert wird?
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--continuationAllowed [true|**false**]
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Ist es erlaubt, die Testsession jederzeit fortzusetzen? Wenn nicht, muss jeder Teststart über die Lernplattform durchgeführt werden.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--suspendAllowed [true|**false**]
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Ist es erlaubt, den Test zu unterbrechen? In diesem Fall wird eine zusätzliche Taste „Unterbrechen“ angezeigt.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--Templateid
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Derzeit einzig unterstützt: onyxwithoutnav - führt zur Nichtanzeige des Navigationsbaumes.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--dontShowItemTitles (% class="error" %)[true|**false**]
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--(% class="error" %)Sollen die Titel der Aufgaben nicht angezeigt werden?
--)))
++* suspendAllowed [true|**false**] Ist es erlaubt, den Test zu unterbrechen? In diesem Fall wird eine zusätzliche Taste „Unterbrechen“ angezeigt.
++* Templateid: Derzeit einzig unterstützt: onyxwithoutnav – führt zur Nichtanzeige des Navigationsbaumes.
++* dontShowItemTitles (% class="error" %)[true|**false**]: Sollen die Titel der Aufgaben nicht angezeigt werden?
--\\
  {{note}}
--Mit folgenden Parametern lässt sich seit ONYX Version 5.15 die Feedback- und Auswertungsanzeige für den Teilnehmer während der Testdurchführung steuern. Eine detaillierte Beschreibung der Funktionalität aus Anwendersicht bietet der Abschnitt "Konfiguration der Testdurchführung".
++Folgende Parameter sind seit **ONYX Version** **5.15** verfügbar:
  {{/note}}
--Aufgabenauswertung:
++* testShowScore [**true**|false] Dem Teilnehmer wird nach Testabgabe eine Testabschlusseite angezeigt, welche alle ermittelten Punktwerte, wie die Gesamtpunktzahl des Tests und ggf. Punkte pro Testabschnitt, (nicht) enthält.
++* testShowPassed (% class="error" %)[true|false](%%) Dem Teilnehmer wird nach Testabgabe eine Testabschlusseite angezeigt, die die Information (nicht) enthält, ob der Test bestanden wurde. Standard ist der in testShowScore gegebene Wert bzw. dessen Standard.
++* testShowFeedback [**true**|false] Dem Teilnehmer wird nach Testabgabe eine Testabschlusseite angezeigt, welche das durch den Autor definierte Test-Feedback (nicht) enthält.
++* itemShowFeedback [**true**|false] Dem Teilnehmer wird nach Abgabe seiner Aufgaben-Antwort das durch den Autor definierte Aufgaben-Feedback angezeigt.
++* itemShowScore [**true**|false] Dem Teilnehmer wird nach Abgabe seiner Aufgaben-Antwort angezeigt, wie viele Punkte er für die Aufgabe erreicht hat..
++* itemShowCorrect [**true**|false] Dem Teilnehmer wird nach Abgabe seiner Aufgaben-Antwort angezeigt, ob seine Antworten korrekt oder falsch waren. Impliziert itemShowScore=true.
++* itemShowSolution [**true**|false] Dem Teilnehmer wird nach Abgabe seiner Aufgaben-Antwort die korrekte Lösung angezeigt. Impliziert itemShowCorrect=true und itemShowScore=true.
--(% class="wrapped" %)
--|=(((
--Parameter
--)))|=(((
--Beschreibung
--)))
--|(((
--itemShowFeedback [**true**|false]
--)))|(((
--Dem Teilnehmer wird nach Abgabe seiner Aufgaben-Antwort das durch den Autor definierte Aufgaben-Feedback angezeigt.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--itemShowMaxScore [**true**|false]
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Dem Teilneher wird die maximal mögliche Punktzahl zur jeder Aufgabe angezeigt.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--itemShowScore [**true**|false]
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Dem Teilnehmer wird nach Abgabe seiner Aufgaben-Antwort angezeigt, wie viele Punkte er für die Aufgabe erreicht hat.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--itemShowCorrect [**true**|false]
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Dem Teilnehmer wird nach Abgabe seiner Aufgaben-Antwort angezeigt, ob seine Antworten korrekt oder falsch waren. Impliziert itemShowScore=true.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--itemShowSolution [**true**|false]
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Dem Teilnehmer wird nach Abgabe seiner Aufgaben-Antwort die korrekte Lösung angezeigt. Impliziert itemShowCorrect=true und itemShowScore=true.
--)))
--
--Testauswertung:
--
--(% class="wrapped" %)
--|=(((
--Parameter
--)))|=(((
--Beschreibung
--)))
--|(((
--testShowFeedback [**true**|false]
--)))|(((
--Dem Teilnehmer wird nach Testabgabe eine Testabschlusseite angezeigt, welche das durch den Autor definierte Test-Feedback (nicht) enthält.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--testShowScore [**true**|false]
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Dem Teilnehmer wird nach Testabgabe eine Testabschlusseite angezeigt, welche alle ermittelten Punktwerte, wie die Gesamtpunktzahl des Tests und ggf. Punkte pro Testabschnitt, (nicht) enthält.
--)))
--|(% colspan="1" %)(% colspan="1" %)
--(((
--testShowPassed (% class="error" %)[**true**|false]
--)))|(% colspan="1" %)(% colspan="1" %)
--(((
--Dem Teilnehmer wird nach Testabgabe eine Testabschlusseite angezeigt, die die Information (nicht) enthält, ob der Test bestanden wurde. Standard ist der in testShowScore gegebene Wert bzw. dessen Standard.
--)))
--
--\\
--
  {{info title="Hinweis"}}
  Werden keine Auswertungsinformationen auf Aufgaben-Ebene angezeigt (itemShowFeedback = false, itemShowScore = false, itemShowCorrect =false, itemShowSolution = false), wird dem Teilnehmer während der Testdurchführung kein Button zur Aufgaben-Abgabe angezeigt. Die Antworten werden zu jeder Zeit gespeichert und nach Test-Abgabe ausgewertet.
  {{/info}}
@@ -313,7 +313,7 @@
  \\
  {{error}}
--Folgende Parameter sind seit **ONYX Version 5.15 **(% style="color: rgb(255,0,0);" %)__nicht mehr__ (%%)verfügbar:
++Folgende Parameter sind seit **ONYX Version 5.15 (% style="color: rgb(255,0,0);" %)__nicht mehr__(%%)** verfügbar:
  {{/error}}
  * showSolution [**true** |false] - Ersetzt durch testShowScore, testShowPassed, itemShowSolution (inkl. Implikationen)
@@ -516,8 +516,6 @@
  Der ONYX Player verwendet eine Konfigurationsdatei namens onyxplugin.config.xml. Diese muss im Java Classpath liegen.
--\\
--
  {{error title="Sicherheit"}}
  Sowohl die WSDL des ONYX Player als auch die der Lernplattform sollten „nach außen“ nicht erreichbar/sichtbar sein. Dies gilt ebenso für die jeweiligen WebServices. Die Web-GUI der Lernplattform und ONYX Player hingegen müssen unabhängig davon für alle Nutzer sichtbar und zugreifbar sein. Kommt bei der Testdurchführung HTTPS zum Einsatz (wozu unbedingt zu raten ist), muss der jeweiligen Java VM der Lernplattform und des ONYX Players das entsprechende Zertifikat bekannt sein. Sonst ist die WebService-Kommunikation nicht möglich.
  {{/error}}
@@ -526,39 +526,6 @@
  \\
  {{/layout-cell}}
  {{/layout-section}}
--
--{{layout-section ac:type="single"}}
--{{layout-cell}}
------
--{{/layout-cell}}
--{{/layout-section}}
--
--{{layout-section ac:type="single"}}
--{{layout-cell}}
--\\
--
--{{column}}
--(% class="auto-cursor-target" %)
--Bei Fragen zur Konfiguration oder zum Einsatz der ONYX-Testsuite in anderen Plattformen helfen wir Ihnen gern weiter.
--
--{{panel title="BPS Bildungsportal Sachsen GmbH"}}
--**[[image:attach:BPS-Logo-web.png]]
--**
--
--**Tel.: **+49 (0) 371 666 2739 0(% style="color: rgb(89,89,89);" %)**
--E-Mail: **(%%)[[support@bps-system.de>>mailto:support@bps-system.de||shape="rect"]]
--
--Gern können Sie auch unser (% style="text-align: left;" %)**[[Kontaktformular>>url:https://www.bps-system.de/cms/kontakt/||shape="rect"]] **(%%)nutzen.
--{{/panel}}
--
--(% class="auto-cursor-target" %)
--\\
--{{/column}}
--
--(% class="auto-cursor-target" %)
--\\
--{{/layout-cell}}
--{{/layout-section}}
  {{/layout}}
  {{/sv-translation}}
@@ -592,7 +592,7 @@
  The ONYX Player defines a web service, which can be reached via the URL **<ONYXPlayer-URL>/onyx/onyxexamservices**.
--Link to the WSDL of the public demo runtime: [[http:~~/~~/demo.bps-system.de/onyx/>>url:http://demo.bps-system.de/onyx/||shape="rect"]] [[onyxexamservices?wsdl>>url:http://demo.bps-system.de/onyx/onyxexamservices?wsdl||shape="rect"]]
++Link to the WSDL of the public demo runtime: [[http:~~/~~/demo.bps-system.de/onyx/>>url:http://demo.bps-system.de/onyx/||shape="rect"]][[onyxexamservices?wsdl>>url:http://demo.bps-system.de/onyx/onyxexamservices?wsdl||shape="rect"]]
  == Registration of a test ==
@@ -611,7 +611,6 @@
  === Parameter registerTest ===
--(% class="wrapped" %)
  |(((
  testSessionId
  )))|(((
@@ -630,13 +630,11 @@
  |(((
  parameters
  )))|(((
--(% class="content-wrapper" %)
--(((
  (% class="TableParagraph" %)
--List of parameters to control the test. Additional parameters can be set for individual participants ( registerStudent ).
++List of parameters to control the test. Additional parameters can be set for individual participants ((% style="color: rgb(13,78,168);" %)registerStudent(%%)).
  (% class="TableParagraph" %)
--All parameters are optional. The default setting is shown in bold.
++All parameters are optional. The default setting is shown in bold.
  {{info title="Note"}}
  Since ONYX version 5.15, the feedback and assessment display for the participant can be controlled more precisely during the test execution. The interface has been adapted for this functionality. For a more detailed description of the functionality from the user perspective, see section "[[Configuration of the test implementation>>url:https://www.bps-system.de/help/display/ONYXintern/.Konfiguration+der+Testdurchfuehrung+v1.11||shape="rect"]]".
@@ -668,17 +668,15 @@
  {{/info}}
  {{error}}
--The following parameters are (% style="color: rgb(255,0,0);" %)**__no longer__ **(%%)available since **ONYX** **version 5.15**:
++The following parameters are (% style="color: rgb(255,0,0);" %)**__no longer__**(%%)** **available since **ONYX** **version 5.15**:
  {{/error}}
  * showSolution [**true **|false] - Replaced by testShowScore, testShowPassed, itemShowSolution (including implications)
  * showFeedback [**true **|false] - Replaced by testShowFeedback and itemShowFeedback
  )))
--)))
  === ReturnValue registerTest ===
--(% class="wrapped" %)
  |(((
  Long
  )))|(((
@@ -698,7 +698,7 @@
  * OK(42) – OK
  )))
  |(((
--\\
++
  )))|(((
  **Error codes:**
@@ -729,7 +729,6 @@
  === Parameter registerStudent ===
--(% class="wrapped" %)
  |(((
  testSessionId
  )))|(((
@@ -764,7 +764,6 @@
  === ReturnValue registerStudent ===
--(% class="wrapped" %)
  |(((
  Long
  )))|(((
@@ -787,7 +787,6 @@
  === Parameter testControl ===
--(% class="wrapped" %)
  |(((
  testSessionId
  )))|(((
@@ -813,7 +813,6 @@
  === ReturnValue testControl ===
--(% class="wrapped" %)
  |(((
  Long
  )))|(((
@@ -835,7 +835,6 @@
  === Parameter deregisterTest ===
--(% class="wrapped" %)
  |(((
  testSessionId
  )))|(((
@@ -854,7 +854,6 @@
  === ReturnValue deregisterTest ===
--(% class="wrapped" %)
  |(((
  Long
  )))|(((
@@ -866,14 +866,16 @@
  After a test has been registered with the Player, it will be displayed to the user **exactly once**. For this reason, the LMS will show an IFrame with the target URL <ONYXWebPlayer-URL>/onyx/onyxrun?id=<UID> in the browser window. The <UID> must be the unique studentId used in the test registration. The test will then be started. If the user finishes the test, the results are returned to the LMS. The LMS then needs to define a web service API that exactly matches the WSDL available under the following URL:
  {{note title="URL"}}
--[[http:~~/~~/demo.bps-system.de/olatce/services/ReturnWSService?wsdl>>url:http://demo.bps-system.de/olatce/services/ReturnWSService?wsdl||shape="rect"]]
++[[http:~~/~~/demo.bps-system.de/olatce/services/ReturnWSService?wsdl>>url:http://demo.bps-system.de/olatce/services/ReturnWSService?wsdl||shape="rect"]]
  Only the URL in the lower part of the WSDL has to be adapted to the LMS.
  {{/note}}
  == Configuration of the ONYX Player ==
--The ONYX Player uses a configuration file named onyxplugin.config.xml, which must be stored in the Java Classpath.
++The ONYX Player uses a configuration file named onyxplugin.config.xml, which must be stored in the Java Classpath. It is defined as follows:
++[[image:attach:SchnittstellePlayer.png]]
++
  {{error title="Security"}}
  Both the WSDL of the ONYX Player and the LMS should not be accessible/visible from the outside. This also applies to the respective web services. The web GUI of the LMS and the ONYX Player, in contrast, must be visible to and accessible for all users. If HTTPS is used during the test execution (recommended), the appropriate certificate must be known to the corresponding JVM of the LMS and the ONYX Player. Otherwise web service communication is not possible.
  {{/error}}

Confluence.Code.ConfluencePageClass[0]

id

@@ -1,1 +1,1 @@
--374473243
++372998366

url

@@ -1,1 +1,1 @@
--https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/374473243/ONYX Player Interface
++https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/372998366/ONYX Player Interface

Änderungen von Dokument 07 Schnittstelle ONYX Player

Zusammenfassung

Details

Suchen

ONYXGlobal

ONYXMenü

Zuletzt besucht