Umgebungen

In OpenVLE bilden Umgebungen die fachliche und organisatorische Grundlage einer Veranstaltung.
Eine Umgebung legt fest, welche VM-Vorlagen verwendet werden und werden in der Regel im Rahmen einer Veranstaltung erstellt und bestimmen, welche Ressourcen den Teilnehmerinnen und Teilnehmern zur Verfügung stehen.

Wo finde ich den Bereich?

Navigation:
Über das Hauptmenü: Veranstaltungen → Umgebungen
Alternativ erreichbar über: Über die Detailansicht einer Veranstaltung verlinkt

Funktionen im Überblick

Anzeigen aller bestehenden Umgebungen einer Veranstaltung
Erstellen neuer Umgebungen mit Kursstruktur und Zuweisung von VM-Vorlagen
Zuweisen von Teilnehmern und Rollen innerhalb einer Umgebung
Verknüpfen von VM-Vorlagen
Bearbeiten oder Löschen bestehender Umgebungen

Wichtige Felder im Überblick

Feldname	Beschreibung
`Beschreibung`	Freitextfeld zur Dokumentation oder Kommentierung der Umgebung.
`Name`	Name der Umgebung. Wird in der gesamten Oberfläche angezeigt und sollte eindeutig sowie aussagekräftig gewählt werden, z. B. „Schulung IT Deutsch 2024“ oder „Modul Informatik 1“.

Erstellen einer Umgebung

Öffne im Hauptmenü den Bereich Umgebungen.
Klicke auf Hinzufügen, um eine neue Umgebungen zu erstellen.
Gib einen Namen und eine Beschreibung für die Umgebung an.
Speichere die Umgebung.
In dem Tab VM-Vorlagen kannst du nun die benötigten VM-Vorlagen zu der Umgebung hinzufügen oder entfernen.
Verwende diese Umgebung, um neue Veranstaltungen vorzubereiten.

Bearbeiten einer Umgebung

Öffne im Hauptmenü den Bereich Umgebungen.
Suche in der Liste nach der gewünschten Umgebung.
Klicke auf Bearbeiten oder öffne das Kontextmenü der Umgebung und wähle Bearbeiten.
Im Formular werden alle aktuellen Daten der Umgebung angezeigt.
Passe die gewünschten Felder an – z. B. Name oder Beschreibung.
Speichere die Änderungen.
In dem Tab VM-Vorlagen kannst du die benötigten VM-Vorlagen zu der Umgebung hinzufügen oder entfernen.

warnung

Änderungen an einer Umgebung (einschließlich der zugewiesenen VM-Vorlagen) wirken sich auf alle geplanten Veranstaltungen aus, die diese Umgebung verwenden. Beim Ausrollen wird die Veranstaltung mit der aktuellen Version der Umgebung bereitgestellt.

Aktive Veranstaltungen sind davon nicht betroffen: Beim Ausrollen wird eine direkte Beziehung zwischen der Veranstaltung und den VM-Vorlagen angelegt, sodass die Veranstaltung ab diesem Zeitpunkt von der Umgebung entkoppelt ist.

Löschen einer Umgebung

Öffne im Hauptmenü den Bereich Umgebungen.
Suche in der Liste nach der gewünschten Umgebung.
Klicke auf Löschen oder öffne das Kontextmenü der Umgebung und wähle Löschen.
Bestätige den Löschvorgang im angezeigten Dialog.
Die Umgebung wird daraufhin dauerhaft entfernt.

gefahr

Eine Umgebung kann erst gelöscht werden, wenn keine zugewiesenen Veranstaltungen mehr existieren.

Beispiel oder Anwendungsfall

Beispiel: Umgebung für einen IT-Grundlagenkurs erstellen

Eine Administratorin möchte eine neue Schulungsumgebung für die Umgebung „IT-Grundlagen“ bereitstellen. Sie erstellt im Bereich Umgebungen eine neue Einheit und weist die VM-Vorlagen für Windows- und Linux-VMs zu. Nach dem Speichern kann die Umgebung in einer neuen Veranstaltung verwendet werden.

Hinweise / Besonderheiten

Umgebungen können mehreren Veranstaltung zugeordnet sein.
Eine Umgebung kann mehrere VM-Vorlagen enthalten.
Änderungen an einer Umgebung wirken sich auf alle geplanten Veranstaltungen aus, die diese Umgebung verwenden. Bereits aktive Veranstaltungen bleiben unverändert, da beim Ausrollen eine direkte Beziehung zwischen Veranstaltung und VM-Vorlagen erstellt wird.
Das Löschen einer Umgebung ist erst möglich wenn keine zugewiesenen Veranstaltungen mehr existieren.
Nur Benutzer mit entsprechenden Berechtigungen dürfen Umgebungen bearbeiten oder löschen.

Beziehungen zu anderen Objekten

Viele Objekte in OpenVLE stehen in Beziehung zu anderen Elementen innerhalb des Systems. Die folgende Übersicht zeigt, welche Verknüpfungen bestehen und ob diese bestimmte Automatisierungen auslösen.

Objekt	Beschreibung	Automatisches Verhalten
Berechtigungen	Objektspezifische Berechtigungen können direkt am Objekt vergeben werden.	Automatisches Entfernen beim Löschen des Objekts.
Changelogs	Alle Änderungen am Objekt werden automatisch protokolliert.	Automatisches Entfernen beim Löschen des Objekts.
Tags	Objekte können mit beliebig vielen Tags versehen werden, um sie zu kategorisieren oder zu filtern.	Automatisches Entfernen beim Löschen des Objekts.
Veranstaltungen	Eine Umgebung kann in beliebig vielen Veranstaltungen zugewiesen werden.	Keine Automatisierungen.
VM-Vorlagen	Einer Umgebung können beliebig viele VM-Vorlagen zugewiesen werden.	Keine Automatisierungen.

Erforderliche Berechtigungen

Die für Aktionen benötigten Berechtigungen können über Rollen oder individuell vergeben werden. Fehlen Ihnen bestimmte Rechte, sind die entsprechenden Funktionen in der Benutzeroberfläche ausgeblendet oder deaktiviert.

Aktion	Benötigte Berechtigung	Pfad
Umgebungen anzeigen	`courses_read`	`/` oder `/<objectID>`
Umgebungen anlegen	`courses_create`	`/`
Umgebungen bearbeiten	`courses_update`	`/` oder `/<objectID>`
Umgebungen löschen	`courses_delete`	`/` oder `/<objectID>`
Veranstaltungen anzeigen	`events_read`	`/` oder `/<objectID>`

info

Die Berechtigungen *_read, *_update und *_delete können auf einen bestimmten Pfad gesetzt werden, also auf die UUID eines Objekts.
Beispiel: /4a3bc312-d1af-4b3f-b222-f5e9cecbf007 – So erhält der Benutzer nur Zugriff auf dieses eine Objekt.
Wird als Pfad / verwendet, gilt die Berechtigung global für alle Objekte dieses Typs.
Für *_create-Berechtigungen ist nur der globale Pfad / zulässig.

Wo finde ich den Bereich?​

Funktionen im Überblick​

Wichtige Felder im Überblick​

Erstellen einer Umgebung​

Bearbeiten einer Umgebung​

Löschen einer Umgebung​

Beispiel oder Anwendungsfall​

Hinweise / Besonderheiten​

Beziehungen zu anderen Objekten​

Erforderliche Berechtigungen​

Verwandte Themen​