Wiki-Quellcode von Expertenregeln zur Prüfung auf ein Benutzerattribut
Zuletzt geändert von Carina Enke am 26.11.2025
Zeige letzte Bearbeiter
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{section}} | ||
| 2 | {{column width="60%"}} | ||
| 3 | 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**. | ||
| 4 | |||
| 5 | {{info}} | ||
| 6 | 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"]]. | ||
| 7 | {{/info}} | ||
| 8 | {{/column}} | ||
| 9 | |||
| 10 | {{column width="30%"}} | ||
| 11 | {{panel title="Inhalt"}} | ||
| 12 | {{toc start="2" depth="2"/}} | ||
| 13 | {{/panel}} | ||
| 14 | |||
| 15 | {{panel title="Verwandte Themen"}} | ||
| 16 | * Link | ||
| 17 | {{/panel}} | ||
| 18 | {{/column}} | ||
| 19 | {{/section}} | ||
| 20 | |||
| 21 | == Allgemeine Nutzerattribute == | ||
| 22 | |||
| 23 | |||
| 24 | Folgende Nutzerattribute sind in der Lernplattform vorhanden und können für Expertenregeln genutzt werden: | ||
| 25 | |||
| 26 | |=(% style="width: 239px;" %)((( | ||
| 27 | Attribut | ||
| 28 | )))|=(% style="width: 1542px;" %)((( | ||
| 29 | Enthält den nutzerspezifischen Wert | ||
| 30 | ))) | ||
| 31 | |=(% colspan="1" style="width: 239px;" %)(% colspan="1" %) | ||
| 32 | ((( | ||
| 33 | firstName | ||
| 34 | )))|(% colspan="1" style="width:1542px" %)(% colspan="1" %) | ||
| 35 | ((( | ||
| 36 | Vorname | ||
| 37 | ))) | ||
| 38 | |=(% colspan="1" style="width: 239px;" %)(% colspan="1" %) | ||
| 39 | ((( | ||
| 40 | lastName | ||
| 41 | )))|(% colspan="1" style="width:1542px" %)(% colspan="1" %) | ||
| 42 | ((( | ||
| 43 | Nachname | ||
| 44 | ))) | ||
| 45 | |=(% style="width: 239px;" %)((( | ||
| 46 | username / userid | ||
| 47 | )))|(% style="width:1542px" %)((( | ||
| 48 | Nutzername | ||
| 49 | ))) | ||
| 50 | |=(% style="width: 239px;" %)((( | ||
| 51 | |||
| 52 | )))|(% style="width:1542px" %)((( | ||
| 53 | E-Mail-Adresse | ||
| 54 | ))) | ||
| 55 | |=(% style="width: 239px;" %)((( | ||
| 56 | institutionalName | ||
| 57 | )))|(% style="width:1542px" %)((( | ||
| 58 | Institution/ Hochschule | ||
| 59 | ))) | ||
| 60 | |=(% colspan="1" style="width: 239px;" %)(% colspan="1" %) | ||
| 61 | ((( | ||
| 62 | institutionalUserIdentifier | ||
| 63 | )))|(% colspan="1" style="width:1542px" %)(% colspan="1" %) | ||
| 64 | ((( | ||
| 65 | Matrikelnummer / Nutzernummer an der Institution | ||
| 66 | ))) | ||
| 67 | |=(% colspan="1" style="width: 239px;" %)(% colspan="1" %) | ||
| 68 | ((( | ||
| 69 | standort | ||
| 70 | )))|(% colspan="1" style="width:1542px" %)(% colspan="1" %) | ||
| 71 | ((( | ||
| 72 | Standort | ||
| 73 | ))) | ||
| 74 | |=(% colspan="1" style="width: 239px;" %)(% colspan="1" %) | ||
| 75 | ((( | ||
| 76 | termsOfStudy | ||
| 77 | )))|(% colspan="1" style="width:1542px" %)(% colspan="1" %) | ||
| 78 | ((( | ||
| 79 | Fachsemester | ||
| 80 | ))) | ||
| 81 | |=(% colspan="1" style="width: 239px;" %)(% colspan="1" %) | ||
| 82 | ((( | ||
| 83 | studySubject | ||
| 84 | )))|(% colspan="1" style="width:1542px" %)(% colspan="1" %) | ||
| 85 | ((( | ||
| 86 | Studiengang | ||
| 87 | ))) | ||
| 88 | |=(% colspan="1" style="width: 239px;" %)(% colspan="1" %) | ||
| 89 | ((( | ||
| 90 | studyGroup | ||
| 91 | )))|(% colspan="1" style="width:1542px" %)(% colspan="1" %) | ||
| 92 | ((( | ||
| 93 | Studiengruppe | ||
| 94 | ))) | ||
| 95 | |=(% colspan="1" style="width: 239px;" %)(% colspan="1" %) | ||
| 96 | ((( | ||
| 97 | orgUnit | ||
| 98 | )))|(% colspan="1" style="width:1542px" %)(% colspan="1" %) | ||
| 99 | ((( | ||
| 100 | Organisationseinheit | ||
| 101 | ))) | ||
| 102 | |=(% colspan="1" style="width: 239px;" %)language|(% colspan="1" style="width:1542px" %)Nutzersprache | ||
| 103 | |||
| 104 | {{note}} | ||
| 105 | === Institutionsspezifische Nutzerattribute === | ||
| 106 | |||
| 107 | 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. | ||
| 108 | {{/note}} | ||
| 109 | |||
| 110 | |||
| 111 | == Prüfung auf ein Benutzerattribut == | ||
| 112 | |||
| 113 | (% class="relative-table" style="width:100.0%" %) | ||
| 114 | |=(% colspan="1" %)(% colspan="1" %) | ||
| 115 | ((( | ||
| 116 | Syntax allgemein | ||
| 117 | )))|=(% colspan="1" %)(% colspan="1" %) | ||
| 118 | ((( | ||
| 119 | Beispiel einer Expertenregel | ||
| 120 | )))|=(% colspan="1" %)(% colspan="1" %) | ||
| 121 | ((( | ||
| 122 | Ergebis der Regel | ||
| 123 | ))) | ||
| 124 | |(% colspan="1" %)(% colspan="1" %) | ||
| 125 | ((( | ||
| 126 | //isInAttribute("//[AttrName]//","//[string]//")// | ||
| 127 | )))|((( | ||
| 128 | (% class="auto-cursor-target" %) | ||
| 129 | isInAttribute("studySubject","Chemie") | ||
| 130 | |||
| 131 | isInAttribute("studySubject","Chemie") | ||
| 132 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 133 | ((( | ||
| 134 | Wurde diese Regel im Tab Zugang eingetragen, ist der Kursbaustein für alle Personen, deren Attribut Studiengang die Buchstabenfolge "Chemie" enthält zugänglich. | ||
| 135 | |||
| 136 | Somit können Personen mit dem Studiengang "Chemie BA" und auch "Chemie MA" den Kursbaustein nutzen, Nutzer mt dem Studiengang "Chemische Wasseraufbereitung" jedoch nicht. | ||
| 137 | ))) | ||
| 138 | |(% colspan="1" %) |((( | ||
| 139 | isInAttribute("language","de") | ||
| 140 | )))|(% colspan="1" %) Wurde diese Regel im Tab Zugang eingetragen, ist der Kursbaustein für alle Personen, deren Nutzersprache Deutsch ist zugänglich. | ||
| 141 | |(% colspan="1" %)(% colspan="1" %) | ||
| 142 | ((( | ||
| 143 | //getUserProperty("//[string]//")// | ||
| 144 | )))|((( | ||
| 145 | (% class="auto-cursor-target" %) | ||
| 146 | getUserProperty("orgUnit") = "Marketing" | ||
| 147 | |||
| 148 | getUserProperty("orgUnit") = "Marketing" | ||
| 149 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 150 | ((( | ||
| 151 | Nur Personen aus der Organisationseinheit "Marketing" sehen den Kursbaustein, wenn diese Regel im Tab Sichtbarkeit genutzt wurde. | ||
| 152 | ))) | ||
| 153 | |(% colspan="1" %)(% colspan="1" %) | ||
| 154 | ((( | ||
| 155 | //hasAttribute("//[AttrName]//","//[string]//")// | ||
| 156 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 157 | ((( | ||
| 158 | hasAttribute("email","muster.mann@opal.de") | ||
| 159 | )))|(% colspan="1" %)(% colspan="1" %) | ||
| 160 | ((( | ||
| 161 | Nur die Person mit dieser Email-Adresse erhält Zugang zum Kursabschnitt. | ||
| 162 | ))) | ||
| 163 | |||
| 164 | 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]]. |