Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Anchor
d13e3329
d13e3329

Konfiguration von Expertenregeln

Eine Expertenregel prüft, ob ein Attribut einen bestimmten Wert besitzt.

AttributBeschreibungBeispiel Expertenregel
isGuestnur für Gäste zugänglichisGuest(0)
isCourseCoachnur für Betreuer sichtbarisCourseCoach(0)
isUsernur für einen bestimmten Benutzer verfügbarisUser("pmuster")

Arbeiten mit den Konstanten "TRUE" und "FALSE"

Die Konstanten „true“ und „false“ prüfen das Vorhandensein („true“ bzw. „1“) oder Nicht-Vorhanden-Sein („false“ bzw. „0“) eines Attributs. Man spricht von einer sogenannten Boolschen Variablen (benannt nach George Boole dem Begründer der Boolschen Algebra). Dabei handelt es sich um eine Variable, die nur endlich viele Werte oder Zustände einnehmen kann. In diesem Fall kann die Variable nur zwei Zustände oder Werte annehmen („true“ = „1“ = wahr, vorhanden oder „false“ = „0“ = falsch, nicht-vorhanden).

Panel
Expand
titleBeispiel: Bereiche für Gäste frei geben

Zur praktischen Erläuterung im OLAT-Kontext soll uns eine Expertenregel für den Zugang  zu einem Kursbaustein bzw. Bereich innerhalb eines Kurses dienen.

Fall 1: Nur Gast-Nutzer sollen Zugang zu einem Baustein erhalten, beispielsweise um Bereiche für Gäste und OLAT Benutzer voneinander zu trennen.
Der jeweilige Nutzer erhält also Zugang, wenn er das Attribut „isGuest“ wahr ist. Für diese Expertenregel gibt es drei Alternativen:

isGuest(0) oder isGuest(0)=1 oder isGuest(0)=true


Fall 2: Hier sollen alle Nutzer außer den Gast-Nutzern einenZugang erhalten. Der jeweilige Nutzer erhält also Zugang, wenn das Attribut „isGuest"nicht wahr bzw. nicht vorhanden ist. Für diese Expertenregel gibt es zwei Alternativen:

isGuest(0)=0 oder isGuest(0)=false

Eine ausführliche Liste aller wichtigen Bestandteile für die Expertenregeln finden Sie in der nachfolgenden Box.

