Zum Inhalt springen

Wiki-Quellcode von Freigabe Kurse und Inhalte

Version 1278.1 von Carina Enke am 15.03.2018
Zeige letzte Bearbeiter
1 {{sv-translation language="de"}}
2 {{layout}}
3 {{layout-section ac:type="single"}}
4 {{layout-cell}}{{/layout-cell}}
5 {{/layout-section}}
6
7 {{layout-section ac:type="two_right_sidebar"}}
8 {{layout-cell}}
9 Verantwortliche bzw. Autoren eines Kurses oder einer anderen [[Lernressource>>doc:Lernressourcen]] können für die Teilnehmenden verschiedene **Freigabe-Einstellungen** vornehmen. Von diesen hängt es ab, ob die Ressource in der Lernplattform für andere Nutzer **sichtbar und auffindbar** sind oder ob ein bestimmter **Inhalt im Kurs sichtbar** ist bzw. ob der **Zugang zu sichtbaren Inhalten** erlaubt ist.
10
11 Die allgemeine Freigabe eines Kurses oder einer Lernressource wird über den **Publikationsstatus** geregelt.
12
13 Für die Freigabe innerhalb eines Kurses können individuelle Regeln zu **Sichtbarkeit und Zugang** festgelegt und frei miteinander kombiniert werden. Für fortgeschrittene Nutzer gibt es zur Abbildung komplexer Szenarien einen **Expertenmodus**.
14
15
16 {{/layout-cell}}
17
18 {{layout-cell}}
19 {{scroll-ignore}}
20 {{panel title="Inhalt"}}
21
22
23 {{toc/}}
24
25 **Verwandte Themen**
26
27 * [[Verwalten von Kursverantwortlichen>>doc:Detailseite]]
28 {{/panel}}
29
30
31
32
33 {{/scroll-ignore}}
34 {{/layout-cell}}
35 {{/layout-section}}
36
37 {{layout-section ac:type="single"}}
38 {{layout-cell}}
39
40
41
42
43 {{id name="zugriff"/}}
44
45 == Allgemeiner Zugriff auf Kurse und Ressourcen (**Publikationsstatus**) ==
46
47
48
49 {{display reference="Publikationsstatus von Kursen oder Lernressoucen"/}}
50
51 == Kurs und Kursinhalte veröffentlichen ==
52
53 Wenn Sie einen Kurs ohne den [[Kurs-Assistenten>>doc:||anchor="ErstellungmitdemKurs-Assistenten"]] erstellen, ist dieser zunächst **nur für Sie sichtbar** und auch die **Kursinhalte sind noch nicht öffentlich** verfügbar. In der Lernplattform gibt es verschiedene Status, die die Sichtbarkeit von Kursen und Kursinhalten sowie den Zugang zu diesen regeln. Um geänderte oder neu hinzugefügte Inhalte für die Teilnehmer Ihres Kurses bereitzustellen, müssen Sie Ihren Kurs publizieren.
54
55 Folgendes ist in Vorbereitung zu beachten:
56
57 * Inhalte, die im Kurseditor mit einem **roten X im Kursmenü** markiert sind, enthalten noch Fehler oder sind nicht vollständig konfiguriert. Neben der Markierung im Kursmenü werden die Probleme außerdem präsent im oberen Bereich des Kurses aufgeführt. Sie müssen die genannten Probleme beheben, um diese Inhalte veröffentlichen zu können.
58 * Inhalte, die neu und bereit zum Publizieren sind, werden im Kursmenü mit einem **grünen Häkchen** gekennzeichnet.
59 * Sobald es neue Inhalte im Kurs gibt, wird **Publizieren** bei den Editorwerkzeugen im rechten Bereich hervorgehoben
60
61 [[image:attach:Kurseditor - Icons zum Status von Kursbausteinen_de.png]]
62
63 (% style="margin-left: 30.0px;" %)
64
65
66 {{tip}}
67 Eine Legende zur Erklärung dieser und weiterer Symbole finden Sie im Kurseditor am Ende der Seite.
68
69 [[image:attach:Kurseditor - Legende_de.png]]
70 {{/tip}}
71
72 === Publikationsstatus ändern ===
73
74 Den Publikationsstatus eines Kurses können Sie wie folgt ändern:
75
76 {{expand title="über die Detailseite ändern"}}
77 ==== Publikationsstatus über die Detailseite ändern ====
78
79 Der allgemeine Zugriff kann für  alle Kurse und Ressourcen über die Detailansicht geändert werden.
80
81 Gehen Sie dazu wie folgt vor:
82
83 |(((
84 1. Öffnen Sie einen Kurs und wählen Sie im Menü den Eintrag// **Details und Einstellungen** //.
85 )))|(((
86 [[image:attach:Kursrun - Details und Einstellungen öffnen_de.png]]
87 )))
88 |(((
89 2. Wählen Sie im Menü rechts //**Einstellungen ändern** //.
90 )))|(((
91 [[image:attach:Detailseite - Einstellungen ändern öffnen_de.png]]
92 )))
93 |(((
94 3. Im Tab **//Zugriffsrechte //**passen Sie den **//Zugriff //**an.
95
96 4. //**Speichern** //Sie Ihre Änderungen abschließend.
97 )))|(((
98 [[image:attach:Detailseite - Publikationsstatus_de.png]]
99 )))
100 {{/expand}}
101
102 {{expand title="über den Kurseditor ändern ..."}}
103 ==== Publikationsstatus über den Kurseditor ändern ====
104
105 |(((
106 Für **Kurse** gibt es die Möglichkeit, den Zugriff direkt beim **Publizieren eines Kurses** zu ändern.
107
108 Im **2. Schritt** können Sie ebenfalls Änderungen vornehmen und bei Bedarf im 3. Schritt einen konkreten Zeitpunkt für diese Änderungen festlegen.
109 )))|(((
110 [[image:attach:Kurseditor - Kurs publizieren_de.png]]
111 )))
112
113 {{info}}
114 Für eine Ressource Kurs haben Sie bei den Optionen **Alle registrierten Benutzer** und **Registrierte Benutzer und Gäste** die Möglichkeit, zusätzlich den Zugriff für sogenannte "Externe Benutzer" freizuschalten. Aktivieren Sie dafür die Checkbox (% style="color: rgb(0,0,0);" %)//**Externe Benutzer können im Kurs mitwirken** //. (% style="color: rgb(0, 0, 0); color: rgb(0, 0, 0)" %)Weitere Informationen zu externen Nutzern finden Sie im Bereich [[doc:Rollen und Rechte]].(% style="color: rgb(0,0,0);" %)
115
116 {{/info}}
117 {{/expand}}
118
119 == Freigabe innerhalb von Kursen (**Sichtbarkeit und Zugang**) ==
120
121 Für die Freigabe von Inhalten innerhalb eines Kurses können individuelle Regeln festgelegt werden, um die **Sichtbarkeit** und den **Zugang** zu steuern. Für fortgeschrittene Nutzer gibt es zur Abbildung komplexer Szenarien einen **Expertenmodus** für die Konfiguration dieser Regeln.
122
123 Einstellungen in diesen beiden Bereichen haben folgende grundsätzliche Auswirkungen:
124
125 |(((
126 **Sichtbarkeit**
127 )))|(((
128 Wenn Inhalte in der **Sichtbarkeit eingeschränkt** sind, weil sie beispielsweise nur für eine festgelegte Gruppe zu sehen sind, werden diese dem Nutzer **nicht im Kursmenü** angezeigt. Ist der Nutzer jedoch Mitglied der Gruppe und erfüllt somit die Bedingung zur Sichtbarkeit, sieht dieser Nutzer den Kursbaustein in der Kursnavigation.
129
130 Das Navigationsmenü eines Kurses ist demnach flexibel und kann sich je nach Zeitpunkt und Art der Nutzung des Kurses (erhaltene Bewertungen, Arbeit in Gruppen) verändern.
131
132
133
134 {{expand title="Beispiel zur Ansicht im Kursmenü ..."}}
135 |(((
136 Ansicht für einen Nutzer, der die Bedingung zur Sichtbarkeit nicht erfüllt: Nutzer sieht Eintrag zum Podcast in der Navigation nicht.
137 )))|(((
138 [[image:attach:Kurseditor - Sichtbarkeit gruppenabhängig Bsp2_de.png]]
139 )))
140 |(% colspan="1" %)(% colspan="1" %)
141 (((
142 Ansicht für einen Nutzer, der die Bedingung zur Sichtbarkeit erfüllt: Nutzer sieht Eintrag zum Podcast in der Navigation.
143 )))|(% colspan="1" %)(% colspan="1" %)
144 (((
145 [[image:attach:Kurseditor - Sichtbarkeit gruppenabhängig Bsp3_de.png]]
146 )))
147
148
149
150
151 {{/expand}}
152 )))|(% colspan="1" %)(% colspan="1" %)
153 (((
154 [[image:attach:Kurseditor - Sichtbarkeit gruppenabhängig Bsp1_de.png]]
155 )))
156 |(((
157 **Zugang**
158 )))|(((
159 Wird ein Inhalt im **Zugang beschränkt** ist er zwar **in der Kursnavigation sichtbar** (sofern keine Sichtbarkeitsregel dies verhindert), aber der eigentliche **Inhalt** **wird dem Nutzer nicht angezeigt**. Er sieht eine Meldung mit entsprechenden Informationen. Im Beispiel ist der Abschlusstest nur für Mitglieder der Gruppe "Kursteilnehmer" freigegeben. Außerdem muss der Lernende den Baustein Prüfungsvorleistung bestanden haben.
160 )))|(% colspan="1" %)(% colspan="1" %)
161 (((
162 [[image:attach:Kursrun - Zugang beschränkt Bsp_de.png]]
163 )))
164
165 {{expand title="Detailiertere Darstellung zum Zusammenspiel beider Einstellungsoptionen ..."}}
166 === (% class="expand-control-icon icon expanded" %)Zusammenhang von Sichtbarkeit und Zugang
167 (%%) ===
168
169 **Datumsabhängige Konfiguration**
170
171 Die nachfolgende Abbildung zeigt, wie die datumsabhängige Konfiguration von Sichtbarkeit und Zugang zusammenspielen. Im oberen Teil der Abbildung wurden keine Einstellungen angepasst. Sichtbarkeit und Zugang sind somit nicht eingeschränkt. Im unteren Teil der Abbildung wurden für die Sichtbarkeit und den Zugang verschiedene Zeitpunkte gewählt. Für die Periode, in der der Kursbaustein zwar im Menü sichtbar, aber der Inhalt nicht zugänglich ist, kann dem Benutzer anstelle des Kursbausteininhalts eine Information angezeigt werden.
172
173 [[image:attach:Grafik - Sichtbarkeit und Zugang_de.png]]
174
175 **Gruppenabhängige Konfiguration**
176
177 Die Abbildung zeigt die gruppenabhängige Konfiguration der Sichtbarkeit bzw. des Zugangs. Im oberen Teil der Abbildung wurde keine Eingabe gemacht. Alle Kursteilnehmer können somit den Kursbaustein-Link sehen und haben Zugang zu den Inhalten - unabhängig davon, ob sie in einer Lerngruppe sind. Im unteren Teil der Abbildung haben dies nur die Gruppen "Rot" und "Grün".
178
179 [[image:attach:Grafik - gruppenabhängige Konfiguration _de.png]]
180 {{/expand}}
181
182 {{info title="Standardeinstellung"}}
183 Werden keine zusätzlichen Einstellungen vorgenommen, sind die Inhalte eines Kursbausteins nach dem Publizieren des Kurses standardmäßig für alle Nutzer der, mit dem Publikationsstatus festgelegten, Nutzergruppe sichtbar. Wird ein Kurs beispielsweise mit dem Status BAR (Alle registrierten Benutzer) publiziert, sind alle Inhalte des Kurses für alle Nutzer, die sich in diesem System anmelden können, sichtbar.
184 {{/info}}
185
186 {{tip}}
187 Durch die Einstellung **Einschränkung des Zugangs **ist es möglich den Lernenden einen Überblick über die gesamten Kursinhalte sowie über die Zugriffsbedingungen (z.B. ab einem Datum, nach Einschreibung in eine Gruppe oder nach Bestehen eines Tests) zur Verfügung zu stellen.
188
189 Eine **Einschränkung der Sichtbarkeit** von Inhalten ist z.B. sinnvoll, wenn Sie für verschiedene Gruppen von Nutzern unterschiedliche Kursinhalte anbieten wollen.
190 {{/tip}}
191
192 {{info title="Hinweis"}}
193 Beachten Sie, dass es nicht sinnvoll ist, die Sichtbarkeit mehr einzuschränken als den Zugang, weil der Inhalt eines unsichtbaren Kursbausteins ohnehin nicht zugänglich ist.
194 {{/info}}
195
196 === Regeln für Sichtbarkeit und Zugang anlegen oder ändern ===
197
198 |(((
199 Einstellungen zu beiden Bereichen werden im **Kurseditor** vorgenommen.
200
201 Neben dem Reiter „Titel und Beschreibung“ besitzt dazu der Kurs selbst und auch jeder Kursbausteintyp die Reiter „**Sichtbarkeit**“ und „**Zugang**“.
202 )))|(((
203 [[image:attach:Kurseditor - Tab Sichtbarkeit und Zugang_de.png]]
204 )))
205
206 Folgende **Attribute** stehen im System zur Verfügung, um Regeln zu Sichtbarkeit und Zugang im Kurseditor festzulegen:
207
208 {{expand title="Allgemeine Attribute"}}
209
210
211 {{display reference="Sichtbarkeit und Zugriff"/}}
212 {{/expand}}
213
214 {{expand title="Spezielle Attribute für Zugangsrechte einzelner Kursbausteine"}}
215 **Zugangsrechte für einzelne Kursbausteine**
216
217
218
219 {{display reference="Zugang Bearbeitungsrechte"/}}
220 {{/expand}}
221
222 === Darstellung von beschränkten Rechten im Kursrun (Schloss-Symbol) ===
223
224 Eingeschränkte Rechte sind in der Kursansicht am** [[image:attach:Icons@Icon_Schloss.png]]Schloss-Symbol** erkennbar. Dieses erscheint hinter dem Titel des Kursbausteins, wenn die Einschränkungen nicht gleichzeitig der Standardeinstellung des Kursbausteins entsprechen.
225
226 Wird der Informationsbereich zum Kursbaustein geöffnet, werden alle Einschränkungen angezeigt, auch solche, die Standardeinstellungen betreffen.
227
228 {{expand title="Beispiele zur Darstellung von beschränkten Rechten ..."}}
229 |(% style="margin-left: 30.0px;" %)(% style="margin-left: 30.0px;" %)
230 (((
231 Lernende können im Kursbaustein Ordner standardmäßig keine Dateien hochladen oder löschen. Das Schloss-Symbol ist bei geschlossenem Informationsbereich nicht zu sehen.
232 )))|(((
233 [[image:attach:Kurseditor - Darstellung Zugang Schloss1_de.png]]
234 )))
235 |(((
236 Öffnet man diesen Informationsbereich, bekommt der Nutzer mit vorgestelltem Schlossymbol den Hinweis, welche Rechte zur Verfügung stehen.
237 )))|(((
238 [[image:attach:Kurseditor - Darstellung Zugang Schloss2_de.png]]
239 )))
240 |(((
241 Wird der Zugang aber über diese Einstellung hinaus konfiguriert, erscheint das Schloss-Symbol auch bei geschlossenenem Informationsbereich direkt hinter dem Titel.
242 )))|(((
243 [[image:attach:Kurseditor - Darstellung Zugang Schloss3_de.png]]
244 )))
245 |(% colspan="1" %)(% colspan="1" %)
246 (((
247 Öffnet man diesen Informationsbereich, erhält der Nutzer Hinweise welche Rechte mit welcher Einschränkung zur Verfügung stehen.
248 )))|(% colspan="1" %)(% colspan="1" %)
249 (((
250 [[image:attach:Kurseditor - Darstellung Zugang Schloss4_de.png]]
251 )))
252 {{/expand}}
253
254 == Freigabe innerhalb von Kursen (**Expertenmodus**) ==
255
256 (% class="wiki-content" %)
257 (((
258 (((
259 Im Kurseditor, in den Reitern „Sichtbarkeit“ und „Zugang“ sind über die Schaltfläche "**Expertenmodus anzeigen**" weitere komplexere Regelkonfigurationen möglich.
260 )))
261
262 (((
263 Dazu ist folgende Syntax einzusetzen:
264 )))
265
266 (((
267
268
269 {{expand title="Expertensyntax anzeigen"}}
270 === Expertensyntax ===
271
272 |=(((
273 Typ
274 )))|=(((
275 Syntax
276 )))|=(((
277 Bedeutung
278 )))
279 |(% rowspan="2" %)(% rowspan="2" %)
280 (((
281 **Konstanten**
282 )))|(((
283 //TRUE// oder //1//
284 )))|(((
285 Wahr
286 )))
287 |(((
288 //FALSE// oder //0//
289 )))|(((
290 Falsch
291 )))
292 |(% colspan="1" %)(% colspan="1" %)
293 (((
294 **Variable**
295 )))|(% colspan="1" %)(% colspan="1" %)
296 (((
297 //now//
298 )))|(% colspan="1" %)(% colspan="1" %)
299 (((
300 Momentane Server-Systemzeit
301 )))
302 |(% rowspan="38" %)(% rowspan="38" %)
303 (((
304 **Funktionen**
305 )))|(% colspan="1" %)(% colspan="1" %)
306 (((
307 //date("//[date]//")//
308 )))|(% colspan="1" %)(% colspan="1" %)
309 (((
310 Datum abfragen
311 )))
312 |(% colspan="1" %)(% colspan="1" %)
313 (((
314 //inLearningGroup("//[string]//")//
315 )))|(% colspan="1" %)(% colspan="1" %)
316 (((
317 Gibt TRUE für alle Mitglieder der Lerngruppe mit dem Titel [string] des aktuellen Kurses zurück.
318 )))
319 |(% colspan="1" %)(% colspan="1" %)
320 (((
321 //inLearningGroup("//[string1]//","//[string2]//")//
322 )))|(% colspan="1" %)(% colspan="1" %)
323 (((
324 Gibt TRUE für alle Mitglieder der angegebenen Lerngruppe [string1] des Kurses mit der angegebenen Kurs-ID=[string2] zurück.
325 )))
326 |(% colspan="1" %)(% colspan="1" %)
327 (((
328 //inLearningGroupWaitingList("//[string]//")//
329 )))|(% colspan="1" %)(% colspan="1" %)
330 (((
331 Gibt TRUE für alle Benutzer in der Warteliste der Lerngruppe [string] des aktuellen Kurses zurück.
332 )))
333 |(% colspan="1" %)(% colspan="1" %)
334 (((
335 //inLearningGroupWaitingList("//[string1]//","//[string2]//")//
336 )))|(% colspan="1" %)(% colspan="1" %)
337 (((
338 Gibt TRUE für alle Benutzer in der Warteliste der Lerngruppe [string1] des Kurses mit der angegebenen Kurs-ID=[string2] zurück.
339 )))
340 |(% colspan="1" %)(% colspan="1" %)
341 (((
342 //inRightGroup("//[string]//")//
343 )))|(% colspan="1" %)(% colspan="1" %)
344 (((
345 Gibt TRUE für alle Mitglieder der Rechtegruppe [string] zurück.
346 )))
347 |(% colspan="1" %)(% colspan="1" %)
348 (((
349 //isLearningGroupFull("//[string]//")//
350 )))|(% colspan="1" %)(% colspan="1" %)
351 (((
352 Gibt für die angegebene Lerngruppe im aktuellen Kurs den Boolean TRUE (=voll) oder FALSE (=nicht voll) zurück.
353 )))
354 |(% colspan="1" %)(% colspan="1" %)
355 (((
356 //isLearningGroupFull("//[string1]//","//[string2]//")//
357 )))|(% colspan="1" %)(% colspan="1" %)
358 (((
359 Gibt für die angegebene Lerngruppe=[string1] des Kurses mit Kurs-ID=[string2] den Boolean TRUE (=voll) oder FALSE (=nicht voll) zurück.
360 )))
361 |(% colspan="1" %)(% colspan="1" %)
362 (((
363 //isUser("//[string]//")//
364 )))|(% colspan="1" %)(% colspan="1" %)
365 (((
366 Gibt TRUE für den Benutzer mit dem Benutzernamen [string] zurück.
367 )))
368 |(% colspan="1" %)(% colspan="1" %)
369 (((
370 //inLearningArea("//[string]//")//
371 )))|(% colspan="1" %)(% colspan="1" %)
372 (((
373 Gibt TRUE für alle Mitglieder der Gruppen im Lernbereich [string] des aktuellen Kurses zurück.
374 )))
375 |(% colspan="1" %)(% colspan="1" %)
376 (((
377 //inLearningArea("//[string1]//","//[string2]//")//
378 )))|(% colspan="1" %)(% colspan="1" %)
379 (((
380 Gibt TRUE für alle Mitglieder der Gruppen im angegebenen Lernbereich [string1] des Kurses mit der angegebenen Kurs-ID=[string2] zurück.
381 )))
382 |(% colspan="1" %)(% colspan="1" %)
383 (((
384 //getNumberOfEnrollments("//[string1]*//")//
385 )))|(% colspan="1" %)(% colspan="1" %)
386 (((
387 Gibt TRUE, wenn die konfigurierte Anzahl der Lerngruppenmitgliedschaften im Lernbereich (string1) erreicht ist.
388 )))
389 |(% colspan="1" %)(% colspan="1" %)
390 (((
391 //isGlobalAuthor(0)//
392 )))|(% colspan="1" %)(% colspan="1" %)
393 (((
394 Gibt TRUE für alle Mitglieder der OPAL-Autorengruppe zurück.
395 )))
396 |(% colspan="1" %)(% colspan="1" %)
397 (((
398 //isCourseAdministrator(0)//
399 )))|(% colspan="1" %)(% colspan="1" %)
400 (((
401 Gibt TRUE für alle Besitzer Ihres Kurses (Lernressource) zurück.
402 )))
403 |(% colspan="1" %)(% colspan="1" %)
404 (((
405 //isCourseCoach(0)//
406 )))|(% colspan="1" %)(% colspan="1" %)
407 (((
408 Gibt TRUE für alle Benutzer, die eine Lerngruppe betreuen  zurück.
409 )))
410 |(% colspan="1" %)(% colspan="1" %)
411 (((
412 //isGuest(0)//
413 )))|(% colspan="1" %)(% colspan="1" %)
414 (((
415 Gibt TRUE für alle Benutzer, die OPAL als Gäste besuchen zurück.
416 )))
417 |(% colspan="1" %)(% colspan="1" %)
418 (((
419 //isExternalUser(0)//
420 )))|(% colspan="1" %)(% colspan="1" %)
421 (((
422 Gibt TRUE für alle, die OPAL als externe Benutzer verwenden zurück.
423 )))
424 |(% colspan="1" %)(% colspan="1" %)
425 (((
426 //hasAttribute("//[AttrName]//","//[string]//")//
427 )))|(% colspan="1" %)(% colspan="1" %)
428 (((
429 Gibt TRUE, wenn [string] dem Wert des AAI-Attributes [AttrName] des jeweiligen Benutzers entspricht.
430 )))
431 |(% colspan="1" %)(% colspan="1" %)
432 (((
433 //isInAttribute("//[AttrName]//","//[substring]//")//
434 )))|(% colspan="1" %)(% colspan="1" %)
435 (((
436 Gibt TRUE, wenn [substring] einem Teil des Wertes des AAI-Attributs [AttrName] des jeweiligen Benutzers entspricht.
437 )))
438 |(% colspan="1" %)(% colspan="1" %)
439 (((
440 //isInAttribute("//[AttrName]//","//[substring]//")//
441 )))|(% colspan="1" %)(% colspan="1" %)
442 (((
443 Gibt TRUE, wenn [substring] einem Teil des Wertes des AAI-Attributs [AttrName] des jeweiligen Benutzers entspricht.
444 )))
445 |(% colspan="1" %)(% colspan="1" %)
446 (((
447 //getUserProperty("//[string]//")//
448 )))|(% colspan="1" %)(% colspan="1" %)
449 (((
450 Liefert die angegebene Benutzer-Eigenschaft des ausführenden Nutzers zurück.
451 )))
452 |(% colspan="1" %)(% colspan="1" %)
453 (((
454 //getPassed("//[integer]//")//
455 )))|(% colspan="1" %)(% colspan="1" %)
456 (((
457 Gibt vom Kursbaustein mit spezifizierter ID den Boolean TRUE (=Bestanden) oder FALSE (=Nicht bestanden) zurück.
458 )))
459 |(% colspan="1" %)(% colspan="1" %)
460 (((
461 //getScore("//[integer]//")//
462 )))|(% colspan="1" %)(% colspan="1" %)
463 (((
464 Gibt vom Kursbaustein mit spezifizierter ID die Anzahl Punkte zurück.
465 )))
466 |(% colspan="1" %)(% colspan="1" %)
467 (((
468 //getAttempts("//[integer]//")//
469 )))|(% colspan="1" %)(% colspan="1" %)
470 (((
471 Gibt vom Kursbaustein mit spezifizierter ID die Anzahl abgeschlossener Versuche zurück. Kann auf Kursbausteine vom Typ //Test//, //Selbsttest//, //Fragebogen// (mögliche Rückgabewerte 0 oder 1) und //Aufgabe// (Rückgabewert = Anzahl abgegebener Dateien) angewendet werden.
472 )))
473 |(% colspan="1" %)(% colspan="1" %)
474 (((
475 //getInitialEnrollmentDate("//[integer]//")//
476 )))|(% colspan="1" %)(% colspan="1" %)
477 (((
478 Gibt vom Kursbaustein //Einschreibung// mit spezifizierter ID das Datum des erstmaligen Einschreibens des betreffenden Kursteilnehmers zurück.
479 )))
480 |(% colspan="1" %)(% colspan="1" %)
481 (((
482 //getRecentEnrollmentDate("//[integer]//")//
483 )))|(% colspan="1" %)(% colspan="1" %)
484 (((
485 Gibt vom Kursbaustein //Einschreibung// mit spezifizierter ID das Datum des letzten Einschreibens des betreffenden Kursteilnehmers zurück.
486 )))
487 |(% colspan="1" %)(% colspan="1" %)
488 (((
489 //getInitialCourseLaunchDate(0)//
490 )))|(% colspan="1" %)(% colspan="1" %)
491 (((
492 Gibt das Datum des erstmaligen Kursbesuchs des betreffenden Kursteilnehmers zurück.
493 )))
494 |(% colspan="1" %)(% colspan="1" %)
495 (((
496 //getRecentCourseLaunchDate(0)//
497 )))|(% colspan="1" %)(% colspan="1" %)
498 (((
499 Gibt das Datum des letzten Kursbesuchs des betreffenden Kursteilnehmers zurück.
500 )))
501 |(% colspan="1" %)(% colspan="1" %)
502 (((
503 //getPassedWithCourseId("//[integer-1]//","//[integer-2]//")//
504 )))|(% colspan="1" %)(% colspan="1" %)
505 (((
506 Gibt vom Kursbaustein mit ID=[integer-2] des Kurses mit ID=[integer-1] den Boolean TRUE (=Bestanden) oder FALSE (=Nicht bestanden) zurück.
507 )))
508 |(% colspan="1" %)(% colspan="1" %)
509 (((
510 //getScoreWithCourseId("//[integer-1]//","//[integer-2]//")//
511 )))|(% colspan="1" %)(% colspan="1" %)
512 (((
513 Gibt vom Kursbaustein mit ID=[integer-2] des Kurses mit ID=[integer-1] die Anzahl Punkte zurück.
514 )))
515 |(% colspan="1" %)(% colspan="1" %)
516 (((
517 //getMarkWithCourseId("//[integer-1]//","//[integer-2]//")//
518 )))|(% colspan="1" %)(% colspan="1" %)
519 (((
520 Gibt vom Kursbaustein mit ID=[integer-2] des Kurses mit ID=[integer-1] die Note zurück.
521 )))
522 |(% colspan="1" %)(% colspan="1" %)
523 (((
524 //hasEvaluationCompleted("//KB-ID//")//
525 )))|(% colspan="1" %)(% colspan="1" %)
526 (((
527 Gibt TRUE für alle Benutzer die den angegebenen Kursbaustein erfolgreich beendeten.
528 )))
529 |(% colspan="1" %)(% colspan="1" %)
530 (((
531 //getNumberOfEnrollments("//[string1]*//")//
532 )))|(% colspan="1" %)(% colspan="1" %)
533 (((
534 Gibt TRUE, wenn die konfigurierte Anzahl der Lerngruppenmitgliedschaften im Lernbereich (string1) erreicht ist.
535 )))
536 |(% colspan="1" %)(% colspan="1" %)
537 (((
538 //getOnyxTestOutcome("//[string1]//","//[string2]//")//
539 )))|(% colspan="1" %)(% colspan="1" %)
540 (((
541 Gibt vom Onyx-Test-Kursbaustein mit spezifizierter ID (string1) und spezifizierter Ausgabevariable (string2) den Wert dieser Variablen zurück. Der Rückgabewert ist eine Zahl.
542 )))
543 |(% colspan="1" %)(% colspan="1" %)
544 (((
545 //getOnyxTestOutcomeZK("//[string1]//","//[string2]//")//
546 )))|(% colspan="1" %)(% colspan="1" %)
547 (((
548 Gibt vom Onyx-Test-Kursbaustein mit spezifizierter ID (string1) und spezifizierter Ausgabevariable (string2) den Wert dieser Variablen zurück. Der Rückgabewert ist eine Zeichenkette.
549 )))
550 |(% colspan="1" %)(% colspan="1" %)
551 (((
552 //getProgress(//"[integer]"//)//
553 )))|(% colspan="1" %)(% colspan="1" %)
554 (((
555 Gibt vom Kursbaustein mit spezifizierter ID den Fortschritt als numerischen Wert zwischen 0 und 100 (Prozent) zurück.
556 )))
557 |(% colspan="1" %)(% colspan="1" %)
558 (((
559 //isPasswordConfirmed("//[string]")
560 )))|(% colspan="1" %)(% colspan="1" %)
561 (((
562 Gibt TRUE nach Eingabe des korrekten Passwortes (string1) zurück.
563
564 Kann nur bei Kursbausteinen verwendet werden, die auch im einfachen Modus eine Passwortbeschränkung anbieten.
565 )))
566 |(% colspan="1" %)(% colspan="1" %)
567 (((
568 //comesFrom("//[string]//")//
569 )))|(% colspan="1" %)(% colspan="1" %)
570 (((
571 Gibt TRUE zurück wenn der Nutzer ein verlinktes Konto zum OLAT mit der angegebenen System-ID hat.
572 )))
573 |(% rowspan="4" %)(% rowspan="4" %)
574 (((
575 **Einheiten**
576 )))|(% colspan="1" %)(% colspan="1" %)
577 (((
578 //min//
579 )))|(% colspan="1" %)(% colspan="1" %)
580 (((
581 Minuten
582 )))
583 |(% colspan="1" %)(% colspan="1" %)
584 (((
585 //h//
586 )))|(% colspan="1" %)(% colspan="1" %)
587 (((
588 //h//
589 )))
590 |(% colspan="1" %)(% colspan="1" %)
591 (((
592 //w//
593 )))|(% colspan="1" %)(% colspan="1" %)
594 (((
595 Wochen
596 )))
597 |(% colspan="1" %)(% colspan="1" %)
598 (((
599 //m//
600 )))|(% colspan="1" %)(% colspan="1" %)
601 (((
602 Monate
603 )))
604 |(% rowspan="9" %)(% rowspan="9" %)
605 (((
606 **Operatoren**
607 )))|(% colspan="1" %)(% colspan="1" %)
608 (((
609 ~=
610 )))|(% colspan="1" %)(% colspan="1" %)
611 (((
612 gleich
613 )))
614 |(% colspan="1" %)(% colspan="1" %)
615 (((
616 ~>
617 )))|(% colspan="1" %)(% colspan="1" %)
618 (((
619 grösser als
620 )))
621 |(% colspan="1" %)(% colspan="1" %)
622 (((
623 <
624 )))|(% colspan="1" %)(% colspan="1" %)
625 (((
626 kleiner als
627 )))
628 |(% colspan="1" %)(% colspan="1" %)
629 (((
630 ~>=
631 )))|(% colspan="1" %)(% colspan="1" %)
632 (((
633 grösser gleich
634 )))
635 |(% colspan="1" %)(% colspan="1" %)
636 (((
637 <=
638 )))|(% colspan="1" %)(% colspan="1" %)
639 (((
640 kleiner gleich
641 )))
642 |(% colspan="1" %)(% colspan="1" %)
643 (((
644 *
645 )))|(% colspan="1" %)(% colspan="1" %)
646 (((
647 Multiplikation
648 )))
649 |(% colspan="1" %)(% colspan="1" %)
650 (((
651 /
652 )))|(% colspan="1" %)(% colspan="1" %)
653 (((
654 Division
655 )))
656 |(% colspan="1" %)(% colspan="1" %)
657 (((
658 +
659 )))|(% colspan="1" %)(% colspan="1" %)
660 (((
661 Addition
662 )))
663 |(% colspan="1" %)(% colspan="1" %)
664 (((
665 -
666 )))|(% colspan="1" %)(% colspan="1" %)
667 (((
668 Subtraktion
669 )))
670 |(% colspan="1" %)(% colspan="1" %)
671 (((
672 **Booleans**
673 )))|(% colspan="1" %)(% colspan="1" %)
674 (((
675 &
676 )))|(% colspan="1" %)(% colspan="1" %)
677 (((
678 Logisches UND
679 )))
680 |(% colspan="1" %)(% colspan="1" %)
681 (((
682
683 )))|(% colspan="1" %)(% colspan="1" %)
684 (((
685 ~|
686 )))|(% colspan="1" %)(% colspan="1" %)
687 (((
688 Logisches ODER
689 )))
690 |(% colspan="1" %)(% colspan="1" %)
691 (((
692
693 )))|(% colspan="1" %)(% colspan="1" %)
694 (((
695 !
696 )))|(% colspan="1" %)(% colspan="1" %)
697 (((
698 Logisches NICHT
699 )))
700 {{/expand}}
701
702 {{expand title="Anwendungsbeispiele zum Expertensyntax"}}
703 === Verwendungsbeispiele ===
704
705 Nachfolgend sind Beispiele aufgeführt, die Ihnen zeigen, wie Sie den Expertensyntax verwenden können.
706
707 {{info}}
708 Neben den allgemeinen Beispielen, die unabhängig von der Institution verwendet werden können, sind auch Einschränkungen zu Daten möglich, welche institutionsspezifisch sind und je nach Institution übermittelt werden ((% class="confluence-link" %)DFN-AAI Attribute(%%)).
709 Für OPAL Nutzer enthält die Seite [[Übersicht der OPAL-Shibboleth-Attribute>>url:https://bildungsportal.sachsen.de/help/attribute-opal_de.html||shape="rect"]] alle aktuell verwendbaren institutionsspezifischen Attribute sächsischer Institutionen.
710 {{/info}}
711
712 |=(((
713 Beispiele für Regeln in den Tabs //«Sichtbarkeit»//, //«Zugang»// und //«Punkte»// (Struktur-Baustein)
714 )))|=(((
715 Auswirkungen
716 )))
717 |(((
718 isGuest(0) oder isGuest(0)=1 oder isGuest(0)=TRUE
719 )))|(((
720 Ausschließlich Gäste haben Zugang auf den Kursbaustein.
721 )))
722 |(((
723 inLearningGroup("Anfänger") = 0
724 )))|(((
725 Mit Ausnahme der Gruppe //«Anfänger»// ist der Kursbaustein für alle Kursteilnehmer sichtbar.
726 )))
727 |(((
728 (now >= date("22.03.2017 12:00")) & (now <= date("23.08.2017 18:00")) | inLearningGroup("Betreuer")
729 )))|(((
730 Der Kursbaustein ist zwischen dem 22.03.2017 und 23.08.2017 für alle Kursteilnehmer sichtbar, während er für Mitglieder der Lerngruppe //«Betreuer»// jederzeit sichtbar ist.
731 )))
732 |(((
733 (now >= date("03.09.2017 00:00")) & (now <= date("13.10.2017 00:00")) & inRightGroup("Assessoren")| isUser("autor")
734 )))|(((
735 Der Kursbaustein ist zwischen dem 03.09.2017 und 13.10.2017 für alle Kursteilnehmer der Rechtegruppe //«Assessoren»// sichtbar, während er für die Person mit dem Benutzernamen //«autor»// jederzeit sichtbar ist.
736 )))
737 |(((
738 isInAttribute("surname","Mue")
739 )))|(((
740 Gibt TRUE für alle Personen, deren Attribut //surname// die Buchstabenfolge "Mue" enthält. Gibt z.B. TRUE für den Wert "Mueller" oder "Muehlebacher" zurück.
741 )))
742 |(% colspan="1" %)(% colspan="1" %)
743 (((
744 (getUserProperty("orgUnit") = "Marketing")
745 )))|(% colspan="1" %)(% colspan="1" %)
746 (((
747 Prüft ob eine Person in der Organisationseinheit "Marketing" ist. Dies ist sinnvoll z.B. wenn die Daten automatisiert aus LDAP übernommen werden.
748 )))
749 |(% colspan="1" %)(% colspan="1" %)
750 (((
751 (getPassed("69742969114730") | getPassed("69742969115733") | getPassed("69742969118009")) * 10
752 )))|(% colspan="1" %)(% colspan="1" %)
753 (((
754 Diese Regel wird im Tab //«Punkte»// -> //«Punkte verarbeiten»// des Bausteins //Struktur// gesetzt. Der Baustein //Struktur// zeigt 10 Punkte, wenn einer der Tests (Kursbaustein-IDs "69742969114730", "69742969115733" oder "69742969118009") bestanden wurde, sonst 0 Punkte.
755 )))
756 |(% colspan="1" %)(% colspan="1" %)
757 (((
758 (getScore("69742969114730") + getScore("69742969115733") + getScore("69742969118009")) >= 140 | getPassed("69978845384688")
759 )))|(% colspan="1" %)(% colspan="1" %)
760 (((
761 Diese Regel wird im Tab //«Punkte»// -> //«Bestanden wenn»// des Bausteins //Struktur// gesetzt. Der Baustein //Struktur// zeigt ein //«Bestanden»//, wenn in allen Tests zusammen minimal 140 Punkte erzielt werden oder wenn manuell ein //«Bestanden»// gesetzt wird (Kursbaustein //Bewertung// mit ID "69978845384688").
762 )))
763 |(% colspan="1" %)(% colspan="1" %)
764 (((
765 getAttempts("70323786958847") > 0
766 )))|(% colspan="1" %)(% colspan="1" %)
767 (((
768 Gibt TRUE zurück, sobald der betreffende Kursteilnehmer den Test mit spezifizierter ID ein erstes Mal abgeschlossen hat.
769 )))
770 |(% colspan="1" %)(% colspan="1" %)
771 (((
772 getAttempts("70323524635734") <= 3
773 )))|(% colspan="1" %)(% colspan="1" %)
774 (((
775 Gibt FALSE zurück, sobald der betreffende Kursteilnehmer mehr als 3 Dateien in den Abgabeordner des Kursbaustein //Aufgabe// gelegt hat.
776 )))
777 |(% colspan="1" %)(% colspan="1" %)
778 (((
779 getInitialEnrollmentDate("70323786958847") <= date("26.5.2017 18:00")
780 )))|(% colspan="1" %)(% colspan="1" %)
781 (((
782 Gibt TRUE für diejenigen Kursteilnehmer zurück, die sich vor 18 Uhr des 26. Mai 2017 über den Kursbaustein //Einschreibung// mit spezifizierter ID in eine zur Auswahl stehende Gruppe eingeschrieben haben.
783 )))
784 |(% colspan="1" %)(% colspan="1" %)
785 (((
786 getInitialEnrollmentDate("70323786958847") + 2h > now
787 )))|(% colspan="1" %)(% colspan="1" %)
788 (((
789 Gibt TRUE während zwei Stunden ab Einschreibezeitpunkt für diejenigen Kursteilnehmer, die sich über den Kursbaustein //Einschreibung// mit spezifizierter ID in eine zur Auswahl stehende Gruppe eingeschrieben haben. So kann abgebildet werden, dass jeder Kursteilnehmer nur während einer bestimmten Zeitdauer z.B. ein Skript bearbeiten kann.
790 )))
791 |(% colspan="1" %)(% colspan="1" %)
792 (((
793 (getInitialCourseLaunchDate(0) >= never) | (getInitialCourseLaunchDate(0) + 2h > now)
794 )))|(% colspan="1" %)(% colspan="1" %)
795 (((
796 Gibt TRUE zurück, wenn der Kursteilnehmer den Kurs noch nicht besucht hat oder während der ersten zwei Stunden des ersten Kursbesuchs. So kann abgebildet werden, dass jeder Kursteilnehmer nur während einer bestimmten Zeitdauer den Kurs sehen kann.
797 )))
798 |(% colspan="1" %)(% colspan="1" %)
799 (((
800 (getRecentCourseLaunchDate(0) + 10min) > now
801 )))|(% colspan="1" %)(% colspan="1" %)
802 (((
803 Gibt TRUE zurück, wenn sich der Benutzer seit mehr als 10 Minuten im Kurs bewegt.
804 )))
805 |(% colspan="1" %)(% colspan="1" %)
806 (((
807 getOnyxTestOutcome("84692289655276","SCORE") >= 10
808 )))|(% colspan="1" %)(% colspan="1" %)
809 (((
810 Gibt TRUE zurück, wenn der Benutzer mindestens 10 Punkte erreicht hat.
811 )))
812 |(% colspan="1" %)(% colspan="1" %)
813 (((
814 getOnyxTestOutcomeZK("84389429397045","PASS") ="true"
815 )))|(% colspan="1" %)(% colspan="1" %)
816 (((
817 Gibt TRUE zurück, wenn der Benutzer den Test bestanden hat.
818 )))
819 |(% colspan="1" %)(% colspan="1" %)
820 (((
821 getMark("84692289655276") > 4
822 )))|(% colspan="1" %)(% colspan="1" %)
823 (((
824 Gibt TRUE zurück, wenn die Note des Nutzers für den angegebenen Baustein besser als 4 ist.
825 )))
826
827 {{note title="Achtung!"}}
828 Bitte beachten Sie, dass die oben erwähnten Kursbaustein-IDs Beispiele sind. Wenn Sie Ihren Kurs erstellen, müssen Sie jeweils die IDs Ihrer Kurse referenzieren.
829 {{/note}}
830 {{/expand}}
831 )))
832 )))
833 {{/layout-cell}}
834 {{/layout-section}}
835 {{/layout}}
836 {{/sv-translation}}
837
838 {{sv-translation language="en"}}
839 {{layout}}
840 {{layout-section ac:type="two_right_sidebar"}}
841 {{layout-cell}}
842 Supervisors or authors of a course or any other [[learning resource>>url:https://www.bps-system.de/help/display/LMSintern/.Lernressourcen+v3.3||shape="rect"]] can perform various **publish settings **for their participants. Whether the resource is also **visible** to other users in the learning platform,** **or whether only certain **course** **content is visible **also depends on these settings, just as whether **access to visible content **is permitted.
843
844 Publishing a course or a learning resource can be regulated via the **publication status**.
845
846 For publishing content within a course, individual rules regarding** visibility and access **can be defined and freely combined with each other. Advanced users can also use the expert mode for the representation of more complex scenarios.
847
848
849 {{/layout-cell}}
850
851 {{layout-cell}}
852 {{scroll-ignore}}
853 {{panel title="Content"}}
854
855
856 {{toc/}}
857 {{/panel}}
858 {{/scroll-ignore}}
859 {{/layout-cell}}
860 {{/layout-section}}
861
862 {{layout-section ac:type="single"}}
863 {{layout-cell}}
864 == General access to courses and resources (**publication status**)  ==
865
866 {{id name="Access"/}}
867
868 The general access to courses and learning resources is controlled via the **publication status**. Depending on this status, the content in the system will be **visible** to certain user groups.
869
870 The general access can be adjusted for the following user groups by assigning the corresponding status:
871
872 |=(((
873 Publication status
874 )))|=(((
875 Short description
876 )))|=(((
877 User group
878 )))
879 |(((
880 (% class="TableParagraph" %)
881 **Only supervisors of this learning resource**
882 )))|(((
883 (% class="TableParagraph" %)
884 **B**
885 )))|(((
886 (% class="TableParagraph" %)
887 Owners and co-owners of the learning resource
888 )))
889 |(((
890 (% class="TableParagraph" %)
891 **Supervisors and authors**
892 )))|(((
893 (% class="TableParagraph" %)
894 **BA**
895 )))|(((
896 (% class="TableParagraph" %)
897 Owners and all persons who have author rights in the system
898 )))
899 |(((
900 (% class="TableParagraph" %)
901 **All registered users**
902 )))|(((
903 (% class="TableParagraph" %)
904 **BAR**
905 )))|(((
906 (% class="TableParagraph" %)
907 Anyone who can log on to the system
908 )))
909 |(((
910 (% class="TableParagraph" %)
911 **Registered users and guests**
912 )))|(((
913 (% class="TableParagraph" %)
914 **BARG**
915 )))|(((
916 (% class="TableParagraph" %)
917 World-wide publication, also for anonymous guests
918 )))
919 |(((
920 (% class="TableParagraph" %)
921 **Registered and external users, guests**
922 )))|(((
923 (% class="TableParagraph" %)
924 **BARG | E**
925 )))|(((
926 (% class="TableParagraph" %)
927 World-wide publication, [[external>>url:https://www.bps-system.de/help/display/LMSintern/.Rollen+und+Rechte+v3.2||shape="rect"]] [[users>>url:https://www.bps-system.de/help/display/LMSintern/.Rollen+und+Rechte+v3.2||shape="rect"]] can also work in the course
928 )))
929
930 {{info title="Initial access"}}
931 When a learning resource is created, the access is initially restricted to the supervisor of the learning resource (**B**).
932 {{/info}}
933
934 === (% style="color: rgb(62,68,68);" %)Change publication status(%%) ===
935
936 You can change the publication status as follows:
937
938 {{expand title="Change via detailed view"}}
939 **Change publication status via the detailed view** // //
940
941 The general access can be changed for all courses and resources via the detailed view.
942
943 Proceed as follows:
944
945 |(((
946 1. Open a course and select the entry **//Details and settings //**from the menu.
947 )))|(((
948 [[image:attach:Kursrun-Details und Einstellungen öffnen_en.png]]
949 )))
950 |(((
951 2. Select **//Change properties //**from the menu on the right.
952 )))|(((
953 [[image:attach:Detailseite-Einstellungen ändern öffnen_en.png]]
954 )))
955 |(((
956 3. Adjust the **//Access//** in the tab **//Access//**.
957
958 4. Save your changes.
959 )))|(((
960 [[image:attach:Detailseite-Publikationsstatus_en.png]]
961 )))
962 {{/expand}}
963
964 {{expand title="Change via course editor"}}
965 **Change publication status via the course editor **
966
967 |(((
968 The access to **courses **can be directly changed when **publishing a course**.
969
970 In the second step, you can also make changes and, if necessary, specify a specific point in time for the implementation of these changes in the third step.
971 )))|(((
972 [[image:attach:Kurseditor-Kurs publizieren_en.png]]
973 )))
974
975 {{info}}
976 For a resource of the type course, you have the possibility to enable access also for so-called "external users" via the options //**All registered users **//and **//Registered users and guests//.** Just activate the checkbox (% style="color: black;" %)**//External users may contribute to course//**. (%%)For further information regarding external users, please refer to the help section [[Roles>>url:https://www.bps-system.de/help/display/LMSintern/.Rollen+und+Rechte+v3.2||shape="rect"]] [[and rights>>url:https://www.bps-system.de/help/display/LMSintern/.Rollen+und+Rechte+v3.2||shape="rect"]].
977 {{/info}}
978 {{/expand}}
979
980 == Publishing within courses (**visibility and access**) ==
981
982 For sharing content within a course, individual rules can be set to control **visibility **and **access**. Advanced users can use the expert mode for the representation of complex scenarios and the configuration of these rules.
983
984 Settings in these two areas have the following basic effects:
985
986 |(((
987 **Visibility**
988 )))|(% rowspan="2" %)(% rowspan="2" %)
989 (((
990 If the **visibility **of content is** limited**, for example because the content is only visible for a specified group, it will not be displayed to the user **in the course menu**. If, however, the user is a member of the group and thus fulfils the condition for visibility, they will see the course element in the course navigation.
991
992 The navigation menu of a course is therefore flexible and can vary according to the time and type of use of the course (obtained assessments, work in groups).
993 )))|(((
994 [[image:attach:Kurseditor-Sichtbarkeit gruppenabhänig Bsp1_en.png]]
995 )))
996 |(((
997
998 )))|(((
999 [[image:attach:Kurseditor-Sichtbarkeit gruppenabhänig Bsp2_en.png]][[image:attach:Kurseditor-Sichtbarkeit gruppenabhänig Bsp3_en.png]]
1000 )))
1001 |(((
1002 **Access**
1003 )))|(((
1004 If the **access** to a content **is** **limited**, it is still **visible in the course navigation **(provided that no visibility rule prevents it), but the actual **content is not displayed to the user**. Instead, they will receive a notification with the relevant access information. In the example, the final test is only published for members of the group "course participants" who have passed the preliminary test.
1005 )))|(((
1006 [[image:attach:Kursrun-Zugang beschränkt Bsp_en.png]]
1007 )))
1008
1009 {{expand title="Detailed representation of the interaction of both setting options ..."}}
1010 === (% style="color: rgb(51,51,51);" %)Date-dependent configuration(%%) ===
1011
1012 The following figure shows how the date-dependent configurations of visibility and access interact. In the upper part of the figure, no settings have been adjusted. Visibility and access are thus not restricted. In the lower part of the figure, different times have been selected for visibility and access. For the period in which the course element is visible in the menu, while its content is not accessible, a notification can be displayed to the user instead of the course element content.
1013
1014 [[image:attach:Grafik -SichtbarkeitundZugang_en.png]]
1015
1016 === (% style="color: rgb(51,51,51);" %)Group-dependent configuration(%%) ===
1017
1018 The figure shows the group-dependent configuration of visibility or access. In the upper part of the figure, no input has been made. Thus, all course participants can see the course element link and have access to the content - regardless of whether or not they are in a learning group. In the lower part of the figure, this only applies to the groups "red" and "green".
1019
1020 [[image:attach:Grafik-GruppenabhängigeKonfiguration _en.png]]
1021
1022
1023
1024 {{info title="Default setting"}}
1025 (% class="WordSection1" %)
1026 (((
1027 If no additional settings are made, the content of a course element will by default be visible to all users of the user group with the defined publication status after the publication of the course. If a course is for example published with the status BAR (all registered users), all content of the course will be visible to all users who can log on to this system.
1028 )))
1029 {{/info}}
1030
1031 {{tip}}
1032 Through the setting **limitation of access**, it is possible to provide the learners with an overview of the whole course content and the conditions (e.g. from a given date onwards, after enrolling in a group, or after passing a test) under which the content can be accessed.
1033
1034 A **limitation of the visibility **of content is for example useful if you aim to offer different course content to different groups of users.
1035 {{/tip}}
1036
1037 {{info title="Note"}}
1038 Please note that it is not useful to limit the visibility more than the access because the content of an invisible course element is not accessible anyway.
1039 {{/info}}
1040 {{/expand}}
1041 {{/layout-cell}}
1042 {{/layout-section}}
1043
1044 {{layout-section ac:type="single"}}
1045 {{layout-cell}}
1046 === (% style="color: rgb(62,68,68);" %)Create or change rules for visibility and access(%%) ===
1047
1048 |(((
1049 The settings for both areas can be made in the **course editor**.
1050
1051 Next to the tab "Title and description", the tabs "**Visibility**" and "**Access**" are available in the settings for each course as well as course element.
1052 )))|(((
1053 [[image:attach:Kurseditor-Tab Sichtbarkeit und Zugang_en.png]]
1054 )))
1055
1056
1057
1058 The following **attributes **are available in the system to set visibility and access rules in the course editor:
1059
1060 {{expand title="General attributes"}}
1061
1062
1063 {{display reference="Sichtbarkeit und Zugriff"/}}
1064 {{/expand}}
1065
1066 {{expand title="Special attributes for access rights of individual course elements"}}
1067 **Access rights for individual course elements**
1068
1069 For individual course element types, there are further attributes which can be used to regulate the **access **to **editing rights **for course participants.
1070
1071 |(((
1072 Task
1073 )))|(((
1074 * Assignment
1075 * Edit task folder
1076 * Drop box - delete own solutions
1077 * Drop box
1078 * Return box
1079 * Assessment
1080 * Sample solution
1081 )))
1082 |(((
1083 Blog
1084 )))|(((
1085 * Read
1086 * Read and write
1087 * Moderate
1088 )))
1089 |(((
1090 File Dialogue
1091 )))|(((
1092 * Only file download / read in the forum
1093 * File upload and download / read and write in the forum
1094 * File upload and download / moderate in the forum
1095 )))
1096 |(((
1097 Forum
1098 )))|(((
1099 * Read
1100 * Read and write
1101 * Moderate
1102 )))
1103 |(((
1104 Calendar
1105 )))|(((
1106 * Read
1107 * Add and edit dates
1108 )))
1109 |(% colspan="1" %)(% colspan="1" %)
1110 (((
1111 Link List
1112 )))|(% colspan="1" %)(% colspan="1" %)
1113 (((
1114 * Display
1115 * Display and add
1116 * Display, edit, and delete
1117 )))
1118 |(% colspan="1" %)(% colspan="1" %)
1119 (((
1120 Bibliography
1121 )))|(% colspan="1" %)(% colspan="1" %)
1122 (((
1123 * Display
1124 * Display and edit
1125 )))
1126 |(% colspan="1" %)(% colspan="1" %)
1127 (((
1128 Messages
1129 )))|(% colspan="1" %)(% colspan="1" %)
1130 (((
1131 * Read
1132 * Write
1133 * Manage
1134 )))
1135 |(% colspan="1" %)(% colspan="1" %)
1136 (((
1137 Folder
1138 )))|(% colspan="1" %)(% colspan="1" %)
1139 (((
1140 * Download
1141 * Upload
1142 * Delete
1143 )))
1144 |(% colspan="1" %)(% colspan="1" %)
1145 (((
1146 Podcast
1147 )))|(% colspan="1" %)(% colspan="1" %)
1148 (((
1149 * Read
1150 * Read and write
1151 * Moderate
1152 )))
1153 |(% colspan="1" %)(% colspan="1" %)
1154 (((
1155 Page
1156 )))|(% colspan="1" %)(% colspan="1" %)
1157 (((
1158 * Display
1159 * Display and edit
1160 )))
1161 |(% colspan="1" %)(% colspan="1" %)
1162 (((
1163 Profile
1164 )))|(% colspan="1" %)(% colspan="1" %)
1165 (((
1166 * Display
1167 * Add
1168 )))
1169 |(% colspan="1" %)(% colspan="1" %)
1170 (((
1171 Test
1172 )))|(% colspan="1" %)(% colspan="1" %)
1173 (((
1174 (% class="TableParagraph" %)
1175 Configurable in the tab visibility:
1176
1177 * Carry out test
1178 * View assessment
1179 * View results
1180 )))
1181 |(% colspan="1" %)(% colspan="1" %)
1182 (((
1183 Wiki
1184 )))|(% colspan="1" %)(% colspan="1" %)
1185 (((
1186 * Read
1187 * Add and edit articles
1188 )))
1189 {{/expand}}
1190
1191 === (% style="color: rgb(62,68,68);" %)Representation of limited rights in the course view (lock icon)(%%) ===
1192
1193 Limited rights can be identified by the **lock icon**. The icon appears behind the title of the course element if the limitations do not correspond to the default setting of the course element.
1194
1195 If the information area to the course element is opened, all limitations will be displayed, including those that affect the default settings.
1196
1197 Example:
1198
1199 |(((
1200 In the course element folder, learners cannot upload or delete files by default. The lock icon is not visible when the information area is closed.
1201 )))|(((
1202 [[image:attach:Kurseditor-Darstellung Zugang Schloss1_en.png]]
1203 )))
1204 |(((
1205 If the information area is opened, the user will be able to see the lock icon and receive a note about the available rights.
1206 )))|(((
1207 [[image:attach:Kurseditor-Darstellung Zugang Schloss2_en.png]]
1208 )))
1209 |(((
1210 If, however, the access is configured beyond this setting, the lock symbol will also appear behind the title when the information area is closed.
1211 )))|(((
1212 [[image:attach:Kurseditor-Darstellung Zugang Schloss3_en.png]]
1213 )))
1214 |(((
1215 If the information area is opened, the user will be informed about which rights are available with which limitations.
1216 )))|(((
1217 [[image:attach:Kurseditor-Darstellung Zugang Schloss4_en.png]]
1218 )))
1219
1220 == Publishing within courses (**expert mode**) ==
1221
1222 Further more complex rule configurations are possible via the button "**Display expert mode**" in the tabs "Visibility" and "Access" in the course editor.
1223
1224 Use the following syntax:
1225
1226 {{expand title="Display expert syntax"}}
1227 === Expert syntax ===
1228
1229 |=(((
1230 Type
1231 )))|=(((
1232 Syntax
1233 )))|=(((
1234 Description
1235 )))
1236 |(((
1237 (% class="TableParagraph" %)
1238 **Constants**
1239 )))|(((
1240 (% class="TableParagraph" %)
1241 //TRUE //or //1//
1242 )))|(((
1243 (% class="TableParagraph" %)
1244 True
1245 )))
1246 |(((
1247
1248 )))|(((
1249 (% class="TableParagraph" %)
1250 //FALSE //or //0//
1251 )))|(((
1252 (% class="TableParagraph" %)
1253 False
1254 )))
1255 |(((
1256 (% class="TableParagraph" %)
1257 **Variable**
1258 )))|(((
1259 (% class="TableParagraph" %)
1260 //now//
1261 )))|(((
1262 (% class="TableParagraph" %)
1263 Current server system time
1264 )))
1265 |(((
1266 (% class="TableParagraph" %)
1267 **Functions**
1268 )))|(((
1269 (% class="TableParagraph" %)
1270 //date("[date]")//
1271 )))|(((
1272 (% class="TableParagraph" %)
1273 Query date
1274 )))
1275 |(% colspan="1" %)(% colspan="1" %)
1276 (((
1277
1278 )))|(% colspan="1" %)(% colspan="1" %)
1279 (((
1280 (% class="TableParagraph" %)
1281 //inLearningGroup("//[string]//")//
1282 )))|(% colspan="1" %)(% colspan="1" %)
1283 (((
1284 (% class="TableParagraph" %)
1285 Returns TRUE for all members of the learning group with the title [string] of the current course.
1286 )))
1287 |(% colspan="1" %)(% colspan="1" %)
1288 (((
1289
1290 )))|(% colspan="1" %)(% colspan="1" %)
1291 (((
1292 (% class="TableParagraph" %)
1293 //inLearningGroup("//[string1]//","//[string2]//")//
1294 )))|(% colspan="1" %)(% colspan="1" %)
1295 (((
1296 (% class="TableParagraph" %)
1297 Returns TRUE for all members of the specified learning group [string1] of the course with the specified course ID=[string2].
1298 )))
1299 |(% colspan="1" %)(% colspan="1" %)
1300 (((
1301
1302 )))|(% colspan="1" %)(% colspan="1" %)
1303 (((
1304 (% class="TableParagraph" %)
1305 //inLearningGroupWaitingList("//[string]//")//
1306 )))|(% colspan="1" %)(% colspan="1" %)
1307 (((
1308 (% class="TableParagraph" %)
1309 Returns TRUE for all users on the waiting list of the learning group [string] of the current course.
1310 )))
1311 |(% colspan="1" %)(% colspan="1" %)
1312 (((
1313
1314 )))|(% colspan="1" %)(% colspan="1" %)
1315 (((
1316 (% class="TableParagraph" %)
1317 //inLearningGroupWaitingList("//[string1]//","//[string2]//")//
1318 )))|(% colspan="1" %)(% colspan="1" %)
1319 (((
1320 (% class="TableParagraph" %)
1321 Returns TRUE for all users on the waiting list of the learning group [string1] of the course with the specified course ID=[string2].
1322 )))
1323 |(% colspan="1" %)(% colspan="1" %)
1324 (((
1325
1326 )))|(% colspan="1" %)(% colspan="1" %)
1327 (((
1328 (% class="TableParagraph" %)
1329 //inRightGroup("//[string]//")//
1330 )))|(% colspan="1" %)(% colspan="1" %)
1331 (((
1332 (% class="TableParagraph" %)
1333 Returns TRUE for all members of the right group [string].
1334 )))
1335 |(% colspan="1" %)(% colspan="1" %)
1336 (((
1337
1338 )))|(% colspan="1" %)(% colspan="1" %)
1339 (((
1340 (% class="TableParagraph" %)
1341 //isLearningGroupFull("//[string]//")//
1342 )))|(% colspan="1" %)(% colspan="1" %)
1343 (((
1344 (% class="TableParagraph" %)
1345 Returns the Boolean TRUE (=full) or FALSE (=not full) for the specified learning group in the current course.
1346 )))
1347 |(% colspan="1" %)(% colspan="1" %)
1348 (((
1349
1350 )))|(% colspan="1" %)(% colspan="1" %)
1351 (((
1352 (% class="TableParagraph" %)
1353 //isLearningGroupFull("//[string1]//","//[string2]//")//
1354 )))|(% colspan="1" %)(% colspan="1" %)
1355 (((
1356 (% class="TableParagraph" %)
1357 Returns the Boolean TRUE (=full) or FALSE (=not full) for the specified learning group=[string1] of the course with the course ID=[string2].
1358 )))
1359 |(% colspan="1" %)(% colspan="1" %)
1360 (((
1361
1362 )))|(% colspan="1" %)(% colspan="1" %)
1363 (((
1364 (% class="TableParagraph" %)
1365 //isUser("//[string]//")//
1366 )))|(% colspan="1" %)(% colspan="1" %)
1367 (((
1368 (% class="TableParagraph" %)
1369 Returns TRUE for the user with the user name [string].
1370 )))
1371 |(% colspan="1" %)(% colspan="1" %)
1372 (((
1373
1374 )))|(% colspan="1" %)(% colspan="1" %)
1375 (((
1376 (% class="TableParagraph" %)
1377 //inLearningArea("//[string]//")//
1378 )))|(% colspan="1" %)(% colspan="1" %)
1379 (((
1380 (% class="TableParagraph" %)
1381 Returns TRUE for all members of the groups in the learning area [string] of the current course.
1382 )))
1383 |(% colspan="1" %)(% colspan="1" %)
1384 (((
1385
1386 )))|(% colspan="1" %)(% colspan="1" %)
1387 (((
1388 (% class="TableParagraph" %)
1389 //inLearningArea("//[string1]//","//[string2]//")//
1390 )))|(% colspan="1" %)(% colspan="1" %)
1391 (((
1392 (% class="TableParagraph" %)
1393 Returns TRUE for all members of the groups in the specified learning area [string1] of the course with the specified course ID=[string2].
1394 )))
1395 |(% colspan="1" %)(% colspan="1" %)
1396 (((
1397
1398 )))|(% colspan="1" %)(% colspan="1" %)
1399 (((
1400 (% class="TableParagraph" %)
1401 //getNumberOfEnrollments("//[string1]*//")//
1402 )))|(% colspan="1" %)(% colspan="1" %)
1403 (((
1404 (% class="TableParagraph" %)
1405 Returns TRUE, when the configured number of learning group members is reached in the learning area (string1).
1406 )))
1407 |(% colspan="1" %)(% colspan="1" %)
1408 (((
1409
1410 )))|(% colspan="1" %)(% colspan="1" %)
1411 (((
1412 (% class="TableParagraph" %)
1413 //isGlobalAuthor(0)//
1414 )))|(% colspan="1" %)(% colspan="1" %)
1415 (((
1416 (% class="TableParagraph" %)
1417 Returns TRUE for all members of the OPAL author group.
1418 )))
1419 |(% colspan="1" %)(% colspan="1" %)
1420 (((
1421
1422 )))|(% colspan="1" %)(% colspan="1" %)
1423 (((
1424 (% class="TableParagraph" %)
1425 //isCourseAdministrator(0)//
1426 )))|(% colspan="1" %)(% colspan="1" %)
1427 (((
1428 (% class="TableParagraph" %)
1429 Returns TRUE for all owners of your course (learning resource).
1430 )))
1431 |(% colspan="1" %)(% colspan="1" %)
1432 (((
1433
1434 )))|(% colspan="1" %)(% colspan="1" %)
1435 (((
1436 (% class="TableParagraph" %)
1437 //isCourseCoach(0)//
1438 )))|(% colspan="1" %)(% colspan="1" %)
1439 (((
1440 (% class="TableParagraph" %)
1441 Returns TRUE for all users who supervise a learning group.
1442 )))
1443 |(% colspan="1" %)(% colspan="1" %)
1444 (((
1445
1446 )))|(% colspan="1" %)(% colspan="1" %)
1447 (((
1448 (% class="TableParagraph" %)
1449 //isGuest(0)//
1450 )))|(% colspan="1" %)(% colspan="1" %)
1451 (((
1452 (% class="TableParagraph" %)
1453 Returns TRUE for all users who visit OPAL as guests.
1454 )))
1455 |(% colspan="1" %)(% colspan="1" %)
1456 (((
1457
1458 )))|(% colspan="1" %)(% colspan="1" %)
1459 (((
1460 (% class="TableParagraph" %)
1461 //isExternalUser(0)//
1462 )))|(% colspan="1" %)(% colspan="1" %)
1463 (((
1464 (% class="TableParagraph" %)
1465 Returns TRUE for everyone who uses OPAL as an external user.
1466 )))
1467 |(% colspan="1" %)(% colspan="1" %)
1468 (((
1469
1470 )))|(% colspan="1" %)(% colspan="1" %)
1471 (((
1472 (% class="TableParagraph" %)
1473 //hasAttribute("//[AttrName]//","//[string]//")//
1474 )))|(% colspan="1" %)(% colspan="1" %)
1475 (((
1476 (% class="TableParagraph" %)
1477 Returns TRUE if [string] matches the value of the AAI attribute [AttrName] of the respective user.
1478 )))
1479 |(% colspan="1" %)(% colspan="1" %)
1480 (((
1481
1482 )))|(% colspan="1" %)(% colspan="1" %)
1483 (((
1484 (% class="TableParagraph" %)
1485 //isInAttribute("//[AttrName]//","//[substring]//")//
1486 )))|(% colspan="1" %)(% colspan="1" %)
1487 (((
1488 (% class="TableParagraph" %)
1489 Returns TRUE if [substring] matches a portion of the value of the AAI attribute [AttrName] of the respective user.
1490 )))
1491 |(% colspan="1" %)(% colspan="1" %)
1492 (((
1493
1494 )))|(% colspan="1" %)(% colspan="1" %)
1495 (((
1496 (% class="TableParagraph" %)
1497 //isInAttribute("//[AttrName]//","//[substring]//")//
1498 )))|(% colspan="1" %)(% colspan="1" %)
1499 (((
1500 (% class="TableParagraph" %)
1501 Returns TRUE if [substring] matches a portion of the value of the AAI attribute [AttrName] of the respective user.
1502 )))
1503 |(% colspan="1" %)(% colspan="1" %)
1504 (((
1505
1506 )))|(% colspan="1" %)(% colspan="1" %)
1507 (((
1508 (% class="TableParagraph" %)
1509 //getUserProperty("//[string]//")//
1510 )))|(% colspan="1" %)(% colspan="1" %)
1511 (((
1512 (% class="TableParagraph" %)
1513 Returns the specified user property of the executing user.
1514 )))
1515 |(% colspan="1" %)(% colspan="1" %)
1516 (((
1517
1518 )))|(% colspan="1" %)(% colspan="1" %)
1519 (((
1520 (% class="TableParagraph" %)
1521 //getPassed("//[integer]//")//
1522 )))|(% colspan="1" %)(% colspan="1" %)
1523 (((
1524 (% class="TableParagraph" %)
1525 Returns the Boolean TRUE (=passed) or FALSE (=not passed) from the course element with the specified ID.
1526 )))
1527 |(% colspan="1" %)(% colspan="1" %)
1528 (((
1529
1530 )))|(% colspan="1" %)(% colspan="1" %)
1531 (((
1532 (% class="TableParagraph" %)
1533 //getScore("//[integer]//")//
1534 )))|(% colspan="1" %)(% colspan="1" %)
1535 (((
1536 (% class="TableParagraph" %)
1537 Returns the number of points from the course element with the specified ID.
1538 )))
1539 |(% colspan="1" %)(% colspan="1" %)
1540 (((
1541
1542 )))|(% colspan="1" %)(% colspan="1" %)
1543 (((
1544 (% class="TableParagraph" %)
1545 //getAttempts("//[integer]//")//
1546 )))|(% colspan="1" %)(% colspan="1" %)
1547 (((
1548 (% class="TableParagraph" %)
1549 Returns the number of completed attempts from the course element with the specified ID. Can be applied to course elements of the type //Test, Self-test//, //Survey //(possible return values 0 or 1), and //Task //(return value = number of submitted files).
1550 )))
1551 |(% colspan="1" %)(% colspan="1" %)
1552 (((
1553
1554 )))|(% colspan="1" %)(% colspan="1" %)
1555 (((
1556 (% class="TableParagraph" %)
1557 //getInitialEnrollmentDate("//[integer]//")//
1558 )))|(% colspan="1" %)(% colspan="1" %)
1559 (((
1560 (% class="TableParagraph" %)
1561 Returns the date of the respective course participant's first-time enrolment from the course element //Enrolment// with the specified ID.
1562 )))
1563 |(% colspan="1" %)(% colspan="1" %)
1564 (((
1565
1566 )))|(% colspan="1" %)(% colspan="1" %)
1567 (((
1568 (% class="TableParagraph" %)
1569 //getRecentEnrollmentDate("//[integer]//")//
1570 )))|(% colspan="1" %)(% colspan="1" %)
1571 (((
1572 (% class="TableParagraph" %)
1573 Returns the date of the respective course participant's last enrolment from the course element //Enrolment// with the specified ID.
1574 )))
1575 |(((
1576
1577 )))|(((
1578 (% class="TableParagraph" %)
1579 //getInitialCourseLaunchDate(0)//
1580 )))|(((
1581 (% class="TableParagraph" %)
1582 Returns the date of the first course visit of the respective course participant.
1583 )))
1584 |(((
1585
1586 )))|(((
1587 (% class="TableParagraph" %)
1588 //getRecentCourseLaunchDate(0)//
1589 )))|(((
1590 (% class="TableParagraph" %)
1591 Returns the date of the last course visit of the respective course participant.
1592 )))
1593 |(% colspan="1" %)(% colspan="1" %)
1594 (((
1595
1596 )))|(% colspan="1" %)(% colspan="1" %)
1597 (((
1598 (% class="TableParagraph" %)
1599 //getRecentCourseLaunchDate(0)//
1600 )))|(% colspan="1" %)(% colspan="1" %)
1601 (((
1602 (% class="TableParagraph" %)
1603 Returns the date of the last course visit of the respective course participant.
1604 )))
1605 |(% colspan="1" %)(% colspan="1" %)
1606 (((
1607
1608 )))|(% colspan="1" %)(% colspan="1" %)
1609 (((
1610 (% class="TableParagraph" %)
1611 //getPassedWithCourseId("//[integer-1]//","//[integer- 2]//")//
1612 )))|(% colspan="1" %)(% colspan="1" %)
1613 (((
1614 (% class="TableParagraph" %)
1615 Returns the Boolean TRUE (=passed) or FALSE (=not passed) from the course element with the ID=[integer-2] of the course with the ID=[integer-1].
1616 )))
1617 |(% colspan="1" %)(% colspan="1" %)
1618 (((
1619
1620 )))|(% colspan="1" %)(% colspan="1" %)
1621 (((
1622 (% class="TableParagraph" %)
1623 //getScoreWithCourseId("//[integer-1]//","//[integer-2]//")//
1624 )))|(% colspan="1" %)(% colspan="1" %)
1625 (((
1626 (% class="TableParagraph" %)
1627 Returns the number of points from the course element with the ID=[integer-2] of the course with the ID=[integer-1].
1628 )))
1629 |(% colspan="1" %)(% colspan="1" %)
1630 (((
1631
1632 )))|(% colspan="1" %)(% colspan="1" %)
1633 (((
1634 //getMarkWithCourseId("//[integer-1]//","//[integer-2]//")//
1635 )))|(% colspan="1" %)(% colspan="1" %)
1636 (((
1637 Returns the grade from the course element with the with the ID=[integer-1].
1638 )))
1639 |(((
1640
1641 )))|(((
1642 (% class="TableParagraph" %)
1643 //hasEvaluationCompleted("//KB-ID//")//
1644 )))|(((
1645 (% class="TableParagraph" %)
1646 Returns TRUE for all users who have successfully completed the specified course element.
1647 )))
1648 |(((
1649
1650 )))|(((
1651 (% class="TableParagraph" %)
1652 //getNumberOfEnrollments("//[string1]*//")//
1653 )))|(((
1654 (% class="TableParagraph" %)
1655 Returns TRUE, when the configured number of learning group members is reached in the learning area (string1).
1656 )))
1657 |(((
1658
1659 )))|(((
1660 (% class="TableParagraph" %)
1661 //getOnyxTestOutcome("//[string1]//","//[string2]//")//
1662 )))|(((
1663 (% class="TableParagraph" %)
1664 Returns the value of the output variable from the ONYX test course element with the specified ID (string1) and the specified output variable (string2). The return value is a number.
1665 )))
1666 |(% colspan="1" %)(% colspan="1" %)
1667 (((
1668
1669 )))|(% colspan="1" %)(% colspan="1" %)
1670 (((
1671 (% class="TableParagraph" %)
1672 //getOnyxTestOutcomeZK("//[string1]//","//[string2]//")//
1673 )))|(% colspan="1" %)(% colspan="1" %)
1674 (((
1675 (% class="TableParagraph" %)
1676 Returns the value of the output variable from the ONYX test course element with the specified ID (string1) and the specified output variable (string2). The return value is a string.
1677 )))
1678 |(% colspan="1" %)(% colspan="1" %)
1679 (((
1680
1681 )))|(% colspan="1" %)(% colspan="1" %)
1682 (((
1683 (% class="TableParagraph" %)
1684 //getProgress(//"[integer]"//)//
1685 )))|(% colspan="1" %)(% colspan="1" %)
1686 (((
1687 (% class="TableParagraph" %)
1688 Returns the progress from the course element with the specified ID as a numerical value between 0 and 100 (percent).
1689 )))
1690 |(% colspan="1" %)(% colspan="1" %)
1691 (((
1692
1693 )))|(% colspan="1" %)(% colspan="1" %)
1694 (((
1695 (% class="TableParagraph" %)
1696 //isPasswordConfirmed("//[string]")
1697 )))|(% colspan="1" %)(% colspan="1" %)
1698 (((
1699 (% class="TableParagraph" %)
1700 Returns TRUE after entering the correct password (string1).
1701
1702 (% class="TableParagraph" %)
1703 Can only be used with course elements which offer a password restriction even in simple mode.
1704 )))
1705 |(% colspan="1" %)(% colspan="1" %)
1706 (((
1707
1708 )))|(% colspan="1" %)(% colspan="1" %)
1709 (((
1710 (% class="TableParagraph" %)
1711 //comesFrom("//[string]//")//
1712 )))|(% colspan="1" %)(% colspan="1" %)
1713 (((
1714 (% class="TableParagraph" %)
1715 Returns TRUE if the user has a linked account to OLAT with the specified system ID.
1716 )))
1717 |(% colspan="1" %)(% colspan="1" %)
1718 (((
1719 (% class="TableParagraph" %)
1720 **Units**
1721 )))|(% colspan="1" %)(% colspan="1" %)
1722 (((
1723 (% class="TableParagraph" %)
1724 //min//
1725 )))|(% colspan="1" %)(% colspan="1" %)
1726 (((
1727 (% class="TableParagraph" %)
1728 Minutes
1729 )))
1730 |(% colspan="1" %)(% colspan="1" %)
1731 (((
1732
1733 )))|(% colspan="1" %)(% colspan="1" %)
1734 (((
1735 (% class="TableParagraph" %)
1736 //h//
1737 )))|(% colspan="1" %)(% colspan="1" %)
1738 (((
1739 (% class="TableParagraph" %)
1740 //h//
1741 )))
1742 |(% colspan="1" %)(% colspan="1" %)
1743 (((
1744
1745 )))|(% colspan="1" %)(% colspan="1" %)
1746 (((
1747 (% class="TableParagraph" %)
1748 //w//
1749 )))|(% colspan="1" %)(% colspan="1" %)
1750 (((
1751 (% class="TableParagraph" %)
1752 Weeks
1753 )))
1754 |(% colspan="1" %)(% colspan="1" %)
1755 (((
1756
1757 )))|(% colspan="1" %)(% colspan="1" %)
1758 (((
1759 (% class="TableParagraph" %)
1760 //m//
1761 )))|(% colspan="1" %)(% colspan="1" %)
1762 (((
1763 (% class="TableParagraph" %)
1764 Months
1765 )))
1766 |(% colspan="1" %)(% colspan="1" %)
1767 (((
1768 (% class="TableParagraph" %)
1769 **Operators**
1770 )))|(% colspan="1" %)(% colspan="1" %)
1771 (((
1772 (% class="TableParagraph" %)
1773 ~=
1774 )))|(% colspan="1" %)(% colspan="1" %)
1775 (((
1776 (% class="TableParagraph" %)
1777 equal to
1778 )))
1779 |(((
1780
1781 )))|(((
1782 (% class="TableParagraph" %)
1783 ~>
1784 )))|(((
1785 (% class="TableParagraph" %)
1786 greater than
1787 )))
1788 |(((
1789
1790 )))|(((
1791 (% class="TableParagraph" %)
1792 <
1793 )))|(((
1794 (% class="TableParagraph" %)
1795 less than
1796 )))
1797 |(((
1798
1799 )))|(((
1800 (% class="TableParagraph" %)
1801 ~>=
1802 )))|(((
1803 (% class="TableParagraph" %)
1804 greater than or equal to
1805 )))
1806 |(((
1807
1808 )))|(((
1809 (% class="TableParagraph" %)
1810 <=
1811 )))|(((
1812 (% class="TableParagraph" %)
1813 less than or equal to
1814 )))
1815 |(((
1816
1817 )))|(((
1818 (% class="TableParagraph" %)
1819 *
1820 )))|(((
1821 (% class="TableParagraph" %)
1822 Multiplication
1823 )))
1824 |(% colspan="1" %)(% colspan="1" %)
1825 (((
1826
1827 )))|(% colspan="1" %)(% colspan="1" %)
1828 (((
1829 (% class="TableParagraph" %)
1830 /
1831 )))|(% colspan="1" %)(% colspan="1" %)
1832 (((
1833 (% class="TableParagraph" %)
1834 Division
1835 )))
1836 |(% colspan="1" %)(% colspan="1" %)
1837 (((
1838
1839 )))|(% colspan="1" %)(% colspan="1" %)
1840 (((
1841 (% class="TableParagraph" %)
1842 +
1843 )))|(% colspan="1" %)(% colspan="1" %)
1844 (((
1845 (% class="TableParagraph" %)
1846 Addition
1847 )))
1848 |(% colspan="1" %)(% colspan="1" %)
1849 (((
1850
1851 )))|(% colspan="1" %)(% colspan="1" %)
1852 (((
1853 (% class="TableParagraph" %)
1854 -
1855 )))|(% colspan="1" %)(% colspan="1" %)
1856 (((
1857 (% class="TableParagraph" %)
1858 Subtraction
1859 )))
1860 |(((
1861 (% class="TableParagraph" %)
1862 **Booleans**
1863 )))|(((
1864 (% class="TableParagraph" %)
1865 &
1866 )))|(((
1867 (% class="TableParagraph" %)
1868 Logical AND
1869 )))
1870 |(((
1871
1872 )))|(((
1873 (% class="TableParagraph" %)
1874 ~|
1875 )))|(((
1876 (% class="TableParagraph" %)
1877 Logical OR
1878 )))
1879 |(((
1880
1881 )))|(((
1882 (% class="TableParagraph" %)
1883 !
1884 )))|(((
1885 (% class="TableParagraph" %)
1886 Logical NOT
1887 )))
1888 {{/expand}}
1889
1890 {{expand title="Application examples of the expert syntax"}}
1891 === Application examples ===
1892
1893 In the following section, you will find examples on how to use the expert syntax.
1894
1895 {{info}}
1896 In addition to these institution-independent examples, there are also institution-dependent rules that restrict and transmit data according to the user's institution (DFN-AAI attributes).
1897
1898 For OPAL users, the page [[Overview of OPAL Shibboleth attributes>>url:https://bildungsportal.sachsen.de/help/attribute-opal_de.html||shape="rect"]] contains all currently usable institution-specific attributes of Saxon institutions.
1899 {{/info}}
1900
1901 |=(((
1902 (% style="color: rgb(63,68,68);" %)Examples of rules in the tabs //«Visibility», «Access», //and// «Points» //(structure element)
1903 )))|=(((
1904 Effects
1905 )))
1906 |(((
1907 (% class="TableParagraph" %)
1908 isGuest(0) or isGuest(0)=1 or isGuest(0)=TRUE
1909 )))|(((
1910 (% class="TableParagraph" %)
1911 Only guests have access to the course element.
1912 )))
1913 |(((
1914 (% class="TableParagraph" %)
1915 inLearningGroup("Beginners") = 0
1916 )))|(((
1917 (% class="TableParagraph" %)
1918 With the exception of the group //«Beginners»,// the course element is visible to all course participants.
1919 )))
1920 |(((
1921 (% class="TableParagraph" %)
1922 (now >= date("22.03.2017 12:00")) & (now <= date("23.08.2017 18:00")) | inLearningGroup("Supervisors")
1923 )))|(((
1924 (% class="TableParagraph" %)
1925 The course element will be visible to all course participants from 22.03.2017 to 23.08.2017. For the members of the learning group //«Supervisors», //in contrast, it will be visible// //at any time//.//
1926 )))
1927 |(((
1928 (% class="TableParagraph" %)
1929 (now >= date("03.09.2017 00:00")) & (now <= date("13.10.2017 00:00")) & inRightGroup("Assessors")| isUser("Author")
1930 )))|(((
1931 (% class="TableParagraph" %)
1932 The course element will be visible to all course participants of the right group //«Assessors»// from 03.09.2017 to 13.10.2017. For the person with the user name //«Author», //in contrast, it will be visible at any time.
1933 )))
1934 |(% colspan="1" %)(% colspan="1" %)
1935 (((
1936 (% class="TableParagraph" %)
1937 isInAttribute("surname","Mue")
1938 )))|(% colspan="1" %)(% colspan="1" %)
1939 (((
1940 (% class="TableParagraph" %)
1941 Returns TRUE for all persons whose attribute //surname// contains// //the letter sequence "Mue". It returns TRUE e.g. for the value "Mueller" or "Muehlebacher".
1942 )))
1943 |(% colspan="1" %)(% colspan="1" %)
1944 (((
1945 (% class="TableParagraph" %)
1946 (getUserProperty("orgUnit") = "Marketing")
1947 )))|(% colspan="1" %)(% colspan="1" %)
1948 (((
1949 (% class="TableParagraph" %)
1950 Checks whether a person is in the organisation unit "Marketing". This is for example useful if the data are automatically transferred from LDAP.
1951 )))
1952 |(% colspan="1" %)(% colspan="1" %)
1953 (((
1954 (% class="TableParagraph" %)
1955 (getPassed("69742969114730") | getPassed("69742969115733") | getPassed("69742969118009")) * 10
1956 )))|(% colspan="1" %)(% colspan="1" %)
1957 (((
1958 (% class="TableParagraph" %)
1959 This rule is set in the tab //«Points» //-> //«Process points»// of the course element //Structure//. The course element //Structure //shows 10 points if any of the tests (course element IDs "69742969114730", "69742969115733", or "69742969118009") has been passed, otherwise it will show 0 points.
1960 )))
1961 |(% colspan="1" %)(% colspan="1" %)
1962 (((
1963 (getScore("69742969114730") + getScore("69742969115733") + getScore("69742969118009")) >= 140 | getPassed("69978845384688")
1964 )))|(% colspan="1" %)(% colspan="1" %)
1965 (((
1966 (% class="TableParagraph" %)
1967 This rule is set in the tab //«Points» //->
1968
1969 //«Passed if»// of the course element //Structure//. The course element //Structure //shows a //"passed"// if a minimum of 140 points is achieved in all tests together or if a //«passed» //is set manually// //(course element //Assessment //with the ID "69978845384688").
1970 )))
1971 |(% colspan="1" %)(% colspan="1" %)
1972 (((
1973 (% class="TableParagraph" %)
1974 getAttempts("70323786958847") > 0
1975 )))|(% colspan="1" %)(% colspan="1" %)
1976 (((
1977 (% class="TableParagraph" %)
1978 Returns TRUE as soon as the course participant has completed the test with the specified ID for the first time.
1979 )))
1980 |(((
1981 (% class="TableParagraph" %)
1982 getAttempts("70323524635734") <= 3
1983 )))|(((
1984 (% class="TableParagraph" %)
1985 Returns FALSE as soon as the course participant has saved more than 3 files in the drop box of the course element //Task//.
1986 )))
1987 |(((
1988 (% class="TableParagraph" %)
1989 getInitialEnrollmentDate("70323786958847") <= date("26.5.2017 18:00")
1990 )))|(((
1991 (% class="TableParagraph" %)
1992 Returns TRUE for those course participants who have enrolled in one of the available groups before 6 p.m. on May 26, 2017 via the course element //Enrolment// with a specified ID.
1993 )))
1994 |(% colspan="1" %)(% colspan="1" %)
1995 (((
1996 (% class="TableParagraph" %)
1997 getInitialEnrollmentDate("70323786958847") + 2h > now
1998 )))|(% colspan="1" %)(% colspan="1" %)
1999 (((
2000 (% class="TableParagraph" %)
2001 Returns TRUE within two hours from the time of enrolment for those course participants who have enrolled in one of the available groups via the course element //Enrolment// with a specified ID. In this way, it can be ensured that each course participant can only e.g. process a script during a certain period of time.
2002 )))
2003 |(% colspan="1" %)(% colspan="1" %)
2004 (((
2005 (% class="TableParagraph" %)
2006 (getInitialCourseLaunchDate(0) >= never) | (getInitialCourseLaunchDate(0) + 2h > now)
2007 )))|(% colspan="1" %)(% colspan="1" %)
2008 (((
2009 (% class="TableParagraph" %)
2010 Returns TRUE if the course participant has not yet visited the course, or during the first two hours of the first course visit. In this way, it can be ensured that each course participant can only see the course for a certain period of time.
2011 )))
2012 |(% colspan="1" %)(% colspan="1" %)
2013 (((
2014 (% class="TableParagraph" %)
2015 (getRecentCourseLaunchDate(0) + 10min) > now
2016 )))|(% colspan="1" %)(% colspan="1" %)
2017 (((
2018 (% class="TableParagraph" %)
2019 Returns TRUE if the user has been active in the course for more than 10 minutes.
2020 )))
2021 |(((
2022 (% class="TableParagraph" %)
2023 getOnyxTestOutcome("84692289655276","SCORE") >= 10
2024 )))|(((
2025 (% class="TableParagraph" %)
2026 Returns TRUE if the user has reached at least 10 points.
2027 )))
2028 |(((
2029 (% class="TableParagraph" %)
2030 getOnyxTestOutcomeZK("84389429397045","PASS") ="true"
2031 )))|(((
2032 (% class="TableParagraph" %)
2033 Returns TRUE if the user has passed the test.
2034 )))
2035 |(((
2036 (% class="TableParagraph" %)
2037 getMark("84692289655276") > 4
2038 )))|(((
2039 (% class="TableParagraph" %)
2040 Returns TRUE if the user's grade for the specified course element is better than 4.
2041 )))
2042
2043 {{note title="Attention!"}}
2044 Please note that the above-mentioned course element IDs are just examples. When you create a course, you need to reference the ID of your own course.
2045 {{/note}}
2046 {{/expand}}
2047
2048 \\
2049
2050 (% style="white-space: pre-wrap;" %)(DFN-AAI attributes)
2051 {{/layout-cell}}
2052 {{/layout-section}}
2053 {{/layout}}
2054 {{/sv-translation}}