Änderungen von Dokument 08 Schnittstelle ONYX Reporter
Zuletzt geändert von Carina Enke am 13.02.2024
Von Version 352.1
bearbeitet von Carina Enke
am 08.03.2018
am 08.03.2018
Änderungskommentar:
Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 1.11.1.
Auf Version 379.1
bearbeitet von sandra_riediger
am 15.12.2014
am 15.12.2014
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Zusammenfassung
-
Seiteneigenschaften (2 geändert, 0 hinzugefügt, 0 gelöscht)
-
Objekte (1 geändert, 0 hinzugefügt, 0 gelöscht)
Details
- Seiteneigenschaften
-
- Dokument-Autor
-
... ... @@ -1,1 +1,1 @@ 1 -XWiki. carina1 +XWiki.sandra_riediger - Inhalt
-
... ... @@ -1,9 +1,5 @@ 1 1 {{sv-translation language="de"}} 2 2 {{layout}} 3 -{{layout-section ac:type="single"}} 4 -{{layout-cell}}{{/layout-cell}} 5 -{{/layout-section}} 6 - 7 7 {{layout-section ac:type="two_right_sidebar"}} 8 8 {{layout-cell}} 9 9 ====== Inhalt: ====== ... ... @@ -10,11 +10,34 @@ 10 10 11 11 12 12 13 -{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}9 +{{toc maxLevel="5" style="square" outline="true" absoluteUrl="true"/}} 14 14 {{/layout-cell}} 15 15 16 16 {{layout-cell}} 13 +|=(% colspan="1" %)(% colspan="1" %) 14 +((( 15 +Programmversion 16 +)))|(% colspan="1" %)(% colspan="1" %) 17 +((( 17 17 19 +))) 20 +|=((( 21 +Status 22 +)))|((( 23 +(% class="status-macro aui-lozenge aui-lozenge-error" %)ENTWURF 24 +))) 25 +|=((( 26 +Aufgaben 27 +)))|((( 28 + 29 + 30 + 31 +))) 32 +|=((( 33 +JIRA 34 +)))|((( 35 + 36 +))) 18 18 {{/layout-cell}} 19 19 {{/layout-section}} 20 20 ... ... @@ -54,7 +54,7 @@ 54 54 55 55 == Anmeldung des LMS == 56 56 57 -{{code language="xml"title="Anmeldung des LMS"}}76 +{{code title="Anmeldung des LMS" language="xml"}} 58 58 @WebMethod(operationName = „armSite") 59 59 public String armSite( 60 60 @WebParam(name = „version") final Integer version, ... ... @@ -119,7 +119,7 @@ 119 119 120 120 == Initialisierung durch LMS == 121 121 122 -{{code language="xml"title="Initialisierung durch LMS"}}141 +{{code title="Initialisierung durch LMS" language="xml"}} 123 123 @WebMethod(operationName = „initiateSite") 124 124 public String initiateSite( 125 125 @WebParam(name = „version") final Integer version, ... ... @@ -240,7 +240,7 @@ 240 240 241 241 == Abfrage von Lernerresultaten durch LMS == 242 242 243 -{{code language="xml"title="Abfrage von Lernerresultaten durch LMS"}}262 +{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}} 244 244 @WebMethod(operationName = „getResultValues") 245 245 public HashMapWrapper getResultValues( 246 246 @WebParam(name = „version") final Integer version, ... ... @@ -292,7 +292,7 @@ 292 292 293 293 == Abfrage von Ergebnisvariablen durch LMS == 294 294 295 -{{code language="xml"title="Abfrage von Ergebnisvariablen durch LMS"}}314 +{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}} 296 296 @WebMethod(operationName = „getResultVariables") 297 297 public HashMapWrapper getResultVariables( 298 298 @WebParam(name = „version") final Integer version, ... ... @@ -329,7 +329,7 @@ 329 329 330 330 == Wrapper == 331 331 332 -Da die Übertragung von Maps und Listen über JAX-WS Probleme machen kann, müssen diese gewrappt werden.351 +Da die Übertragung von Maps und Listen über JAX-WS Probleme macht (clientseitig gefüllte Listen werden leer über den WS versandt und kommen daher auch leer serverseitig an), müssen diese gewrappt werden. 333 333 334 334 === Wrapper für die HashMap<String, String> === 335 335 ... ... @@ -355,7 +355,7 @@ 355 355 {{layout-cell}} 356 356 ====== relevante Links: ====== 357 357 358 -* [[doc:ONYX Player Interface]]377 +* [[doc:Schnittstelle ONYX WebPlayer]] 359 359 {{/layout-cell}} 360 360 {{/layout-section}} 361 361 {{/layout}} ... ... @@ -369,39 +369,64 @@ 369 369 370 370 371 371 372 -{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}391 +{{toc style="square" maxLevel="5" outline="true" absoluteUrl="true"/}} 373 373 {{/layout-cell}} 374 374 375 375 {{layout-cell}} 395 +|=(% colspan="1" %)(% colspan="1" %) 396 +((( 397 +Programmversion 398 +)))|(% colspan="1" %)(% colspan="1" %) 399 +((( 376 376 401 +))) 402 +|=((( 403 +Status 404 +)))|((( 405 +(% class="status-macro aui-lozenge aui-lozenge-error" %)DRAFT 406 +))) 407 +|=((( 408 +Aufgaben 409 +)))|((( 410 + 411 + 412 + 413 +))) 414 +|=((( 415 +JIRA 416 +)))|((( 417 + 418 +))) 377 377 {{/layout-cell}} 378 378 {{/layout-section}} 379 379 380 380 {{layout-section ac:type="single"}} 381 381 {{layout-cell}} 382 - ==General ==424 + 383 383 384 - TheAPI to the ONYX WebReporter enables the communicationbetween the LMS and the reporter. Therefore, a couple of commandswill be executed:426 +== Allgemeines == 385 385 428 +Über die Schnittstelle zum ONYX WebReporter erfolgt jede Kommunikation zwischen dem LMS und dem Reporter. Dazu erfolgt eine Reihe von Aufrufen: 429 + 386 386 |((( 387 387 armSite 388 388 )))|((( 389 - Registration of sequencerequestsat the ONYXreporter433 +Anmeldung von Folgerequests beim ONYX Reporter. 390 390 ))) 391 391 |((( 392 392 initiateSite 393 393 )))|((( 394 -Initi atesthereportersession (transmissionof the CP).438 +Initiiert die Reporter-Session (Übertragung des CPs). 395 395 ))) 396 396 |((( 397 397 disarmSite 398 398 )))|((( 399 - Release ofallreporterresourcesforthissession.443 +Freigabe von allen Reporter-Ressourcen für diese Session. 400 400 ))) 401 401 |((( 402 402 getResultValues 403 403 )))|((( 404 - Returnsallorallrequestedresultsforthetest.Condition:thereis exactlyonestudent inlisttransmittedintheinitiateSite.448 +Gibt alle bzw. die angeforderten Resultate für den Test zurück. Voraussetzung: Es ist nur exakt ein Student in der bei initiateSite übertragenen Liste. 405 405 ))) 406 406 |(% colspan="1" %)(% colspan="1" %) 407 407 ((( ... ... @@ -408,12 +408,12 @@ 408 408 getResultVariables 409 409 )))|(% colspan="1" %)(% colspan="1" %) 410 410 ((( 411 - Returnsallorallrequestedoutcomevariablesforthetest.NoarmSite, initiateSite or disarmSiteis necessary.455 +Gibt alle bzw. die angeforderten Outcome-Variablen für den Test zurück. Hierfür sind kein armSite, initiateSite oder disarmSite erforderlich. 412 412 ))) 413 413 414 -== Connectionto the LMS ==458 +== Anmeldung des LMS == 415 415 416 -{{code language="xml"title="Anmeldung des LMS"}}460 +{{code title="Anmeldung des LMS" language="xml"}} 417 417 @WebMethod(operationName = „armSite") 418 418 public String armSite( 419 419 @WebParam(name = „version") final Integer version, ... ... @@ -431,27 +431,27 @@ 431 431 |((( 432 432 version 433 433 )))|((( 434 - Requestedversion: 1478 +Angefragte Version: 1 435 435 ))) 436 436 |((( 437 437 userId 438 438 )))|((( 439 -UserId of the requestedreporterser483 +UserId des anfragenden Reporter-Benutzers 440 440 ))) 441 441 |((( 442 442 optionalRole 443 443 )))|((( 444 -Optional. User role. 0=student, 1=tutor488 +Optional. Rolle des Benutzers. 0 = Student, 1= Tutor 445 445 ))) 446 446 |((( 447 447 secretToShare 448 448 )))|((( 449 - Shared secret.Hastoremain identicalfor everycommunication.493 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben. 450 450 ))) 451 451 |((( 452 452 optionalUserLastName 453 453 )))|((( 454 -Optional. User lastname.498 +Optional. Nachname des Benutzers. 455 455 ))) 456 456 |(% colspan="1" %)(% colspan="1" %) 457 457 ((( ... ... @@ -458,7 +458,7 @@ 458 458 optionalUserFirstName 459 459 )))|(% colspan="1" %)(% colspan="1" %) 460 460 ((( 461 -Optional. Userfirstname.505 +Optional. Vorname des Benutzers. 462 462 ))) 463 463 |(% colspan="1" %)(% colspan="1" %) 464 464 ((( ... ... @@ -473,12 +473,12 @@ 473 473 |((( 474 474 String 475 475 )))|((( 476 -Session ID t hathas to be usedto markanyfurtherreporter call.520 +Session ID, mit der alle weiteren Reporter-Aufrufe gekennzeichnet werden müssen. 477 477 ))) 478 478 479 -== Initialis ation through LMS ==523 +== Initialisierung durch LMS == 480 480 481 -{{code language="xml"title="Initialisierung durch LMS"}}525 +{{code title="Initialisierung durch LMS" language="xml"}} 482 482 @WebMethod(operationName = „initiateSite") 483 483 public String initiateSite( 484 484 @WebParam(name = „version") final Integer version, ... ... @@ -495,7 +495,7 @@ 495 495 |((( 496 496 version 497 497 )))|((( 498 - Requestedversion: 1542 +Angefragte Version: 1 499 499 ))) 500 500 |(% colspan="1" %)(% colspan="1" %) 501 501 ((( ... ... @@ -502,22 +502,22 @@ 502 502 sessionId 503 503 )))|(% colspan="1" %)(% colspan="1" %) 504 504 ((( 505 -SessionId, as returnedbyarmSite.549 +SessionId, wie von armSite zurück geliefert. 506 506 ))) 507 507 |((( 508 508 secretToShare 509 509 )))|((( 510 - Shared secret.Hastoremain identicalateverycommunication.554 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben. 511 511 ))) 512 512 |((( 513 513 students 514 514 )))|((( 515 -List ofstudentswiththeirresults. Seebelow.559 +Liste der Studenten mit ihren Resultaten. Siehe unten. 516 516 ))) 517 517 |((( 518 518 optionalContentPackage 519 519 )))|((( 520 -Optional. Content Package (zipp ed) asbytearray.564 +Optional. Content Package (gezippt) als Byte-Array. 521 521 ))) 522 522 |((( 523 523 additionalParams ... ... @@ -530,13 +530,11 @@ 530 530 |((( 531 531 String 532 532 )))|((( 533 -Absolute URL of thesite fortheframe.It hasto beenrichedbytheLMSwiththe following URLparameters:577 +Absolute URL der Reporter-Seite für den IFrame. Dieser ist vom LMS durch die folgenden URL-Parameter anzureichern: 534 534 535 -* sid: Session ID as returned by armSite 536 -* ((( 537 -uid: Student ID as registrated in the initiateSite at the ONYX Reporter. 579 +* sid: Session ID, wie von armSite zurück gegeben 580 +* uid: Student ID, wie in initiateSite beim Reporter angemeldet 538 538 ))) 539 -))) 540 540 541 541 {{code language="xml"}} 542 542 public class ResultsForStudent { ... ... @@ -550,7 +550,7 @@ 550 550 } 551 551 {{/code}} 552 552 553 -== DeconnectionthroughtheLMS ==595 +== Abmeldung durch LMS == 554 554 555 555 556 556 ... ... @@ -571,7 +571,7 @@ 571 571 |((( 572 572 version 573 573 )))|((( 574 - Requestedversion: 1616 +Angefragte Version: 1 575 575 ))) 576 576 |(% colspan="1" %)(% colspan="1" %) 577 577 ((( ... ... @@ -578,12 +578,12 @@ 578 578 sessionId 579 579 )))|(% colspan="1" %)(% colspan="1" %) 580 580 ((( 581 -SessionId, as returnedbyarmSite.623 +SessionId, wie von armSite zurück geliefert. 582 582 ))) 583 583 |((( 584 584 secretToShare 585 585 )))|((( 586 - Shared secret.Hastoremain identicalateverycommunication.628 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben. 587 587 ))) 588 588 |((( 589 589 additionalParams ... ... @@ -596,12 +596,12 @@ 596 596 |((( 597 597 Boolean 598 598 )))|((( 599 -True i fsuccessful, otherwisefalse.641 +True bei Erfolg, sonst false. 600 600 ))) 601 601 602 -== RequestoflearningresultsthroughtheLMS ==644 +== Abfrage von Lernerresultaten durch LMS == 603 603 604 -{{code language="xml"title="Abfrage von Lernerresultaten durch LMS"}}646 +{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}} 605 605 @WebMethod(operationName = „getResultValues") 606 606 public HashMapWrapper getResultValues( 607 607 @WebParam(name = „version") final Integer version, ... ... @@ -618,7 +618,7 @@ 618 618 |((( 619 619 version 620 620 )))|((( 621 - Requestedversion: 1663 +Angefragte Version: 1 622 622 ))) 623 623 |(% colspan="1" %)(% colspan="1" %) 624 624 ((( ... ... @@ -625,17 +625,17 @@ 625 625 sessionId 626 626 )))|(% colspan="1" %)(% colspan="1" %) 627 627 ((( 628 -SessionId, as returnedbyarmSite.670 +SessionId, wie von armSite zurück geliefert. 629 629 ))) 630 630 |((( 631 631 secretToShare 632 632 )))|((( 633 - Shared secret.Hastoremain identicalateverycommunication.675 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben. 634 634 ))) 635 635 |((( 636 636 requestedValues 637 637 )))|((( 638 - Canbe empty,thusallresultvariableswillbereturned.Ifit containskeys,onlythosewillbe returned.680 +Kann leer sein, dann werden alle Result-Variables zurück geliefert. Sind Keys enthalten, so kommen nur diese zurück. 639 639 ))) 640 640 |((( 641 641 additionalParams ... ... @@ -648,12 +648,12 @@ 648 648 |((( 649 649 HashMap<String, String> 650 650 )))|((( 651 -Map ofresultvariables,key ishevariablevaluethecorrespondingvalue (HashMap is wrapped)693 +Map der Result-Variables, Key ist der Variablenname, Value der jeweilige Wert (HashMap ist gewrappt) 652 652 ))) 653 653 654 -== RequestofresultvariablesthroughtheLMS ==696 +== Abfrage von Ergebnisvariablen durch LMS == 655 655 656 -{{code language="xml"title="Abfrage von Ergebnisvariablen durch LMS"}}698 +{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}} 657 657 @WebMethod(operationName = „getResultVariables") 658 658 public HashMapWrapper getResultVariables( 659 659 @WebParam(name = „version") final Integer version, ... ... @@ -667,12 +667,12 @@ 667 667 |((( 668 668 version 669 669 )))|((( 670 - Requestedversion: 1712 +Angefragte Version: 1 671 671 ))) 672 672 |((( 673 673 contentPackage 674 674 )))|((( 675 -Content package (zipped) asbytearray.717 +Content Package (gezippt) als Byte-Array. 676 676 ))) 677 677 |((( 678 678 additionalParams ... ... @@ -685,15 +685,14 @@ 685 685 |((( 686 686 HashMap<String, String> 687 687 )))|((( 688 -Map of result variables, key is the variable name, value the corresponding 689 -value (HashMap is wrapped). 730 +Map der Result-Variables, Key ist der Variablenname, Value der jeweilige Wert (HashMap ist gewrappt) 690 690 ))) 691 691 692 692 == Wrapper == 693 693 694 - Asthe transmissionof mapsandlists generateproblemsviaJAX-WS(lists filled bythecustomeraresentwithoutanydataandthusreachthe serverwithoutdata)theyhaveto be wrapped.735 +Da die Übertragung von Maps und Listen über JAX-WS Probleme macht (clientseitig gefüllte Listen werden leer über den WS versandt und kommen daher auch leer serverseitig an), müssen diese gewrappt werden. 695 695 696 -=== Wrapper f or HashMap<String, String> ===737 +=== Wrapper für die HashMap<String, String> === 697 697 698 698 HashMapWrapper.java: 699 699 ... ... @@ -701,7 +701,7 @@ 701 701 702 702 [[image:attach:HashMapWrapperjava2.png]] 703 703 704 -=== Wrapper f orthe ArrayList<ResultsForStudent> ===745 +=== Wrapper für die ArrayList<ResultsForStudent> === 705 705 706 706 ResultsForStudentsWrapper.java: 707 707
- Confluence.Code.ConfluencePageClass[0]
-
- id
-
... ... @@ -1,1 +1,1 @@ 1 - 1478825091 +3342793 - url
-
... ... @@ -1,1 +1,1 @@ 1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/ 147882509/Schnittstelle ONYX Reporter1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/3342793/Schnittstelle ONYX Reporter