Zum Inhalt springen

Änderungen von Dokument 06 Schnittstelle ONYX Editor

Zuletzt geändert von Carina Enke am 13.02.2024
Von Version 80.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 95.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 Editor
1 +05 Schnittstelle ONYX Editor
Übergeordnete Seite
... ... @@ -1,0 +1,1 @@
1 +ONYX.Systeminformationen.WebHome
Inhalt
... ... @@ -1,8 +1,4 @@
1 1  {{layout}}
2 -{{layout-section ac:type="single"}}
3 -{{layout-cell}}{{/layout-cell}}
4 -{{/layout-section}}
5 -
6 6  {{layout-section ac:type="two_right_sidebar"}}
7 7  {{layout-cell}}
8 8  
... ... @@ -9,17 +9,9 @@
9 9  {{/layout-cell}}
10 10  
11 11  {{layout-cell}}
12 -{{scroll-ignore}}
13 13  {{panel title="Inhalt"}}
14 -
15 -
16 -{{toc/}}
9 +{{toc depth="3" start="2"/}}
17 17  {{/panel}}
18 -{{/scroll-ignore}}
19 -
20 -
21 -
22 -
23 23  {{/layout-cell}}
24 24  {{/layout-section}}
25 25  
... ... @@ -37,19 +37,19 @@
37 37  @RestParam(name = "params") final Map<String, String> params) {}
38 38  {{/code}}
39 39  
40 -
41 41  
42 42  === Parameter saveResult2 ===
43 43  
31 +(% class="wrapped" %)
44 44  |(((
45 45  uniqueId
46 46  )))|(((
47 -Eindeutige ID, die ONYX WebPlayer und ONYX Editor bei der Ausführung des Tests vereinbart haben
35 +Eindeutige ID, die ONYX WebPlayer und ONYX Editor bei der Ausführung des Tests vereinbart haben.
48 48  )))
49 49  |(((
50 50  resultFile
51 51  )))|(((
52 -Ergebnis-Datei als ZIP-File (QTI-konformes result.xml, ggf. inkl. darin referenzierter Dateien wie User-Uploads oder User-Contents
40 +Ergebnis-Datei als ZIP-File (QTI-konformes result.xml, ggf. inkl. darin referenzierter Dateien wie User-Uploads oder User-Contents)
53 53  )))
54 54  |(((
55 55  params
... ... @@ -57,10 +57,9 @@
57 57  Generische Parameter. Diese werden aktuell ohne weitere Verarbeitung einfach nur gespeichert.
58 58  )))
59 59  
60 -
61 -
62 62  === returnValue saveResult2 ===
63 63  
50 +(% class="wrapped" %)
64 64  |(((
65 65  boolean
66 66  )))|(((
... ... @@ -69,8 +69,6 @@
69 69  
70 70  == Ergebnisse speichern (Legacy) ==
71 71  
72 -
73 -
74 74  {{code title="Ergebnisse speichern (Legacy)"}}
75 75  @RestMethod(name = "saveResult")
76 76  public Boolean saveResult(
... ... @@ -78,23 +78,24 @@
78 78  @RestParam(name = "resultFile") final byte[] resultFile) {}
79 79  {{/code}}
80 80  
81 -
82 82  
83 83  === Parameter saveResult2 ===
84 84  
69 +(% class="wrapped" %)
85 85  |(((
86 86  uniqueId
87 87  )))|(((
88 -Eindeutige ID, die ONYX WebPlayer und ONYX Editor bei der Ausführung des Tests vereinbart haben
73 +Eindeutige ID, die ONYX WebPlayer und ONYX Editor bei der Ausführung des Tests vereinbart haben.
89 89  )))
90 90  |(((
91 91  resultFile
92 92  )))|(((
93 -Ergebnis-Datei als ZIP-File (QTI-konformes result.xml, ggf. inkl. darin referenzierter Dateien wie User-Uploads oder User-Contents
78 +Ergebnis-Datei als ZIP-File (QTI-konformes result.xml, ggf. inkl. darin referenzierter Dateien wie User-Uploads oder User-Contents)
94 94  )))
95 95  
96 96  === returnValue saveResult2 ===
97 97  
83 +(% class="wrapped" %)
98 98  |(((
99 99  boolean
100 100  )))|(((
... ... @@ -101,27 +101,22 @@
101 101  True bei Erfolg, sonst false
102 102  )))
103 103  
104 -
105 -
106 106  == Version der Schnittstelle abfragen ==
107 107  
108 -
109 -
110 110  {{code title="Version abfragen"}}
111 111  @RestMethod(name = "version")
112 112  public String version() {}
113 113  {{/code}}
114 114  
115 -
116 116  
117 117  === Parameter version ===
118 118  
119 119  keine
120 120  
121 -
122 122  
123 123  === returnValue saveResult2 ===
124 124  
105 +(% class="wrapped" %)
125 125  |(((
126 126  String
127 127  )))|(((
... ... @@ -128,8 +128,6 @@
128 128  Version der REST-Schnittstelle, aktuell immer "1.0 (ONYX-Editor-Version)"
129 129  )))
130 130  
131 -
132 -
133 133  == Nutzer löschen ==
134 134  
135 135  Der ONYX Editor kann an ein LMS gekoppelt werden, so dass das LMS das nutzerdatenführende System ist. Werden Nutzer im LMS gelöscht, so sollten alle zugehörigen Daten (bspw. die persönlichen Einstellungen des Nutzers) auch im ONYX Editor gelöscht werden.
... ... @@ -148,6 +148,7 @@
148 148  
149 149  === Parameter deleteUser ===
150 150  
130 +(% class="wrapped" %)
151 151  |(((
152 152  login
153 153  )))|(((
... ... @@ -161,12 +161,12 @@
161 161  |(((
162 162  repo
163 163  )))|(((
164 -ID des LMS-Repositories, so wie diese im LMS bereits konfiguriert ist und zur Kommunikation mit dem ONYX Editor verwendet wird
144 +ID des LMS-Repositories, so wie diese im LMS bereits konfiguriert ist und zur Kommunikation mit dem ONYX Editor verwendet wird.
165 165  )))
166 166  |(((
167 167  property
168 168  )))|(((
169 -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.
149 +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.
170 170  )))
171 171  |(((
172 172  values
... ... @@ -188,6 +188,7 @@
188 188  
189 189  Löschresultat-Informationen.
190 190  
171 +(% class="wrapped" %)
191 191  |(((
192 192  Key
193 193  )))|(((
... ... @@ -201,3 +201,181 @@
201 201  {{/layout-cell}}
202 202  {{/layout-section}}
203 203  {{/layout}}
185 +
186 +{{layout}}
187 +{{layout-section ac:type="two_right_sidebar"}}
188 +{{layout-cell}}
189 +
190 +{{/layout-cell}}
191 +
192 +{{layout-cell}}
193 +{{panel borderColor="#ddd" bgColor="#f0f0f0" borderStyle="solid" title="Content"}}
194 +{{toc start="2"/}}
195 +{{/panel}}
196 +{{/layout-cell}}
197 +{{/layout-section}}
198 +
199 +{{layout-section ac:type="single"}}
200 +{{layout-cell}}
201 +== Save results ==
202 +
203 +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:
204 +
205 +{{code title="Save results"}}
206 +@RestMethod(name = "saveResult2")
207 +public Boolean saveResult(
208 +@RestParam(name = "uniqueId") final String uniqueId,
209 +@RestParam(name = "resultFile") final byte[] resultFile,
210 +@RestParam(name = "params") final Map<String, String> params) {}
211 +{{/code}}
212 +
213 +
214 +=== Parameter saveResult2 ===
215 +
216 +|(((
217 +uniqueId
218 +)))|(((
219 +Unique ID used by the ONYX WebPlayer and ONYX Editor when running the test.
220 +)))
221 +|(((
222 +resultFile
223 +)))|(((
224 +Result file as ZIP file (QTI-compliant result.xml, including any referenced files such as user uploads or user content if necessary)
225 +)))
226 +|(((
227 +params
228 +)))|(((
229 +Generic parameters. These are currently only stored without further processing.
230 +)))
231 +
232 +=== returnValue saveResult2 ===
233 +
234 +|(((
235 +boolean
236 +)))|(((
237 +True if successful, otherwise false
238 +)))
239 +
240 +== Save results (legacy) ==
241 +
242 +{{code title="Save results (legacy)"}}
243 +@RestMethod(name = "saveResult")
244 +public Boolean saveResult(
245 +@RestParam(name = "uniqueId") final String uniqueId,
246 +@RestParam(name = "resultFile") final byte[] resultFile) {}
247 +{{/code}}
248 +
249 +
250 +=== Parameter saveResult2 ===
251 +
252 +|(((
253 +uniqueId
254 +)))|(((
255 +Unique ID used by the ONYX WebPlayer and ONYX Editor when running the test.
256 +)))
257 +|(((
258 +resultFile
259 +)))|(((
260 +Result file as ZIP file (QTI-compliant result.xml, including any referenced files such as user uploads or user content if necessary)
261 +)))
262 +
263 +=== returnValue saveResult2 ===
264 +
265 +|(((
266 +boolean
267 +)))|(((
268 +True if successful, otherwise false
269 +)))
270 +
271 +== Query interface version ==
272 +
273 +{{code title="Query version"}}
274 +@RestMethod(name = "version")
275 +public String version() {}
276 +{{/code}}
277 +
278 +
279 +=== Parameter version ===
280 +
281 +None
282 +
283 +
284 +=== returnValue saveResult2 ===
285 +
286 +|(((
287 +String
288 +)))|(((
289 +REST interface version, currently always "1.0 (ONYX Editor version)"
290 +)))
291 +
292 +== Delete user ==
293 +
294 +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.
295 +
296 +{{code title="Delete user"}}
297 +@RestMethod
298 +public Map<String, String> deleteUser(
299 + @RestParam(name = "login") final String login,
300 + @RestParam(name = "password") final String password,
301 + @RestParam(name = "repo") final String repo,
302 + @RestParam(name = "property") final String property,
303 + @RestParam(name = "values") final ArrayList<String> values,
304 + @RestParam(name = "reason") final String reason,
305 + @RestParam(name = "params") final Map<String, String> params) {}
306 +{{/code}}
307 +
308 +=== Parameter deleteUser ===
309 +
310 +|(((
311 +login
312 +)))|(((
313 +User name of an ONYX Editor admin user who has the right to delete other users.
314 +)))
315 +|(((
316 +password
317 +)))|(((
318 +Password of this ONYX Editor admin user.
319 +)))
320 +|(((
321 +repo
322 +)))|(((
323 +ID of the LMS repository as it is already configured in the LMS and used for communication with the ONYX Editor.
324 +)))
325 +|(((
326 +property
327 +)))|(((
328 +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.
329 +)))
330 +|(((
331 +values
332 +)))|(((
333 +List of values to filter by, for example, list of user names.
334 +)))
335 +|(((
336 +reason
337 +)))|(((
338 +Reason for deletion. Will be included in the deletion log.
339 +)))
340 +|(((
341 +params
342 +)))|(((
343 +Currently not used
344 +)))
345 +
346 +=== returnValue deleteUser ===
347 +
348 +Deletion result information.
349 +
350 +|(((
351 +Key
352 +)))|(((
353 +The values as specified in the _values_ parameter
354 +)))
355 +|(((
356 +Value
357 +)))|(((
358 +Deletion result (e. g _NOT FOUND_, _ERROR:xyz_, ...)
359 +)))
360 +{{/layout-cell}}
361 +{{/layout-section}}
362 +{{/layout}}
Confluence.Code.ConfluencePageClass[0]
id
... ... @@ -1,1 +1,1 @@
1 -226231253
1 +226230567
url
... ... @@ -1,1 +1,1 @@
1 -https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/226231253/Schnittstelle ONYX Editor
1 +https://www.bps-system.de/help/display/SOV/wiki/spaces/ONYX/pages/226230567/Schnittstelle ONYX Editor