Änderungen von Dokument 08 Schnittstelle ONYX Reporter
Zuletzt geändert von Carina Enke am 13.02.2024
Von Version 275.1
bearbeitet von Carina Enke
am 08.05.2019
am 08.05.2019
Änderungskommentar:
Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 8.7.
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,22 +1,39 @@ 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 - 5 +====== Inhalt: ====== 6 + 7 + 8 + 9 +{{toc maxLevel="5" style="square" outline="true" absoluteUrl="true"/}} 10 10 {{/layout-cell}} 11 11 12 12 {{layout-cell}} 13 -{{scroll-ignore}} 14 -{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Inhalt"}} 13 +|=(% colspan="1" %)(% colspan="1" %) 14 +((( 15 +Programmversion 16 +)))|(% colspan="1" %)(% colspan="1" %) 17 +((( 18 + 19 +))) 20 +|=((( 21 +Status 22 +)))|((( 23 +(% class="status-macro aui-lozenge aui-lozenge-error" %)ENTWURF 24 +))) 25 +|=((( 26 +Aufgaben 27 +)))|((( 28 + 15 15 16 - 17 -{{toc/}} 18 -{{/panel}} 19 -{{/scroll-ignore}} 30 + 31 +))) 32 +|=((( 33 +JIRA 34 +)))|((( 35 + 36 +))) 20 20 {{/layout-cell}} 21 21 {{/layout-section}} 22 22 ... ... @@ -56,7 +56,7 @@ 56 56 57 57 == Anmeldung des LMS == 58 58 59 -{{code language="xml"title="Anmeldung des LMS"}}76 +{{code title="Anmeldung des LMS" language="xml"}} 60 60 @WebMethod(operationName = „armSite") 61 61 public String armSite( 62 62 @WebParam(name = „version") final Integer version, ... ... @@ -121,7 +121,7 @@ 121 121 122 122 == Initialisierung durch LMS == 123 123 124 -{{code language="xml"title="Initialisierung durch LMS"}}141 +{{code title="Initialisierung durch LMS" language="xml"}} 125 125 @WebMethod(operationName = „initiateSite") 126 126 public String initiateSite( 127 127 @WebParam(name = „version") final Integer version, ... ... @@ -242,7 +242,7 @@ 242 242 243 243 == Abfrage von Lernerresultaten durch LMS == 244 244 245 -{{code language="xml"title="Abfrage von Lernerresultaten durch LMS"}}262 +{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}} 246 246 @WebMethod(operationName = „getResultValues") 247 247 public HashMapWrapper getResultValues( 248 248 @WebParam(name = „version") final Integer version, ... ... @@ -294,7 +294,7 @@ 294 294 295 295 == Abfrage von Ergebnisvariablen durch LMS == 296 296 297 -{{code language="xml"title="Abfrage von Ergebnisvariablen durch LMS"}}314 +{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}} 298 298 @WebMethod(operationName = „getResultVariables") 299 299 public HashMapWrapper getResultVariables( 300 300 @WebParam(name = „version") final Integer version, ... ... @@ -331,7 +331,7 @@ 331 331 332 332 == Wrapper == 333 333 334 -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. 335 335 336 336 === Wrapper für die HashMap<String, String> === 337 337 ... ... @@ -357,7 +357,7 @@ 357 357 {{layout-cell}} 358 358 ====== relevante Links: ====== 359 359 360 -* [[doc:ONYX Player Interface]]377 +* [[doc:Schnittstelle ONYX WebPlayer]] 361 361 {{/layout-cell}} 362 362 {{/layout-section}} 363 363 {{/layout}} ... ... @@ -371,39 +371,64 @@ 371 371 372 372 373 373 374 -{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}391 +{{toc style="square" maxLevel="5" outline="true" absoluteUrl="true"/}} 375 375 {{/layout-cell}} 376 376 377 377 {{layout-cell}} 395 +|=(% colspan="1" %)(% colspan="1" %) 396 +((( 397 +Programmversion 398 +)))|(% colspan="1" %)(% colspan="1" %) 399 +((( 378 378 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 +))) 379 379 {{/layout-cell}} 380 380 {{/layout-section}} 381 381 382 382 {{layout-section ac:type="single"}} 383 383 {{layout-cell}} 384 - ==General information ==424 + 385 385 386 - TheAPI to the ONYX WebReporter enables the communicationbetween the LMS and the Reporter. Therefore, a couple of commandswill be executed:426 +== Allgemeines == 387 387 428 +Über die Schnittstelle zum ONYX WebReporter erfolgt jede Kommunikation zwischen dem LMS und dem Reporter. Dazu erfolgt eine Reihe von Aufrufen: 429 + 388 388 |((( 389 389 armSite 390 390 )))|((( 391 - Registration of sequencerequestsat the ONYX Reporter433 +Anmeldung von Folgerequests beim ONYX Reporter. 392 392 ))) 393 393 |((( 394 394 initiateSite 395 395 )))|((( 396 -Initi atesthe Reportersession (transmissionof the CP).438 +Initiiert die Reporter-Session (Übertragung des CPs). 397 397 ))) 398 398 |((( 399 399 disarmSite 400 400 )))|((( 401 - Release ofall Reporterresourcesforthissession.443 +Freigabe von allen Reporter-Ressourcen für diese Session. 402 402 ))) 403 403 |((( 404 404 getResultValues 405 405 )))|((( 406 - 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. 407 407 ))) 408 408 |(% colspan="1" %)(% colspan="1" %) 409 409 ((( ... ... @@ -410,12 +410,12 @@ 410 410 getResultVariables 411 411 )))|(% colspan="1" %)(% colspan="1" %) 412 412 ((( 413 - 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. 414 414 ))) 415 415 416 -== Loginthroughthe LMS ==458 +== Anmeldung des LMS == 417 417 418 -{{code language="xml"title="Loginthroughthe LMS"}}460 +{{code title="Anmeldung des LMS" language="xml"}} 419 419 @WebMethod(operationName = „armSite") 420 420 public String armSite( 421 421 @WebParam(name = „version") final Integer version, ... ... @@ -433,27 +433,27 @@ 433 433 |((( 434 434 version 435 435 )))|((( 436 - Requestedversion: 1478 +Angefragte Version: 1 437 437 ))) 438 438 |((( 439 439 userId 440 440 )))|((( 441 -UserId of the requested Reporterser483 +UserId des anfragenden Reporter-Benutzers 442 442 ))) 443 443 |((( 444 444 optionalRole 445 445 )))|((( 446 -Optional. User role. 0 =student, 1tutor488 +Optional. Rolle des Benutzers. 0 = Student, 1= Tutor 447 447 ))) 448 448 |((( 449 449 secretToShare 450 450 )))|((( 451 - 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. 452 452 ))) 453 453 |((( 454 454 optionalUserLastName 455 455 )))|((( 456 -Optional. Lastnameof the user.498 +Optional. Nachname des Benutzers. 457 457 ))) 458 458 |(% colspan="1" %)(% colspan="1" %) 459 459 ((( ... ... @@ -460,7 +460,7 @@ 460 460 optionalUserFirstName 461 461 )))|(% colspan="1" %)(% colspan="1" %) 462 462 ((( 463 -Optional. Firstnameof the user.505 +Optional. Vorname des Benutzers. 464 464 ))) 465 465 |(% colspan="1" %)(% colspan="1" %) 466 466 ((( ... ... @@ -475,12 +475,12 @@ 475 475 |((( 476 476 String 477 477 )))|((( 478 -Session ID which hastobe usedto markanyother Reporter call.520 +Session ID, mit der alle weiteren Reporter-Aufrufe gekennzeichnet werden müssen. 479 479 ))) 480 480 481 -== Initialis ation through LMS ==523 +== Initialisierung durch LMS == 482 482 483 -{{code language="xml"title="Initialisation through LMS"}}525 +{{code title="Initialisierung durch LMS" language="xml"}} 484 484 @WebMethod(operationName = „initiateSite") 485 485 public String initiateSite( 486 486 @WebParam(name = „version") final Integer version, ... ... @@ -497,7 +497,7 @@ 497 497 |((( 498 498 version 499 499 )))|((( 500 - Requestedversion: 1542 +Angefragte Version: 1 501 501 ))) 502 502 |(% colspan="1" %)(% colspan="1" %) 503 503 ((( ... ... @@ -504,22 +504,22 @@ 504 504 sessionId 505 505 )))|(% colspan="1" %)(% colspan="1" %) 506 506 ((( 507 -SessionId, as returnedbyarmSite.549 +SessionId, wie von armSite zurück geliefert. 508 508 ))) 509 509 |((( 510 510 secretToShare 511 511 )))|((( 512 - 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. 513 513 ))) 514 514 |((( 515 515 students 516 516 )))|((( 517 -List ofstudents andtheirresults. Seebelow.559 +Liste der Studenten mit ihren Resultaten. Siehe unten. 518 518 ))) 519 519 |((( 520 520 optionalContentPackage 521 521 )))|((( 522 -Optional. Content package (zipped) asbytearray.564 +Optional. Content Package (gezippt) als Byte-Array. 523 523 ))) 524 524 |((( 525 525 additionalParams ... ... @@ -532,13 +532,11 @@ 532 532 |((( 533 533 String 534 534 )))|((( 535 -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: 536 536 537 -* sid: Session ID, as returned by armSite 538 -* ((( 539 -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 540 540 ))) 541 -))) 542 542 543 543 {{code language="xml"}} 544 544 public class ResultsForStudent { ... ... @@ -552,7 +552,7 @@ 552 552 } 553 553 {{/code}} 554 554 555 -== LogoutthroughtheLMS ==595 +== Abmeldung durch LMS == 556 556 557 557 558 558 ... ... @@ -573,7 +573,7 @@ 573 573 |((( 574 574 version 575 575 )))|((( 576 - Requestedversion: 1616 +Angefragte Version: 1 577 577 ))) 578 578 |(% colspan="1" %)(% colspan="1" %) 579 579 ((( ... ... @@ -580,12 +580,12 @@ 580 580 sessionId 581 581 )))|(% colspan="1" %)(% colspan="1" %) 582 582 ((( 583 -SessionId, as returnedbyarmSite.623 +SessionId, wie von armSite zurück geliefert. 584 584 ))) 585 585 |((( 586 586 secretToShare 587 587 )))|((( 588 - 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. 589 589 ))) 590 590 |((( 591 591 additionalParams ... ... @@ -598,12 +598,12 @@ 598 598 |((( 599 599 Boolean 600 600 )))|((( 601 -True i nthe case ofsuccess, otherwisefalse.641 +True bei Erfolg, sonst false. 602 602 ))) 603 603 604 -== RequestoflearnersthroughtheLMS ==644 +== Abfrage von Lernerresultaten durch LMS == 605 605 606 -{{code language="xml"title="RequestoflearnersthroughtheLMS"}}646 +{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}} 607 607 @WebMethod(operationName = „getResultValues") 608 608 public HashMapWrapper getResultValues( 609 609 @WebParam(name = „version") final Integer version, ... ... @@ -620,7 +620,7 @@ 620 620 |((( 621 621 version 622 622 )))|((( 623 - Requestedversion: 1663 +Angefragte Version: 1 624 624 ))) 625 625 |(% colspan="1" %)(% colspan="1" %) 626 626 ((( ... ... @@ -627,17 +627,17 @@ 627 627 sessionId 628 628 )))|(% colspan="1" %)(% colspan="1" %) 629 629 ((( 630 -SessionId, as returnedbyarmSite.670 +SessionId, wie von armSite zurück geliefert. 631 631 ))) 632 632 |((( 633 633 secretToShare 634 634 )))|((( 635 - 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. 636 636 ))) 637 637 |((( 638 638 requestedValues 639 639 )))|((( 640 - 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. 641 641 ))) 642 642 |((( 643 643 additionalParams ... ... @@ -650,12 +650,12 @@ 650 650 |((( 651 651 HashMap<String, String> 652 652 )))|((( 653 -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) 654 654 ))) 655 655 656 -== RequestofresultvariablesthroughtheLMS ==696 +== Abfrage von Ergebnisvariablen durch LMS == 657 657 658 -{{code language="xml"title="RequestofresultvariablesthroughtheLMS"}}698 +{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}} 659 659 @WebMethod(operationName = „getResultVariables") 660 660 public HashMapWrapper getResultVariables( 661 661 @WebParam(name = „version") final Integer version, ... ... @@ -669,12 +669,12 @@ 669 669 |((( 670 670 version 671 671 )))|((( 672 - Requestedversion: 1712 +Angefragte Version: 1 673 673 ))) 674 674 |((( 675 675 contentPackage 676 676 )))|((( 677 -Content package (zipped) asbytearray.717 +Content Package (gezippt) als Byte-Array. 678 678 ))) 679 679 |((( 680 680 additionalParams ... ... @@ -687,14 +687,14 @@ 687 687 |((( 688 688 HashMap<String, String> 689 689 )))|((( 690 -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) 691 691 ))) 692 692 693 693 == Wrapper == 694 694 695 - 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. 696 696 697 -=== Wrapper f or HashMap<String, String> ===737 +=== Wrapper für die HashMap<String, String> === 698 698 699 699 HashMapWrapper.java: 700 700 ... ... @@ -702,7 +702,7 @@ 702 702 703 703 [[image:attach:HashMapWrapperjava2.png]] 704 704 705 -=== Wrapper f orthe ArrayList<ResultsForStudent> ===745 +=== Wrapper für die ArrayList<ResultsForStudent> === 706 706 707 707 ResultsForStudentsWrapper.java: 708 708
- Confluence.Code.ConfluencePageClass[0]
-
- id
-
... ... @@ -1,1 +1,1 @@ 1 - 2349794131 +3342793 - url
-
... ... @@ -1,1 +1,1 @@ 1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/ 234979413/Schnittstelle ONYX Reporter1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/3342793/Schnittstelle ONYX Reporter