ONYX Player Interface

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".

131

132

133

Aufgabenauswertung:

134

135

(% class="wrapped" %)

|=(((

Parameter

)))|=(((

Beschreibung

)))

|(((

itemShowFeedback [**true**|false]

143

)))|(((

144

Dem Teilnehmer wird nach Abgabe seiner Aufgaben-Antwort das durch den Autor definierte Aufgaben-Feedback angezeigt.

145

)))

146

|(% colspan="1" %)(% colspan="1" %)

147

(((

148

itemShowMaxScore [**true**|false]

149

)))|(% colspan="1" %)(% colspan="1" %)

150

(((

151

Dem Teilnehmer wird die maximal mögliche Punktzahl zu jeder Aufgabe angezeigt.

152

)))

153

|(% colspan="1" %)(% colspan="1" %)

154

(((

155

itemShowScore [**true**|false]

156

)))|(% colspan="1" %)(% colspan="1" %)

157

(((

158

Dem Teilnehmer wird nach Abgabe seiner Aufgaben-Antwort angezeigt, wie viele Punkte er für die Aufgabe erreicht hat.

159

)))

160

|(% colspan="1" %)(% colspan="1" %)

161

(((

162

itemShowCorrect [**true**|false]

163

)))|(% colspan="1" %)(% colspan="1" %)

164

(((

165

Dem Teilnehmer wird nach Abgabe seiner Aufgaben-Antwort angezeigt, ob seine Antworten korrekt oder falsch waren. Impliziert itemShowScore=true.

166

)))

167

|(% colspan="1" %)(% colspan="1" %)

168

(((

169

itemShowSolution [**true**|false]

170

)))|(% colspan="1" %)(% colspan="1" %)

171

(((

172

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]

185

)))|(((

186

Dem Teilnehmer wird nach Testabgabe eine Testabschlussseite angezeigt, welche das durch den Autor definierte Test-Feedback (nicht) enthält.

187

)))

188

|(% colspan="1" %)(% colspan="1" %)

189

(((

190

testShowScore [**true**|false]

191

)))|(% colspan="1" %)(% colspan="1" %)

192

(((

193

Dem Teilnehmer wird nach Testabgabe eine Testabschlussseite angezeigt, welche alle ermittelten Punktwerte wie die Gesamtpunktzahl des Tests und ggf. die Punkte pro Testabschnitt (nicht) enthält.

194

)))

195

|(% colspan="1" %)(% colspan="1" %)

196

(((

197

testShowPassed (% class="error" %)[**true**|false]

198

)))|(% colspan="1" %)(% colspan="1" %)

199

(((

200

Dem Teilnehmer wird nach Testabgabe eine Testabschlussseite angezeigt, welche die Information (nicht) enthält, ob der Test bestanden wurde. Standard ist der in testShowScore gegebene Wert bzw. dessen Standard.

)))

\\

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.

Folgende Parameter sind seit **ONYX Version 5.15 **(% style="color: rgb(255,0,0);" %)__nicht mehr__ (%%)verfügbar:

211

212

213

* showSolution [**true** |false] - Ersetzt durch testShowScore, testShowPassed, itemShowSolution (inkl. Implikationen)

214

* showFeedback [**true** |false] - Ersetzt durch testShowFeedback sowie itemShowFeedback

)))

)))

=== ReturnValue registerTest ===

219

220

(% class="wrapped" %)

|(((

Long

)))|(((

**Einer der folgenden Werte:**

225

226

* WAITING(0) – warten auf Teststart

227

* WORKING(1) – bearbeitet Test

228

* FINISHED(2) – hat Test abgegeben

229

* RESUME_ALLOWED(3) – Fortsetzen erlaubt

230

* NOT_ENTERED(4) – hat Test noch nicht betreten

231

* CANCELED(5) – hat Testbearbeitung abgebrochen

232

* RESUME_REQUESTED(6) – möchte fortsetzen

233

* RESUMED(7) – hat fortgesetzt

234

* DISCONNECTED(8) – Client nicht (mehr) erreichbar

235

* SUSPENDED(9) – Testbearbeitung unterbrochen

236

* RESUME_SUSPENDED(10) – unterbrochene Bearbeitung fortgesetzt

* OK(42) – OK

)))

