Expertensyntax

Zuletzt geändert von Carina Enke am 16.01.2024

Neben den beschriebenen Anwendungsbeispielen zu Expertenregeln können Sie mit Hilfe der Syntax weitere eigene Regeln zusammenstellen.

Folgende Syntax können Sie zur Konfiguration eigener Regeln verwenden:

Typ

Syntax

Bedeutung

Konstanten

true oder TRUE

Wahr

false oder FALSE

Falsch

Variable

now

Momentane Server-Systemzeit

Funktionen

date("[date]")

Datum abfragen

inLearningGroup("[string]")

Gibt TRUE für alle Mitglieder der Lerngruppe mit dem Titel [string] des aktuellen Kurses zurück. Ein Beispiel dazu finden Sie auf der Seite Expertenregeln zur Prüfung von Nutzerrolle und Guppenzugehörigkeit.

inLearningGroup("[string1]","[string2]")

Gibt TRUE für alle Mitglieder der angegebenen Lerngruppe [string1] des Kurses mit der angegebenen Kurs-ID=[string2] zurück.

inLearningGroupWaitingList("[string]")

Gibt TRUE für alle Benutzer in der Warteliste der Lerngruppe [string] des aktuellen Kurses zurück.

inLearningGroupWaitingList("[string1]","[string2]")

Gibt TRUE für alle Benutzer in der Warteliste der Lerngruppe [string1] des Kurses mit der angegebenen Kurs-ID=[string2] zurück.

inRightGroup("[string]")

Gibt TRUE für alle Mitglieder der Rechtegruppe [string] zurück.

isLearningGroupFull("[string]")

Gibt für die angegebene Lerngruppe im aktuellen Kurs den Boolean TRUE (=voll) oder FALSE (=nicht voll) zurück.

isLearningGroupFull("[string1]","[string2]")

Gibt für die angegebene Lerngruppe=[string1] des Kurses mit Kurs-ID=[string2] den Boolean TRUE (=voll) oder FALSE (=nicht voll) zurück.

isUser("[string]")

Gibt TRUE für den Benutzer mit dem Benutzernamen [string] zurück.

inLearningArea("[string]")

Gibt TRUE für alle Mitglieder der Gruppen im Lernbereich [string] des aktuellen Kurses zurück.

inLearningArea("[string1]","[string2]")

Gibt TRUE für alle Mitglieder der Gruppen im angegebenen Lernbereich [string1] des Kurses mit der angegebenen Kurs-ID=[string2] zurück.

inLearningAreaWaitingList("[string1]","[string2]")

Gibt TRUE für alle Mitglieder der Warteliste der Lerngruppen die zum angegebenen Lernbereich [string1] des Kurses mit der angegebenen Kurs-ID=[string2] gehören zurück.

getNumberOfEnrollments("[string1]*")

Gibt TRUE, wenn die konfigurierte Anzahl der Lerngruppenmitgliedschaften im Lernbereich (string1) erreicht ist.

isGlobalAuthor(0)

Gibt TRUE für alle Mitglieder der OPAL-Autorengruppe zurück.

isCourseAdministrator(0)

Gibt TRUE für alle Besitzer Ihres Kurses (Lernressource) zurück.

isCourseCoach(0)

Gibt TRUE für alle Benutzer, die eine Lerngruppe betreuen zurück.

isGuest(0)

Gibt TRUE für alle Benutzer, die OPAL als Gäste besuchen zurück. Ein Beispiel dazu finden Sie auf der Seite Expertenregeln zur Prüfung von Nutzerrolle und Guppenzugehörigkeit.

isExternalUser(0)

Gibt TRUE für alle, die OPAL als externe Benutzer verwenden zurück.

hasAttribute("[AttrName]","[string]")

Gibt TRUE, wenn [string] dem Wert des AAI-Attributes [AttrName] des jeweiligen Benutzers entspricht. Ein Beispiel dazu finden Sie auf der Seite Expertenregeln zur Prüfung auf ein Benutzerattribut.

isInAttribute("[AttrName]","[substring]")

Gibt TRUE, wenn [substring] einem Teil des Wertes des AAI-Attributs [AttrName] des jeweiligen Benutzers entspricht.

getUserProperty("[string]")

Liefert die angegebene Benutzer-Eigenschaft des ausführenden Nutzers zurück. Ein Beispiel dazu finden Sie auf der Seite Expertenregeln zur Prüfung auf ein Benutzerattribut.

getPassed("[integer]")

