Zum Inhalt springen

Änderungen von Dokument 06 Schnittstelle ONYX Editor

Zuletzt geändert von Carina Enke am 13.02.2024
Von Version 78.1
bearbeitet von Carina Enke
am 08.05.2019
Änderungskommentar: Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 8.7.
Auf Version 73.1
bearbeitet von Carina Enke
am 19.05.2020
Änderungskommentar: Mittels Scroll Versions veröffentlicht aus dem Bereich ONYXintern und Version 9.0.

Zusammenfassung

Details

Seiteneigenschaften
Inhalt
... ... @@ -1,12 +1,94 @@
1 1  {{sv-translation language="de"}}
2 2  {{layout}}
3 3  {{layout-section ac:type="single"}}
4 -{{layout-cell}}{{/layout-cell}}
4 +{{layout-cell}}
5 +\\
6 +
7 +{{details}}
8 +(% class="wrapped" %)
9 +|=(((
10 +Verantwortlicher
11 +)))|(((
12 +\\
13 +)))
14 +|=(% colspan="1" %)(% colspan="1" %)
15 +(((
16 +Status
17 +)))|(% class="highlight-yellow" colspan="1" data-highlight-colour="yellow" %)(% class="highlight-yellow" colspan="1" data-highlight-colour="yellow" %)
18 +(((
19 +(% class="content-wrapper" %)
20 +(((
21 +{{sv-metadata type="workflow-status"/}}
22 +
23 +{{status colour="Green" title="Fertig"/}}
24 +)))
25 +)))
26 +|=(% colspan="1" %)(% colspan="1" %)
27 +(((
28 +Varianten
29 +)))|(% colspan="1" %)(% colspan="1" %)
30 +(((
31 +(% class="content-wrapper" %)
32 +(((
33 +{{sv-metadata type="variants"/}}
34 +)))
35 +)))
36 +|=(% colspan="1" %)(% colspan="1" %)
37 +(((
38 +Attribute
39 +)))|(% colspan="1" %)(% colspan="1" %)
40 +(((
41 +(% class="content-wrapper" %)
42 +(((
43 +{{sv-metadata type="attributes"/}}
44 +)))
45 +)))
46 +|=(% colspan="1" %)(% colspan="1" %)
47 +(((
48 +Pagekey
49 +)))|(% colspan="1" %)(% colspan="1" %)
50 +(((
51 +(% class="content-wrapper" %)
52 +(((
53 +{{sv-metadata type="pagekey"/}}
54 +)))
55 +)))
56 +|=(% colspan="1" %)(% colspan="1" %)
57 +(((
58 +Übersetzung
59 +)))|(% colspan="1" %)(% colspan="1" %)
60 +(((
61 +(% class="content-wrapper" %)
62 +(((
63 +Interface ONYX Editor 
64 +
65 +{{status colour="Green" title="fertig"/}}
66 +)))
67 +)))
68 +|=(% colspan="1" %)(% colspan="1" %)
69 +(((
70 +TODOs
71 +)))|(% colspan="1" %)(% colspan="1" %)
72 +(((
73 +(% class="content-wrapper" %)
74 +(((
75 +Stand der Infos auf Ticket ONYX-4213 vom Aug 2018
76 +
77 +(% class="task-list" %)
78 +(((
79 +{{task reference="/Tasks/Task_1" status="Done"}}
80 +carina {{mention reference="XWiki.0a49950f5c0f19a8015c101b60e10001" style="FULL_NAME" anchor="XWiki-0a49950f5c0f19a8015c101b60e10001-mSKyV"/}}Neue Seite bitte übersetzen
81 +{{/task}}
82 +)))
83 +)))
84 +)))
85 +{{/details}}
86 +{{/layout-cell}}
5 5  {{/layout-section}}
6 6  
7 7  {{layout-section ac:type="two_right_sidebar"}}
8 8  {{layout-cell}}
9 -
91 +\\
10 10  {{/layout-cell}}
11 11  
12 12  {{layout-cell}}
... ... @@ -17,10 +17,6 @@
17 17  {{toc/}}
18 18  {{/panel}}
19 19  {{/scroll-ignore}}
20 -
21 -
22 -
23 -
24 24  {{/layout-cell}}
25 25  {{/layout-section}}
26 26  
... ... @@ -38,19 +38,20 @@
38 38  @RestParam(name = "params") final Map<String, String> params) {}
39 39  {{/code}}
40 40  
41 -
119 +\\
42 42  
43 43  === Parameter saveResult2 ===
44 44  
123 +(% class="wrapped" %)
45 45  |(((
46 46  uniqueId
47 47  )))|(((
48 -Eindeutige ID, die ONYX WebPlayer und ONYX Editor bei der Ausführung des Tests vereinbart haben
127 +Eindeutige ID, die ONYX WebPlayer und ONYX Editor bei der Ausführung des Tests vereinbart haben.
49 49  )))
50 50  |(((
51 51  resultFile
52 52  )))|(((
53 -Ergebnis-Datei als ZIP-File (QTI-konformes result.xml, ggf. inkl. darin referenzierter Dateien wie User-Uploads oder User-Contents
132 +Ergebnis-Datei als ZIP-File (QTI-konformes result.xml, ggf. inkl. darin referenzierter Dateien wie User-Uploads oder User-Contents)
54 54  )))
55 55  |(((
56 56  params
... ... @@ -58,10 +58,11 @@
58 58  Generische Parameter. Diese werden aktuell ohne weitere Verarbeitung einfach nur gespeichert.
59 59  )))
60 60  
61 -
140 +\\
62 62  
63 63  === returnValue saveResult2 ===
64 64  
144 +(% class="wrapped" %)
65 65  |(((
66 66  boolean
67 67  )))|(((
... ... @@ -70,7 +70,7 @@
70 70  
71 71  == Ergebnisse speichern (Legacy) ==
72 72  
73 -
153 +\\
74 74  
75 75  {{code title="Ergebnisse speichern (Legacy)"}}
76 76  @RestMethod(name = "saveResult")
... ... @@ -79,23 +79,25 @@
79 79  @RestParam(name = "resultFile") final byte[] resultFile) {}
80 80  {{/code}}
81 81  
82 -
162 +\\
83 83  
84 84  === Parameter saveResult2 ===
85 85  
166 +(% class="wrapped" %)
86 86  |(((
87 87  uniqueId
88 88  )))|(((
89 -Eindeutige ID, die ONYX WebPlayer und ONYX Editor bei der Ausführung des Tests vereinbart haben
170 +Eindeutige ID, die ONYX WebPlayer und ONYX Editor bei der Ausführung des Tests vereinbart haben.
90 90  )))
91 91  |(((
92 92  resultFile
93 93  )))|(((
94 -Ergebnis-Datei als ZIP-File (QTI-konformes result.xml, ggf. inkl. darin referenzierter Dateien wie User-Uploads oder User-Contents
175 +Ergebnis-Datei als ZIP-File (QTI-konformes result.xml, ggf. inkl. darin referenzierter Dateien wie User-Uploads oder User-Contents)
95 95  )))
96 96  
97 97  === returnValue saveResult2 ===
98 98  
180 +(% class="wrapped" %)
99 99  |(((
100 100  boolean
101 101  )))|(((
... ... @@ -102,11 +102,11 @@
102 102  True bei Erfolg, sonst false
103 103  )))
104 104  
105 -
187 +\\
106 106  
107 107  == Version der Schnittstelle abfragen ==
108 108  
109 -
191 +\\
110 110  
111 111  {{code title="Version abfragen"}}
112 112  @RestMethod(name = "version")
... ... @@ -113,16 +113,17 @@
113 113  public String version() {}
114 114  {{/code}}
115 115  
116 -
198 +\\
117 117  
118 118  === Parameter version ===
119 119  
120 120  keine
121 121  
122 -
204 +\\
123 123  
124 124  === returnValue saveResult2 ===
125 125  
208 +(% class="wrapped" %)
126 126  |(((
127 127  String
128 128  )))|(((
... ... @@ -129,7 +129,7 @@
129 129  Version der REST-Schnittstelle, aktuell immer "1.0 (ONYX-Editor-Version)"
130 130  )))
131 131  
132 -
215 +\\
133 133  
134 134  == Nutzer löschen ==
135 135  
... ... @@ -149,6 +149,7 @@
149 149  
150 150  === Parameter deleteUser ===
151 151  
235 +(% class="wrapped" %)
152 152  |(((
153 153  login
154 154  )))|(((
... ... @@ -162,12 +162,12 @@
162 162  |(((
163 163  repo
164 164  )))|(((
165 -ID des LMS-Repositories, so wie diese im LMS bereits konfiguriert ist und zur Kommunikation mit dem ONYX Editor verwendet wird
249 +ID des LMS-Repositories, so wie diese im LMS bereits konfiguriert ist und zur Kommunikation mit dem ONYX Editor verwendet wird.
166 166  )))
167 167  |(((
168 168  property
169 169  )))|(((
170 -Selektionskriterium der zu löschenden Nutzer. Wenn "uid", dann wird nach dem gloabl gültigem Nutzer-Identifier (Shibboleth-Kriterium) gefiltert, sonst nach den Nutzernamen, die vom LMS in Verbindung mit dem ONYX Editor intern genutzt werden.
254 +Selektionskriterium der zu löschenden Nutzer. Wenn "uid", dann wird nach dem global gültigen Nutzer-Identifier (Shibboleth-Kriterium) gefiltert, sonst nach den Nutzernamen, die vom LMS in Verbindung mit dem ONYX Editor intern genutzt werden.
171 171  )))
172 172  |(((
173 173  values
... ... @@ -189,6 +189,7 @@
189 189  
190 190  Löschresultat-Informationen.
191 191  
276 +(% class="wrapped" %)
192 192  |(((
193 193  Key
194 194  )))|(((
... ... @@ -208,22 +208,196 @@
208 208  {{layout}}
209 209  {{layout-section ac:type="two_right_sidebar"}}
210 210  {{layout-cell}}
211 -
296 +\\
212 212  {{/layout-cell}}
213 213  
214 214  {{layout-cell}}
215 215  {{scroll-ignore}}
216 -{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="On this page"}}
301 +{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Content"}}
217 217  
218 218  
219 219  {{toc/}}
220 -
221 -**related pages**
222 -
223 -* pages
224 224  {{/panel}}
225 225  {{/scroll-ignore}}
226 226  {{/layout-cell}}
227 227  {{/layout-section}}
309 +
310 +{{layout-section ac:type="single"}}
311 +{{layout-cell}}
312 +== Save results ==
313 +
314 +With the ONYX Editor, system independent tests may be published. If users perform these tests, the result will be transferred back to the ONYX Editor, which saves it. The ONYX Editor provides the following REST interfaces:
315 +
316 +{{code title="Save results"}}
317 +@RestMethod(name = "saveResult2")
318 +public Boolean saveResult(
319 +@RestParam(name = "uniqueId") final String uniqueId,
320 +@RestParam(name = "resultFile") final byte[] resultFile,
321 +@RestParam(name = "params") final Map<String, String> params) {}
322 +{{/code}}
323 +
324 +\\
325 +
326 +=== Parameter saveResult2 ===
327 +
328 +|(((
329 +uniqueId
330 +)))|(((
331 +Unique ID used by the ONYX WebPlayer and ONYX Editor when running the test.
332 +)))
333 +|(((
334 +resultFile
335 +)))|(((
336 +Result file as ZIP file (QTI-compliant result.xml, including any referenced files such as user uploads or user content if necessary)
337 +)))
338 +|(((
339 +params
340 +)))|(((
341 +Generic parameters. These are currently only stored without further processing.
342 +)))
343 +
344 +\\
345 +
346 +=== returnValue saveResult2 ===
347 +
348 +|(((
349 +boolean
350 +)))|(((
351 +True if successful, otherwise false
352 +)))
353 +
354 +== Save results (legacy) ==
355 +
356 +\\
357 +
358 +{{code title="Save results (legacy)"}}
359 +@RestMethod(name = "saveResult")
360 +public Boolean saveResult(
361 +@RestParam(name = "uniqueId") final String uniqueId,
362 +@RestParam(name = "resultFile") final byte[] resultFile) {}
363 +{{/code}}
364 +
365 +\\
366 +
367 +=== Parameter saveResult2 ===
368 +
369 +|(((
370 +uniqueId
371 +)))|(((
372 +Unique ID used by the ONYX WebPlayer and ONYX Editor when running the test.
373 +)))
374 +|(((
375 +resultFile
376 +)))|(((
377 +Result file as ZIP file (QTI-compliant result.xml, including any referenced files such as user uploads or user content if necessary)
378 +)))
379 +
380 +=== returnValue saveResult2 ===
381 +
382 +|(((
383 +boolean
384 +)))|(((
385 +True if successful, otherwise false
386 +)))
387 +
388 +\\
389 +
390 +== Query interface version ==
391 +
392 +\\
393 +
394 +{{code title="Query version"}}
395 +@RestMethod(name = "version")
396 +public String version() {}
397 +{{/code}}
398 +
399 +\\
400 +
401 +=== Parameter version ===
402 +
403 +None
404 +
405 +\\
406 +
407 +=== returnValue saveResult2 ===
408 +
409 +|(((
410 +String
411 +)))|(((
412 +REST interface version, currently always "1.0 (ONYX Editor version)"
413 +)))
414 +
415 +\\
416 +
417 +== Delete user ==
418 +
419 +The ONYX Editor can be coupled to an LMS with the LMS being the user data management system. If users are deleted from the LMS, all related data (e. g. personal user settings) should also be deleted from the ONYX Editor.
420 +
421 +{{code title="Delete user"}}
422 +@RestMethod
423 +public Map<String, String> deleteUser(
424 + @RestParam(name = "login") final String login,
425 + @RestParam(name = "password") final String password,
426 + @RestParam(name = "repo") final String repo,
427 + @RestParam(name = "property") final String property,
428 + @RestParam(name = "values") final ArrayList<String> values,
429 + @RestParam(name = "reason") final String reason,
430 + @RestParam(name = "params") final Map<String, String> params) {}
431 +{{/code}}
432 +
433 +=== Parameter deleteUser ===
434 +
435 +|(((
436 +login
437 +)))|(((
438 +User name of an ONYX Editor admin user who has the right to delete other users.
439 +)))
440 +|(((
441 +password
442 +)))|(((
443 +Password of this ONYX Editor admin user.
444 +)))
445 +|(((
446 +repo
447 +)))|(((
448 +ID of the LMS repository as it is already configured in the LMS and used for communication with the ONYX Editor.
449 +)))
450 +|(((
451 +property
452 +)))|(((
453 +Selection criterion for the users to be deleted. If "uid", filtering is done according to the globally valid user identifier (Shibboleth criterion). Otherwise, the filtering is done according to the user names used internally by the LMS in conjunction with the ONYX Editor.
454 +)))
455 +|(((
456 +values
457 +)))|(((
458 +List of values to filter by, for example, list of user names.
459 +)))
460 +|(((
461 +reason
462 +)))|(((
463 +Reason for deletion. Will be included in the deletion log.
464 +)))
465 +|(((
466 +params
467 +)))|(((
468 +Currently not used
469 +)))
470 +
471 +=== returnValue deleteUser ===
472 +
473 +Deletion result information.
474 +
475 +|(((
476 +Key
477 +)))|(((
478 +The values as specified in the _values_ parameter
479 +)))
480 +|(((
481 +Value
482 +)))|(((
483 +Deletion result (e. g _NOT FOUND_, _ERROR:xyz_, ...)
484 +)))
485 +{{/layout-cell}}
486 +{{/layout-section}}
228 228  {{/layout}}
229 229  {{/sv-translation}}
Confluence.Code.ConfluencePageClass[0]
id
... ... @@ -1,1 +1,1 @@
1 -234979411
1 +337413505
url
... ... @@ -1,1 +1,1 @@
1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/234979411/Schnittstelle ONYX Editor
1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/337413505/Schnittstelle ONYX Editor