Änderungen von Dokument 08 Schnittstelle ONYX Reporter
Zuletzt geändert von Carina Enke am 13.02.2024
Von Version 341.1
bearbeitet von Carina Enke
am 15.10.2018
am 15.10.2018
Änderungskommentar:
Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 1.12.
Auf Version 378.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,16 +1,5 @@ 1 1 {{sv-translation language="de"}} 2 2 {{layout}} 3 -{{layout-section ac:type="single"}} 4 -{{layout-cell}} 5 - 6 - 7 -(% class="removedPlaceholderWrapper" %) 8 - 9 - 10 - 11 -{{/layout-cell}} 12 -{{/layout-section}} 13 - 14 14 {{layout-section ac:type="two_right_sidebar"}} 15 15 {{layout-cell}} 16 16 ====== Inhalt: ====== ... ... @@ -17,11 +17,34 @@ 17 17 18 18 19 19 20 -{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}9 +{{toc maxLevel="5" style="square" outline="true" absoluteUrl="true"/}} 21 21 {{/layout-cell}} 22 22 23 23 {{layout-cell}} 13 +|=(% colspan="1" %)(% colspan="1" %) 14 +((( 15 +Programmversion 16 +)))|(% colspan="1" %)(% colspan="1" %) 17 +((( 24 24 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 +))) 25 25 {{/layout-cell}} 26 26 {{/layout-section}} 27 27 ... ... @@ -61,7 +61,7 @@ 61 61 62 62 == Anmeldung des LMS == 63 63 64 -{{code language="xml"title="Anmeldung des LMS"}}76 +{{code title="Anmeldung des LMS" language="xml"}} 65 65 @WebMethod(operationName = „armSite") 66 66 public String armSite( 67 67 @WebParam(name = „version") final Integer version, ... ... @@ -126,7 +126,7 @@ 126 126 127 127 == Initialisierung durch LMS == 128 128 129 -{{code language="xml"title="Initialisierung durch LMS"}}141 +{{code title="Initialisierung durch LMS" language="xml"}} 130 130 @WebMethod(operationName = „initiateSite") 131 131 public String initiateSite( 132 132 @WebParam(name = „version") final Integer version, ... ... @@ -247,7 +247,7 @@ 247 247 248 248 == Abfrage von Lernerresultaten durch LMS == 249 249 250 -{{code language="xml"title="Abfrage von Lernerresultaten durch LMS"}}262 +{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}} 251 251 @WebMethod(operationName = „getResultValues") 252 252 public HashMapWrapper getResultValues( 253 253 @WebParam(name = „version") final Integer version, ... ... @@ -299,7 +299,7 @@ 299 299 300 300 == Abfrage von Ergebnisvariablen durch LMS == 301 301 302 -{{code language="xml"title="Abfrage von Ergebnisvariablen durch LMS"}}314 +{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}} 303 303 @WebMethod(operationName = „getResultVariables") 304 304 public HashMapWrapper getResultVariables( 305 305 @WebParam(name = „version") final Integer version, ... ... @@ -336,7 +336,7 @@ 336 336 337 337 == Wrapper == 338 338 339 -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. 340 340 341 341 === Wrapper für die HashMap<String, String> === 342 342 ... ... @@ -362,7 +362,7 @@ 362 362 {{layout-cell}} 363 363 ====== relevante Links: ====== 364 364 365 -* [[doc:ONYX Player Interface]]377 +* [[doc:Schnittstelle ONYX WebPlayer]] 366 366 {{/layout-cell}} 367 367 {{/layout-section}} 368 368 {{/layout}} ... ... @@ -376,39 +376,64 @@ 376 376 377 377 378 378 379 -{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}391 +{{toc style="square" maxLevel="5" outline="true" absoluteUrl="true"/}} 380 380 {{/layout-cell}} 381 381 382 382 {{layout-cell}} 395 +|=(% colspan="1" %)(% colspan="1" %) 396 +((( 397 +Programmversion 398 +)))|(% colspan="1" %)(% colspan="1" %) 399 +((( 383 383 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 +))) 384 384 {{/layout-cell}} 385 385 {{/layout-section}} 386 386 387 387 {{layout-section ac:type="single"}} 388 388 {{layout-cell}} 389 - ==General information ==424 + 390 390 391 - TheAPI to the ONYX WebReporter enables the communicationbetween the LMS and the Reporter. Therefore, a couple of commandswill be executed:426 +== Allgemeines == 392 392 428 +Über die Schnittstelle zum ONYX WebReporter erfolgt jede Kommunikation zwischen dem LMS und dem Reporter. Dazu erfolgt eine Reihe von Aufrufen: 429 + 393 393 |((( 394 394 armSite 395 395 )))|((( 396 - Registration of sequencerequestsat the ONYX Reporter433 +Anmeldung von Folgerequests beim ONYX Reporter. 397 397 ))) 398 398 |((( 399 399 initiateSite 400 400 )))|((( 401 -Initi atesthe Reportersession (transmissionof the CP).438 +Initiiert die Reporter-Session (Übertragung des CPs). 402 402 ))) 403 403 |((( 404 404 disarmSite 405 405 )))|((( 406 - Release ofall Reporterresourcesforthissession.443 +Freigabe von allen Reporter-Ressourcen für diese Session. 407 407 ))) 408 408 |((( 409 409 getResultValues 410 410 )))|((( 411 - Returnsall(requested)resultsforthetest.Condition:Thereisonlyonestudent inthelisttransmitted withinitiateSite.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. 412 412 ))) 413 413 |(% colspan="1" %)(% colspan="1" %) 414 414 ((( ... ... @@ -415,12 +415,12 @@ 415 415 getResultVariables 416 416 )))|(% colspan="1" %)(% colspan="1" %) 417 417 ((( 418 - Returnsall(requested)outcomevariablesforthetest.NoarmSite, initiateSite,or disarmSiteis required.455 +Gibt alle bzw. die angeforderten Outcome-Variablen für den Test zurück. Hierfür sind kein armSite, initiateSite oder disarmSite erforderlich. 419 419 ))) 420 420 421 -== Loginthroughthe LMS ==458 +== Anmeldung des LMS == 422 422 423 -{{code language="xml"title="Loginthroughthe LMS"}}460 +{{code title="Anmeldung des LMS" language="xml"}} 424 424 @WebMethod(operationName = „armSite") 425 425 public String armSite( 426 426 @WebParam(name = „version") final Integer version, ... ... @@ -438,27 +438,27 @@ 438 438 |((( 439 439 version 440 440 )))|((( 441 - Requestedversion: 1478 +Angefragte Version: 1 442 442 ))) 443 443 |((( 444 444 userId 445 445 )))|((( 446 -UserId of the requested Reporterser483 +UserId des anfragenden Reporter-Benutzers 447 447 ))) 448 448 |((( 449 449 optionalRole 450 450 )))|((( 451 -Optional. User role. 0 =student, 1tutor488 +Optional. Rolle des Benutzers. 0 = Student, 1= Tutor 452 452 ))) 453 453 |((( 454 454 secretToShare 455 455 )))|((( 456 - Asecretstring thatallowstheserverandclientto encrypt theircommunication. Mustremainthesameforany furthercommunication.493 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben. 457 457 ))) 458 458 |((( 459 459 optionalUserLastName 460 460 )))|((( 461 -Optional. Lastnameof the user.498 +Optional. Nachname des Benutzers. 462 462 ))) 463 463 |(% colspan="1" %)(% colspan="1" %) 464 464 ((( ... ... @@ -465,7 +465,7 @@ 465 465 optionalUserFirstName 466 466 )))|(% colspan="1" %)(% colspan="1" %) 467 467 ((( 468 -Optional. Firstnameof the user.505 +Optional. Vorname des Benutzers. 469 469 ))) 470 470 |(% colspan="1" %)(% colspan="1" %) 471 471 ((( ... ... @@ -480,12 +480,12 @@ 480 480 |((( 481 481 String 482 482 )))|((( 483 -Session ID which hastobe usedto markanyother Reporter call.520 +Session ID, mit der alle weiteren Reporter-Aufrufe gekennzeichnet werden müssen. 484 484 ))) 485 485 486 -== Initialis ation through LMS ==523 +== Initialisierung durch LMS == 487 487 488 -{{code language="xml"title="Initialisation through LMS"}}525 +{{code title="Initialisierung durch LMS" language="xml"}} 489 489 @WebMethod(operationName = „initiateSite") 490 490 public String initiateSite( 491 491 @WebParam(name = „version") final Integer version, ... ... @@ -502,7 +502,7 @@ 502 502 |((( 503 503 version 504 504 )))|((( 505 - Requestedversion: 1542 +Angefragte Version: 1 506 506 ))) 507 507 |(% colspan="1" %)(% colspan="1" %) 508 508 ((( ... ... @@ -509,22 +509,22 @@ 509 509 sessionId 510 510 )))|(% colspan="1" %)(% colspan="1" %) 511 511 ((( 512 -SessionId, as returnedbyarmSite.549 +SessionId, wie von armSite zurück geliefert. 513 513 ))) 514 514 |((( 515 515 secretToShare 516 516 )))|((( 517 - Asecretstring thatallowstheserverandclientto encrypt theircommunication. Mustremainthesameforany furthercommunication.554 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben. 518 518 ))) 519 519 |((( 520 520 students 521 521 )))|((( 522 -List ofstudents andtheirresults. Seebelow.559 +Liste der Studenten mit ihren Resultaten. Siehe unten. 523 523 ))) 524 524 |((( 525 525 optionalContentPackage 526 526 )))|((( 527 -Optional. Content package (zipped) asbytearray.564 +Optional. Content Package (gezippt) als Byte-Array. 528 528 ))) 529 529 |((( 530 530 additionalParams ... ... @@ -537,13 +537,11 @@ 537 537 |((( 538 538 String 539 539 )))|((( 540 -Absolute URL of the Reportersite forthe IFrame.TheURL has tobe amendedby theLMSwiththe following URLparameters:577 +Absolute URL der Reporter-Seite für den IFrame. Dieser ist vom LMS durch die folgenden URL-Parameter anzureichern: 541 541 542 -* sid: Session ID, as returned by armSite 543 -* ((( 544 -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 545 545 ))) 546 -))) 547 547 548 548 {{code language="xml"}} 549 549 public class ResultsForStudent { ... ... @@ -557,7 +557,7 @@ 557 557 } 558 558 {{/code}} 559 559 560 -== LogoutthroughtheLMS ==595 +== Abmeldung durch LMS == 561 561 562 562 563 563 ... ... @@ -578,7 +578,7 @@ 578 578 |((( 579 579 version 580 580 )))|((( 581 - Requestedversion: 1616 +Angefragte Version: 1 582 582 ))) 583 583 |(% colspan="1" %)(% colspan="1" %) 584 584 ((( ... ... @@ -585,12 +585,12 @@ 585 585 sessionId 586 586 )))|(% colspan="1" %)(% colspan="1" %) 587 587 ((( 588 -SessionId, as returnedbyarmSite.623 +SessionId, wie von armSite zurück geliefert. 589 589 ))) 590 590 |((( 591 591 secretToShare 592 592 )))|((( 593 - Asecretstring thatallowstheserverandclientto encrypt theircommunication. Mustremainthesameforany furthercommunication.628 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben. 594 594 ))) 595 595 |((( 596 596 additionalParams ... ... @@ -603,12 +603,12 @@ 603 603 |((( 604 604 Boolean 605 605 )))|((( 606 -True i nthe case ofsuccess, otherwisefalse.641 +True bei Erfolg, sonst false. 607 607 ))) 608 608 609 -== RequestoflearnersthroughtheLMS ==644 +== Abfrage von Lernerresultaten durch LMS == 610 610 611 -{{code language="xml"title="RequestoflearnersthroughtheLMS"}}646 +{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}} 612 612 @WebMethod(operationName = „getResultValues") 613 613 public HashMapWrapper getResultValues( 614 614 @WebParam(name = „version") final Integer version, ... ... @@ -625,7 +625,7 @@ 625 625 |((( 626 626 version 627 627 )))|((( 628 - Requestedversion: 1663 +Angefragte Version: 1 629 629 ))) 630 630 |(% colspan="1" %)(% colspan="1" %) 631 631 ((( ... ... @@ -632,17 +632,17 @@ 632 632 sessionId 633 633 )))|(% colspan="1" %)(% colspan="1" %) 634 634 ((( 635 -SessionId, as returnedbyarmSite.670 +SessionId, wie von armSite zurück geliefert. 636 636 ))) 637 637 |((( 638 638 secretToShare 639 639 )))|((( 640 - Asecretstring thatallowstheserverandclientto encrypt theircommunication. Mustremainthesameforany furthercommunication.675 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben. 641 641 ))) 642 642 |((( 643 643 requestedValues 644 644 )))|((( 645 - Canbe empty,in which case allresultvariablesarereturned.If keysareincluded, onlythekeyswillbereturned.680 +Kann leer sein, dann werden alle Result-Variables zurück geliefert. Sind Keys enthalten, so kommen nur diese zurück. 646 646 ))) 647 647 |((( 648 648 additionalParams ... ... @@ -655,12 +655,12 @@ 655 655 |((( 656 656 HashMap<String, String> 657 657 )))|((( 658 -Map ofresultvariables,key ishevariablevalueis thespective variable'svalue (HashMap is wrapped)693 +Map der Result-Variables, Key ist der Variablenname, Value der jeweilige Wert (HashMap ist gewrappt) 659 659 ))) 660 660 661 -== RequestofresultvariablesthroughtheLMS ==696 +== Abfrage von Ergebnisvariablen durch LMS == 662 662 663 -{{code language="xml"title="RequestofresultvariablesthroughtheLMS"}}698 +{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}} 664 664 @WebMethod(operationName = „getResultVariables") 665 665 public HashMapWrapper getResultVariables( 666 666 @WebParam(name = „version") final Integer version, ... ... @@ -674,12 +674,12 @@ 674 674 |((( 675 675 version 676 676 )))|((( 677 - Requestedversion: 1712 +Angefragte Version: 1 678 678 ))) 679 679 |((( 680 680 contentPackage 681 681 )))|((( 682 -Content package (zipped) asbytearray.717 +Content Package (gezippt) als Byte-Array. 683 683 ))) 684 684 |((( 685 685 additionalParams ... ... @@ -692,14 +692,14 @@ 692 692 |((( 693 693 HashMap<String, String> 694 694 )))|((( 695 -Map ofresultvariables,key ishevariablevalueis thespective variable'svalue (HashMap is wrapped)730 +Map der Result-Variables, Key ist der Variablenname, Value der jeweilige Wert (HashMap ist gewrappt) 696 696 ))) 697 697 698 698 == Wrapper == 699 699 700 - Sincethesmissionof mapsandlistsviaJAX-WScancauseproblems,theyhave tobe 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. 701 701 702 -=== Wrapper f or HashMap<String, String> ===737 +=== Wrapper für die HashMap<String, String> === 703 703 704 704 HashMapWrapper.java: 705 705 ... ... @@ -707,7 +707,7 @@ 707 707 708 708 [[image:attach:HashMapWrapperjava2.png]] 709 709 710 -=== Wrapper f orthe ArrayList<ResultsForStudent> ===745 +=== Wrapper für die ArrayList<ResultsForStudent> === 711 711 712 712 ResultsForStudentsWrapper.java: 713 713
- Confluence.Code.ConfluencePageClass[0]
-
- id
-
... ... @@ -1,1 +1,1 @@ 1 - 1825182811 +3342793 - url
-
... ... @@ -1,1 +1,1 @@ 1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/ 182518281/Schnittstelle ONYX Reporter1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/3342793/Schnittstelle ONYX Reporter