Änderungen von Dokument 08 Schnittstelle ONYX Reporter
Zuletzt geändert von Carina Enke am 13.02.2024
Von Version 378.1
bearbeitet von sandra_riediger
am 15.12.2014
am 15.12.2014
Änderungskommentar:
Es gibt keinen Kommentar für diese Version
Auf Version 345.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.
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. sandra_riediger1 +XWiki.carina - Inhalt
-
... ... @@ -1,5 +1,9 @@ 1 1 {{sv-translation language="de"}} 2 2 {{layout}} 3 +{{layout-section ac:type="single"}} 4 +{{layout-cell}}{{/layout-cell}} 5 +{{/layout-section}} 6 + 3 3 {{layout-section ac:type="two_right_sidebar"}} 4 4 {{layout-cell}} 5 5 ====== Inhalt: ====== ... ... @@ -6,34 +6,11 @@ 6 6 7 7 8 8 9 -{{toc maxLevel="5" style="square"outline="true" absoluteUrl="true"/}}13 +{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}} 10 10 {{/layout-cell}} 11 11 12 12 {{layout-cell}} 13 -|=(% colspan="1" %)(% colspan="1" %) 14 -((( 15 -Programmversion 16 -)))|(% colspan="1" %)(% colspan="1" %) 17 -((( 18 18 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 -))) 37 37 {{/layout-cell}} 38 38 {{/layout-section}} 39 39 ... ... @@ -73,7 +73,7 @@ 73 73 74 74 == Anmeldung des LMS == 75 75 76 -{{code title="Anmeldung des LMS" language="xml"}}57 +{{code language="xml" title="Anmeldung des LMS"}} 77 77 @WebMethod(operationName = „armSite") 78 78 public String armSite( 79 79 @WebParam(name = „version") final Integer version, ... ... @@ -138,7 +138,7 @@ 138 138 139 139 == Initialisierung durch LMS == 140 140 141 -{{code title="Initialisierung durch LMS" language="xml"}}122 +{{code language="xml" title="Initialisierung durch LMS"}} 142 142 @WebMethod(operationName = „initiateSite") 143 143 public String initiateSite( 144 144 @WebParam(name = „version") final Integer version, ... ... @@ -259,7 +259,7 @@ 259 259 260 260 == Abfrage von Lernerresultaten durch LMS == 261 261 262 -{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}}243 +{{code language="xml" title="Abfrage von Lernerresultaten durch LMS"}} 263 263 @WebMethod(operationName = „getResultValues") 264 264 public HashMapWrapper getResultValues( 265 265 @WebParam(name = „version") final Integer version, ... ... @@ -311,7 +311,7 @@ 311 311 312 312 == Abfrage von Ergebnisvariablen durch LMS == 313 313 314 -{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}}295 +{{code language="xml" title="Abfrage von Ergebnisvariablen durch LMS"}} 315 315 @WebMethod(operationName = „getResultVariables") 316 316 public HashMapWrapper getResultVariables( 317 317 @WebParam(name = „version") final Integer version, ... ... @@ -348,7 +348,7 @@ 348 348 349 349 == Wrapper == 350 350 351 -Da die Übertragung von Maps und Listen über JAX-WS Probleme mach t (clientseitiggefüllte Listen werden leer über den WS versandt undkommen daher auch leer serverseitig an), müssen diese gewrappt werden.332 +Da die Übertragung von Maps und Listen über JAX-WS Probleme machen kann, müssen diese gewrappt werden. 352 352 353 353 === Wrapper für die HashMap<String, String> === 354 354 ... ... @@ -374,7 +374,7 @@ 374 374 {{layout-cell}} 375 375 ====== relevante Links: ====== 376 376 377 -* [[doc: SchnittstelleONYXWebPlayer]]358 +* [[doc:ONYX Player Interface]] 378 378 {{/layout-cell}} 379 379 {{/layout-section}} 380 380 {{/layout}} ... ... @@ -388,64 +388,39 @@ 388 388 389 389 390 390 391 -{{toc style="square"maxLevel="5" outline="true" absoluteUrl="true"/}}372 +{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}} 392 392 {{/layout-cell}} 393 393 394 394 {{layout-cell}} 395 -|=(% colspan="1" %)(% colspan="1" %) 396 -((( 397 -Programmversion 398 -)))|(% colspan="1" %)(% colspan="1" %) 399 -((( 400 400 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 -))) 419 419 {{/layout-cell}} 420 420 {{/layout-section}} 421 421 422 422 {{layout-section ac:type="single"}} 423 423 {{layout-cell}} 424 - 382 +== General == 425 425 426 - ==Allgemeines==384 +The API to the ONYX WebReporter enables the communication between the LMS and the reporter. Therefore, a couple of commands will be executed: 427 427 428 -Über die Schnittstelle zum ONYX WebReporter erfolgt jede Kommunikation zwischen dem LMS und dem Reporter. Dazu erfolgt eine Reihe von Aufrufen: 429 - 430 430 |((( 431 431 armSite 432 432 )))|((( 433 - AnmeldungvonFolgerequestsbeimONYXReporter.389 +Registration of sequence requests at the ONYX reporter 434 434 ))) 435 435 |((( 436 436 initiateSite 437 437 )))|((( 438 -Initi iertdieReporter-Session (ÜbertragungdesCPs).394 +Initiates the reporter session (transmission of the CP). 439 439 ))) 440 440 |((( 441 441 disarmSite 442 442 )))|((( 443 - FreigabevonallenReporter-RessourcenfürdieseSession.399 +Release of all reporter resources for this session. 444 444 ))) 445 445 |((( 446 446 getResultValues 447 447 )))|((( 448 - Gibt allebzw.dieangefordertenResultatefürdenTestzurück.Voraussetzung:EsistnurexakteinStudent inder beiinitiateSiteübertragenen Liste.404 +Returns all or all requested results for the test. Condition: there is exactly one student in list transmitted in the initiateSite. 449 449 ))) 450 450 |(% colspan="1" %)(% colspan="1" %) 451 451 ((( ... ... @@ -452,12 +452,12 @@ 452 452 getResultVariables 453 453 )))|(% colspan="1" %)(% colspan="1" %) 454 454 ((( 455 - Gibt allebzw.dieangefordertenOutcome-VariablenfürdenTestzurück.Hierfürsind keinarmSite, initiateSite oder disarmSite erforderlich.411 +Returns all or all requested outcome variables for the test. No armSite, initiateSite or disarmSite is necessary. 456 456 ))) 457 457 458 -== AnmeldungdesLMS ==414 +== Connection to the LMS == 459 459 460 -{{code title="Anmeldung des LMS" language="xml"}}416 +{{code language="xml" title="Anmeldung des LMS"}} 461 461 @WebMethod(operationName = „armSite") 462 462 public String armSite( 463 463 @WebParam(name = „version") final Integer version, ... ... @@ -475,27 +475,27 @@ 475 475 |((( 476 476 version 477 477 )))|((( 478 - AngefragteVersion: 1434 +Requested version: 1 479 479 ))) 480 480 |((( 481 481 userId 482 482 )))|((( 483 -UserId desanfragendenReporter-Benutzers439 +UserId of the requested reporter user 484 484 ))) 485 485 |((( 486 486 optionalRole 487 487 )))|((( 488 -Optional. Rolle desBenutzers. 0Student, 1=Tutor444 +Optional. User role. 0=student, 1=tutor 489 489 ))) 490 490 |((( 491 491 secretToShare 492 492 )))|((( 493 - Ein geheimerString, mit dessen Hilfe ServerundClientihreKommunikationverschlüsseln.Muss bei jederweiterenKommunikationgleich bleiben.449 +Shared secret. Has to remain identical for every communication. 494 494 ))) 495 495 |((( 496 496 optionalUserLastName 497 497 )))|((( 498 -Optional. Nachnamedes Benutzers.454 +Optional. User lastname. 499 499 ))) 500 500 |(% colspan="1" %)(% colspan="1" %) 501 501 ((( ... ... @@ -502,7 +502,7 @@ 502 502 optionalUserFirstName 503 503 )))|(% colspan="1" %)(% colspan="1" %) 504 504 ((( 505 -Optional. Vornamedes Benutzers.461 +Optional. User firstname. 506 506 ))) 507 507 |(% colspan="1" %)(% colspan="1" %) 508 508 ((( ... ... @@ -517,12 +517,12 @@ 517 517 |((( 518 518 String 519 519 )))|((( 520 -Session ID ,mitderalleweiterenReporter-Aufrufegekennzeichnetwerdenmüssen.476 +Session ID that has to be used to mark any further reporter call. 521 521 ))) 522 522 523 -== Initialisi erungdurch LMS ==479 +== Initialisation through LMS == 524 524 525 -{{code title="Initialisierung durch LMS" language="xml"}}481 +{{code language="xml" title="Initialisierung durch LMS"}} 526 526 @WebMethod(operationName = „initiateSite") 527 527 public String initiateSite( 528 528 @WebParam(name = „version") final Integer version, ... ... @@ -539,7 +539,7 @@ 539 539 |((( 540 540 version 541 541 )))|((( 542 - AngefragteVersion: 1498 +Requested version: 1 543 543 ))) 544 544 |(% colspan="1" %)(% colspan="1" %) 545 545 ((( ... ... @@ -546,22 +546,22 @@ 546 546 sessionId 547 547 )))|(% colspan="1" %)(% colspan="1" %) 548 548 ((( 549 -SessionId, wievon armSitezurück geliefert.505 +SessionId, as returned by armSite. 550 550 ))) 551 551 |((( 552 552 secretToShare 553 553 )))|((( 554 - Ein geheimerString, mit dessen Hilfe ServerundClientihreKommunikationverschlüsseln.Mussbei jederweiteren Kommunikationgleich bleiben.510 +Shared secret. Has to remain identical at every communication. 555 555 ))) 556 556 |((( 557 557 students 558 558 )))|((( 559 -List ederStudentenmitihrenResultaten. Sieheunten.515 +List of students with their results. See below. 560 560 ))) 561 561 |((( 562 562 optionalContentPackage 563 563 )))|((( 564 -Optional. Content Package ( gezippt) alsByte-Array.520 +Optional. Content Package (zipped) as byte array. 565 565 ))) 566 566 |((( 567 567 additionalParams ... ... @@ -574,11 +574,13 @@ 574 574 |((( 575 575 String 576 576 )))|((( 577 -Absolute URL derReporter-Seite fürdenIFrame.DieseristvomLMSdurchdie folgendenURL-Parameteranzureichern:533 +Absolute URL of the reporter site for the frame. It has to be enriched by the LMS with the following URLparameters: 578 578 579 -* sid: Session ID, wie von armSite zurück gegeben 580 -* uid: Student ID, wie in initiateSite beim Reporter angemeldet 535 +* sid: Session ID as returned by armSite 536 +* ((( 537 +uid: Student ID as registrated in the initiateSite at the ONYX Reporter. 581 581 ))) 539 +))) 582 582 583 583 {{code language="xml"}} 584 584 public class ResultsForStudent { ... ... @@ -592,7 +592,7 @@ 592 592 } 593 593 {{/code}} 594 594 595 -== Abmeldungdurch LMS ==553 +== Deconnection through the LMS == 596 596 597 597 598 598 ... ... @@ -613,7 +613,7 @@ 613 613 |((( 614 614 version 615 615 )))|((( 616 - AngefragteVersion: 1574 +Requested version: 1 617 617 ))) 618 618 |(% colspan="1" %)(% colspan="1" %) 619 619 ((( ... ... @@ -620,12 +620,12 @@ 620 620 sessionId 621 621 )))|(% colspan="1" %)(% colspan="1" %) 622 622 ((( 623 -SessionId, wievon armSitezurück geliefert.581 +SessionId, as returned by armSite. 624 624 ))) 625 625 |((( 626 626 secretToShare 627 627 )))|((( 628 - Ein geheimerString, mit dessen Hilfe ServerundClientihreKommunikationverschlüsseln.Mussbei jederweiteren Kommunikationgleich bleiben.586 +Shared secret. Has to remain identical at every communication. 629 629 ))) 630 630 |((( 631 631 additionalParams ... ... @@ -638,12 +638,12 @@ 638 638 |((( 639 639 Boolean 640 640 )))|((( 641 -True beiErfolg,sonst false.599 +True if successful, otherwise false. 642 642 ))) 643 643 644 -== AbfragevonLernerresultatendurch LMS ==602 +== Request of learning results through the LMS == 645 645 646 -{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}}604 +{{code language="xml" title="Abfrage von Lernerresultaten durch LMS"}} 647 647 @WebMethod(operationName = „getResultValues") 648 648 public HashMapWrapper getResultValues( 649 649 @WebParam(name = „version") final Integer version, ... ... @@ -660,7 +660,7 @@ 660 660 |((( 661 661 version 662 662 )))|((( 663 - AngefragteVersion: 1621 +Requested version: 1 664 664 ))) 665 665 |(% colspan="1" %)(% colspan="1" %) 666 666 ((( ... ... @@ -667,17 +667,17 @@ 667 667 sessionId 668 668 )))|(% colspan="1" %)(% colspan="1" %) 669 669 ((( 670 -SessionId, wievon armSitezurück geliefert.628 +SessionId, as returned by armSite. 671 671 ))) 672 672 |((( 673 673 secretToShare 674 674 )))|((( 675 - Ein geheimerString, mit dessen Hilfe ServerundClientihreKommunikationverschlüsseln.Mussbei jederweiteren Kommunikationgleich bleiben.633 +Shared secret. Has to remain identical at every communication. 676 676 ))) 677 677 |((( 678 678 requestedValues 679 679 )))|((( 680 - Kannleersein,dannwerdenalleResult-Variableszurückgeliefert.SindKeysenthalten,sokommennurdiese zurück.638 +Can be empty, thus all result variables will be returned. If it contains keys, only those will be returned. 681 681 ))) 682 682 |((( 683 683 additionalParams ... ... @@ -690,12 +690,12 @@ 690 690 |((( 691 691 HashMap<String, String> 692 692 )))|((( 693 -Map derResult-Variables,Key istderVariablenname,ValuederjeweiligeWert(HashMap istgewrappt)651 +Map of result variables, key is the variable name, value the corresponding value (HashMap is wrapped) 694 694 ))) 695 695 696 -== AbfragevonErgebnisvariablendurch LMS ==654 +== Request of result variables through the LMS == 697 697 698 -{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}}656 +{{code language="xml" title="Abfrage von Ergebnisvariablen durch LMS"}} 699 699 @WebMethod(operationName = „getResultVariables") 700 700 public HashMapWrapper getResultVariables( 701 701 @WebParam(name = „version") final Integer version, ... ... @@ -709,12 +709,12 @@ 709 709 |((( 710 710 version 711 711 )))|((( 712 - AngefragteVersion: 1670 +Requested version: 1 713 713 ))) 714 714 |((( 715 715 contentPackage 716 716 )))|((( 717 -Content Package (gezippt) alsByte-Array.675 +Content package (zipped) as byte array. 718 718 ))) 719 719 |((( 720 720 additionalParams ... ... @@ -727,14 +727,15 @@ 727 727 |((( 728 728 HashMap<String, String> 729 729 )))|((( 730 -Map der Result-Variables, Key ist der Variablenname, Value der jeweilige Wert (HashMap ist gewrappt) 688 +Map of result variables, key is the variable name, value the corresponding 689 +value (HashMap is wrapped). 731 731 ))) 732 732 733 733 == Wrapper == 734 734 735 - DadieÜbertragung vonMapsundListenüberJAX-WS Problememacht(clientseitiggefüllteListen werdenleerüber denWSversandtundkommen daherauchleerserverseitigan),müssendiesegewrappt werden.694 +As the transmission of maps and lists generate problems via JAX-WS (lists filled by the customer are sent without any data and thus reach the server without data) they have to be wrapped. 736 736 737 -=== Wrapper f ürdieHashMap<String, String> ===696 +=== Wrapper for HashMap<String, String> === 738 738 739 739 HashMapWrapper.java: 740 740 ... ... @@ -742,7 +742,7 @@ 742 742 743 743 [[image:attach:HashMapWrapperjava2.png]] 744 744 745 -=== Wrapper f ürdie ArrayList<ResultsForStudent> ===704 +=== Wrapper for the ArrayList<ResultsForStudent> === 746 746 747 747 ResultsForStudentsWrapper.java: 748 748
- Confluence.Code.ConfluencePageClass[0]
-
- id
-
... ... @@ -1,1 +1,1 @@ 1 - 33427931 +147882402 - url
-
... ... @@ -1,1 +1,1 @@ 1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/ 3342793/Schnittstelle ONYX Reporter1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/147882402/Schnittstelle ONYX Reporter