Wiki source code of Daten- und Parameterübertragung über LTI
Last modified by Carina Enke on 09.01.2026
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{section}} | ||
| 2 | {{column width="60%"}} | ||
| 3 | Wird ein externer Lerninhalt über den Kursbaustein **LTI Tool** in einen Kurs eingebunden, übermittelt die Lernplattform beim Aufruf der LTI-Verknüpfung Informationen an das externe Tool. Diese Datenübertragung ermöglicht dem Tool, den Kurs, die teilnehmende Person und die jeweilige Nutzungssituation eindeutig zuzuordnen. | ||
| 4 | |||
| 5 | Die vorliegende Seite gibt Ihnen einen Überblick der verschiedenen Datengruppen und allgemeine Anwendungsbeispiele und Hinweise. Einen Einblick in die Konfiguration im Kurseditor anhand konkreter Beispiele bietet die Seite **[[Paramter (LTI)>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Kursbausteine.LTI-Tool.KB LTI Konfiguration allgemein.Parameter.WebHome]]. ** | ||
| 6 | |||
| 7 | {{info}} | ||
| 8 | Die genaue Datenübertragung richtet sich nach den LTI-Einstellungen im Kurs und den Anforderungen des eingebundenen Tools. | ||
| 9 | {{/info}} | ||
| 10 | {{/column}} | ||
| 11 | |||
| 12 | {{column width="30%"}} | ||
| 13 | {{panel title="Inhalt"}} | ||
| 14 | {{toc start="2" depth="2"/}} | ||
| 15 | {{/panel}} | ||
| 16 | {{/column}} | ||
| 17 | {{/section}} | ||
| 18 | |||
| 19 | |||
| 20 | Folgende Datengruppen lassen sind für die Übermittung unterscheiden: | ||
| 21 | |||
| 22 | {{velocity}} | ||
| 23 | |||
| 24 | {{toc start="2" depth="2"/}} | ||
| 25 | |||
| 26 | {{/velocity}} | ||
| 27 | |||
| 28 | |||
| 29 | == Anonyme Kontextinformationen == | ||
| 30 | |||
| 31 | Diese Informationen sind notwendig, damit das Tool weiß, wie es Inhalte anzeigen und Zugriffsrechte richtig interpretieren soll. Sie werden **immer übertragen** und ermöglichen es dem externen Tool, den Aufruf in den richtigen Kontext einzuordnen – ohne persönliche Daten der Teilnehmenden. | ||
| 32 | |||
| 33 | **Beispiele für anonyme Kontextinformationen** | ||
| 34 | |||
| 35 | **Kurskontext** | ||
| 36 | |||
| 37 | * Information zum Kurs und dem Kursbaustein, aus dem das Tool aufgerufen wurde. | ||
| 38 | * Konkret wird eine Kombination aus Kurs- und Kursbaustein-ID, sowie der Kurstitel übertragen. | ||
| 39 | * Mehr zum Kurskontext in LTI > [[https:~~/~~/www.imsglobal.org/spec/lti/v1p3#contexts-and-resources>>url:https://www.imsglobal.org/spec/lti/v1p3#contexts-and-resources]] | ||
| 40 | |||
| 41 | **Nutzerkontext**: | ||
| 42 | |||
| 43 | * Information zu Nutzer, von dem das Tool aufgerufen wurde. | ||
| 44 | * Konkret wird eine anonyme Nutzer-ID, sowie die Nutzerrolle übertragen. Die Nutzer-ID ermöglicht auch die eindeutige Zuordnung von Bewertungsdaten, die vom Tool an die Lernplattform zurückgegeben werden. | ||
| 45 | * | ||
| 46 | * Weitere allgemeine Informationen zu Nutzerkontext und Nutzerrolle in LTI bietet die Seite [[https:~~/~~/www.imsglobal.org/spec/lti/v1p3#users-and-roles>>url:https://www.imsglobal.org/spec/lti/v1p3#users-and-roles]] | ||
| 47 | |||
| 48 | {{info}} | ||
| 49 | Die Übergabe der Nutzerrolle hat Auswirkungen auf die Anzeige des Inhalts bei Aufruf des Kursbausteins in der Kursansicht. Für Kursverantwortliche wird die Rolle "Instruktor" übergeben, für den Aufruf durch Lernende die Rolle "Learner". Beim Aufruf über die Lernendensicht wird immer die Rolle "Learner" übergeben. | ||
| 50 | |||
| 51 | Weitere Informationen bieten die Seiten [[https:~~/~~/www.imsglobal.org/spec/lti/v1p3/#lis-vocabulary-for-institution-roles>>url:https://www.imsglobal.org/spec/lti/v1p3/#lis-vocabulary-for-institution-roles]] | ||
| 52 | {{/info}} | ||
| 53 | |||
| 54 | |||
| 55 | |||
| 56 | == Optionale Nutzerinformationen == | ||
| 57 | |||
| 58 | Neben den anonymen Kontextdaten können auf Wunsch auch personenbezogene Informationen an das externe Tool übermittelt werden. Diese Option lässt sich im Kurseditor aktivieren. Sie werden z. B. benötigt, wenn das externe Tool persönliche Lernstände speichert oder namentliche Rückmeldungen gibt. | ||
| 59 | |||
| 60 | * Vorname | ||
| 61 | * Nachname | ||
| 62 | * E-Mail-Adresse | ||
| 63 | |||
| 64 | {{warning}} | ||
| 65 | **Wichtig:** Die teilnehmende Person muss aktiv der Übertragung dieser Daten zustimmen, bevor sie das Tool nutzen kann. | ||
| 66 | {{/warning}} | ||
| 67 | |||
| 68 | {{info}} | ||
| 69 | Werden vom Tool Bewertungsdaten an die Lernplattform OPAL zurückgegeben und ausschließlich in der Lernplattform verwaltet, ist eine Übertragung von personenbezogenen an das LTI Tool NICHT notwendig. Hierzu sind die anonymen Kontextinformationen ausreichend. | ||
| 70 | {{/info}} | ||
| 71 | |||
| 72 | |||
| 73 | |||
| 74 | == Feste Key-Value-Werte == | ||
| 75 | |||
| 76 | Feste Key-Value-Werte sind **benutzerunabhängige Parameter,** die im Kurseditor manuell festgelegt werden können. Sie werden bei jedem Aufruf des Tools mitgesendet und sind immer gleich – unabhängig von der Person, die den Link öffnet. | ||
| 77 | |||
| 78 | **Typische Einsatzmöglichkeiten:** | ||
| 79 | |||
| 80 | * Übertragung einer Inhalts-ID oder Aufgabenkennung, damit das externe Tool den richtigen Inhalt anzeigen kann | ||
| 81 | * Übermittlung eines Zugriffscodes für spezielle Inhalte | ||
| 82 | * Definition eines Modus (z. B. „Übung“ oder „Prüfung“) | ||
| 83 | |||
| 84 | Diese Werte sind nützlich, um das Verhalten des Tools für einen bestimmten Kursabschnitt zu steuern. | ||
| 85 | |||
| 86 | |||
| 87 | |||
| 88 | == Nutzerabhängige Key-Value-Werte == | ||
| 89 | |||
| 90 | Diese Werte können ebenfalls im Kurseditor definiert werden, unterscheiden sich aber dadurch, dass sie** personenabhängig** sind. Sie ermöglichen, dass **individuelle Kursdaten an das Tool übermittelt** werden – zum Beispiel, um persönliche Nutzerattribute, Bewertungen anderer Bausteine oder aktuelle Fortschrittsinformationen zu übergeben. | ||
| 91 | |||
| 92 | **Beispiele für nutzerabhängige Werte:** | ||
| 93 | |||
| 94 | * Nutzerattribute, wie Studiengang | ||
| 95 | * Nutzereinstellung, wie die eingestellte Systemsprache | ||
| 96 | * Zugehörigkeit zu einer bestimmten Lerngruppe | ||
| 97 | * Punktzahl oder Bewertung in einem vorherigen Kursabschnitt | ||
| 98 | * Lernfortschritt oder Bearbeitungsstatus | ||
| 99 | |||
| 100 | Konkrete Beispiele für die Konfiguration im Kurseditor finden Sie auf der Seite [[Parameter>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Kursbausteine.LTI-Tool.KB LTI Konfiguration allgemein.Parameter.WebHome]]. | ||
| 101 | |||
| 102 | {{warning}} | ||
| 103 | **Wichtig:** Die teilnehmende Person muss aktiv der Übertragung dieser Daten zustimmen, bevor sie das Tool nutzen kann. | ||
| 104 | {{/warning}} | ||
| 105 | |||
| 106 | |||
| 107 | === Zusammenfassung === | ||
| 108 | |||
| 109 | |=(% style="width: 252px;" %)Datengruppe|=(% style="width: 144px;" %)Personenbezug|=(% style="width: 138px;" %)Konfiguration|=(% style="width: 196px;" %)Zustimmung notwendig|=(% style="width: 572px;" %)Beispiel | ||
| 110 | |(% style="width:252px" %)**Anonyme Kontextinformationen**|(% style="width:144px" %)Nein|(% style="width:138px" %)automatisch|(% style="width:196px" %)Nein|(% style="width:572px" %)Kurs- und Nutzerkontext, Rolle | ||
| 111 | |(% style="width:252px" %)**Optionale Nutzerinformationen**|(% style="width:144px" %)Ja|(% style="width:138px" %)[[Kurseditor>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Kursbausteine.LTI-Tool.KB LTI Konfiguration allgemein.Parameter.WebHome||anchor="HNutzerdaten"]]|(% style="width:196px" %)Ja|(% style="width:572px" %)Vor- und Nachname, E-Mail-Adresse | ||
| 112 | |(% style="width:252px" %)**Feste Key-Value-Werte**|(% style="width:144px" %)Nein|(% style="width:138px" %)[[Kurseditor>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Kursbausteine.LTI-Tool.KB LTI Konfiguration allgemein.Parameter.WebHome||anchor="HZusE4tzlicheParameter"]]|(% style="width:196px" %)Nein|(% style="width:572px" %)bspw. Inhalts-ID, Sprache | ||
| 113 | |(% style="width:252px" %)**Nutzerabhängige Key-Value-Werte**|(% style="width:144px" %)Ja|(% style="width:138px" %)[[Kurseditor>>doc:LMS.Benutzerhandbuch OPAL.Lehren.Kursbausteine.LTI-Tool.KB LTI Konfiguration allgemein.Parameter.WebHome||anchor="HIndividuelleBewertungs-undNutzerdaten"]]|(% style="width:196px" %)Ja|(% style="width:572px" %)bspw. Nutzerattribut, Fortschritt, Bewertung | ||
| 114 | |||
| 115 | Für technische Prüfungen übertragener Daten eignet die sich Anbindung eines IMS Testtools. Weitere Informationen zur Erstellung und konfiguration bietet die Seite [[https:~~/~~/lti-ri.imsglobal.org/lti/tools>>https://lti-ri.imsglobal.org/lti/tools]] |