|(((

\\

)))|(((

**Fehlercodes:**

* ERROR_RETURN_RESULTS(0xFF01)

245

* ERROR_MULTIPLE_REGISTER_STUDENT_WITH_SAME_ID_CALLS(0xFF02)

246

* ERROR_REGISTER_STUDENT_WITH_UNKNOWN_TEST_ID(0xFF03)

247

* ERROR_REGISTER_STUDENT_WITH_EMPTY_TEST_ID(0xFF04)

248

* ERROR_REGISTER_STUDENT_WITH_EMPTY_STUDENT_ID(0xFF05)

249

* ERROR_REGISTER_STUDENT_TO_RESUME_WITHOUT_PAYLOAD(0xFF06)

250

* ERROR_REGISTER_STUDENT_FOR_UNKNOWN_PROVIDER(0xFF07)

* UNKNOWN(-1)

)))

== Anmeldung eines Studenten ==

255

256

Nach Anmeldung eines Tests können Studenten diesen nutzen. Dazu müssen auch diese angemeldet werden.

257

258

259

@WebMethod(operationName = „registerStudent")

260

public Long registerStudent(

261

@WebParam(name = „testSessionId", partName = „testSessionId") final Long test

262

SessionId,

263

@WebParam(name = „studentId", partName = „studentId") final Long studentId,

264

@WebParam(name = „payload", partName = „payload") final byte[] payload,

265

@WebParam(name = „parameters") final MapWrapper parameters) throws Exception {

}

=== Parameter registerStudent ===

270

271

(% class="wrapped" %)

|(((

testSessionId

)))|(((

Durch die Lernplattform vergebene, eindeutige ID, welche die Kennung für den Test darstellt (siehe registerTest).

)))

|(((

studentId

)))|(((

Eindeutige Kennung für Testteilnehmer. Diese wird von ONYX zurückgemeldet, wenn Statusänderungen oder Ergebnisse übertragen werden.

281

)))

282

|(% colspan="1" %)(% colspan="1" %)

283

(((

284

payload

285

)))|(% colspan="1" %)(% colspan="1" %)

286

(((

287

Optional. Resultate für den Teilnehmer (bspw. im Fall der Fortsetzung unterbrochener Tests)

288

)))

289

|(% colspan="1" %)(% colspan="1" %)

290

(((

291

parameters

292

)))|(% colspan="1" %)(% colspan="1" %)

293

(((

294

Liste von Parametern zur Teststeuerung (alle optional, fett gedruckt = Standard):

295

296

* language [**de**|en|fr|es]: Sprache des Benutzer-Interfaces von ONYX.

297

* status: Initialer Status des Teilnehmers (aktuell wird nur RESUME_SUSPENDED(10) unterstützt).

298

)))

299

300

=== ReturnValue registerStudent ===

301

302

(% class="wrapped" %)

|(((

Long

)))|(((

Einer der Werte wie unter Anmeldung eines Tests beschrieben.

)))

== Teststeuerung ==

Für registrierte Testteilnehmer kann der Status durch die Lernplattform kontrolliert werden, bspw. um nach der Freigabe durch den Betreuer für alle den Test zu starten, am Ende zu beenden oder fortzusetzen.

312

313

314

@WebMethod(operationName = „testControl")

315

public Long testControl(

316

@WebParam(name = „testSessionId") final Long testSessionId,

317

@WebParam(name = „studentIds") final StudentIdsWrapper students,

318

@WebParam(name = „status") final Integer status,

319

@WebParam(name = „parameters") final MapWrapper parameters) throws Exception {

}

=== Parameter testControl ===

324

325

(% class="wrapped" %)

|(((

testSessionId

)))|(((

Durch die Lernplattform vergebene, eindeutige ID, welche die Kennung für den Test darstellt (siehe registerTest).

)))

|(((

studentIds

)))|(((

Liste eindeutiger Kennungen für Testteilnehmer.

)))

|(((

status

)))|(((

Neu zu setzender Status für die gegebenen Testteilnehmer.

)))

|(((

parameters

)))|(((

Liste von Parametern zur Teststeuerung (alle optional):

345

346

* addTime: Time in minutes to add to the test session.

347

)))

348

349

=== ReturnValue testControl ===

350

351

(% class="wrapped" %)

|(((

Long

)))|(((

Einer der Werte wie unter Anmeldung eines Tests beschrieben.

356

)))

357

358

== Speicher aufräumen ==

359

360

Haben alle Teilnehmer den Test durchgeführt, so kann die Lernplattform ONYX mitteilen, dass dieses den Test deregistrieren und den Speicher aufräumen kann.

361

362

363

@WebMethod(operationName = „deregisterTest")

364

public Long deregisterTest(

365

@WebParam(name = „testSessionId") final Long testSessionId,

366

@WebParam(name = „providerId") final String providerId,

367

@WebParam(name = „parameters") final MapWrapper parameters) throws Exception {

}

=== Parameter deregisterTest ===

372

373

(% class="wrapped" %)

|(((

testSessionId

)))|(((

Durch die Lernplattform vergebene, eindeutige ID, welche die Kennung für den Test darstellt (siehe registerTest).

)))

|(((

providerId

)))|(((

Die Kennung, unter welcher die anfordernde Lernplattform bei ONYX angemeldet ist.

)))

|(((

parameters

)))|(((

Aktuell nicht verwendet.

388

)))

389

390

=== ReturnValue deregisterTest ===

391

392

(% class="wrapped" %)

|(((

Long

)))|(((

Einer der Werte wie unter Anmeldung eines Tests beschrieben.

397

)))

398

399

== Anzeige des Tests ==

400

401

Nachdem ein Test beim Player angemeldet wurde, kann er vom Nutzer** exakt ein Mal** angezeigt werden. Dazu muss er von der Lernplattform im Browserfenster einen IFrame mit der Ziel-URL <ONYXWebPlayer-URL>/onyx/onyxrun?id=<UID> angezeigt bekommen, wobei <UID> die bei der Testanmeldung verwendete eindeutige studentId sein muss. Der Test wird dann wiedergegeben. Beendet der Nutzer den Test, so erfolgt eine Rückgabe der Resultate an die Lernplattform. Diese muss dazu eine Webservice-Schnittstelle definieren, welche exakt der unter der folgenden URL verfügbaren WSDL entspricht:

402

403

404

[[http:~~/~~/demo.bps-system.de/olatce/services/ReturnWSService?wsdl>>url:http://demo.bps-system.de/olatce/services/ReturnWSService?wsdl||shape="rect"]]

405

Lediglich die URL im unteren Teil der WSDL muss an die Lernplattform angepasst werden.

406

407

408

== Konfiguration des ONYX Players ==

409

410

Der ONYX Player verwendet eine Konfigurationsdatei namens onyxplugin.config.xml. Diese muss im Java Classpath liegen.

\\

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 des 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 Player das entsprechende Zertifikat bekannt sein. Sonst ist die WebService-Kommunikation nicht möglich.

----

\\

(% class="auto-cursor-target" %)

432

Bei Fragen zur Konfiguration oder zum Einsatz der ONYX-Testsuite in anderen Plattformen helfen wir Ihnen gern weiter.

433

434

435

**[[image:attach:BPS-Logo-web.png]]

436

**

437

438

**Tel.: **+49 (0) 371 666 2739 0(% style="color: rgb(89,89,89);" %)**

439

E-Mail: **(%%)[[support@bps-system.de>>mailto:support@bps-system.de||shape="rect"]]

440

441

Gern können Sie auch unser (% style="text-align: left;" %)**[[Kontaktformular>>url:https://www.bps-system.de/cms/kontakt/||shape="rect"]] **(%%)nutzen.

The API between the ONYX Player and the LMS consists of the following components:

454

455

* Registration of a test with the ONYX Player through the LMS

456

* Registration of a participant with the ONYX Player through the LMS

457

* Test control

458

* Return of test results to the LMS through the ONYX Player

459

* Deregistration of the test

{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Content"}}

== General information ==

476

477

The ONYX Player defines a web service, which is accessible via the URL **<ONYXPlayer-URL>/onyx/onyxexamservices**.

478

479

Link to the WSDL of the public demo runtime: [[http:~~/~~/demo.bps-system.de/onyx/onyxexamservices?wsdl>>url:http://demo.bps-system.de/onyx/||shape="rect"]]

480

481

== Registration of a test ==

482

483

Before participants can take tests, the tests need to be registered with ONYX.

484

485

486

@WebMethod(operationName = „registerTest")

487

public Long registerTest(

488

@WebParam(name = „testSessionId") final Long testSessionId,

489

@WebParam(name = „providerId") final String providerId,

490

@WebParam(name = „contentPackage") final byte[] contentPackage,

491

@WebParam(name = „parameters") final MapWrapper parameters) throws Exception {

}

=== Parameters registerTest ===

496

497

(% class="wrapped" %)

|(((

testSessionId

)))|(((

Unique ID assigned by the LMS, which serves as an identifier for this test.

)))

|(((

providerId

)))|(((

Identification under which the requesting LMS is registrated with ONYX.

)))

|(((

contentPackage

)))|(((

The IMS QTI v2.1 CP (zip file as byte array).

)))

|(((

parameters

)))|(((

(% class="content-wrapper" %)

517

(((

518

(% class="TableParagraph" %)

519

List of parameters to control the test. It is also possible to set additional parameters for the individual participant (registerStudent).

520

521

(% class="TableParagraph" %)

522

All parameters are optional. The default setting is shown in bold.

523

524

(% class="wrapped" %)

|=(((

Paramter

)))|=(((

Description

)))

|(((

showSolution [true|**false**]

532

)))|(((

533

Should the correct answer be displayed to the user?

534

)))

535

|(((

536

isSynchronized [true|**false**]

537

)))|(((

538

Is the test for which the test start is synchronised across all users in the exam mode?

539

)))

540

|(((

541

continuationAllowed [true|**false**]

542

)))|(((

543

Is it allowed to continue the test session at any time? If not, each test start must be performed via the LMS.

544

)))

545

|(% colspan="1" %)(% colspan="1" %)

546

(((

547

suspendAllowed [true|**false**]

548

)))|(% colspan="1" %)(% colspan="1" %)

549

(((

550

Is it is allowed to interrupt the test? If this is the case, the button "Suspend" will additionally be displayed.

551

)))

552

|(% colspan="1" %)(% colspan="1" %)

553

(((

554

Templateid:

555

)))|(% colspan="1" %)(% colspan="1" %)

556

(((

557

Currently only supported: onyxwithoutnav - hides the navigation tree.

558

)))

559

|(% colspan="1" %)(% colspan="1" %)

560

(((

561

dontShowItemTitles [true|**false**]

562

)))|(% colspan="1" %)(% colspan="1" %)

563

(((

564

Should the titles of the questions not be displayed?

)))

\\

Since ONYX version 5.15, the following parameters can be used to control the feedback and evaluation display for the participant while taking the test. A detailed description of the functionality from the user's perspective is provided in the section "Test procedure configuration".

571

572

573

Questions evaluation:

574

575

(% class="wrapped" %)

|=(((

Parameter

)))|=(((

Description

)))

|(((

itemShowFeedback [**true**|false]

583

)))|(((

584

The question feedback defined by the author is displayed to the participant after submitting an answer to the question.

585

)))

586

|(((

587

itemShowMaxScore [**true**|false]

588

)))|(((

589

The participant is shown the maximum possible score for each question.

590

)))

591

|(% colspan="1" %)(% colspan="1" %)

592

(((

593

itemShowScore [**true**|false]

594

)))|(% colspan="1" %)(% colspan="1" %)

595

(((

596

The participant is shown the number of points achieved for the question after submitting their answer.

597

)))

598

|(% colspan="1" %)(% colspan="1" %)

599

(((

600

itemShowCorrect [**true**|false]

601

)))|(% colspan="1" %)(% colspan="1" %)

602

(((

603

The participant is shown whether their answer was correct or incorrect after submitting their answer. Implies itemShowScore=true.

604

)))

605

|(% colspan="1" %)(% colspan="1" %)

606

(((

607

itemShowSolution [**true**|false]

608

)))|(% colspan="1" %)(% colspan="1" %)

609

(((

610

The participant is shown the correct solution after submitting their answer. Implies itemShowCorrect=true and itemShowScore=true.

)))

Test evaluation:

(% class="wrapped" %)

|=(((

Parameter

)))|=(((

Description

)))

|(((

testShowFeedback [**true**|false]

623

)))|(((

624

After submitting the test, the participant is shown a test completion page, which does (not) contain the test feedback defined by the author.

625

)))

626

|(((

627

testShowScore [**true**|false]

628

)))|(((

629

After submitting the test, the participant is shown a test completion page, which does (not) contain all determined point values, such as the total test score and the points per test section, if applicable.

630

)))

631

|(((

632

testShowPassed [**true**|false]

633

)))|(((

634

After submitting the test, the participant is shown a test completion page, which does (not) contain information about whether or not the test was passed. The default is the value given in testShowScore or its default.

)))

\\

If no evaluation information is displayed on question level (itemShowFeedback = false, itemShowScore = false, itemShowCorrect = false, itemShowSolution = false), then the participant will not be shown the button to submit questions while taking the test. Instead, the answers are saved at any time and assessed after test submission.

The following parameters are (% style="color: rgb(255,0,0);" %)__no longer__ (%%)available since **ONYX** **version 5.15**:

645

646

647

* showSolution [**true **|false] - Replaced by testShowScore, testShowPassed, itemShowSolution (including implications)

648

* showFeedback [**true **|false] - Replaced by testShowFeedback and itemShowFeedback

)))

)))

=== ReturnValue registerTest ===

653

654

(% class="wrapped" %)

|(((

Long

)))|(((

**One of the following values:**

659

660

* WAITING(0) – waiting for test start

661

* WORKING(1) – is processing the test

662

* FINISHED(2) – submitted the test

663

* RESUME_ALLOWED(3) – resuming allowed

664

* NOT_ENTERED(4) – has not yet entered the test

665

* CANCELED(5) – has cancelled the testing process

666

* RESUME_REQUESTED(6) – wishes to continue

667

* RESUMED(7) – has continued

668

* DISCONNECTED(8) – client is not / no longer reachable

669

* SUSPENDED(9) – testing process has been interrupted

670

* RESUME_SUSPENDED(10) – interrupted testing process is continued

* OK(42) – OK

)))

|(((

\\

)))|(((

**Error codes:**

* ERROR_RETURN_RESULTS(0xFF01)

679

* ERROR_MULTIPLE_REGISTER_STUDENT_WITH_SAME_ID_CALLS(0xFF02)

680

* ERROR_REGISTER_STUDENT_WITH_UNKNOWN_TEST_ID(0xFF03)

681

* ERROR_REGISTER_STUDENT_WITH_EMPTY_TEST_ID(0xFF04)

682

* ERROR_REGISTER_STUDENT_WITH_EMPTY_STUDENT_ID(0xFF05)

683

* ERROR_REGISTER_STUDENT_TO_RESUME_WITHOUT_PAYLOAD(0xFF06)

684

* ERROR_REGISTER_STUDENT_FOR_UNKNOWN_PROVIDER(0xFF07)

* UNKNOWN(-1)

)))

== Registration of a student ==

689

690

Students can use a test after it has been registered, provided that they have been registered as well.

691

692

693

@WebMethod(operationName = „registerStudent")

694

public Long registerStudent(

695

@WebParam(name = „testSessionId", partName = „testSessionId") final Long test

696

SessionId,

697

@WebParam(name = „studentId", partName = „studentId") final Long studentId,

698

@WebParam(name = „payload", partName = „payload") final byte[] payload,

699

@WebParam(name = „parameters") final MapWrapper parameters) throws Exception {

}

=== Parameters registerStudent ===

704

705

(% class="wrapped" %)

|(((

testSessionId

)))|(((

(% class="TableParagraph" %)

710

Unique ID assigned by the LMS, which serves as an identifier for the test (cf. registerTest).

)))

|(((

studentId

)))|(((

(% class="TableParagraph" %)

716

Unique identification for test participants. ID will be returned by ONYX when status changes or results are transmitted.

717

)))

718

|(% colspan="1" %)(% colspan="1" %)

719

(((

720

payload

721

)))|(% colspan="1" %)(% colspan="1" %)

722

(((

723

(% class="TableParagraph" %)

724

Optional. Results for the participant (e. g. if interrupted tests are continued).

725

)))

726

|(% colspan="1" %)(% colspan="1" %)

727

(((

728

parameters

729

)))|(% colspan="1" %)(% colspan="1" %)

730

(((

731

(% class="TableParagraph" %)

732

List of test control parameters (all optional, bold = default):

733

734

* Language [**de**|en|fr|es]: Language of the ONYX user interface.

735

* Status: Initial status of the participant (currently only RESUME_SUSPENDED(10) is supported).

736

)))

737

738

=== ReturnValue registerStudent ===

739

740

(% class="wrapped" %)

|(((

Long

)))|(((

One of the values as described under "Registration of a test".

)))

== Test control ==

The status of registered test participants can be controlled by the LMS, e. g. to start, finish, or continue the test for everyone after the tutor has approved of it.

750

751

752

@WebMethod(operationName = „testControl")

753

public Long testControl(

754

@WebParam(name = „testSessionId") final Long testSessionId,

755

@WebParam(name = „studentIds") final StudentIdsWrapper students,

756

@WebParam(name = „status") final Integer status,

757

@WebParam(name = „parameters") final MapWrapper parameters) throws Exception {

}

=== Parameters testControl ===

762

763

(% class="wrapped" %)

|(((

testSessionId

)))|(((

Unique ID assigned by the LMS, which serves as an identifier for the test (cf. registerTest).

)))

|(((

studentIds

)))|(((

List of unique IDs for test participants.

)))

|(((

status

)))|(((

New status to be set for the given test participants.

)))

|(((

parameters

)))|(((

List of test control parameters (all optional):

783

784

* addTime: Time in minutes to add to the test session.

785

)))

786

787

=== ReturnValue testControl ===

788

789

(% class="wrapped" %)

|(((

Long

)))|(((

One of the values as described under "Registration of a test".

)))

== Clear storage ==

When all participants have finished the test, the LMS can inform ONYX to deregister the test and to clear the storage.

799

800

801

@WebMethod(operationName = „deregisterTest")

802

public Long deregisterTest(

803

@WebParam(name = „testSessionId") final Long testSessionId,

804

@WebParam(name = „providerId") final String providerId,

805

@WebParam(name = „parameters") final MapWrapper parameters) throws Exception {

}

=== Parameters deregisterTest ===

810

811

(% class="wrapped" %)

|(((

testSessionId

)))|(((

Unique ID assigned by the LMS, which serves as an identifier for the test (cf. registerTest).

)))

|(((

providerId

)))|(((

Identification under which the requesting LMS is registered with ONYX.

)))

|(((

parameters

)))|(((

Currently not used.

)))

=== ReturnValue deregisterTest ===

829

830

(% class="wrapped" %)

|(((

Long

)))|(((

One of the values as described under "Registration of a test".

)))

== Test display ==

After a test has been registered with the Player, the user can display it **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 will be returned to the LMS. The LMS then needs to define a web service API that exactly matches the WSDL available under the following URL:

840

841

842

[[http:~~/~~/demo.bps-system.de/olatce/services/ReturnWSService?wsdl>>url:http://demo.bps-system.de/olatce/services/ReturnWSService?wsdl||shape="rect"]]

843

Only the URL in the lower part of the WSDL has to be adapted to the LMS.

844

845

846

== Configuration of the ONYX Player ==

847

848

The ONYX Player uses a configuration file named onyxplugin.config.xml, which must be stored in the Java Classpath.

849

850

851

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 by all users. If HTTPS is used during the test process (which is strongly recommended), then the appropriate certificate must be known to the corresponding JVM of the LMS and the ONYX Player. Otherwise web service communication will not be possible.

----