Änderungen von Dokument 08 Schnittstelle ONYX Reporter
Zuletzt geändert von Carina Enke am 13.02.2024
Zusammenfassung
-
Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)
-
Objekte (1 geändert, 0 hinzugefügt, 0 gelöscht)
Details
- Seiteneigenschaften
-
- Inhalt
-
... ... @@ -6,7 +6,7 @@ 6 6 7 7 8 8 9 -{{toc style="square" maxLevel="5"outline="true" absoluteUrl="true"/}}9 +{{toc maxLevel="5" style="square" outline="true" absoluteUrl="true"/}} 10 10 {{/layout-cell}} 11 11 12 12 {{layout-cell}} ... ... @@ -392,35 +392,60 @@ 392 392 {{/layout-cell}} 393 393 394 394 {{layout-cell}} 395 +|=(% colspan="1" %)(% colspan="1" %) 396 +((( 397 +Programmversion 398 +)))|(% colspan="1" %)(% colspan="1" %) 399 +((( 395 395 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 +))) 396 396 {{/layout-cell}} 397 397 {{/layout-section}} 398 398 399 399 {{layout-section ac:type="single"}} 400 400 {{layout-cell}} 401 - ==General ==424 + 402 402 403 - TheAPI to the ONYX WebReporter enables the communicationbetween the LMS and the reporter. Therefore, a couple of commandswill be executed:426 +== Allgemeines == 404 404 428 +Über die Schnittstelle zum ONYX WebReporter erfolgt jede Kommunikation zwischen dem LMS und dem Reporter. Dazu erfolgt eine Reihe von Aufrufen: 429 + 405 405 |((( 406 406 armSite 407 407 )))|((( 408 - Registration of sequencerequestsat the ONYXreporter433 +Anmeldung von Folgerequests beim ONYX Reporter. 409 409 ))) 410 410 |((( 411 411 initiateSite 412 412 )))|((( 413 -Initi atesthereportersession (transmissionof the CP).438 +Initiiert die Reporter-Session (Übertragung des CPs). 414 414 ))) 415 415 |((( 416 416 disarmSite 417 417 )))|((( 418 - Release ofallreporterresourcesforthissession.443 +Freigabe von allen Reporter-Ressourcen für diese Session. 419 419 ))) 420 420 |((( 421 421 getResultValues 422 422 )))|((( 423 - 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. 424 424 ))) 425 425 |(% colspan="1" %)(% colspan="1" %) 426 426 ((( ... ... @@ -427,10 +427,10 @@ 427 427 getResultVariables 428 428 )))|(% colspan="1" %)(% colspan="1" %) 429 429 ((( 430 - 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. 431 431 ))) 432 432 433 -== Connectionto the LMS ==458 +== Anmeldung des LMS == 434 434 435 435 {{code title="Anmeldung des LMS" language="xml"}} 436 436 @WebMethod(operationName = „armSite") ... ... @@ -450,27 +450,27 @@ 450 450 |((( 451 451 version 452 452 )))|((( 453 - Requestedversion: 1478 +Angefragte Version: 1 454 454 ))) 455 455 |((( 456 456 userId 457 457 )))|((( 458 -UserId of the requestedreporterser483 +UserId des anfragenden Reporter-Benutzers 459 459 ))) 460 460 |((( 461 461 optionalRole 462 462 )))|((( 463 -Optional. User role. 0=student, 1=tutor488 +Optional. Rolle des Benutzers. 0 = Student, 1= Tutor 464 464 ))) 465 465 |((( 466 466 secretToShare 467 467 )))|((( 468 - 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. 469 469 ))) 470 470 |((( 471 471 optionalUserLastName 472 472 )))|((( 473 -Optional. User lastname.498 +Optional. Nachname des Benutzers. 474 474 ))) 475 475 |(% colspan="1" %)(% colspan="1" %) 476 476 ((( ... ... @@ -477,7 +477,7 @@ 477 477 optionalUserFirstName 478 478 )))|(% colspan="1" %)(% colspan="1" %) 479 479 ((( 480 -Optional. Userfirstname.505 +Optional. Vorname des Benutzers. 481 481 ))) 482 482 |(% colspan="1" %)(% colspan="1" %) 483 483 ((( ... ... @@ -492,10 +492,10 @@ 492 492 |((( 493 493 String 494 494 )))|((( 495 -Session ID t hathas to be usedto markanyfurtherreporter call.520 +Session ID, mit der alle weiteren Reporter-Aufrufe gekennzeichnet werden müssen. 496 496 ))) 497 497 498 -== Initialis ation through LMS ==523 +== Initialisierung durch LMS == 499 499 500 500 {{code title="Initialisierung durch LMS" language="xml"}} 501 501 @WebMethod(operationName = „initiateSite") ... ... @@ -514,7 +514,7 @@ 514 514 |((( 515 515 version 516 516 )))|((( 517 - Requestedversion: 1542 +Angefragte Version: 1 518 518 ))) 519 519 |(% colspan="1" %)(% colspan="1" %) 520 520 ((( ... ... @@ -521,22 +521,22 @@ 521 521 sessionId 522 522 )))|(% colspan="1" %)(% colspan="1" %) 523 523 ((( 524 -SessionId, as returnedbyarmSite.549 +SessionId, wie von armSite zurück geliefert. 525 525 ))) 526 526 |((( 527 527 secretToShare 528 528 )))|((( 529 - 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. 530 530 ))) 531 531 |((( 532 532 students 533 533 )))|((( 534 -List ofstudentswiththeirresults. Seebelow.559 +Liste der Studenten mit ihren Resultaten. Siehe unten. 535 535 ))) 536 536 |((( 537 537 optionalContentPackage 538 538 )))|((( 539 -Optional. Content Package (zipp ed) asbytearray.564 +Optional. Content Package (gezippt) als Byte-Array. 540 540 ))) 541 541 |((( 542 542 additionalParams ... ... @@ -549,13 +549,11 @@ 549 549 |((( 550 550 String 551 551 )))|((( 552 -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: 553 553 554 -* sid: Session ID as returned by armSite 555 -* ((( 556 -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 557 557 ))) 558 -))) 559 559 560 560 {{code language="xml"}} 561 561 public class ResultsForStudent { ... ... @@ -569,7 +569,7 @@ 569 569 } 570 570 {{/code}} 571 571 572 -== DeconnectionthroughtheLMS ==595 +== Abmeldung durch LMS == 573 573 574 574 575 575 ... ... @@ -590,7 +590,7 @@ 590 590 |((( 591 591 version 592 592 )))|((( 593 - Requestedversion: 1616 +Angefragte Version: 1 594 594 ))) 595 595 |(% colspan="1" %)(% colspan="1" %) 596 596 ((( ... ... @@ -597,12 +597,12 @@ 597 597 sessionId 598 598 )))|(% colspan="1" %)(% colspan="1" %) 599 599 ((( 600 -SessionId, as returnedbyarmSite.623 +SessionId, wie von armSite zurück geliefert. 601 601 ))) 602 602 |((( 603 603 secretToShare 604 604 )))|((( 605 - 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. 606 606 ))) 607 607 |((( 608 608 additionalParams ... ... @@ -615,10 +615,10 @@ 615 615 |((( 616 616 Boolean 617 617 )))|((( 618 -True i fsuccessful, otherwisefalse.641 +True bei Erfolg, sonst false. 619 619 ))) 620 620 621 -== RequestoflearningresultsthroughtheLMS ==644 +== Abfrage von Lernerresultaten durch LMS == 622 622 623 623 {{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}} 624 624 @WebMethod(operationName = „getResultValues") ... ... @@ -637,7 +637,7 @@ 637 637 |((( 638 638 version 639 639 )))|((( 640 - Requestedversion: 1663 +Angefragte Version: 1 641 641 ))) 642 642 |(% colspan="1" %)(% colspan="1" %) 643 643 ((( ... ... @@ -644,17 +644,17 @@ 644 644 sessionId 645 645 )))|(% colspan="1" %)(% colspan="1" %) 646 646 ((( 647 -SessionId, as returnedbyarmSite.670 +SessionId, wie von armSite zurück geliefert. 648 648 ))) 649 649 |((( 650 650 secretToShare 651 651 )))|((( 652 - 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. 653 653 ))) 654 654 |((( 655 655 requestedValues 656 656 )))|((( 657 - 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. 658 658 ))) 659 659 |((( 660 660 additionalParams ... ... @@ -667,10 +667,10 @@ 667 667 |((( 668 668 HashMap<String, String> 669 669 )))|((( 670 -Map ofresultvariables,key ishevariablevaluethecorrespondingvalue (HashMap is wrapped)693 +Map der Result-Variables, Key ist der Variablenname, Value der jeweilige Wert (HashMap ist gewrappt) 671 671 ))) 672 672 673 -== RequestofresultvariablesthroughtheLMS ==696 +== Abfrage von Ergebnisvariablen durch LMS == 674 674 675 675 {{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}} 676 676 @WebMethod(operationName = „getResultVariables") ... ... @@ -686,12 +686,12 @@ 686 686 |((( 687 687 version 688 688 )))|((( 689 - Requestedversion: 1712 +Angefragte Version: 1 690 690 ))) 691 691 |((( 692 692 contentPackage 693 693 )))|((( 694 -Content package (zipped) asbytearray.717 +Content Package (gezippt) als Byte-Array. 695 695 ))) 696 696 |((( 697 697 additionalParams ... ... @@ -704,15 +704,14 @@ 704 704 |((( 705 705 HashMap<String, String> 706 706 )))|((( 707 -Map of result variables, key is the variable name, value the corresponding 708 -value (HashMap is wrapped). 730 +Map der Result-Variables, Key ist der Variablenname, Value der jeweilige Wert (HashMap ist gewrappt) 709 709 ))) 710 710 711 711 == Wrapper == 712 712 713 - 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. 714 714 715 -=== Wrapper f or HashMap<String, String> ===737 +=== Wrapper für die HashMap<String, String> === 716 716 717 717 HashMapWrapper.java: 718 718 ... ... @@ -720,7 +720,7 @@ 720 720 721 721 [[image:attach:HashMapWrapperjava2.png]] 722 722 723 -=== Wrapper f orthe ArrayList<ResultsForStudent> ===745 +=== Wrapper für die ArrayList<ResultsForStudent> === 724 724 725 725 ResultsForStudentsWrapper.java: 726 726
- Confluence.Code.ConfluencePageClass[0]
-
- id
-
... ... @@ -1,1 +1,1 @@ 1 -334 30391 +3342793 - url
-
... ... @@ -1,1 +1,1 @@ 1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/334 3039/Schnittstelle ONYX Reporter1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/3342793/Schnittstelle ONYX Reporter