Panel
Expand
titleFunktionen, Operatoren und andere Expertenregel Komponenten
TypSyntaxBedeutung
KonstantenTRUE oder 1Wahr
FALSE oder 0Falsch
ANY_COURSEAbfrage soll für jeden Kurs gelten (nur für isCourseAdministrator(), isCourseCoach(), isCourseParticipant()
VariablenowMomentane Server-Systemzeit
Funktionendate("[date]")Datum abfragen
inLearningGroup("[string]")Gibt TRUE für alle Mitglieder der Lerngruppe [string]
inRightGroup("[string]")Gibt TRUE für alle Mitglieder der Rechtegruppe [string]
isLearningGroupFull("[string]")Gibt für die angegebene Lerngruppe den Boolean TRUE (=voll) oder FALSE (=nicht voll) zurück.
isUser("[string]")Gibt TRUE für den Benutzer mit dem Benutzernamen [string]
inLearningArea("[string]")Gibt TRUE für alle Mitglieder der Gruppen im Lernbereich [string]
isGlobalAuthor(0)Gibt TRUE für alle Mitglieder der OLAT-Autorengruppe
isCourseAdministrator(0)Gibt TRUE für alle Besitzer Ihres Kurses (Lernressource)
isCourseAdministrator(ANY_COURSE)Gibt TRUE für alle Benutzer die Besitzer eines beliebigen Kurses auf dem System sind (Lernressource)
isCourseCoach(0)Gibt TRUE für alle Benutzer, die eine Lerngruppe oder den gesamten Kurs betreuen
isCourseCoach(ANY_COURSE)Gibt TRUE für alle Benutzer, die eine Lerngruppe eines beliebigen Kurses oder einen beliebigen gesamten Kurs betreuen
isCourseParticipant(0)Gibt TRUE für alle Teilnehmer des Kurses
isCourseParticipant(ANY_COURSE)Gibt TRUE für alle Benutzer, die in einem beliebigen Kurs als Teilnehmer eingetragen sind
isGuest(0)Gibt TRUE für alle Benutzer, die OLAT als Gäste besuchen
hasAttribute("[AttrName]","[string]")

Gibt TRUE, wenn [string] dem Wert des AAI-Attributes [AttrName] des jeweiligen Benutzers entspricht.

AAI - Generelle Informationen
AAI-Attribute
Spezifikation der AAI-Attribute (pdf-Datei)

isInAttribute("[AttrName]","[substring]")Gibt TRUE, wenn [substring] einem Teil des Wertes des AAI-Attributs [AttrName] des jeweiligen Benutzers entspricht.
getUserProperty("[userPropertyname]")Gibt den Wert des spezifizierten Benutzerattributes zurück. Mit "=" kann dieser Wert mit einem fixen Wert verglichen werden.
getPassed("[integer]")Gibt vom Kursbaustein mit spezifizierter ID den Boolean TRUE (=Bestanden) oder FALSE (=Nicht bestanden) zurück
getScore("[integer]")Gibt vom Kursbaustein mit spezifizierter ID die Anzahl Punkte zurück
getAttempts("[integer]")Gibt vom Kursbaustein mit spezifizierter ID die Anzahl abgeschlossener Versuche zurück. Kann auf Kursbausteine vom Typ Test, Selbsttest, Fragebogen angewendet werden. 
getLastAttemptDate("[integer]")Gibt vom Kursbaustein mit spezifizierter ID das Datum des letzen Versuches zurück. Die Anwendung ist gleich wie die getAttempts Methode.
getInitialEnrollmentDate("[integer]")Gibt vom Kursbaustein Einschreibung mit spezifizierter ID das Datum des erstmaligen Einschreibens des betreffenden Kursteilnehmers zurück.
getRecentEnrollmentDate("[integer]")Gibt vom Kursbaustein Einschreibung mit spezifizierter ID das Datum des letzten Einschreibens des betreffenden Kursteilnehmers zurück.
getInitialCourseLaunchDate(0)Gibt das Datum des erstmaligen Kursbesuchs des betreffenden Kursteilnehmers zurück.
getRecentCourseLaunchDate(0)Gibt das Datum des letzten Kursbesuchs des betreffenden Kursteilnehmers zurück.
getPassedWithCourseId("[integer-1]","[integer-2]")Gibt vom Kursbaustein mit ID=[integer-2] des Kurses mit ID=[integer-1] den Boolean TRUE (=Bestanden) oder FALSE (=Nicht bestanden) zurück
getScoreWithCourseId("[integer-1]","[integer-2]")

Gibt vom Kursbaustein mit ID=[integer-2] des Kurses mit ID=[integer-1] die Anzahl Punkte zurück

hasUserProperty("[userPropertyname]", "[string]")

Gibt TRUE, wenn [string] dem Wert des Benutzerattribut [userPropertyname] des jeweiligen Benutzers entspricht.

userPropertyStartswith(" [userPropertyname]", "[substring]")Gibt TRUE, wenn das Benutzerattribut [userPropertyname] des jeweiligen Benutzers mit [substring] beginnt.
userPropertyEndswith(" [userPropertyname]", "[substring]")

Gibt TRUE, wenn das Benutzerattribut [userPropertyname] des jeweiligen Benutzers mit [substring] endet.

isInUserProperty(" [userPropertyname]", "[substring]")

Gibt TRUE, wenn das Benutzerattribut [userPropertyname] des jeweiligen Benutzers [substring] enthält.

isNotInUserProperty("[userPropertyname]", "[substring]")Gibt TRUE, wenn das Benutzerattribut [userPropertyname] des jeweiligen Benutzers [substring] nicht enthält.
hasNotUserProperty("[userPropertyname]", "[string]")Gibt TRUE, wenn der jeweilige Benutzer das Benutzerattribut [userPropertyname] nicht besitzt.
hasLanguage("de")Gibt TRUE, wenn der jeweilige Benutzer Deutsch als Systemsprache eingestellt hat. Für Englisch "de" durch "en" ersetzen.
EinheitenminMinuten
hStunden
dTage
wWochen
mMonate
Operatoren=gleich
>grösser als
<kleiner als
>=grösser gleich
<=kleiner gleich
*Multiplikation
/Division
+Addition
-Subtraktion
Booleans&Logisches UND
|Logisches ODER
Panel
bgColorwhite
Expand
titleBenutzerattribute (UserProperty)

Verschiedene Expertenregeln benötigen Benutzerattribute um Einschränkungen vornehmen zu können. Dies ermöglicht bspw. die Einschränkung von Benutzern nach Name, Geschlecht, Adresse, Studienfach und weitere. Diese Benutzerattribute sind in der Regel im Benutzerprofil enthalten. OpenOLAT stellt standardisierte Begriffe für diese Attribute bereit. Folgende Expertenregeln benötigen Benutzerattribute:

  • getUserProperty("[userPropertyname]")
  • hasUserProperty("[userPropertyname]", "[string]")
  • userPropertyStartswith(" [userPropertyname]", "[substring]")
  • userPropertyEndswith(" [userPropertyname]", "[substring]")
  • isInUserProperty(" [userPropertyname]", "[substring]")
  • isNotInUserProperty("[userPropertyname]", "[substring]")
  • hasNotUserProperty("[userPropertyname]", "[string]")

Die folgenden Benutzerattribute stehen in OpenOLAT zur Verfügung. Bitte beachten Sie, dass eine Einschränkung mittels Benutzerattributen nur dann erfolgreich sein kann, wenn diese in ihrem System auch genutzt werden, und standardmässig ausgefüllt sind. Überprüfen Sie im persönlichen Menü unter Konfiguration/Profil die verfügbaren Benutzerattribute. Bei Fragen kontaktieren Sie ihren Systemadministrator.

BenutzerdatenKontaktdatenAdressdaten
userNameBenutzernametelPrivateTelefon privatstreetStrasse
firstNameVornametelMobileTelefon MobilextendedAddressAdresszusatz
lastNameNachnametelOfficeTelefon GeschäftpoBoxPostfach
emailE-Mail-AdresseskypeSkype IDzipCodePLZ
creationDateDisplayPropertyErstelldatum des BenutzersxingXingregionRegion / Kanton
lastloginDateDisplayPropertyLetzter Login des BenutzershomepageHomepagecityStadt
birthDayGeburtsdatum

countryLand
genderGeschlecht

countryCodeLänderkürzel

OrganisationBerufliche KontaktdatenVerschiedenes
institutionalNameInstitutiondepartmentDienststelle / FirmatypeOfUserArt von Benutzer
institutionalUserIdentifierInstitutionsnummer (Matrikelnummer)officeStreetDienstadresse - StrasserankDienstgrad / Amtsbezeichnung
institutionalEmailInstitutions E-MailextendedOfficeAddressDienstadresszusatzsocialSecurityNumberSozialversicherungs-nummer
orgUnitOrganisationseinheit / StudiengruppeofficeZipCodeDienst-PostleitzahldegreeAkademischer Grad
studySubjectStudienfachofficeCityDienstadresse - StadtpositionFunktion / Stellung
graduationAbschlussjahrofficeCountryDienstadresse - LanduserInterestsExpertise


officeMobilePhoneDienstmobiltelefon


Beispiele für die Anwendung:

  • Es sollen nur Kursteilnehmer eines bestimmten Studienganges Zugang erhalten:

    getUserProperty("studySubject") = "Maschinenbau"

    Nun muss, wer Zugang haben möchte, in seinem Profil, im Feld Studienfach Maschinenbau eingetragen haben.

  • Sollen nur Kursteilnehmer Zugang erhalten, die nichts im Feld Studiengang eingetragen haben, lautet die Regel:

    getUserProperty("studySubject") = ""
  • Sollen nur Kursteilnehmer Zugang erhalten, die irgendeinen Studiengang eingetragen haben, muss die Regel lauten:

    getUserProperty("studySubject") = "" = false

    oder

    getUserProperty("studySubject") = "" = 0


Es gibt verschiedene Möglichkeiten, die einzelnen Regeln miteinander zu verknüpfen. Die beiden wichtigsten Operatoren zur Verknüpfung von Attributen sind:

  • UND-Verknüpfung: &
  • ODER-Verknüpfung: |

Bitte beachten Sie, dass eine ODER-Verknüpfung vor einer UND-Verknüpfung gemacht wird. Damit die UND-Verknüpfung zuerst gemacht wird, müssen Klammern gesetzt werden.

Beispiel: Die Expertenregel (inGroup("Teilnehmende Intensivkurs") | isCourseCoach(0)) lässt entweder Teilnehmende des Intensivkurses oder alle Gruppenbetreuer auf den Kursbaustein zugreifen.

Anchor
example
example
Nachfolgend sind einige Beispiele aufgeführt, die Ihnen zeigen, wie Sie die Expertensyntax verwenden können.

Expand
titleBeispiele Expertenmodus
Panel
titleBeispiele für Expertenregeln in den Tabs «Sichtbarkeit», «Zugang» und «Punkte» (Struktur-Baustein)

Beispiele für Expertenregeln in den Tabs «Sichtbarkeit», «Zugang» und «Punkte» (Struktur-Baustein)

inLearningGroup("Anfänger") = 0
Mit Ausnahme der Gruppe «Anfänger» ist der Kursbaustein für alle Kursteilnehmer sichtbar.

(now >= date("22.07.2018 12:00")) & (now <= date("23.12.2018 18:00")) | inLearningGroup("Betreuer")
Der Kursbaustein ist zwischen dem 22.07.2018 und 23.12.2018 für alle Kursteilnehmer sichtbar, während er für Mitglieder der Lerngruppe «Betreuer» jederzeit sichtbar ist.

(now >= date("03.09.2018 00:00")) & (now <= date("13.10.2018 00:00")) & inRightGroup("Assessoren")| isUser("schmidt")
Der Kursbaustein ist zwischen dem 03.09.2018 und 13.10.2018 für alle Kursteilnehmer der Rechtegruppe «Assessoren» sichtbar, während er für die Person mit dem Benutzernamen «schmidt» jederzeit sichtbar ist.

hasAttribute("swissEduPersonStudyBranch3","6200")
Ausschliesslich Studierende der Humanmedizin haben Zugriff auf den Kursbaustein.
Siehe auch:
AAI-Attribute
Spezifikation der AAI-Attribute (pdf-Datei)

hasAttribute("swissEduPersonHomeOrganization","uzh.ch")
Ausschliesslich Studierende der Universität Zürich haben Zugriff auf den Kursbaustein.
Siehe auch:
AAI-Attribute
Spezifikation der AAI-Attribute (pdf-Datei)

isInAttribute("surname","Mue")
Gibt TRUE für alle Personen, deren Attribut surname die Buchstabenfolge "Mue" enthaltet. Gibt z.B. TRUE für den Wert "Mueller" oder "Muehlebacher"
Siehe auch:
AAI-Attribute
Spezifikation der AAI-Attribute (pdf-Datei)

isInAttribute("eduPersonEntitlement","http://vam.uzh.ch")
Gibt TRUE für alle Personen, deren Attribut eduPersonEntitlement den Wert "http://vam.uzh.ch" enthaltet. Gibt z.B. auch TRUE für den Wert "http://vam.uzh.ch/surgery"
Siehe auch:
AAI-Attribute
Spezifikation der AAI-Attribute (pdf-Datei)

(getUserProperty("orgUnit") = "Sales")
Prüft ob eine Person in der Organisationseinheit "Sales" ist. Sinnvoll z.B. wenn die Daten automatisiert aus LDAP übernommen werden.

(getPassed("69742969114730") | getPassed("69742969115733") | getPassed("69742969118009")) * 10
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.

(getScore("69742969114730") + getScore("69742969115733") + getScore("69742969118009")) >= 140 | getPassed("69978845384688")
Diese Regel wird im Tab «Punkte» -> «Bestanden wenn» des Bausteins Struktur gesetzt. Der Bausteins 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").

getAttempts("70323786958847") > 0
Gibt TRUE, sobald der betreffende Kursteilnehmer den Test mit spezifizierter ID ein erstes Mal abgeschlossen hat, also sobald ein Versuch erfolgte unabhängig von der Punktzahl.

getLastAttemptDate("70323524635734") + 24h < now
Gibt TRUE, wenn der letzte Testversuch 24 Stunden zurückliegt.

getInitialEnrollmentDate("70323786958847") <= date("26.5.2018 18:00")
Gibt TRUE für diejenigen Kursteilnehmer, die sich vor 18 Uhr des 26. Mai 2018 über den Kursbaustein Einschreibung mit spezifizierter ID in eine zur Auswahl stehende Gruppe eingeschrieben haben.

getInitialEnrollmentDate("70323786958847") + 2h > now
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.

(getInitialCourseLaunchDate(0) >= never) | (getInitialCourseLaunchDate(0) + 2h > now)
Gibt TRUE, wenn der Kursteilnehmer den Kurs noch nicht besucht hat oder während zwei Stunden seit dem ersten Kursbesuch. So kann abgebildet werden, dass jeder Kursteilnehmer nur während einer bestimmten Zeitdauer den Kurs sehen kann.

(getRecentCourseLaunchDate(0) + 10min < now)
Gibt TRUE, wenn sich der Benutzer seit mehr als 10 Minuten im Kurs bewegt.

(getCourseBeginDate(0) <= today) & (getCourseEndDate(0) >= today)
Gibt den Wert TRUE zurück, wenn das heutige Datum zwischen Beginn- und Enddatum des Durchführungszeitraums des Kurses liegt.

isAssessmentMode(0)
Gibt TRUE sobald der Kurs innerhalb eine Prüfung ist.

hasUserProperty("email","john.doe@openolat.org")
Gibt TRUE, wenn der Kursteilnehmer in OpenOLAT mit der eingetragenen E-Mail-Adresse registriert ist.
 

userPropertyEndswith("email","@openolat.org")
Gibt TRUE, wenn die E-Mail-Adresse des Kursteilnehmers auf @openolat.org endet.
 
isInUserProperty("email","doe@openo")
Gibt TRUE, wenn der Begriff doe@openo ein Teil der E-Mail-Adresse des Kursteilnehmers ist.
 
isNotInUserProperty("email","doe@openo")
Gibt FALSE, wenn der Begriff doe@openo ein Teil der E-Mail-Adresse des Kursteilnehmers ist.
 

isNotInUserProperty("email","doe@openo")
Gibt FALSE, wenn der Begriff doe@openo ein Teil der E-Mail-Adresse des Kursteilnehmers ist.

Note
Bitte beachten Sie, dass die oben erwähnten Kursbaustein-IDs Beispiele sind. Wenn Sie Ihren Kurs erstellen, müssen Sie jeweils die Nummern referenzieren, die auf dem ersten Tab «Titel und Beschreibung» des gewünschten Kursbausteins sichtbar sind.

Anchor
_aai
_aai

...


AttributBeschreibungBeispiel Expertenregel und Erklärung
swissEduPerson-HomeOrganizationUniversität oder HeimorganisationhasAttribute ("swissEduPersonHomeOrganization", "uzh.ch"): Nur Angehörige der Universität Zürich sind zugelassen.
swissEduStudyBranch3Studienrichtung 3. KlassifikationhasAttribute ("swissEduPersonStudyBranch3","6400"): Nur Studierende der Studienrichtung Veterinärmedizin sind zugelassen.

Anwendung

Sie können AAI-Attribute mit der Syntax

hasAttribute("[AttrName]","[string]") oder 
isInAttribute("[AttrName]","[substring]") abfragen.

Dabei gilt folgendes:

[AttrName] ist der Attributnamen, den Sie in der nachfolgenden Tabelle und auch in der Spezifikation der AAI-Attribute (pdf-Datei) (Spalte LDAP Namen) auf Seite 5 vorfinden.
[string]ist der Wert des AAI-Attributes mit Namen [AttrName].
[substring] ist ein beliebig grosser Teil von [string].
Panel
titleAAI Beispiel
Expand
titleAbfragen für Max Mustermann
Variable
Sie können AAI-Attribute mit der Syntax
hasAttribute("[AttrName]","[string]") oder
isInAttribute("[AttrName]","[substring]") abfragen.
Beispiel Wert
[string]
Beschreibung
swissEduPersonUniqueID845938727494@uzh.chEindeutige persönliche Identifikationsnummer
surnameMusterNachname
givenNameHansVorname
mailhans.muster@uzh.chBevorzugte E-Mail-Adresse
swissEduPersonHomeOrganizationuzh.chHeimorganisation/Universität
swissEduPersonHomeOrganizationTypeuniversityArt der Heimorganisation
eduPersonAffiliationstudentFunktion innerhalb der Heimorganisation
swissEduPersonStudyBranch14Studienrichtung 1. Klassifikation
swissEduPersonStudyBranch242 (=Naturwissenschaften)Studienrichtung 2. Klassifikation
swissEduPersonStudyBranch34600 (=Chemie)Studienrichtung 3. Klassifikation
swissEduPersonStudyLevel15Beschreibung des Studien-Fortschrittes
eduPersonEntitlementhttp://vam.uzh.ch/surgeryZugriffsrecht auf Ressource
employeeNumber01-234-567Matrikelnummer (nur für Studierende der Universität Zürich)
organizationalUnit1Einheit der Heimorganisation z.B. Fakultät (nur für Mitarbeiter)
Expand
titleBeispiel Max Mustermann
isInAttribute("surname","ust")true
hasAttribute("swissEduPersonStudyBranch3","4600")true
hasAttribute("swissEduPersonStudyBranch3","1200")false
isInAttribute("eduPersonEntitlement","http://vam.uzh.ch")true
isInAttribute("eduPersonEntitlement","http://vam.uzh.ch/ophthalmology")false
hasAttribute("employeeNumber","01-234-567")true


Einen Link zur Liste der möglichen Attribut-Werte finden Sie im Appendix der Spezifikation der AAI-Attribute (pdf-Datei) ab Seite 20. Spezifikation der AAI-Attribute (pdf-Datei)

Für weitere Informationen zu Werten oder der Anwendung von AAI-Attributen, wenden Sie sich in der Schweiz bitte an Switch, und in Deutschland an das Deutsche Forschungsnetz.

Info
Verwenden Sie die AAI Attribute nur dann wenn Sie sicher sind, dass alle Teilnehmer Ihres Kurses sich über eine AAI Struktur einwählen. Ansonsten greifen die Parameter nicht!