Data and parameter transfer via LTI

Version 11.2 by Anna Paul-Hasenfuss on 14.02.2026
Warning: For security reasons, the document is displayed in restricted mode as it is not the current version. There may be differences and errors due to this.

Whenever external learning content is integrated into a course via the LTI tool course element, the learning platform transfers information to the external tool when the LTI link is used. This data transfer enables the tool to clearly identify the course, the participant and the respective situation of use.

This page explains the available data groups, shows typical application examples, and provides basic information. For step-by-step examples on how to configure the course editor, please refer to the page Parameter (LTI)

Information

Exact data transfer depends on the LTI settings in the course and the requirements of the integrated tool.

The following data groups can be distinguished for transmission:

Failed to execute the [velocity] macro. Cause: [The execution of the [velocity] script macro is not allowed in [xwiki:LMS.Benutzerhandbuch OPAL.Lehren.Kursbausteine.LTI-Tool.Daten- und Parameterübertragung über LTI.WebHome]. Check the rights of its last author or the parameters if it's rendered from another script.]. Click on this message for details.

Anonymous context information

This data is necessary in order for the tool to know how to display content and interpret access rights correctly. It is always transferred and enables the external tool to place the request in the correct context - without any personal data of the participants.

Examples of anonymous context information

Course context:

User context:

  • Information about the user who accessed the tool.
  • This means that an anonymous user ID and the user role are transferred. The user ID allows for the clear allocation of assessment data that is returned by the tool to the learning platform.
  • Learn more on user context and user roles in LTI at https://www.imsglobal.org/spec/lti/v1p3#users-and-roles
Information

Transferring the user role affects how content is displayed when the course element is accessed in the course view. The ‘Instructor’ role is transferred for course owners, and the “Learner” role is transferred for learners. When accessed from the learner view, the ‘Learner’ role is always transferred.

Find more information at https://www.imsglobal.org/spec/lti/v1p3/#lis-vocabulary-for-institution-roles

Optionale Nutzerinformationen

Neben den anonymen Kontextdaten können auf Wunsch auch personenbezogene Informationen an das externe Tool übermittelt werden. Diese Optionen lassen sich im Kurseditor aktivieren. Sie werden z. B. benötigt, wenn das externe Tool persönliche Lernstände speichert oder namentliche Rückmeldungen gibt. 

  • Vorname
  • Nachname
  • E-Mail-Adresse
Warning

Wichtig: Die teilnehmende Person muss aktiv der Übertragung dieser Daten zustimmen, bevor sie das Tool nutzen kann.

Information

Werden vom Tool Bewertungsdaten an die Lernplattform OPAL zurückgegeben und ausschließlich in der Lernplattform verwaltet, ist eine Übertragung von personenbezogenen Daten an das LTI-Tool NICHT notwendig. Hierzu sind die anonymen Kontextinformationen ausreichend.

Feste Key-Value-Werte

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.

Typische Einsatzmöglichkeiten:

  • Übertragung einer Inhalts-ID oder Aufgabenkennung, damit das externe Tool den richtigen Inhalt anzeigen kann
  • Übermittlung eines Zugriffscodes für spezielle Inhalte
  • Definition eines Modus (z. B. „Übung“ oder „Prüfung“)

Diese Werte sind nützlich, um das Verhalten des Tools für einen bestimmten Kursabschnitt zu steuern.

Nutzerabhängige Key-Value-Werte

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.

Beispiele für nutzerabhängige Werte:

  • Nutzerattribute, wie Studiengang
  • Nutzereinstellung, wie die eingestellte Systemsprache
  • Zugehörigkeit zu einer bestimmten Lerngruppe
  • Punktzahl oder Bewertung in einem vorherigen Kursabschnitt
  • Lernfortschritt oder Bearbeitungsstatus

 Konkrete Beispiele für die Konfiguration im Kurseditor finden Sie auf der Seite Parameter.

Warning

Wichtig: Die teilnehmende Person muss aktiv der Übertragung dieser Daten zustimmen, bevor sie das Tool nutzen kann.

Zusammenfassung

DatengruppePersonenbezugKonfigurationZustimmung notwendigBeispiel
Anonyme KontextinformationenNeinautomatischNeinKurs- und Nutzerkontext, Rolle
Optionale NutzerinformationenJaKurseditorJaVor- und Nachname, E-Mail-Adresse
Feste Key-Value-WerteNeinKurseditorNeinbeispielsweise Inhalts-ID, Sprache
Nutzerabhängige Key-Value-WerteJaKurseditorJabeispielsweise Nutzerattribut, Fortschritt, Bewertung

Für technische Prüfungen übertragener Daten eignet sich die Anbindung eines IMS Testtools. Weitere Informationen zur Erstellung und Konfiguration bietet die Seite https://lti-ri.imsglobal.org/lti/tools.