Zum Inhalt springen

Expertenregeln zur Prüfung auf ein Benutzerattribut

Zuletzt geändert von Carina Enke am 08.01.2026

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.

Information

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).

Inhalt

Allgemeine Nutzerattribute

Folgende Nutzerattribute sind in der Lernplattform vorhanden und können für Expertenregeln genutzt werden:

Attribut

Enthält den nutzerspezifischen Wert

firstName

Vorname

lastName

Nachname

username / userid

Nutzername

email

E-Mail-Adresse

institutionalName

Institution/ Hochschule

institutionalUserIdentifier

Matrikelnummer / Nutzernummer an der Institution

standort

Standort

termsOfStudy

Fachsemester

studySubject

Studiengang

studyGroup

Studiengruppe

orgUnit

Organisationseinheit

languageNutzersprache
Warning

Institutionsspezifische Nutzerattribute

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 bietet eine Übersicht dieser verwendbaren Attribute und entsprechende Beispielwerte.

Prüfung auf ein Benutzerattribut

Allgemein nutzt man

  • hasAttribute, um zu prüfen, ob ein Benutzer ein bestimmtes Attribut überhaupt besitzt. Die Funktion gibt true zurück, wenn das Attribut existiert, unabhängig vom Wert. Geeignet für einfache Existenzprüfungen.
  • ​isInAttribute, wenn übergeben werden soll, ob der Wert eines Attributs in einer Liste von erlaubten Werten enthalten ist. Die Regel prüft Mehrwert-Listen oder Aufzählungen, z. B. Rollen oder Gruppenmitgliedschaften.
  • ​getUserProperty wenn der genaue Wert eines Benutzerattributs abgerufen und dann mit einer Bedingungen verglichen werden soll. Ideal für exakte Wertabgleiche oder dynamische Berechnungen mit Attributwerten.
Syntax allgemeinBeispiel einer ExpertenregelErgebnis der Regel
isInAttribute("[AttrName]","[string]")isInAttribute("studySubject","Chemie")

Wurde diese Regel im Tab Zugang eingetragen, ist der Kursbaustein für alle Personen, deren Attribut Studiengang die Buchstabenfolge "Chemie" enthält zugänglich.

Somit können Personen mit dem Studiengang "Chemie BA" und auch "Chemie MA" den Kursbaustein nutzen, Nutzer mt dem Studiengang "Chemische Wasseraufbereitung" jedoch nicht.

isInAttribute("language","de")Wurde diese Regel im Tab Zugang eingetragen, ist der Kursbaustein für alle Personen, deren Nutzersprache Deutsch ist zugänglich.
getUserProperty("[string]")getUserProperty("orgUnit") = "Marketing"Nur Personen aus der Organisationseinheit "Marketing" sehen den Kursbaustein, wenn diese Regel im Tab Sichtbarkeit genutzt wurde.
hasAttribute("[AttrName]","[string]")hasAttribute("email","muster.mann@opal.de")Nur die Person mit dieser Email-Adresse erhält Zugang zum Kursabschnitt.
hasAttribute("language","en")Nur die Person mit eingestellter Nutzersprache "English" erhalten Zugang zum Kursabschnitt. 

Erstellen Sie weitere Regeln mit Hilfe Expertensyntax. Eine tabellarische Übersicht bietet die Seite Expertensyntax.