Zum Inhalt springen

Änderungen von Dokument 08 Schnittstelle ONYX Reporter

Zuletzt geändert von Carina Enke am 13.02.2024
Von Version 328.1
bearbeitet von Carina Enke
am 24.09.2018
Änderungskommentar: Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 1.11.1.
Auf Version 397.1
bearbeitet von Carina Enke
am 13.02.2024
Änderungskommentar: Es gibt keinen Kommentar für diese Version

Zusammenfassung

Details

Seiteneigenschaften
Titel
... ... @@ -1,1 +1,1 @@
1 -Schnittstelle ONYX Reporter
1 +10 Schnittstelle ONYX Reporter
Übergeordnete Seite
... ... @@ -1,0 +1,1 @@
1 +ONYX.Systeminformationen.WebHome
Inhalt
... ... @@ -1,27 +2,13 @@
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 -
14 14  {{layout-section ac:type="two_right_sidebar"}}
15 15  {{layout-cell}}
16 -====== Inhalt: ======
17 -
18 -
19 -
20 -{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}
4 +
21 21  {{/layout-cell}}
22 22  
23 23  {{layout-cell}}
24 -
8 +{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Inhalt"}}
9 +{{toc start="2"/}}
10 +{{/panel}}
25 25  {{/layout-cell}}
26 26  {{/layout-section}}
27 27  
... ... @@ -31,6 +31,7 @@
31 31  
32 32  Über die Schnittstelle zum ONYX WebReporter erfolgt jede Kommunikation zwischen dem LMS und dem Reporter. Dazu erfolgt eine Reihe von Aufrufen:
33 33  
20 +(% class="wrapped" %)
34 34  |(((
35 35  armSite
36 36  )))|(((
... ... @@ -76,6 +76,7 @@
76 76  
77 77  === Parameter armSite ===
78 78  
66 +(% class="wrapped" %)
79 79  |(((
80 80  version
81 81  )))|(((
... ... @@ -118,6 +118,7 @@
118 118  
119 119  === ReturnValue armSite ===
120 120  
109 +(% class="wrapped" %)
121 121  |(((
122 122  String
123 123  )))|(((
... ... @@ -140,6 +140,7 @@
140 140  
141 141  === Parameter initiateSite ===
142 142  
132 +(% class="wrapped" %)
143 143  |(((
144 144  version
145 145  )))|(((
... ... @@ -175,6 +175,7 @@
175 175  
176 176  === ReturnValue initiateSite ===
177 177  
168 +(% class="wrapped" %)
178 178  |(((
179 179  String
180 180  )))|(((
... ... @@ -198,7 +198,6 @@
198 198  
199 199  == Abmeldung durch LMS ==
200 200  
201 -
202 202  
203 203  {{code}}
204 204  @WebMethod(operationName = „disarmSite")
... ... @@ -210,10 +210,10 @@
210 210  }
211 211  {{/code}}
212 212  
213 -
214 214  
215 215  === Parameter disarmSite ===
216 216  
206 +(% class="wrapped" %)
217 217  |(((
218 218  version
219 219  )))|(((
... ... @@ -239,6 +239,7 @@
239 239  
240 240  === ReturnValue disarmSite ===
241 241  
232 +(% class="wrapped" %)
242 242  |(((
243 243  Boolean
244 244  )))|(((
... ... @@ -261,6 +261,7 @@
261 261  
262 262  === Parameter getResultValues ===
263 263  
255 +(% class="wrapped" %)
264 264  |(((
265 265  version
266 266  )))|(((
... ... @@ -291,6 +291,7 @@
291 291  
292 292  === ReturnValue getResultValues ===
293 293  
286 +(% class="wrapped" %)
294 294  |(((
295 295  HashMap<String, String>
296 296  )))|(((
... ... @@ -310,6 +310,7 @@
310 310  
311 311  === Parameter getResultVariables ===
312 312  
306 +(% class="wrapped" %)
313 313  |(((
314 314  version
315 315  )))|(((
... ... @@ -328,6 +328,7 @@
328 328  
329 329  === ReturnValue getResultVariables ===
330 330  
325 +(% class="wrapped" %)
331 331  |(((
332 332  HashMap<String, String>
333 333  )))|(((
... ... @@ -342,15 +342,15 @@
342 342  
343 343  HashMapWrapper.java:
344 344  
345 -[[image:attach:HashMapWrapperjava.png]]
340 +[[image:attach:HashMapWrapperjava.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
346 346  
347 -[[image:attach:HashMapWrapperjava2.png]]
342 +[[image:attach:HashMapWrapperjava2.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
348 348  
349 349  === Wrapper für die ArrayList<ResultsForStudent> ===
350 350  
351 351  ResultsForStudentsWrapper.java:
352 352  
353 -[[image:attach:ResultsForStudentsWrapperjava.png]]
348 +[[image:attach:ResultsForStudentsWrapperjava.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
354 354  {{/layout-cell}}
355 355  {{/layout-section}}
356 356  
... ... @@ -362,358 +362,7 @@
362 362  {{layout-cell}}
363 363  ====== relevante Links: ======
364 364  
365 -* [[doc:ONYX Player Interface]]
360 +* [[ONYX Player Interface>>doc:ONYX.Systeminformationen.Schnittstelle ONYX Player.WebHome]]
366 366  {{/layout-cell}}
367 367  {{/layout-section}}
368 368  {{/layout}}
369 -{{/sv-translation}}
370 -
371 -{{sv-translation language="en"}}
372 -{{layout}}
373 -{{layout-section ac:type="two_equal"}}
374 -{{layout-cell}}
375 -====== Content: ======
376 -
377 -
378 -
379 -{{toc maxLevel="5" outline="true" absoluteUrl="true" style="square"/}}
380 -{{/layout-cell}}
381 -
382 -{{layout-cell}}
383 -
384 -{{/layout-cell}}
385 -{{/layout-section}}
386 -
387 -{{layout-section ac:type="single"}}
388 -{{layout-cell}}
389 -== General ==
390 -
391 -The API to the ONYX WebReporter enables the communication between the LMS and the reporter. Therefore, a couple of commands will be executed:
392 -
393 -|(((
394 -armSite
395 -)))|(((
396 -Registration of sequence requests at the ONYX reporter
397 -)))
398 -|(((
399 -initiateSite
400 -)))|(((
401 -Initiates the reporter session (transmission of the CP).
402 -)))
403 -|(((
404 -disarmSite
405 -)))|(((
406 -Release of all reporter resources for this session.
407 -)))
408 -|(((
409 -getResultValues
410 -)))|(((
411 -Returns all or all requested results for the test. Condition: there is exactly one student in list transmitted in the initiateSite.
412 -)))
413 -|(% colspan="1" %)(% colspan="1" %)
414 -(((
415 -getResultVariables
416 -)))|(% colspan="1" %)(% colspan="1" %)
417 -(((
418 -Returns all or all requested outcome variables for the test. No armSite, initiateSite or disarmSite is necessary.
419 -)))
420 -
421 -== Connection to the LMS ==
422 -
423 -{{code language="xml" title="Anmeldung des LMS"}}
424 -@WebMethod(operationName = „armSite")
425 -public String armSite(
426 -@WebParam(name = „version") final Integer version,
427 -@WebParam(name = „userId") final String userId,
428 -@WebParam(name = „optionalRole") final Integer role,
429 -@WebParam(name = „secretToShare") final String secretToShare,
430 -@WebParam(name = „optionalUserLastName") final String userLastName,
431 -@WebParam(name = „optionalUserFirstName") final String userFirstName,
432 -@WebParam(name = „additionalParams") final HashMapWrapper additionalParams) {
433 -}
434 -{{/code}}
435 -
436 -=== Parameter armSite ===
437 -
438 -|(((
439 -version
440 -)))|(((
441 -Requested version: 1
442 -)))
443 -|(((
444 -userId
445 -)))|(((
446 -UserId of the requested reporter user
447 -)))
448 -|(((
449 -optionalRole
450 -)))|(((
451 -Optional. User role. 0=student, 1=tutor
452 -)))
453 -|(((
454 -secretToShare
455 -)))|(((
456 -Shared secret. Has to remain identical for every communication.
457 -)))
458 -|(((
459 -optionalUserLastName
460 -)))|(((
461 -Optional. User lastname.
462 -)))
463 -|(% colspan="1" %)(% colspan="1" %)
464 -(((
465 -optionalUserFirstName
466 -)))|(% colspan="1" %)(% colspan="1" %)
467 -(((
468 -Optional. User firstname.
469 -)))
470 -|(% colspan="1" %)(% colspan="1" %)
471 -(((
472 -additionalParams
473 -)))|(% colspan="1" %)(% colspan="1" %)
474 -(((
475 -Reserved for future use.
476 -)))
477 -
478 -=== ReturnValue armSite ===
479 -
480 -|(((
481 -String
482 -)))|(((
483 -Session ID that has to be used to mark any further reporter call.
484 -)))
485 -
486 -== Initialisation through LMS ==
487 -
488 -{{code language="xml" title="Initialisierung durch LMS"}}
489 -@WebMethod(operationName = „initiateSite")
490 -public String initiateSite(
491 -@WebParam(name = „version") final Integer version,
492 -@WebParam(name = „sessionId") final String sessionId,
493 -@WebParam(name = „secretToShare") final String secretToShare,
494 -@WebParam(name = „students") final ArrayList<ResultsForStudent> students,
495 -@WebParam(name = „optionalContentPackage") final byte[] contentPackage,
496 -@WebParam(name = „additionalParams") final HashMapWrapper additionalParams) {
497 -}
498 -{{/code}}
499 -
500 -=== Parameter initiateSite ===
501 -
502 -|(((
503 -version
504 -)))|(((
505 -Requested version: 1
506 -)))
507 -|(% colspan="1" %)(% colspan="1" %)
508 -(((
509 -sessionId
510 -)))|(% colspan="1" %)(% colspan="1" %)
511 -(((
512 -SessionId, as returned by armSite.
513 -)))
514 -|(((
515 -secretToShare
516 -)))|(((
517 -Shared secret. Has to remain identical at every communication.
518 -)))
519 -|(((
520 -students
521 -)))|(((
522 -List of students with their results. See below.
523 -)))
524 -|(((
525 -optionalContentPackage
526 -)))|(((
527 -Optional. Content Package (zipped) as byte array.
528 -)))
529 -|(((
530 -additionalParams
531 -)))|(((
532 -Reserved for future use.
533 -)))
534 -
535 -=== ReturnValue initiateSite ===
536 -
537 -|(((
538 -String
539 -)))|(((
540 -Absolute URL of the reporter site for the frame. It has to be enriched by the LMS with the following URLparameters:
541 -
542 -* sid: Session ID as returned by armSite
543 -* (((
544 -uid: Student ID as registrated in the initiateSite at the ONYX Reporter.
545 -)))
546 -)))
547 -
548 -{{code language="xml"}}
549 -public class ResultsForStudent {
550 -   private String studentId = „";
551 -   private String firstname = „";
552 -   private String lastname = „";
553 -   private String groupname = „";
554 -   private String tutorname = „";
555 -   private File contentFile = null;
556 -   private byte[] resultsFile = null;
557 -}
558 -{{/code}}
559 -
560 -== Deconnection through the LMS ==
561 -
562 -
563 -
564 -{{code}}
565 -@WebMethod(operationName = „disarmSite")
566 -public Boolean disarmSite(
567 -@WebParam(name = „version") final Integer version,
568 -@WebParam(name = „sessionId") final String sessionId,
569 -@WebParam(name = „secretToShare") final String secretToShare,
570 -@WebParam(name = „additionalParams") final HashMapWrapper additionalParams) {
571 -}
572 -{{/code}}
573 -
574 -
575 -
576 -=== Parameter disarmSite ===
577 -
578 -|(((
579 -version
580 -)))|(((
581 -Requested version: 1
582 -)))
583 -|(% colspan="1" %)(% colspan="1" %)
584 -(((
585 -sessionId
586 -)))|(% colspan="1" %)(% colspan="1" %)
587 -(((
588 -SessionId, as returned by armSite.
589 -)))
590 -|(((
591 -secretToShare
592 -)))|(((
593 -Shared secret. Has to remain identical at every communication.
594 -)))
595 -|(((
596 -additionalParams
597 -)))|(((
598 -Reserved for future use.
599 -)))
600 -
601 -=== ReturnValue disarmSite ===
602 -
603 -|(((
604 -Boolean
605 -)))|(((
606 -True if successful, otherwise false.
607 -)))
608 -
609 -== Request of learning results through the LMS ==
610 -
611 -{{code language="xml" title="Abfrage von Lernerresultaten durch LMS"}}
612 - @WebMethod(operationName = „getResultValues")
613 -public HashMapWrapper getResultValues(
614 - @WebParam(name = „version") final Integer version,
615 - @WebParam(name = „sessionId") final String sessionId,
616 - @WebParam(name = „secretToShare") final String secretToShare,
617 - @WebParam(name = „requestedValues") final HashMap<String, String>
618 - requestedValues,
619 - @WebParam(name = „additionalParams") final HashMapWrapper additionalParams) {
620 -}
621 -{{/code}}
622 -
623 -=== Parameter getResultValues ===
624 -
625 -|(((
626 -version
627 -)))|(((
628 -Requested version: 1
629 -)))
630 -|(% colspan="1" %)(% colspan="1" %)
631 -(((
632 -sessionId
633 -)))|(% colspan="1" %)(% colspan="1" %)
634 -(((
635 -SessionId, as returned by armSite.
636 -)))
637 -|(((
638 -secretToShare
639 -)))|(((
640 -Shared secret. Has to remain identical at every communication.
641 -)))
642 -|(((
643 -requestedValues
644 -)))|(((
645 -Can be empty, thus all result variables will be returned. If it contains keys, only those will be returned.
646 -)))
647 -|(((
648 -additionalParams
649 -)))|(((
650 -Reserved for future use.
651 -)))
652 -
653 -=== ReturnValue getResultValues ===
654 -
655 -|(((
656 -HashMap<String, String>
657 -)))|(((
658 -Map of result variables, key is the variable name, value the corresponding value (HashMap is wrapped)
659 -)))
660 -
661 -== Request of result variables through the LMS ==
662 -
663 -{{code language="xml" title="Abfrage von Ergebnisvariablen durch LMS"}}
664 - @WebMethod(operationName = „getResultVariables")
665 -public HashMapWrapper getResultVariables(
666 -@WebParam(name = „version") final Integer version,
667 -@WebParam(name = „contentPackage") final byte[] contentPackage,
668 -@WebParam(name = „additionalParams") final HashMapWrapper additionalParams) {
669 -}
670 -{{/code}}
671 -
672 -=== Parameter getResultVariables ===
673 -
674 -|(((
675 -version
676 -)))|(((
677 -Requested version: 1
678 -)))
679 -|(((
680 -contentPackage
681 -)))|(((
682 -Content package (zipped) as byte array.
683 -)))
684 -|(((
685 -additionalParams
686 -)))|(((
687 -Reserved for future use.
688 -)))
689 -
690 -=== ReturnValue getResultVariables ===
691 -
692 -|(((
693 -HashMap<String, String>
694 -)))|(((
695 -Map of result variables, key is the variable name, value the corresponding
696 -value (HashMap is wrapped).
697 -)))
698 -
699 -== Wrapper ==
700 -
701 -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.
702 -
703 -=== Wrapper for HashMap<String, String> ===
704 -
705 -HashMapWrapper.java:
706 -
707 -[[image:attach:HashMapWrapperjava.png]]
708 -
709 -[[image:attach:HashMapWrapperjava2.png]]
710 -
711 -=== Wrapper for the ArrayList<ResultsForStudent> ===
712 -
713 -ResultsForStudentsWrapper.java:
714 -
715 -[[image:attach:ResultsForStudentsWrapperjava.png]]
716 -{{/layout-cell}}
717 -{{/layout-section}}
718 -{{/layout}}
719 -{{/sv-translation}}
HashMapWrapperjava.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Größe
... ... @@ -1,0 +1,1 @@
1 +135.3 KB
Inhalt
HashMapWrapperjava2.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Größe
... ... @@ -1,0 +1,1 @@
1 +187.3 KB
Inhalt
ResultsForStudentsWrapperjava.png
Author
... ... @@ -1,0 +1,1 @@
1 +XWiki.XWikiGuest
Größe
... ... @@ -1,0 +1,1 @@
1 +83.3 KB
Inhalt
Confluence.Code.ConfluencePageClass[0]
id
... ... @@ -1,1 +1,1 @@
1 -182190540
1 +3342390
url
... ... @@ -1,1 +1,1 @@
1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/182190540/Schnittstelle ONYX Reporter
1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/3342390/Schnittstelle ONYX Reporter