Änderungen von Dokument 08 Schnittstelle ONYX Reporter
Zuletzt geändert von Carina Enke am 13.02.2024
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. tleu1 +XWiki.sandra_riediger - Inhalt
-
... ... @@ -6,11 +6,34 @@ 6 6 7 7 8 8 9 -{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}9 +{{toc maxLevel="5" style="square" outline="true" absoluteUrl="true"/}} 10 10 {{/layout-cell}} 11 11 12 12 {{layout-cell}} 13 +|=(% colspan="1" %)(% colspan="1" %) 14 +((( 15 +Programmversion 16 +)))|(% colspan="1" %)(% colspan="1" %) 17 +((( 13 13 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 +))) 14 14 {{/layout-cell}} 15 15 {{/layout-section}} 16 16 ... ... @@ -50,7 +50,7 @@ 50 50 51 51 == Anmeldung des LMS == 52 52 53 -{{code language="xml"title="Anmeldung des LMS"}}76 +{{code title="Anmeldung des LMS" language="xml"}} 54 54 @WebMethod(operationName = „armSite") 55 55 public String armSite( 56 56 @WebParam(name = „version") final Integer version, ... ... @@ -115,7 +115,7 @@ 115 115 116 116 == Initialisierung durch LMS == 117 117 118 -{{code language="xml"title="Initialisierung durch LMS"}}141 +{{code title="Initialisierung durch LMS" language="xml"}} 119 119 @WebMethod(operationName = „initiateSite") 120 120 public String initiateSite( 121 121 @WebParam(name = „version") final Integer version, ... ... @@ -236,7 +236,7 @@ 236 236 237 237 == Abfrage von Lernerresultaten durch LMS == 238 238 239 -{{code language="xml"title="Abfrage von Lernerresultaten durch LMS"}}262 +{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}} 240 240 @WebMethod(operationName = „getResultValues") 241 241 public HashMapWrapper getResultValues( 242 242 @WebParam(name = „version") final Integer version, ... ... @@ -288,7 +288,7 @@ 288 288 289 289 == Abfrage von Ergebnisvariablen durch LMS == 290 290 291 -{{code language="xml"title="Abfrage von Ergebnisvariablen durch LMS"}}314 +{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}} 292 292 @WebMethod(operationName = „getResultVariables") 293 293 public HashMapWrapper getResultVariables( 294 294 @WebParam(name = „version") final Integer version, ... ... @@ -351,7 +351,7 @@ 351 351 {{layout-cell}} 352 352 ====== relevante Links: ====== 353 353 354 -* [[doc:Schnittstelle ONYX Player]] 377 +* [[doc:Schnittstelle ONYX WebPlayer]] 355 355 {{/layout-cell}} 356 356 {{/layout-section}} 357 357 {{/layout}} ... ... @@ -365,39 +365,64 @@ 365 365 366 366 367 367 368 -{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}391 +{{toc style="square" maxLevel="5" outline="true" absoluteUrl="true"/}} 369 369 {{/layout-cell}} 370 370 371 371 {{layout-cell}} 395 +|=(% colspan="1" %)(% colspan="1" %) 396 +((( 397 +Programmversion 398 +)))|(% colspan="1" %)(% colspan="1" %) 399 +((( 372 372 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 +))) 373 373 {{/layout-cell}} 374 374 {{/layout-section}} 375 375 376 376 {{layout-section ac:type="single"}} 377 377 {{layout-cell}} 378 - ==General ==424 + 379 379 380 - TheAPI to the ONYX WebReporter enables the communicationbetween the LMS and the reporter. Therefore, a couple of commandswill be executed:426 +== Allgemeines == 381 381 428 +Über die Schnittstelle zum ONYX WebReporter erfolgt jede Kommunikation zwischen dem LMS und dem Reporter. Dazu erfolgt eine Reihe von Aufrufen: 429 + 382 382 |((( 383 383 armSite 384 384 )))|((( 385 - Registration of sequencerequestsat the ONYXreporter433 +Anmeldung von Folgerequests beim ONYX Reporter. 386 386 ))) 387 387 |((( 388 388 initiateSite 389 389 )))|((( 390 -Initi atesthereportersession (transmissionof the CP).438 +Initiiert die Reporter-Session (Übertragung des CPs). 391 391 ))) 392 392 |((( 393 393 disarmSite 394 394 )))|((( 395 - Release ofallreporterresourcesforthissession.443 +Freigabe von allen Reporter-Ressourcen für diese Session. 396 396 ))) 397 397 |((( 398 398 getResultValues 399 399 )))|((( 400 - 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. 401 401 ))) 402 402 |(% colspan="1" %)(% colspan="1" %) 403 403 ((( ... ... @@ -404,12 +404,12 @@ 404 404 getResultVariables 405 405 )))|(% colspan="1" %)(% colspan="1" %) 406 406 ((( 407 - 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. 408 408 ))) 409 409 410 -== Connectionto the LMS ==458 +== Anmeldung des LMS == 411 411 412 -{{code language="xml"title="Anmeldung des LMS"}}460 +{{code title="Anmeldung des LMS" language="xml"}} 413 413 @WebMethod(operationName = „armSite") 414 414 public String armSite( 415 415 @WebParam(name = „version") final Integer version, ... ... @@ -427,27 +427,27 @@ 427 427 |((( 428 428 version 429 429 )))|((( 430 - Requestedversion: 1478 +Angefragte Version: 1 431 431 ))) 432 432 |((( 433 433 userId 434 434 )))|((( 435 -UserId of the requestedreporterser483 +UserId des anfragenden Reporter-Benutzers 436 436 ))) 437 437 |((( 438 438 optionalRole 439 439 )))|((( 440 -Optional. User role. 0=student, 1=tutor488 +Optional. Rolle des Benutzers. 0 = Student, 1= Tutor 441 441 ))) 442 442 |((( 443 443 secretToShare 444 444 )))|((( 445 - 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. 446 446 ))) 447 447 |((( 448 448 optionalUserLastName 449 449 )))|((( 450 -Optional. User lastname.498 +Optional. Nachname des Benutzers. 451 451 ))) 452 452 |(% colspan="1" %)(% colspan="1" %) 453 453 ((( ... ... @@ -454,7 +454,7 @@ 454 454 optionalUserFirstName 455 455 )))|(% colspan="1" %)(% colspan="1" %) 456 456 ((( 457 -Optional. Userfirstname.505 +Optional. Vorname des Benutzers. 458 458 ))) 459 459 |(% colspan="1" %)(% colspan="1" %) 460 460 ((( ... ... @@ -469,12 +469,12 @@ 469 469 |((( 470 470 String 471 471 )))|((( 472 -Session ID t hathas to be usedto markanyfurtherreporter call.520 +Session ID, mit der alle weiteren Reporter-Aufrufe gekennzeichnet werden müssen. 473 473 ))) 474 474 475 -== Initialis ation through LMS ==523 +== Initialisierung durch LMS == 476 476 477 -{{code language="xml"title="Initialisierung durch LMS"}}525 +{{code title="Initialisierung durch LMS" language="xml"}} 478 478 @WebMethod(operationName = „initiateSite") 479 479 public String initiateSite( 480 480 @WebParam(name = „version") final Integer version, ... ... @@ -491,7 +491,7 @@ 491 491 |((( 492 492 version 493 493 )))|((( 494 - Requestedversion: 1542 +Angefragte Version: 1 495 495 ))) 496 496 |(% colspan="1" %)(% colspan="1" %) 497 497 ((( ... ... @@ -498,22 +498,22 @@ 498 498 sessionId 499 499 )))|(% colspan="1" %)(% colspan="1" %) 500 500 ((( 501 -SessionId, as returnedbyarmSite.549 +SessionId, wie von armSite zurück geliefert. 502 502 ))) 503 503 |((( 504 504 secretToShare 505 505 )))|((( 506 - 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. 507 507 ))) 508 508 |((( 509 509 students 510 510 )))|((( 511 -List ofstudentswiththeirresults. Seebelow.559 +Liste der Studenten mit ihren Resultaten. Siehe unten. 512 512 ))) 513 513 |((( 514 514 optionalContentPackage 515 515 )))|((( 516 -Optional. Content Package (zipp ed) asbytearray.564 +Optional. Content Package (gezippt) als Byte-Array. 517 517 ))) 518 518 |((( 519 519 additionalParams ... ... @@ -526,13 +526,11 @@ 526 526 |((( 527 527 String 528 528 )))|((( 529 -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: 530 530 531 -* sid: Session ID as returned by armSite 532 -* ((( 533 -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 534 534 ))) 535 -))) 536 536 537 537 {{code language="xml"}} 538 538 public class ResultsForStudent { ... ... @@ -546,7 +546,7 @@ 546 546 } 547 547 {{/code}} 548 548 549 -== DeconnectionthroughtheLMS ==595 +== Abmeldung durch LMS == 550 550 551 551 552 552 ... ... @@ -567,7 +567,7 @@ 567 567 |((( 568 568 version 569 569 )))|((( 570 - Requestedversion: 1616 +Angefragte Version: 1 571 571 ))) 572 572 |(% colspan="1" %)(% colspan="1" %) 573 573 ((( ... ... @@ -574,12 +574,12 @@ 574 574 sessionId 575 575 )))|(% colspan="1" %)(% colspan="1" %) 576 576 ((( 577 -SessionId, as returnedbyarmSite.623 +SessionId, wie von armSite zurück geliefert. 578 578 ))) 579 579 |((( 580 580 secretToShare 581 581 )))|((( 582 - 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. 583 583 ))) 584 584 |((( 585 585 additionalParams ... ... @@ -592,12 +592,12 @@ 592 592 |((( 593 593 Boolean 594 594 )))|((( 595 -True i fsuccessful, otherwisefalse.641 +True bei Erfolg, sonst false. 596 596 ))) 597 597 598 -== RequestoflearningresultsthroughtheLMS ==644 +== Abfrage von Lernerresultaten durch LMS == 599 599 600 -{{code language="xml"title="Abfrage von Lernerresultaten durch LMS"}}646 +{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}} 601 601 @WebMethod(operationName = „getResultValues") 602 602 public HashMapWrapper getResultValues( 603 603 @WebParam(name = „version") final Integer version, ... ... @@ -614,7 +614,7 @@ 614 614 |((( 615 615 version 616 616 )))|((( 617 - Requestedversion: 1663 +Angefragte Version: 1 618 618 ))) 619 619 |(% colspan="1" %)(% colspan="1" %) 620 620 ((( ... ... @@ -621,17 +621,17 @@ 621 621 sessionId 622 622 )))|(% colspan="1" %)(% colspan="1" %) 623 623 ((( 624 -SessionId, as returnedbyarmSite.670 +SessionId, wie von armSite zurück geliefert. 625 625 ))) 626 626 |((( 627 627 secretToShare 628 628 )))|((( 629 - 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. 630 630 ))) 631 631 |((( 632 632 requestedValues 633 633 )))|((( 634 - 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. 635 635 ))) 636 636 |((( 637 637 additionalParams ... ... @@ -644,12 +644,12 @@ 644 644 |((( 645 645 HashMap<String, String> 646 646 )))|((( 647 -Map ofresultvariables,key ishevariablevaluethecorrespondingvalue (HashMap is wrapped)693 +Map der Result-Variables, Key ist der Variablenname, Value der jeweilige Wert (HashMap ist gewrappt) 648 648 ))) 649 649 650 -== RequestofresultvariablesthroughtheLMS ==696 +== Abfrage von Ergebnisvariablen durch LMS == 651 651 652 -{{code language="xml"title="Abfrage von Ergebnisvariablen durch LMS"}}698 +{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}} 653 653 @WebMethod(operationName = „getResultVariables") 654 654 public HashMapWrapper getResultVariables( 655 655 @WebParam(name = „version") final Integer version, ... ... @@ -663,12 +663,12 @@ 663 663 |((( 664 664 version 665 665 )))|((( 666 - Requestedversion: 1712 +Angefragte Version: 1 667 667 ))) 668 668 |((( 669 669 contentPackage 670 670 )))|((( 671 -Content package (zipped) asbytearray.717 +Content Package (gezippt) als Byte-Array. 672 672 ))) 673 673 |((( 674 674 additionalParams ... ... @@ -681,15 +681,14 @@ 681 681 |((( 682 682 HashMap<String, String> 683 683 )))|((( 684 -Map of result variables, key is the variable name, value the corresponding 685 -value (HashMap is wrapped). 730 +Map der Result-Variables, Key ist der Variablenname, Value der jeweilige Wert (HashMap ist gewrappt) 686 686 ))) 687 687 688 688 == Wrapper == 689 689 690 - 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. 691 691 692 -=== Wrapper f or HashMap<String, String> ===737 +=== Wrapper für die HashMap<String, String> === 693 693 694 694 HashMapWrapper.java: 695 695 ... ... @@ -697,7 +697,7 @@ 697 697 698 698 [[image:attach:HashMapWrapperjava2.png]] 699 699 700 -=== Wrapper f orthe ArrayList<ResultsForStudent> ===745 +=== Wrapper für die ArrayList<ResultsForStudent> === 701 701 702 702 ResultsForStudentsWrapper.java: 703 703
- Confluence.Code.ConfluencePageClass[0]
-
- id
-
... ... @@ -1,1 +1,1 @@ 1 - 1469649031 +3342793 - url
-
... ... @@ -1,1 +1,1 @@ 1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/ 146964903/Schnittstelle ONYX Reporter1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/3342793/Schnittstelle ONYX Reporter