Wiki-Quellcode von Expertenregeln zur Prüfung auf ein Benutzerattribut
Zuletzt geändert von Carina Enke am 15.01.2024
Zeige letzte Bearbeiter
author | version | line-number | content |
---|---|---|---|
1 | {{layout}} | ||
2 | {{layout-section ac:type="two_right_sidebar"}} | ||
3 | {{layout-cell}} | ||
4 | Mit Expertenregeln können Sie Nutzerattribute auswerten und so die Sichtbarkeit und den Zugang eines Kursabschnittes oder Kursbausteins steuern. Nutzen Sie dafür die Expertenregeln **hasAttribute**, **isInAttribute **oder **getUserProperty**. | ||
5 | |||
6 | {{info}} | ||
7 | Alle nachfolgenden Beispielregeln lassen sich für die **Sichtbarkeit** und ebenso für den **Zugang** eines Kursbausteins anlegen. Zur Vereinfachung wird in den folgenden Beispielen immer nur ein Szenario beschrieben. Den Unterschied von Sichtbarkeit und Zugang erläutert die Seite [[Freigabe innerhalb von Kursen (Sichtbarkeit und Zugang)>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Kurs.Freigabe von Kursen und Kursinhalten.Freigabe innerhalb von Kursen Sichtbarkeit und Zugang.WebHome||shape="rect"]]. | ||
8 | {{/info}} | ||
9 | {{/layout-cell}} | ||
10 | |||
11 | {{layout-cell}} | ||
12 | |||
13 | {{/layout-cell}} | ||
14 | {{/layout-section}} | ||
15 | |||
16 | {{layout-section ac:type="single"}} | ||
17 | {{layout-cell}} | ||
18 | == Allgemeine Nutzerattribute == | ||
19 | |||
20 | |||
21 | Folgende Nutzerattribute sind in der Lernplattform vorhanden und können für Expertenregeln genutzt werden: | ||
22 | |||
23 | (% class="wrapped" %) | ||
24 | |=((( | ||
25 | Attribut | ||
26 | )))|=((( | ||
27 | Enthält den nutzerspezifischen Wert | ||
28 | ))) | ||
29 | |=(% colspan="1" %)(% colspan="1" %) | ||
30 | ((( | ||
31 | firstName | ||
32 | )))|(% colspan="1" %)(% colspan="1" %) | ||
33 | ((( | ||
34 | Vorname | ||
35 | ))) | ||
36 | |=(% colspan="1" %)(% colspan="1" %) | ||
37 | ((( | ||
38 | lastName | ||
39 | )))|(% colspan="1" %)(% colspan="1" %) | ||
40 | ((( | ||
41 | Nachname | ||
42 | ))) | ||
43 | |=((( | ||
44 | username / userid | ||
45 | )))|((( | ||
46 | Nutzername | ||
47 | ))) | ||
48 | |=((( | ||
49 | |||
50 | )))|((( | ||
51 | E-Mail-Adresse | ||
52 | ))) | ||
53 | |=((( | ||
54 | institutionalName | ||
55 | )))|((( | ||
56 | Institution/ Hochschule | ||
57 | ))) | ||
58 | |=(% colspan="1" %)(% colspan="1" %) | ||
59 | ((( | ||
60 | institutionalUserIdentifier | ||
61 | )))|(% colspan="1" %)(% colspan="1" %) | ||
62 | ((( | ||
63 | Matrikelnummer / Nutzernummer an der Institution | ||
64 | ))) | ||
65 | |=(% colspan="1" %)(% colspan="1" %) | ||
66 | ((( | ||
67 | standort | ||
68 | )))|(% colspan="1" %)(% colspan="1" %) | ||
69 | ((( | ||
70 | Standort | ||
71 | ))) | ||
72 | |=(% colspan="1" %)(% colspan="1" %) | ||
73 | ((( | ||
74 | termsOfStudy | ||
75 | )))|(% colspan="1" %)(% colspan="1" %) | ||
76 | ((( | ||
77 | Fachsemester | ||
78 | ))) | ||
79 | |=(% colspan="1" %)(% colspan="1" %) | ||
80 | ((( | ||
81 | studySubject | ||
82 | )))|(% colspan="1" %)(% colspan="1" %) | ||
83 | ((( | ||
84 | Studiengang | ||
85 | ))) | ||
86 | |=(% colspan="1" %)(% colspan="1" %) | ||
87 | ((( | ||
88 | studyGroup | ||
89 | )))|(% colspan="1" %)(% colspan="1" %) | ||
90 | ((( | ||
91 | Studiengruppe | ||
92 | ))) | ||
93 | |=(% colspan="1" %)(% colspan="1" %) | ||
94 | ((( | ||
95 | orgUnit | ||
96 | )))|(% colspan="1" %)(% colspan="1" %) | ||
97 | ((( | ||
98 | Organisationseinheit | ||
99 | ))) | ||
100 | |||
101 | {{note}} | ||
102 | === Institutionsspezifische Nutzerattribute === | ||
103 | |||
104 | Neben zu diesen allgemeinen Nutzerattributen sind institutionsspezifische Einschränkungen oder Erweiterungen möglich. Prüfen Sie deshalb vor der Anwendung, welche der Benutzerattribute in Ihrer Plattform verfügbar sind. Die Seite [[Übersicht der OPAL-Shibboleth-Attribute>>url:https://bildungsportal.sachsen.de/help/attribute-opal_de.html||shape="rect"]] bietet eine Übersicht dieser verwendbaren Attribute und entsprechende Beispielwerte. | ||
105 | {{/note}} | ||
106 | {{/layout-cell}} | ||
107 | {{/layout-section}} | ||
108 | |||
109 | {{layout-section ac:type="single"}} | ||
110 | {{layout-cell}} | ||
111 | (% id="HPrFCfungaufeinBenutzerattribut" class="auto-cursor-target" %) | ||
112 | == Prüfung auf ein Benutzerattribut == | ||
113 | |||
114 | |||
115 | (% class="relative-table" style="width:100.0%" %) | ||
116 | |=(% colspan="1" %)(% colspan="1" %) | ||
117 | ((( | ||
118 | Syntax allgemein | ||
119 | )))|=(% colspan="1" %)(% colspan="1" %) | ||
120 | ((( | ||
121 | Beispiel einer Expertenregel | ||
122 | )))|=(% colspan="1" %)(% colspan="1" %) | ||
123 | ((( | ||
124 | Ergebis der Regel | ||
125 | ))) | ||
126 | |(% colspan="1" %)(% colspan="1" %) | ||
127 | ((( | ||
128 | //isInAttribute("//[AttrName]//","//[string]//")// | ||
129 | )))|((( | ||
130 | (% class="auto-cursor-target" %) | ||
131 | isInAttribute("studySubject","Chemie") | ||
132 | |||
133 | |||
134 | )))|(% colspan="1" %)(% colspan="1" %) | ||
135 | ((( | ||
136 | Wurde diese Regel im Tab Zugang eingetragen, ist der Kursbaustein für alle Personen, deren Attribut Studiengang die Buchstabenfolge "Chemie" enthält zugänglich. | ||
137 | |||
138 | Somit können Personen mit dem Studiengang "Chemie BA" und auch "Chemie MA" den Kursbaustein nutzen, Nutzer mt dem Studiengang "Chemische Wasseraufbereitung" jedoch nicht. | ||
139 | ))) | ||
140 | |(% colspan="1" %)(% colspan="1" %) | ||
141 | ((( | ||
142 | //getUserProperty("//[string]//")// | ||
143 | )))|((( | ||
144 | (% class="auto-cursor-target" %) | ||
145 | getUserProperty("orgUnit") = "Marketing" | ||
146 | |||
147 | |||
148 | )))|(% colspan="1" %)(% colspan="1" %) | ||
149 | ((( | ||
150 | Nur Personen aus der Organisationseinheit "Marketing" sehen den Kursbaustein, wenn diese Regel im Tab Sichtbarkeit genutzt wurde. | ||
151 | ))) | ||
152 | |(% colspan="1" %)(% colspan="1" %) | ||
153 | ((( | ||
154 | //hasAttribute("//[AttrName]//","//[string]//")// | ||
155 | )))|(% colspan="1" %)(% colspan="1" %) | ||
156 | ((( | ||
157 | hasAttribute("email","muster.mann@opal.de") | ||
158 | )))|(% colspan="1" %)(% colspan="1" %) | ||
159 | ((( | ||
160 | Nur die Person mit dieser Email-Adresse erhält Zugang zum Kursabschnitt. | ||
161 | ))) | ||
162 | {{/layout-cell}} | ||
163 | {{/layout-section}} | ||
164 | |||
165 | {{layout-section ac:type="single"}} | ||
166 | {{layout-cell}} | ||
167 | Erstellen Sie weitere Regeln mit Hilfe Expertensyntax. Eine tabellarische Übersicht bietet die Seite [[Expertensyntax>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Kurs.Freigabe von Kursen und Kursinhalten.Expertenmodus zur Freigabe innerhalb von Kursen.Expertensyntax.WebHome]]. | ||
168 | {{/layout-cell}} | ||
169 | {{/layout-section}} | ||
170 | {{/layout}} |