Gibt vom Kursbaustein mit spezifizierter ID den Boolean TRUE (=Bestanden) oder FALSE (=Nicht bestanden) zurück. Ein Beispiel dazu finden Sie auf der Seite Auswertung von Bewertungsdaten anderer Kursbausteine.

getScore("[integer]")

Gibt vom Kursbaustein mit spezifizierter ID die Anzahl Punkte zurück.  Ein Beispiel dazu finden Sie auf der Seite Auswertung von Bewertungsdaten anderer Kursbausteine.

getMark("[integer]")

Gibt vom Kursbaustein mit spezifizierter ID die Note zurück. Ein Beispiel dazu finden Sie auf der Seite Auswertung von Bewertungsdaten anderer Kursbausteine.

getAttempts("[integer]")

Gibt vom Kursbaustein mit spezifizierter ID die Anzahl der Versuche zurück. Bei Kursbausteinen vom Typ Test, Selbsttest, Fragebogen (mögliche Rückgabewerte 0 oder 1) werden gestartete Versuche zurückgegeben. Beim Kursbaustein Aufgabe zeigt der Rückgabewert die Anzahl abgegebener Dateien. Der Kursbaustein Portfolioaufgabe die Anzahl der abgegebenen Portfolioaufgaben. Ein Beispiel dazu finden Sie auf der Seite Auswertung der Versuchsanzahl.

getInitialEnrollmentDate("[integer]")

Gibt vom Kursbaustein Einschreibung mit spezifizierter ID das Datum des erstmaligen Einschreibens des betreffenden Kursteilnehmers zurück. Ein Beispiel dazu finden Sie auf der Seite Auswertung Einschreibezeitpunkt.

getRecentEnrollmentDate("[integer]")

Gibt vom Kursbaustein Einschreibung mit spezifizierter ID das Datum des letzten Einschreibens des betreffenden Kursteilnehmers zurück. Ein Beispiel dazu finden Sie auf der Seite Auswertung Einschreibezeitpunkt.

getInitialCourseLaunchDate(0)

Gibt das Datum des erstmaligen Kursbesuchs des betreffenden Kursteilnehmers zurück. Ein Beispiel dazu finden Sie auf der Seite Auswertung Einschreibezeitpunkt.

getRecentCourseLaunchDate(0)

Gibt das Datum des letzten Kursbesuchs des betreffenden Kursteilnehmers zurück. Ein Beispiel dazu finden Sie auf der Seite Auswertung Einschreibezeitpunkt.

 

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.

getMarkWithCourseId("[integer-1]","[integer-2]")

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

hasEvaluationCompleted("KB-ID")

Gibt TRUE für alle Benutzer die den angegebenen Kursbaustein erfolgreich beendeten.

getNumberOfEnrollments("[string1]*")

Gibt TRUE, wenn die konfigurierte Anzahl der Lerngruppenmitgliedschaften im Lernbereich (string1) erreicht ist.

getOnyxTestOutcome("[string1]","[string2]")

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. Beispiele dazu finden Sie auf der Seite Steuerung auf Basis von Ausgabevariablen eines Tests.

getOnyxTestOutcomeZK("[string1]","[string2]")

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. Ein Beispiel dazu finden Sie auf der Seite Steuerung auf Basis von Ausgabevariablen eines Tests.

getProgress("[integer]")

Gibt vom Kursbaustein mit spezifizierter ID den Fortschritt als numerischen Wert zwischen 0 und 100 (Prozent) zurück. Der Rückgabewert ist eine Zahl. Ein Beispiel dazu finden Sie auf der Seite Auswertung von Bewertungsdaten anderer Kursbausteine.

isPasswordConfirmed("[string]")

Gibt TRUE nach Eingabe des korrekten Passwortes (string1) zurück.

Kann nur bei Kursbausteinen verwendet werden, die auch im einfachen Modus eine Passwortbeschränkung anbieten.

comesFrom("[string]")

Gibt TRUE zurück wenn der Nutzer ein verlinktes Konto zum OPAL mit der angegebenen System-ID hat.

Einheiten

min

Minuten

h

h

w

Wochen

m

Monate

Operatoren

=

gleich

!=

ungleich

>

grösser als

<

kleiner als

>=

grösser gleich

<=

kleiner gleich

*

Multiplikation

/

Division

+

Addition

-

Subtraktion

%

Modulo

^

Potenz

Booleans

&

Binäres UND

 

|

Binäres ODER

 

xor

Binäres XOR

 

!

Logisches NICHT

 

or

Logische ODER

 

and

Logische UND