Änderungen von Dokument 08 Schnittstelle ONYX Reporter
Zuletzt geändert von Carina Enke am 13.02.2024
Von Version 356.1
bearbeitet von tleu
am 11.03.2015
am 11.03.2015
Änderungskommentar:
Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 1.0.
Auf 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.
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.carina - Inhalt
-
... ... @@ -1,5 +1,16 @@ 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 + 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"/}}20 +{{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"}}64 +{{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"}}129 +{{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"}}250 +{{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"}}302 +{{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.339 +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 ... ... @@ -388,7 +388,7 @@ 388 388 389 389 390 390 391 -{{toc maxLevel="5" style="square"outline="true" absoluteUrl="true"/}}379 +{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}} 392 392 {{/layout-cell}} 393 393 394 394 {{layout-cell}} ... ... @@ -398,29 +398,29 @@ 398 398 399 399 {{layout-section ac:type="single"}} 400 400 {{layout-cell}} 401 -== General == 389 +== General information == 402 402 403 -The API to the ONYX WebReporter enables the communication between the LMS and the reporter.391 +The API to the ONYX WebReporter enables the communication between the LMS and the Reporter. Therefore, a couple of commands will be executed: 404 404 405 405 |((( 406 406 armSite 407 407 )))|((( 408 -Registration of sequence requests at the ONYX reporter396 +Registration of sequence requests at the ONYX Reporter 409 409 ))) 410 410 |((( 411 411 initiateSite 412 412 )))|((( 413 -Initiates the reporter session (transmission of the CP).401 +Initiates the Reporter session (transmission of the CP). 414 414 ))) 415 415 |((( 416 416 disarmSite 417 417 )))|((( 418 -Release of all reporter resources for this session.406 +Release of all Reporter resources for this session. 419 419 ))) 420 420 |((( 421 421 getResultValues 422 422 )))|((( 423 -Returns all orall requested results for the test. Condition:there isexactly one student in list transmitted intheinitiateSite.411 +Returns all (requested) results for the test. Condition: There is only one student in the list transmitted with initiateSite. 424 424 ))) 425 425 |(% colspan="1" %)(% colspan="1" %) 426 426 ((( ... ... @@ -427,12 +427,12 @@ 427 427 getResultVariables 428 428 )))|(% colspan="1" %)(% colspan="1" %) 429 429 ((( 430 -Returns all orall requested outcome variables for the test. No armSite, initiateSite or disarmSite isnecessary.418 +Returns all (requested) outcome variables for the test. No armSite, initiateSite, or disarmSite is required. 431 431 ))) 432 432 433 -== Connection to the LMS ==421 +== Login through the LMS == 434 434 435 -{{code title=" AnmeldungdesLMS"language="xml"}}423 +{{code language="xml" title="Login through the LMS"}} 436 436 @WebMethod(operationName = „armSite") 437 437 public String armSite( 438 438 @WebParam(name = „version") final Integer version, ... ... @@ -455,22 +455,22 @@ 455 455 |((( 456 456 userId 457 457 )))|((( 458 -UserId of the requested reporter user446 +UserId of the requested Reporter user 459 459 ))) 460 460 |((( 461 461 optionalRole 462 462 )))|((( 463 -Optional. User role. 0=student, 1=tutor 451 +Optional. User role. 0 = student, 1 = tutor 464 464 ))) 465 465 |((( 466 466 secretToShare 467 467 )))|((( 468 - Sharedsecret.Has to remain identical for every communication.456 +A secret string that allows the server and client to encrypt their communication. Must remain the same for any further communication. 469 469 ))) 470 470 |((( 471 471 optionalUserLastName 472 472 )))|((( 473 -Optional. User lastname.461 +Optional. Last name of the user. 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. User firstname.468 +Optional. First name of the user. 481 481 ))) 482 482 |(% colspan="1" %)(% colspan="1" %) 483 483 ((( ... ... @@ -492,12 +492,12 @@ 492 492 |((( 493 493 String 494 494 )))|((( 495 -Session ID thathas to be used to mark anyfurtherreporter call.483 +Session ID which has to be used to mark any other Reporter call. 496 496 ))) 497 497 498 498 == Initialisation through LMS == 499 499 500 -{{code title="Initialisi erungdurch LMS"language="xml"}}488 +{{code language="xml" title="Initialisation through LMS"}} 501 501 @WebMethod(operationName = „initiateSite") 502 502 public String initiateSite( 503 503 @WebParam(name = „version") final Integer version, ... ... @@ -526,17 +526,17 @@ 526 526 |((( 527 527 secretToShare 528 528 )))|((( 529 - Sharedsecret.Has to remain identicalat every communication.517 +A secret string that allows the server and client to encrypt their communication. Must remain the same for any further communication. 530 530 ))) 531 531 |((( 532 532 students 533 533 )))|((( 534 -List of students withtheir results. See below.522 +List of students and their results. See below. 535 535 ))) 536 536 |((( 537 537 optionalContentPackage 538 538 )))|((( 539 -Optional. Content Package (zipped) as byte array.527 +Optional. Content package (zipped) as byte array. 540 540 ))) 541 541 |((( 542 542 additionalParams ... ... @@ -549,11 +549,11 @@ 549 549 |((( 550 550 String 551 551 )))|((( 552 -Absolute URL of the reporter site for theframe.Ithas to be enriched by the LMS with the following URLparameters:540 +Absolute URL of the Reporter site for the IFrame. The URL has to be amended by the LMS with the following URL parameters: 553 553 554 -* sid: Session ID as returned by armSite 542 +* sid: Session ID, as returned by armSite 555 555 * ((( 556 -uid: Student ID as registrated in the initiateSite at the ONYX Reporter .544 +uid: Student ID, as registrated in the initiateSite at the ONYX Reporter 557 557 ))) 558 558 ))) 559 559 ... ... @@ -569,7 +569,7 @@ 569 569 } 570 570 {{/code}} 571 571 572 -== Deconnectionthrough the LMS ==560 +== Logout through the LMS == 573 573 574 574 575 575 ... ... @@ -602,7 +602,7 @@ 602 602 |((( 603 603 secretToShare 604 604 )))|((( 605 - Sharedsecret.Has to remain identicalat every communication.593 +A secret string that allows the server and client to encrypt their communication. Must remain the same for any further communication. 606 606 ))) 607 607 |((( 608 608 additionalParams ... ... @@ -615,12 +615,12 @@ 615 615 |((( 616 616 Boolean 617 617 )))|((( 618 -True if success ful, otherwise false.606 +True in the case of success, otherwise false. 619 619 ))) 620 620 621 -== Request of learn ingresults through the LMS ==609 +== Request of learner results through the LMS == 622 622 623 -{{code title=" AbfragevonLernerresultatendurch LMS"language="xml"}}611 +{{code language="xml" title="Request of learner results through the LMS"}} 624 624 @WebMethod(operationName = „getResultValues") 625 625 public HashMapWrapper getResultValues( 626 626 @WebParam(name = „version") final Integer version, ... ... @@ -649,12 +649,12 @@ 649 649 |((( 650 650 secretToShare 651 651 )))|((( 652 - Sharedsecret.Has to remain identicalat every communication.640 +A secret string that allows the server and client to encrypt their communication. Must remain the same for any further communication. 653 653 ))) 654 654 |((( 655 655 requestedValues 656 656 )))|((( 657 -Can be empty, thus all result variableswill be returned. Ifitcontains keys, only those will be returned.645 +Can be empty, in which case all result variables are returned. If keys are included, only the keys will be returned. 658 658 ))) 659 659 |((( 660 660 additionalParams ... ... @@ -667,12 +667,12 @@ 667 667 |((( 668 668 HashMap<String, String> 669 669 )))|((( 670 -Map of result variables, key is the variable name, value the correspondingvalue (HashMap is wrapped)658 +Map of result variables, key is the variable name, value is the respective variable's value (HashMap is wrapped) 671 671 ))) 672 672 673 673 == Request of result variables through the LMS == 674 674 675 -{{code title=" AbfragevonErgebnisvariablendurch LMS"language="xml"}}663 +{{code language="xml" title="Request of result variables through the LMS"}} 676 676 @WebMethod(operationName = „getResultVariables") 677 677 public HashMapWrapper getResultVariables( 678 678 @WebParam(name = „version") final Integer version, ... ... @@ -704,13 +704,12 @@ 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). 695 +Map of result variables, key is the variable name, value is the respective variable's value (HashMap is wrapped) 709 709 ))) 710 710 711 711 == Wrapper == 712 712 713 - Asthe transmission of maps and listsgenerate problemsvia JAX-WS(lists filled by thecustomerare sentwithoutany data and thusreachthe serverwithout data) they have to be wrapped.700 +Since the transmission of maps and lists via JAX-WS can cause problems, they have to be wrapped. 714 714 715 715 === Wrapper for HashMap<String, String> === 716 716
- Confluence.Code.ConfluencePageClass[0]
-
- id
-
... ... @@ -1,1 +1,1 @@ 1 - 69190091 +182518281 - url
-
... ... @@ -1,1 +1,1 @@ 1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/ 6919009/Schnittstelle ONYX Reporter1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/182518281/Schnittstelle ONYX Reporter