Wiki source code of Expertenregeln Beispiele

Last modified by Carina Enke on 15.01.2024

version	line-number	content
70.1	1
23.1	2
70.1	3	{{layout}}
	4	{{layout-section ac:type="two_right_sidebar"}}
	5	{{layout-cell}}
	6	Expert rules offer a wide range of applications and can have different effects. The examples on this page give a brief insight into possible application scenarios.
	7	{{/layout-cell}}
56.2	8
70.1	9	{{layout-cell}}
	10	{{panel title="Content"}}
	11	{{toc minLevel="2"/}}
	12	{{/panel}}
	13	{{/layout-cell}}
	14	{{/layout-section}}
17.1	15
70.1	16	{{layout-section ac:type="single"}}
	17	{{layout-cell}}
	18	== Expert rules in example images ==
	19
	20	In these examples, you can see how to configure expert rules and how they affect the course view.
	21
	22	{{expand title="Making individual content in a public course visible only to registered users ..."}}
17.1	23	(% class="wrapped" %)
	24	\|(((
	25	(% class="content-wrapper" %)
	26	(((
70.1	27	Do you wish to hide content in a public course from guests?
17.1	28
70.1	29	Enter the following content in the text field next to Expert rule in the Visibility tab of the respective course element.
17.1	30
	31	{{code}}
51.1	32	isGuest()=false
17.1	33	{{/code}}
	34
70.1	35	This will prevent the course element in a publicly accessible course from being displayed to guest users.
17.1	36	)))
	37	)))\|(((
	38	(% class="content-wrapper" %)
	39	(((
58.2	40	[[image:attach:Kurseditor - Konfiguration nur registrierte Nutzer_de.png\|\|data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
17.1	41	)))
	42	)))
	43
70.1	44	After publishing, users will see the following view:
17.1	45
	46	(% class="wrapped" %)
	47	\|=(((
70.1	48	View as a registered user
	49	)))\|=(((
	50	View as a guest user
	51	)))\|=(((
	52	View as a course owner
17.1	53	)))
70.1	54	\|(((
17.1	55	(% class="content-wrapper" %)
	56	(((
70.1	57	[[image:attach:Kursrun - Ansicht registrierte Nutzer_de.png]]
17.1	58	)))
70.1	59	)))\|(((
17.1	60	(% class="content-wrapper" %)
	61	(((
58.2	62	[[image:attach:Kurseditor - Konfiguration nicht für Gäste_de.png\|\|data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
17.1	63	)))
70.1	64	)))\|(((
17.1	65	(% class="content-wrapper" %)
	66	(((
58.2	67	[[image:attach:Kursrun - Ansicht Kursverantwortlicher_de.png\|\|data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
17.1	68	)))
	69	)))
	70	{{/expand}}
	71
70.1	72	{{expand title="Making individual content in a public course visible only to guests ..."}}
17.1	73	(% class="wrapped" %)
	74	\|(((
	75	(% class="content-wrapper" %)
	76	(((
70.1	77	Do you wish to display content in a public course exclusively to guests and course owners?
17.1	78
70.1	79	Enter the following content in the text field next to Expert rule in the Visibility tab of the respective course element.
17.1	80
	81	{{code}}
51.1	82	isGuest() or isCourseAdministrator()
17.1	83	{{/code}}
	84
	85	(% class="auto-cursor-target" %)
70.1	86	This will make the course element in a publicly accessible course visible only to guest users and course owners.
17.1	87	)))
	88	)))\|(((
	89	(% class="content-wrapper" %)
	90	(((
58.2	91	[[image:attach:Kurseditor - Konfiguration nur Gäste und Kursverantwortliche_de.png\|\|data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
17.1	92	)))
	93	)))
	94
70.1	95	After publishing, users will see the following view:
17.1	96
70.1	97	(% class="wrapped" %)
17.1	98	\|=(((
70.1	99	View as a registered user
	100	)))\|=(((
	101	View as a guest user
	102	)))\|=(((
	103	View as a course owner
17.1	104	)))
70.1	105	\|(((
17.1	106	(% class="content-wrapper" %)
	107	(((
58.2	108	[[image:attach:Kursansicht - nicht für registrierte Nutzer_de.png\|\|data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
17.1	109	)))
70.1	110	)))\|(((
17.1	111	(% class="content-wrapper" %)
	112	(((
70.1	113	[[image:attach:Kursrun - Ansicht nur Gäste_de.png]]
17.1	114	)))
70.1	115	)))\|(((
17.1	116	(% class="content-wrapper" %)
	117	(((
70.1	118	[[image:attach:Kursrun - Ansicht Kursverantwortlicher_de.png]]
17.1	119	)))
	120	)))
	121	{{/expand}}
	122
70.1	123	{{expand title="Releasing course content based on test results ..."}}
	124	Do you wish to release content depending on a test? The implementation of this scenario is explained on the help page [[Learning path control by test result>>url:https://www.bps-system.de/help/display/LMSintern/.Lernwegsteuerung+nach+Testergebnis+v12.4\|\|shape="rect"]].
17.1	125	{{/expand}}
70.1	126	{{/layout-cell}}
	127	{{/layout-section}}
17.1	128
70.1	129	{{layout-section ac:type="single"}}
	130	{{layout-cell}}
	131
	132	{{/layout-cell}}
	133	{{/layout-section}}
17.1	134
70.1	135	{{layout-section ac:type="single"}}
	136	{{layout-cell}}
	137	== Expert rules for checking user properties ==
	138
17.1	139	{{info}}
70.1	140	All of the following example rules can be created for both the visibility and access of a course element. For simplicity, the following examples only describe one scenario at a time.
17.1	141	{{/info}}
70.1	142	{{/layout-cell}}
	143	{{/layout-section}}
17.1	144
70.1	145	{{layout-section ac:type="single"}}
	146	{{layout-cell}}
	147
	148	{{/layout-cell}}
	149	{{/layout-section}}
51.1	150
70.1	151	{{layout-section ac:type="single"}}
	152	{{layout-cell}}
	153	=== Checking for a user role ===
17.1	154
	155	(% class="wrapped" %)
	156	\|(((
70.1	157	Only guests but no registered users can see the course element.
17.1	158	)))\|(((
	159	(% class="content-wrapper" %)
	160	(((
70.1	161	Enter the following on the Visibility tab:
17.1	162
	163	{{code language="text"}}
51.1	164	isGuest()
17.1	165	{{/code}}
	166
70.1	167	Alternatively enter: isGuest()=true or isGuest()=1
17.1	168	)))
	169	)))
	170	\|(((
70.1	171	Guests do not have access to this course element.
17.1	172	)))\|(((
	173	(% class="content-wrapper" %)
	174	(((
70.1	175	Enter the following on the Access tab:
17.1	176
	177	{{code language="text"}}
51.1	178	isGuest()=false
17.1	179	{{/code}}
51.1	180
	181	(% class="auto-cursor-target" %)
70.1	182	Alternatively enter: !isGuest()
17.1	183	)))
	184	)))
	185
70.1	186	=== Checking for a group membership ===
17.1	187
	188	(% class="wrapped" %)
70.1	189	\|(((
	190	Except of the (learning) group with the title "Anfänger", all course participants can see the course element.
	191	)))\|(((
17.1	192	(% class="content-wrapper" %)
	193	(((
70.1	194	Enter the following on the Visibility tab:
17.1	195
70.1	196	{{code language="text"}}
51.1	197	inLearningGroup("Anfänger")= false
17.1	198	{{/code}}
51.1	199
	200	(% class="auto-cursor-target" %)
70.1	201	Alternatively enter: !inLearningGroup("Anfänger")
17.1	202	)))
	203	)))
70.1	204	\|(((
	205	Only members of the "Intern" group can see the course element. Course owners and group tutors also cannot see the course element in the course navigation.
	206	)))\|(((
51.1	207	(% class="content-wrapper" %)
	208	(((
70.1	209	{{code language="text"}}
51.1	210	inLearningGroup("Intern")
	211	{{/code}}
	212	)))
	213	)))
70.1	214	\|(((
	215	The course element is visible to all course participants within a certain time frame (22.03.2020 - 23.08.2020), while being visible to members of the learning group with the title "Betreuer" at any time.
	216	)))\|(((
17.1	217	(% class="content-wrapper" %)
	218	(((
70.1	219	Enter the following on the Visibility tab:
17.1	220
70.1	221	{{code language="text"}}
51.1	222	(now >= date("22.03.2020 12:00")) and (now <= date("23.08.2020 18:00")) or inLearningGroup("Betreuer")
17.1	223	{{/code}}
	224	)))
	225	)))
70.1	226	\|(((
	227	The course element is visible to all course participants in the right group with the title “Assessoren" within a certain time frame (03.09.2020 - 13.10.2020), while being always visible to the person with the username "natalie".
	228	)))\|(((
17.1	229	(% class="content-wrapper" %)
	230	(((
70.1	231	Enter the following on the Visibility tab:
17.1	232
70.1	233	{{code language="text"}}
	234	(now >= date("03.09.2020 00:00")) and (now <= date("13.10.2020 00:00")) and inRightGroup("Assessoren")or isUser("natalie")
17.1	235	{{/code}}
	236	)))
	237	)))
	238
70.1	239	=== Checking of user attributes ===
17.1	240
	241	{{info}}
70.1	242	In addition to these institution-independent examples, there are also institution-dependent rules that restrict and transmit data according to the user's institution.
	243	For OPAL users, the help page [[Overview of OPAL Shibboleth attributes>>doc:LMS.Benutzerhandbuch OPAL.Administration.OPAL Shibboleth Attribute.WebHome]] contains all currently usable institution-specific attributes of Saxon institutions.
17.1	244	{{/info}}
	245
	246	(% class="wrapped" %)
	247	\|(((
70.1	248	This course element can be accessed by everyone whose study subject attribute contains the letter sequence "Chemie".
17.1	249
70.1	250	This means that users with the study subject "Chemie BA" or "Chemie MA" can use the course element, but users with the study subject "Chemische Wasseraufbereitung" cannot.
17.1	251	)))\|(((
	252	(% class="content-wrapper" %)
	253	(((
70.1	254	Enter the following on the Access tab:
17.1	255
	256	{{code language="text"}}
	257	isInAttribute("studySubject","Chemie")
	258	{{/code}}
	259
70.1	260	{{expand title="Examples of further attributes ..."}}
17.1	261	{{info}}
70.1	262	Different user attributes can be configured depending on the system. Therefore, it is advisable to check beforehand which user attributes are available on your platform.
17.1	263
70.1	264	Examples of user attributes:
17.1	265
70.1	266	* Username: username
	267	* Email address: email
	268	* Term: termsOfStudy
17.1	269	* Institution: institutionalName
70.1	270	* Matriculation number: institutionalUserIdentifier
	271	* Location: standort
	272	* Study subject: studySubject
	273	* Study group: studyGroup
	274	* Organisation unit: orgUnit
	275	* First name: firstName
	276	* Last name: lastName
17.1	277	{{/info}}
	278	{{/expand}}
	279	)))
	280	)))
	281	\|(((
70.1	282	Only users from the "Marketing" organisation unit can see the course element.
17.1	283	)))\|(((
	284	(% class="content-wrapper" %)
	285	(((
70.1	286	Enter the following on the Visibility tab:
17.1	287
	288	{{code language="text"}}
	289	(getUserProperty("orgUnit") = "Marketing")
	290	{{/code}}
	291	)))
	292	)))
70.1	293	{{/layout-cell}}
	294	{{/layout-section}}
17.1	295
70.1	296	{{layout-section ac:type="single"}}
	297	{{layout-cell}}
	298
	299	{{/layout-cell}}
	300	{{/layout-section}}
51.1	301
70.1	302	{{layout-section ac:type="single"}}
	303	{{layout-cell}}
	304	=== Evaluation of the enrolment date ===
	305
51.1	306	{{info}}
70.1	307	Some of the following example rules check for an enrolment course element. For example, you can use //getInitialEnrollmentDate// if only the initial enrolment is to be considered, independent of a later deregistration from the course element. Alternatively, you can also use //getRecentEnrollmentDate// if each enrolment is to be re-evaluated. For simplicity, the following examples only describe one scenario at a time.
51.1	308	{{/info}}
	309
	310	(% class="wrapped" %)
70.1	311	\|(((
	312	Access to a course element is possible depending on a specific enrolment date.
51.1	313
70.1	314	Course participants who got enrolled via an enrolment course element (course element ID "70323786958847") before May 26, 2020, 6 pm can use the course element.
	315	)))\|(((
51.1	316	(% class="content-wrapper" %)
	317	(((
70.1	318	Enter the following on the Access tab:
51.1	319
	320	{{code language="text"}}
	321	getInitialEnrollmentDate("70323786958847") <= date("26.5.2020 18:00")
	322	{{/code}}
	323	)))
	324	)))
70.1	325	\|(((
	326	Each course participant can see the course element from a relative point in time, e. g. only 2 hours after the enrolment (course element ID "70323786958847").
	327	)))\|(((
51.1	328	(% class="content-wrapper" %)
	329	(((
70.1	330	Enter the following on the Visibility tab:
51.1	331
	332	{{code language="text"}}
	333	getInitialEnrollmentDate("70323786958847") + 2h < now
	334	{{/code}}
	335	)))
	336	)))
70.1	337	\|(((
51.1	338	(% class="content-wrapper" %)
	339	(((
70.1	340	Each course participant can only see the course element up to a relative point in time, e. g. only for the first 2 hours after the enrolment (course element ID "70323786958847").
51.1	341
	342	{{note}}
70.1	343	When using this rule, make sure that the visibility of the learning group is already limited by a higher level course element. Otherwise, if you only use this rule, non-enrolled users and guests will always have access to this course element.
51.1	344	{{/note}}
70.1	345	)))
	346	)))\|(((
51.1	347	(% class="content-wrapper" %)
	348	(((
70.1	349	Enter the following on the Visibility tab:
51.1	350
	351	{{code language="text"}}
	352	getInitialEnrollmentDate("70323786958847") + 2h > now
	353	{{/code}}
	354	)))
	355	)))
70.1	356	\|(((
	357	Each course participant can only see the course element within a relative time period, e. g. starting 2 hours prior to the enrolment (course element ID "70323786958847") until 5 hours after the enrolment. Course tutors are exempt from this restriction.
	358	)))\|(((
51.1	359	(% class="content-wrapper" %)
	360	(((
70.1	361	Enter the following on the Visibility tab:
51.1	362
	363	{{code language="text"}}
70.1	364	(getInitialEnrollmentDate("101524102434663") + 2h < now and getInitialEnrollmentDate("101524102434663") + 5h > now ) or isCourseCoach(0) or isCourseAdministrator(0)
51.1	365	{{/code}}
	366	)))
	367	)))
70.1	368	\|(% colspan="1" %)(% colspan="1" %)
	369	(((
	370	Each course participant can only see the course element for a certain period of time (during the first two hours of the first course visit).
	371	)))\|(% colspan="1" %)(% colspan="1" %)
	372	(((
51.1	373	(% class="content-wrapper" %)
	374	(((
70.1	375	Enter the following on the Visibility tab:
51.1	376
	377	{{code language="text"}}
	378	(getInitialCourseLaunchDate() >= never) or (getInitialCourseLaunchDate() + 2h > now)
	379	{{/code}}
	380	)))
	381	)))
70.1	382	\|(% colspan="1" %)(% colspan="1" %)
	383	(((
	384	The course element becomes only visible if the user has been active in the course for more than 10 minutes.
	385	)))\|(% colspan="1" %)(% colspan="1" %)
	386	(((
51.1	387	(% class="content-wrapper" %)
	388	(((
70.1	389	Enter the following on the Visibility tab:
51.1	390
	391	{{code language="text"}}
	392	(getRecentCourseLaunchDate() + 10min) > now
	393	{{/code}}
	394	)))
	395	)))
70.1	396	{{/layout-cell}}
	397	{{/layout-section}}
51.1	398
70.1	399	{{layout-section ac:type="single"}}
	400	{{layout-cell}}
	401
	402	{{/layout-cell}}
	403	{{/layout-section}}
17.1	404
70.1	405	{{layout-section ac:type="single"}}
	406	{{layout-cell}}
	407	== Expert rules with specific course elements ==
	408
17.1	409	{{info}}
70.1	410	In all of the following examples, specific course elements are used.
17.1	411
70.1	412	Before using these rules, note down the course element IDs of the relevant course elements for your scenario and adjust them accordingly in the expert rules.
17.1	413	{{/info}}
70.1	414	{{/layout-cell}}
	415	{{/layout-section}}
17.1	416
70.1	417	{{layout-section ac:type="single"}}
	418	{{layout-cell}}
	419
	420	{{/layout-cell}}
	421	{{/layout-section}}
51.1	422
70.1	423	{{layout-section ac:type="single"}}
	424	{{layout-cell}}
	425	=== Evaluation of the number of attempts ===
33.1	426
17.1	427	(% class="wrapped" %)
	428	\|(((
70.1	429	The course element becomes visible as soon as the respective course participant has performed the test course element (course element ID "70323786958847") for the first time.
17.1	430	)))\|(((
	431	(% class="content-wrapper" %)
	432	(((
70.1	433	Enter the following on the Visibility tab:
17.1	434
	435	{{code language="text"}}
	436	getAttempts("70323786958847") > 0
	437	{{/code}}
	438	)))
	439	)))
	440	\|(((
70.1	441	Users should no longer be able to see a course element as soon as they have placed more than 3 files in the drop box of a task course element (course element ID "70323524635734").
17.1	442	)))\|(((
	443	(% class="content-wrapper" %)
	444	(((
70.1	445	Enter the following on the Visibility tab:
17.1	446
	447	{{code language="text"}}
	448	getAttempts("70323524635734") <= 3
	449	{{/code}}
	450	)))
	451	)))
70.1	452	{{/layout-cell}}
	453	{{/layout-section}}
17.1	454
70.1	455	{{layout-section ac:type="single"}}
	456	{{layout-cell}}
	457
	458	{{/layout-cell}}
	459	{{/layout-section}}
51.1	460
70.1	461	{{layout-section ac:type="single"}}
	462	{{layout-cell}}
	463	=== Evaluation of other course elements' assessment data ===
	464
49.1	465	(% class="wrapped" %)
	466	\|(((
70.1	467	The course element is visible as soon as the user has reached at least 10 points in the test (course element ID "84692289655276").
51.1	468	)))\|(((
	469	(% class="content-wrapper" %)
	470	(((
70.1	471	Enter the following on the Visibility tab:
49.1	472
51.1	473	{{code language="text"}}
	474	getOnyxTestOutcome("84692289655276","SCORE") >= 10
	475	{{/code}}
	476	)))
	477	)))
	478	\|(((
70.1	479	The course element is visible as soon as the user has passed the test (course element ID "84389429397045").
49.1	480	)))\|(((
	481	(% class="content-wrapper" %)
	482	(((
70.1	483	Enter the following on the Visibility tab:
49.1	484
	485	{{code language="text"}}
51.1	486	getOnyxTestOutcomeZK("84389429397045","PASS") ="true"
	487	{{/code}}
	488	)))
	489	)))
	490	\|(((
70.1	491	The course element is visible if the user's grade for the indicated element (course element ID "84692289655276") is better than 4.
51.1	492	)))\|(((
	493	(% class="content-wrapper" %)
	494	(((
70.1	495	Enter the following on the Visibility tab:
49.1	496
51.1	497	{{code language="text"}}
	498	getMark("84692289655276") < 4
49.1	499	{{/code}}
	500	)))
	501	)))
	502	\|(((
70.1	503	The course element is visible when the user has completed the indicated course element (course element ID "69742969114730") (course progress).
49.1	504	)))\|(((
	505	(% class="content-wrapper" %)
	506	(((
70.1	507	Enter the following on the Visibility tab:
51.1	508
	509	{{code language="text"}}
	510	getProgress("69742969114730")>=100
	511	{{/code}}
	512	)))
	513	)))
	514
	515	{{info}}
70.1	516	The implementation of another example of the use of expert rules is explained on the help page [[Learning path control by test result>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Leitfäden.Lernwegsteuerung nach Testergebnis.WebHome]].
51.1	517	{{/info}}
70.1	518	{{/layout-cell}}
	519	{{/layout-section}}
51.1	520
70.1	521	{{layout-section ac:type="single"}}
	522	{{layout-cell}}
	523
	524	{{/layout-cell}}
	525	{{/layout-section}}
51.1	526
70.1	527	{{layout-section ac:type="single"}}
	528	{{layout-cell}}
	529	=== Controlling visibility and access based on test output variables (ONYX) ===
51.1	530
70.1	531	If global test variables are used in a test course element, they can also be used to control visibility and access.
	532
51.1	533	{{info}}
70.1	534	The available test variables can be viewed in the corresponding test course element in the Test configuration tab via the Output variables of this resource link. In addition to visibility and access rules (expert syntax), they can also be used as [[placeholders in certificate templates>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Bewertung.Zertifikate.WebHome]].
51.1	535
70.1	536	[[image:attach:Kurseditor - Ausgabevariablen_de.png]]
51.1	537	{{/info}}
	538
	539	(% class="wrapped" %)
	540	\|(((
70.1	541	The course element is visible if the user has reached a value greater than 10 for the test variable "S1_max" in the indicated test course element (course element ID "69742969114730").
51.1	542	)))\|(((
	543	(% class="content-wrapper" %)
	544	(((
70.1	545	Enter the following on the Visibility tab:
49.1	546
	547	{{code language="text"}}
51.1	548	getOnyxTestOutcome("84692289655276","S1_max") > 10
49.1	549	{{/code}}
	550	)))
	551	)))
70.1	552	\|(((
	553	The course element is visible if the user has exactly the value "Wiederholen" for the test variable “feedbackE" in the indicated test course element (course element ID "69742969114730").
	554	)))\|(((
51.1	555	(% class="content-wrapper" %)
	556	(((
70.1	557	Enter the following on the Visibility tab:
51.1	558
	559	{{code language="text"}}
	560	getOnyxTestOutcome("84692289655276","feedbackE")="Wiederholen"
	561	{{/code}}
	562	)))
	563	)))
70.1	564	{{/layout-cell}}
	565	{{/layout-section}}
51.1	566
70.1	567	{{layout-section ac:type="single"}}
	568	{{layout-cell}}
	569
	570	{{/layout-cell}}
	571	{{/layout-section}}
51.1	572
70.1	573	{{layout-section ac:type="single"}}
	574	{{layout-cell}}
	575	=== Set scoring or passing status automatically ===
	576
51.1	577	{{info}}
70.1	578	These rules can be set in a structure course element in the Assessment tab in the respective input field.
51.1	579
70.1	580	[[image:attach:Kurseditor - Expertenregeln zur Bewertung_de.png]]
51.1	581	{{/info}}
	582
	583	(% class="wrapped" %)
70.1	584	\|(((
	585	Automatic scoring:
49.1	586
70.1	587	10 points should automatically be awarded for a structure course element if one of three test course elements (course element IDs "69742969114730", "69742969115733" or "69742969118009") has been passed. If this is not the case, 0 points should automatically be set for the structure course element.
	588	)))\|(((
49.1	589	(% class="content-wrapper" %)
	590	(((
70.1	591	This rule is set in the Process points section.
49.1	592
	593	{{code language="text"}}
51.1	594	getPassed("69742969114730") or getPassed("69742969115733") or getPassed("69742969118009")) * 10
49.1	595	{{/code}}
	596	)))
	597	)))
70.1	598	\|(((
	599	Set passing status automatically:
51.1	600
70.1	601	A structure course element should automatically be displayed as passed if a total of at least 140 points has been reached in all test course elements (course element IDs "69742969114730", "69742969115733" or "69742969118009") together or if a "passed" was manually set for the assessment course element (ID "69978845384688").
	602	)))\|(((
49.1	603	(% class="content-wrapper" %)
	604	(((
70.1	605	This rule is set in the Passed if section.
49.1	606
	607	{{code language="text"}}
51.1	608	(getScore("69742969114730") + getScore("69742969115733") + getScore("69742969118009")) >= 140 or getPassed("69978845384688")
49.1	609	{{/code}}
	610	)))
	611	)))
70.1	612	{{/layout-cell}}
	613	{{/layout-section}}
	614	{{/layout}}

Wiki source code of Expertenregeln Beispiele

Search

OPALGlobal

OPALMenü

Recently Visited