Änderungen von Dokument 08 Schnittstelle ONYX Reporter

Zuletzt geändert von Carina Enke am 13.02.2024

Von Version 353.1
bearbeitet von Carina Enke
am 08.03.2018
Änderungskommentar: Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 1.11.1.
Auf Version 379.1
bearbeitet von sandra_riediger
am 15.12.2014
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Dokument-Autor
... ... @@ -1,1 +1,1 @@
1 -XWiki.carina
1 +XWiki.sandra_riediger
Inhalt
... ... @@ -1,9 +1,5 @@
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 9  ====== Inhalt: ======
... ... @@ -10,11 +10,34 @@
10 10  
11 11  
12 12  
13 -{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}
9 +{{toc maxLevel="5" style="square" outline="true" absoluteUrl="true"/}}
14 14  {{/layout-cell}}
15 15  
16 16  {{layout-cell}}
13 +|=(% colspan="1" %)(% colspan="1" %)
14 +(((
15 +Programmversion
16 +)))|(% colspan="1" %)(% colspan="1" %)
17 +(((
17 17  
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 +)))
18 18  {{/layout-cell}}
19 19  {{/layout-section}}
20 20  
... ... @@ -54,7 +54,7 @@
54 54  
55 55  == Anmeldung des LMS ==
56 56  
57 -{{code language="xml" title="Anmeldung des LMS"}}
76 +{{code title="Anmeldung des LMS" language="xml"}}
58 58  @WebMethod(operationName = „armSite")
59 59  public String armSite(
60 60  @WebParam(name = „version") final Integer version,
... ... @@ -119,7 +119,7 @@
119 119  
120 120  == Initialisierung durch LMS ==
121 121  
122 -{{code language="xml" title="Initialisierung durch LMS"}}
141 +{{code title="Initialisierung durch LMS" language="xml"}}
123 123  @WebMethod(operationName = „initiateSite")
124 124  public String initiateSite(
125 125  @WebParam(name = „version") final Integer version,
... ... @@ -240,7 +240,7 @@
240 240  
241 241  == Abfrage von Lernerresultaten durch LMS ==
242 242  
243 -{{code language="xml" title="Abfrage von Lernerresultaten durch LMS"}}
262 +{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}}
244 244   @WebMethod(operationName = „getResultValues")
245 245  public HashMapWrapper getResultValues(
246 246   @WebParam(name = „version") final Integer version,
... ... @@ -292,7 +292,7 @@
292 292  
293 293  == Abfrage von Ergebnisvariablen durch LMS ==
294 294  
295 -{{code language="xml" title="Abfrage von Ergebnisvariablen durch LMS"}}
314 +{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}}
296 296   @WebMethod(operationName = „getResultVariables")
297 297  public HashMapWrapper getResultVariables(
298 298  @WebParam(name = „version") final Integer version,
... ... @@ -329,7 +329,7 @@
329 329  
330 330  == Wrapper ==
331 331  
332 -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.
333 333  
334 334  === Wrapper für die HashMap<String, String> ===
335 335  
... ... @@ -355,7 +355,7 @@
355 355  {{layout-cell}}
356 356  ====== relevante Links: ======
357 357  
358 -* [[doc:ONYX Player Interface]]
377 +* [[doc:Schnittstelle ONYX WebPlayer]]
359 359  {{/layout-cell}}
360 360  {{/layout-section}}
361 361  {{/layout}}
... ... @@ -369,39 +369,64 @@
369 369  
370 370  
371 371  
372 -{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}
391 +{{toc style="square" maxLevel="5" outline="true" absoluteUrl="true"/}}
373 373  {{/layout-cell}}
374 374  
375 375  {{layout-cell}}
395 +|=(% colspan="1" %)(% colspan="1" %)
396 +(((
397 +Programmversion
398 +)))|(% colspan="1" %)(% colspan="1" %)
399 +(((
376 376  
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 +)))
377 377  {{/layout-cell}}
378 378  {{/layout-section}}
379 379  
380 380  {{layout-section ac:type="single"}}
381 381  {{layout-cell}}
382 -== General ==
424 +
383 383  
384 -The API to the ONYX WebReporter enables the communication between the LMS and the reporter. Therefore, a couple of commands will be executed:
426 +== Allgemeines ==
385 385  
428 +Über die Schnittstelle zum ONYX WebReporter erfolgt jede Kommunikation zwischen dem LMS und dem Reporter. Dazu erfolgt eine Reihe von Aufrufen:
429 +
386 386  |(((
387 387  armSite
388 388  )))|(((
389 -Registration of sequence requests at the ONYX reporter
433 +Anmeldung von Folgerequests beim ONYX Reporter.
390 390  )))
391 391  |(((
392 392  initiateSite
393 393  )))|(((
394 -Initiates the reporter session (transmission of the CP).
438 +Initiiert die Reporter-Session (Übertragung des CPs).
395 395  )))
396 396  |(((
397 397  disarmSite
398 398  )))|(((
399 -Release of all reporter resources for this session.
443 +Freigabe von allen Reporter-Ressourcen für diese Session.
400 400  )))
401 401  |(((
402 402  getResultValues
403 403  )))|(((
404 -Returns all or all requested results for the test. Condition: there is exactly one student in list transmitted in the initiateSite.
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.
405 405  )))
406 406  |(% colspan="1" %)(% colspan="1" %)
407 407  (((
... ... @@ -408,12 +408,12 @@
408 408  getResultVariables
409 409  )))|(% colspan="1" %)(% colspan="1" %)
410 410  (((
411 -Returns all or all requested outcome variables for the test. No armSite, initiateSite or disarmSite is necessary.
455 +Gibt alle bzw. die angeforderten Outcome-Variablen für den Test zurück. Hierfür sind kein armSite, initiateSite oder disarmSite erforderlich.
412 412  )))
413 413  
414 -== Connection to the LMS ==
458 +== Anmeldung des LMS ==
415 415  
416 -{{code language="xml" title="Anmeldung des LMS"}}
460 +{{code title="Anmeldung des LMS" language="xml"}}
417 417  @WebMethod(operationName = „armSite")
418 418  public String armSite(
419 419  @WebParam(name = „version") final Integer version,
... ... @@ -431,27 +431,27 @@
431 431  |(((
432 432  version
433 433  )))|(((
434 -Requested version: 1
478 +Angefragte Version: 1
435 435  )))
436 436  |(((
437 437  userId
438 438  )))|(((
439 -UserId of the requested reporter user
483 +UserId des anfragenden Reporter-Benutzers
440 440  )))
441 441  |(((
442 442  optionalRole
443 443  )))|(((
444 -Optional. User role. 0=student, 1=tutor
488 +Optional. Rolle des Benutzers. 0 = Student, 1= Tutor
445 445  )))
446 446  |(((
447 447  secretToShare
448 448  )))|(((
449 -Shared secret. Has to remain identical for every communication.
493 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben.
450 450  )))
451 451  |(((
452 452  optionalUserLastName
453 453  )))|(((
454 -Optional. User lastname.
498 +Optional. Nachname des Benutzers.
455 455  )))
456 456  |(% colspan="1" %)(% colspan="1" %)
457 457  (((
... ... @@ -458,7 +458,7 @@
458 458  optionalUserFirstName
459 459  )))|(% colspan="1" %)(% colspan="1" %)
460 460  (((
461 -Optional. User firstname.
505 +Optional. Vorname des Benutzers.
462 462  )))
463 463  |(% colspan="1" %)(% colspan="1" %)
464 464  (((
... ... @@ -473,12 +473,12 @@
473 473  |(((
474 474  String
475 475  )))|(((
476 -Session ID that has to be used to mark any further reporter call.
520 +Session ID, mit der alle weiteren Reporter-Aufrufe gekennzeichnet werden müssen.
477 477  )))
478 478  
479 -== Initialisation through LMS ==
523 +== Initialisierung durch LMS ==
480 480  
481 -{{code language="xml" title="Initialisierung durch LMS"}}
525 +{{code title="Initialisierung durch LMS" language="xml"}}
482 482  @WebMethod(operationName = „initiateSite")
483 483  public String initiateSite(
484 484  @WebParam(name = „version") final Integer version,
... ... @@ -495,7 +495,7 @@
495 495  |(((
496 496  version
497 497  )))|(((
498 -Requested version: 1
542 +Angefragte Version: 1
499 499  )))
500 500  |(% colspan="1" %)(% colspan="1" %)
501 501  (((
... ... @@ -502,22 +502,22 @@
502 502  sessionId
503 503  )))|(% colspan="1" %)(% colspan="1" %)
504 504  (((
505 -SessionId, as returned by armSite.
549 +SessionId, wie von armSite zurück geliefert.
506 506  )))
507 507  |(((
508 508  secretToShare
509 509  )))|(((
510 -Shared secret. Has to remain identical at every communication.
554 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben.
511 511  )))
512 512  |(((
513 513  students
514 514  )))|(((
515 -List of students with their results. See below.
559 +Liste der Studenten mit ihren Resultaten. Siehe unten.
516 516  )))
517 517  |(((
518 518  optionalContentPackage
519 519  )))|(((
520 -Optional. Content Package (zipped) as byte array.
564 +Optional. Content Package (gezippt) als Byte-Array.
521 521  )))
522 522  |(((
523 523  additionalParams
... ... @@ -530,13 +530,11 @@
530 530  |(((
531 531  String
532 532  )))|(((
533 -Absolute URL of the reporter site for the frame. It has to be enriched by the LMS with the following URLparameters:
577 +Absolute URL der Reporter-Seite für den IFrame. Dieser ist vom LMS durch die folgenden URL-Parameter anzureichern:
534 534  
535 -* sid: Session ID as returned by armSite
536 -* (((
537 -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
538 538  )))
539 -)))
540 540  
541 541  {{code language="xml"}}
542 542  public class ResultsForStudent {
... ... @@ -550,7 +550,7 @@
550 550  }
551 551  {{/code}}
552 552  
553 -== Deconnection through the LMS ==
595 +== Abmeldung durch LMS ==
554 554  
555 555  
556 556  
... ... @@ -571,7 +571,7 @@
571 571  |(((
572 572  version
573 573  )))|(((
574 -Requested version: 1
616 +Angefragte Version: 1
575 575  )))
576 576  |(% colspan="1" %)(% colspan="1" %)
577 577  (((
... ... @@ -578,12 +578,12 @@
578 578  sessionId
579 579  )))|(% colspan="1" %)(% colspan="1" %)
580 580  (((
581 -SessionId, as returned by armSite.
623 +SessionId, wie von armSite zurück geliefert.
582 582  )))
583 583  |(((
584 584  secretToShare
585 585  )))|(((
586 -Shared secret. Has to remain identical at every communication.
628 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben.
587 587  )))
588 588  |(((
589 589  additionalParams
... ... @@ -596,12 +596,12 @@
596 596  |(((
597 597  Boolean
598 598  )))|(((
599 -True if successful, otherwise false.
641 +True bei Erfolg, sonst false.
600 600  )))
601 601  
602 -== Request of learning results through the LMS ==
644 +== Abfrage von Lernerresultaten durch LMS ==
603 603  
604 -{{code language="xml" title="Abfrage von Lernerresultaten durch LMS"}}
646 +{{code title="Abfrage von Lernerresultaten durch LMS" language="xml"}}
605 605   @WebMethod(operationName = „getResultValues")
606 606  public HashMapWrapper getResultValues(
607 607   @WebParam(name = „version") final Integer version,
... ... @@ -618,7 +618,7 @@
618 618  |(((
619 619  version
620 620  )))|(((
621 -Requested version: 1
663 +Angefragte Version: 1
622 622  )))
623 623  |(% colspan="1" %)(% colspan="1" %)
624 624  (((
... ... @@ -625,17 +625,17 @@
625 625  sessionId
626 626  )))|(% colspan="1" %)(% colspan="1" %)
627 627  (((
628 -SessionId, as returned by armSite.
670 +SessionId, wie von armSite zurück geliefert.
629 629  )))
630 630  |(((
631 631  secretToShare
632 632  )))|(((
633 -Shared secret. Has to remain identical at every communication.
675 +Ein geheimer String, mit dessen Hilfe Server und Client ihre Kommunikation verschlüsseln. Muss bei jeder weiteren Kommunikation gleich bleiben.
634 634  )))
635 635  |(((
636 636  requestedValues
637 637  )))|(((
638 -Can be empty, thus all result variables will be returned. If it contains keys, only those will be returned.
680 +Kann leer sein, dann werden alle Result-Variables zurück geliefert. Sind Keys enthalten, so kommen nur diese zurück.
639 639  )))
640 640  |(((
641 641  additionalParams
... ... @@ -648,12 +648,12 @@
648 648  |(((
649 649  HashMap<String, String>
650 650  )))|(((
651 -Map of result variables, key is the variable name, value the corresponding value (HashMap is wrapped)
693 +Map der Result-Variables, Key ist der Variablenname, Value der jeweilige Wert (HashMap ist gewrappt)
652 652  )))
653 653  
654 -== Request of result variables through the LMS ==
696 +== Abfrage von Ergebnisvariablen durch LMS ==
655 655  
656 -{{code language="xml" title="Abfrage von Ergebnisvariablen durch LMS"}}
698 +{{code title="Abfrage von Ergebnisvariablen durch LMS" language="xml"}}
657 657   @WebMethod(operationName = „getResultVariables")
658 658  public HashMapWrapper getResultVariables(
659 659  @WebParam(name = „version") final Integer version,
... ... @@ -667,12 +667,12 @@
667 667  |(((
668 668  version
669 669  )))|(((
670 -Requested version: 1
712 +Angefragte Version: 1
671 671  )))
672 672  |(((
673 673  contentPackage
674 674  )))|(((
675 -Content package (zipped) as byte array.
717 +Content Package (gezippt) als Byte-Array.
676 676  )))
677 677  |(((
678 678  additionalParams
... ... @@ -685,15 +685,14 @@
685 685  |(((
686 686  HashMap<String, String>
687 687  )))|(((
688 -Map of result variables, key is the variable name, value the corresponding
689 -value (HashMap is wrapped).
730 +Map der Result-Variables, Key ist der Variablenname, Value der jeweilige Wert (HashMap ist gewrappt)
690 690  )))
691 691  
692 692  == Wrapper ==
693 693  
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.
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.
695 695  
696 -=== Wrapper for HashMap<String, String> ===
737 +=== Wrapper für die HashMap<String, String> ===
697 697  
698 698  HashMapWrapper.java:
699 699  
... ... @@ -701,7 +701,7 @@
701 701  
702 702  [[image:attach:HashMapWrapperjava2.png]]
703 703  
704 -=== Wrapper for the ArrayList<ResultsForStudent> ===
745 +=== Wrapper für die ArrayList<ResultsForStudent> ===
705 705  
706 706  ResultsForStudentsWrapper.java:
707 707  
Confluence.Code.ConfluencePageClass[0]
id
... ... @@ -1,1 +1,1 @@
1 -147882509
1 +3342793
url
... ... @@ -1,1 +1,1 @@
1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/147882509/Schnittstelle ONYX Reporter
1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/3342793/Schnittstelle ONYX Reporter