Wiki source code of 04 Parameter (LTI)

Version 18.1 by Carina Enke on 09.01.2026

Show last authors
1 {{section}}
2 {{column width="60%"}}
3 Beim Aufruf einer LTI-Verknüpfung überträgt die Lernplattform OPAL bestimmte Informationen an das externe Tool. Diese Datenübermittlung stellt sicher, dass das Tool den Kurs, die teilnehmende Person sowie die jeweilige Nutzungssituation eindeutig zuordnen kann.
4
5 Neben anonymen Kontextinformationen können Sie im Reiter **Parameter **des Kursbausteins LTI Tool festlegen, welche zusätzlichen Informationen an das LTI Tool übermittelt werden.
6 {{/column}}
7
8 {{column width="30%"}}
9 {{panel title="Inhalt"}}
10 {{toc start="2" depth="2"/}}
11 {{/panel}}
12 {{/column}}
13 {{/section}}
14
15 {{info}}
16 Die genaue Datenübertragung richtet sich nach den LTI-Einstellungen im Kurs und den Anforderungen des eingebundenen Tools. Einen allgemeinen Einblick in die Datenübertragung an ein LTI Tool bietet die Seite [[Daten- und Parameterübertragung über LTI>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Kursbausteine.LTI-Tool.Daten- und Parameterübertragung über LTI.WebHome]]
17 {{/info}}
18
19 == Konfiguration im Reiter Parameter ==
20
21 Im Reiter Parameter stehen für die Konfiguration diese Bereiche zur Verfügung:
22
23 |(% style="width:1099px" %)(((
24 ===== **Nutzerdaten (1)** =====
25
26 Aktivieren Sie die Checkboxen der benötigten optionalen Nutzerinformationen.
27
28 Die teilnehmende Person muss aktiv der Übertragung dieser Daten zustimmen, bevor sie das angebundene LTI Tool nutzen kann.
29
30 [[image:Kursrun - Zustimmung zur Datenübertragung_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
31 )))|(% rowspan="2" style="width:447px" %)[[image:Kurseditor - Tab Parameter1_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
32 |(% style="width:1099px" %)(((
33 ===== **Zusätzliche Parameter (2)** =====
34
35 Konfigurieren Sie in diesem Abschnitt **Feste Key-Value-Werte** bspw. Inhalts-ID, Sprache
36 )))
37 |(% style="width:1099px" %)(((
38 ===== **Individuelle Bewertungs- und Nutzerdaten ** =====
39
40 Vergeben Sie in diesem Abschnitt einen eigenen **Parameternamen (3)** und tragen Sie in das Textfeld  die benötigten **nutzerabhängigen Werte **wie Nutzerattribute, Nutzereinstellungen, Bewertungs- oder Fortschrittsdaten **per Expertenregel (4) **ein. Das Ergebnis der eingetragenen Expertenregel wird als String an das LTI Tool übergeben. Eine Testauswertung bietet der Button **Vorschau (5)**
41
42 Die teilnehmende Person muss aktiv der Übertragung dieser Daten zustimmen, bevor sie das angebundene LTI Tool nutzen kann.
43
44 [[image:Kursrun - Zustimmung zur Datenübertragung individueller Parameter_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
45 )))|(% style="width:447px" %)[[image:Kurseditor - Parameter per Expertenregel_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
46
47
48
49 == Beispiele zur Wertekonfiguration ==
50
51 **Key-Value-Werte**.
52
53 Beispielkonfiguration mit einem **festen Key-Value-Paar** aus einer Anbindung eines Programierlerntools. Der übergebene Parameters "task=juice-setvar-interactive" zeigt dem Anwender im Kursrun nur die konkrete Programmieraufgabe.
54
55 {{info}}
56 Welche Key-Value-Parameter übergeben werden können hängt vom angebundenen LTI Tool ab und sollten dort dokumentiert sein.
57 {{/info}}
58
59 [[image:Kurseditor - Beispiel zur für nutzerunabhängige Parameter _de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" height="227" width="348"]] [[image:Kursrun - Parameterabhängiger Inhalt eines LTI Tools _de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
60
61
62 **Nutzerabhängige Key-Value-Werte**
63
64
65 |=(% style="width: 203px;" %)Übergabe von |=(% style="width: 768px;" %)Beispiele|=(% style="width: 443px;" %)allgemeine Expertensyntax|=(% style="width: 909px;" %)Konkretes Beispiel aus einem Testkurs
66 |=(% colspan="1" rowspan="2" style="width: 203px;" %)Nutzerattribute und Nutzereinstellungen |(% style="width:768px" %)Übergabe des Studiengangs|(% colspan="1" rowspan="2" style="width:443px" %)//getUserProperty("[string]")//|(% style="width:909px" %)(((
67 getUserProperty("studySubject")
68 )))
69 |(% style="width:768px" %)Übergabe der eingestellte Systemsprache|(% style="width:909px" %)(((
70 getUserProperty("language")
71 )))
72 |=(% style="width: 203px;" %)Zugehörigkeit zu einer bestimmten Lerngruppe|(% style="width:768px" %)Übergabe der zugehörigkeit zur Lerngruppe "Anfänger"|(% style="width:443px" %)//inLearningGroup("[string]")//|(% style="width:909px" %)inLearningGroup("Anfänger")
73 |=(% style="width: 203px;" %)Bewertungsdaten|(% style="width:768px" %)Punktzahl des Kursabschnitt 1 - Übergabe der Punktzahl eines ONYX Tests|(% style="width:443px" %)//getOnyxTestOutcome("[string1]","[string2]")//|(% style="width:909px" %)getOnyxTestOutcome("1670470101589006009","SCORE")
74 |=(% style="width: 203px;" %) |(% style="width:768px" %)Bewertung des  Kursabschnitt 2 - Kursbaustein bestanden|(% style="width:443px" %)//getPassed("[integer]")//|(% style="width:909px" %)getPassed("84389429397045")
75 |=(% style="width: 203px;" %)Lernfortschritt oder Bearbeitungszustand|(% style="width:768px" %)Übergabe der gestarteten Versuche eines Kursbausteins|(% style="width:443px" %)//getAttempts("//[integer]//")//|(% style="width:909px" %)getAttempts("1670470101589006009")
76 |=(% style="width: 203px;" %) |(% style="width:768px" %)Bearbeitungsstand (Kursfortschritt).|(% style="width:443px" %)//getProgress("[integer]")//|(% style="width:909px" %)getProgress("1670470101585115009")
77 |=(% style="width: 203px;" %)Kombination mehrere Informationen|(% style="width:768px" %) |(% style="width:443px" %)//getUserProperty("[string1]") + getUserProperty("[string2]") + getUserProperty("[string]")//|(% style="width:909px" %)getUserProperty("firstName") + getUserProperty("language") +  getUserProperty("studySubject")
78
79 {{info}}
80 Weitere Beispiele für die Erstellung von Expertenregeln finden Sie im Abschnitt [[Anwendungsbeispiele zu Expertenregeln>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Kurs.Freigabe von Kursen und Kursinhalten.Expertenmodus zur Freigabe innerhalb von Kursen.Anwendungsbeispiele zu Expertenregeln.WebHome]] und in der [[Expertensyntax>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Kurs.Freigabe von Kursen und Kursinhalten.Expertenmodus zur Freigabe innerhalb von Kursen.Expertensyntax.WebHome]].
81 {{/info}}
82
83 {{info}}
84 Für die technische Prüfungen der übertragenen Daten eignet sich die Anbindung eines IMS Testtools. Weitere Informationen zur Erstellung und Konfiguration bietet die Seite [[https:~~/~~/lti-ri.imsglobal.org/lti/tools>>url:https://lti-ri.imsglobal.org/lti/tools]]
85 [[image:IMS Testtool - Anzeige der übertragenen Beispielparameter_de.png||data-xwiki-image-style="img-screen" data-xwiki-image-style-border="true" width="500"]]
86 {{/info}}
87
88