# Anforderungen der Universität Bern an Tobira

Die Anforderungen gelten _bis 1. August 2022_.
Anforderungen, die hier als unwichtig gekennzeichnet werden, _können_ danach wichtig werden.

## Übersicht

- Es gibt zwei Publikations-Szenarien zu Tobira (siehe Beschreibungen unten):
- Aus dem Admin-Interface von Opencast
- Aus ILIAS heraus
- Eine Bearbeitung/Verwaltung von Inhalten auf Tobira selber ist nicht wichtig
- Eine Strukturierung des Portals ist erst einmal nicht wichtig.
- Anforderung zu klären: Gibt es an der Uni Bern im Herbst überhaupt einen Login auf Tobira?

## Publikation aus dem Admin-Interface von Opencast

> Ⓘ Diese Anforderung überschneidet sich mit den Anforderungen der ETH.

Nutzer können beim Anlegen von Serien auswählen, wo diese in Tobira angezeigt werden. Dabei wird ihnen die Struktur von Tobira präsentiert und sie haben die Möglichkeiten eine bestehende Seite auszuwählen, oder eine neue Unterseite in der Struktur von Tobira zu erstellen.

### Ablauf

Bestehende Seite auswählen:

- Nutzer klickt auf „Add Series“
- Nutzer durchläuft „Metadata“ und „Access Policy“ im Wizard
- Nutzer landet auf dem Reiter „Videoportal“ im Wizard
- Es wird die Baumstruktur von Tobira angezeigt
- Nutzer klickt Seite an
- Nutzer fährt im Wizard fort und schließt das Erstellen der Serie ab
- In Tobira…
- Wurde ein Serienblock im Standardlayout am Ende der selektierten Seite eingefügt
- Alle in die Serie publizierten Videos landen in diesem Serienblock

Neue Seite erstellen:

- Nutzer klickt auf „Add Series“
- Nutzer durchläuft „Metadata“ und „Access Policy“ im Wizard
- Nutzer landet auf dem Reiter „Videoportal“ im Wizard
- Es wird die Baumstruktur von Tobira angezeigt
- Nutzer klickt Seite an
- Nutzer wählt „Unterseite erstellen“
- Es wird nach Name und URL-Part gefragt
- Neue Seite erscheint in der Baumstruktur und ist selektiert
- Sie existiert noch nicht in Tobira
- Nutzer fährt im Wizard fort und schließt das Erstellen der Serie ab
- In Tobira…
- Wurde eine neue Unterseite angelegt
- Wurde ein Serienblock auf der neuen Seite eingefügt
- Alle in die Serie publizierten Videos landen in diesem Serienblock

Notizen:
- Wenn normale Nutzer (Professoren, ...) auf die Admin-UI dürfen, ist es natürlich fraglich, wer wo neue Seiten anlegen kann. Uni Bern lässt durchaus Profs auf Admin-UI. Aber das Problem muss nicht gelöst werden bis Herbst.

### Technische Notizen

- Admin-Oberfläche anpassen
- Optional mit Tobira-Modul koppeln
- Tobira-Modul braucht Zugriff auf Realm-Struktur
- Auslesen
- Realm hinzufügen
- Block einfügen

## Publikation aus ILIAS heraus

> Anforderung einzig der Universität Bern.
> Hier gibt es technisch noch einiges zu klären.

Nutzer sollen in ILIAS auswählen können, dass Serien zu Tobira publiziert werden. Die Option dazu ist (beziehungsweise ersetzt) [die aktuelle Option zur Publikation auf SWITCHtube (siehe Seite 6)](https://ilias.unibe.ch/goto_ilias3_unibe_file_698954_download.html). Serien werden jeweils auf einer eigenen Seite in Tobira eingebunden. Alle Videos, die dieser Serie zugeordnet werden, erscheinen dann auf der Seite in Tobira.

### Annahmen

> __⚠ Die Annahmen scheinen nicht korrekt zu sein!__

Es ist unklar, was die Funktion „Serie auf SWITCHtube“ genau macht. Wir gehen von folgender Annahme aus:

- _(entweder)_ Ist die Option selektiert, wird ein besonderer Workflow zur Verarbeitung von Events gestartet.
- _(oder)_ Ist die Option selektiert, wird dem Workflow zur Verarbeitung von Events ein besonderer Parameter mitgegeben.

### Ablauf

Serie bearbeiten in ILIAS

- Nutzer bearbeitet Serie in ILIAS
- Nutzer selektiert „Serie auf SWITCHtube“ publizieren
- In Opencast und Tobira geschieht nichts

Video publizieren

- Nutzer bearbeitet Serie in ILIAS
- Nutzer selektiert „Serie auf SWITCHtube“ publizieren
- Nutzer publiziert Video in Serie
- Eine neue Seite mit dem Serientitel erscheint auf Tobira
- Auf der Seite ist ein Serienblock

### Anforderungen/Beschreibung von David

- Bleibt einfach eine checkbox "Series auf Tobira publizieren"
- Dann suboptionen für 5 visibilities (öffentlich, federation, organisation, privat, öffentlich (versteckt))
- Ilias setzt dann passende ACL templates in OC, sonst ACL template "learning management system"
- Ohne neue publikation
- 2/3 Minuten warten
- Link zu Switchcast wird in Ilias angezeigt
- Soll auch für Tobira funktionieren
- Link wird direkt von Ilias erzeugt (stem + serienid), führt dann erstmal zu 404 bis es gesynct ist
- Irgendwo in der Admin UI soll auch so ein Link sein
- In Switchtube findet man es:
- Über Suche
- oder eine Seite mit allen von ilias publizierten seiten (aber das ist "doof")
- in Tobira muss es erstmal nicht in Navigation auftauchen, also nur suche und direktlink
- Langfristig
- in Ilias ähnliche UI wie in Admin-UI: Seiten auswählen und erstellen

### Einschränkungen

- Serie taucht erst in Tobira auf, _nachdem_ das erste Event publiziert wurde
- Änderungen der Publikation werden nur wirksam, wenn ein Workflow in der Serie gestartet wird

### Technische Notizen

- ⚠ Wird irgendwie funktionieren, ist so aber kaum erweiterbar.
- ILIAS sollte langfristig Serien direkt in Tobira einhängen
- Das ist unsere Lösung, um ILIAS nicht anpassen zu müssen
- Workflow Operation zum Publizieren
- Legt auf Tobira eine Seite mit Serientitel an
- Fügt einen Serienblock in die neue Seite ein

## Offene Fragen

- Was genau beeinflusst die Option „Serie auf SWITCHtube“ alles? Ändert sie nur den Verarbeitungsworflow? Oder teile ILIAS noch an irgendeiner anderen Stelle etwas davon mit?
- Eventuell ACL?
- Publikation? Wo kommen die Daten für ILIAS her?
- Wo ist der Code des ILIAS-Plugins von Bern?
- Ist das https://github.com/fluxapps/OpenCast
- Gibt es da ein Bern-Branch?

### Rechtemanagement

- NICHT: "alle die in diesem Ilias Kurs sind, können das sehen"
- Feingranulare nur unter Ilias. Tobira nur wenn ich die Usergruppe öffnen möchte