Freigeben von Dateien

Das DAM Modul bringt die Möglichkeit mit, Dateien mit Anderen zu teilen, indem man Dateien freigbt. Das wird erreicht, indem man für Dateien, Ordner, Sammlungen, Kategorien etc. eine Freigabe erstellt. Die freigegebenen Inhalte können über eine geschützte Seite im öffentichen Kontext eingesehen und heruntergeladen werden.

Funktionsweise

Freigaben werden durch die Entität mamShare abgebildet. Diese Entität enthält alle nötigen Informationen, um die Inhalte der Freigabe zu steuern und den Zugriff auf die Freigabe zu limitieren. Eine Freigabe referenziert eine freigegebene Entität. Eine freigegebene Entität steuert durch ein Event, welche Dateien freigegeben werden. Beispielsweise gibt ein Ordner Dateien auf Basis dessen Pfades frei. Eine Sammlung hingegen ermittelt die durch sie freigegebene Dateien anhand von Relationen. Entsprechend ist es möglich beliebige Entitäten freizugeben, solange es einen Eventlistener gibt, welcher über das Event mamFile-Datensätze freigibt.

Um die Inhalte der Freigabe abrufen zu können, muss außerdem ein Empfängerdatensatz existieren (mamShareRecipient). Eine Freigabe kann über beliebig viele Empfänger verfügen. Ein solcher Empfängerdatensatz wird durch ein Token identifiziert und verfügt über einen eigenen Zähler, um den Zugriff zur Freigabe zu limitieren. Nur bei gültigem Token und passendem Zähler, ist die Freigabe aufrufbar bzw. die Dateien herunterladbar.

Events

Es existieren mehrere Events um in DAM mit Freigaben zu interagieren. Folgende Events werden beim Erstellen von Freigaben und Empfängern ausgelöst.

Event	Beschreibung

Event	Beschreibung
\Brandbox\DamCore\Ui\Share\lib\event\CreateShare\OnValidateNewShare	Dieses Event wird ausgelöst, um Freigaben zu validieren, die mit dem Formular erstellt werden. Das Event enthält spezifische Daten aus dem Formular, wie zum Beispiel die Informationen zu E-Mails.
\Brandbox\DamCore\Ui\Share\lib\event\CreateShare\OnCollectShareRecipients	Dieses Event wird ausgelöst, um die Empfänger beim Erstellen von Freigaben mit dem Formular zu sammeln. Das Produkt reagiert auf dieses Event fügt die Empfänger aus dem Eingabefeld und aus den Empfängergruppen hinzu.
\Brandbox\DamCore\Ui\Share\lib\event\CreateShare\OnCreatedShare	Dieses Event wird ausgelöst, wenn eine Freigabe erfolgreich erstellt wurde. Das Produkt reagiert auf dieses Event und kümmert sich um den E-Mailversand.
\Brandbox\DamCore\Ui\Share\lib\event\CreateShare\OnCreatedShareRecipient	Dieses Event wird ausgelöst, wenn ein Freigabenempfänger erfolgreich erstellt wurde. Das Produkt reagiert auf dieses Event und kümmert sich um den E-Mailversand.

Die folgenden Events werden beim Interagieren mit der Downloadseite ausgelöst.

Event	Beschreibung

Event	Beschreibung
\Brandbox\DamCore\Dam\Share\lib\event\OnCollectSharedFiles	Dieses Event wird ausgelöst, um die freigegebenen Dateien einer Freigabe zu sammeln. Das Produkt reagiert auf dieses Event, um die Dateien von Ordnern, Freigaben und einzelnen Dateien bereitzustellen. Zur Identifikation können sowohl die Freigabe selbst, als auch die freigegebene Entität genutzt werden.
\Brandbox\DamCore\Dam\Share\lib\event\OnPreShareDownload	Dieses Event wird im Setup der Downloadseite der Freigabe ausgelöst.

Nutzung

Erstellen von Freigaben

Das Produkt erlaubt das Freigeben von einer einer oder mehreren Dateien, Ordnern und Sammlungen. Wie diese Dateien freigegeben werden, wird im Folgenden beschrieben. Entitäten kann man freigeben, indem man zu diesen Entitäten in Base oder DAM navigiert. Die Buttons zum Freigeben von Dateien sind sowohl in den Kontextmenüs, als auch in den Toolbars der entsprechenden Entitäten zu finden. Sobald eine Auswahl getroffen und der Button "Freigeben" geklickt wurde, wird ein Formular geöffnet, in dem man die Freigabe auskonfigurieren kann. Das Formular verfügt über folgende Einstellungsmöglichkeiten.

Feld	Beschreibung

Feld	Beschreibung
Name	Zeichenkette. Name der Freigabe.
Ablaufdatum	Ganzzahl. Ablaufdatum der Freigabe. Dieses Datum beschränkt den Zugriff auf die Freigabe.
Unbegrenzte Gültigkeit	Boolescher Wert. Die Freigabe hat keine zeitliche Gültigkeit, wenn diese Checkbox gewählt wurde.
Maximale Anzahl Seitenaufrufe	Ganzzahl. Die maximale Anzahl der Seitenaufrufe einer Freigabe. Jeder Freigabeempfänger verfügt über einen eigenen Zähler.
Unbegrenzte Anzahl Seitenraufrufe	Boolescher Wert. Die Freigabe hat keine Begrenzung von Seitenaufrufen, wenn diese Checkbox gewählt wurde.
Ordnerstruktur verstecken	Boolescher Wert. Die Dateien der Freigabe werden ohne Stuktur in einer ZIP-Datei abgelegt, wenn mehrere Dateien gleichzeitig heruntergeladen werden.
Original freigeben	Boolescher Wert. Die freigegebenen Dateien können im Originalformat heruntergeladen werden.
Empfänger	Pro Empfänger wird ein Empfänger-Datensatz für die Freigabe erstellt. Es können mehrere E-Mail-Adressen definiert.
Empfängergruppen	Empfängergruppen fassen mehrere Empfänger zusammen. Die Empfänger der Empfängergruppen verhalten sich analog zu den Empfängern aus dem Eingabefeld.
E-Mails versenden	Boolescher Wert. Es wird an jeden Empfänger eine E-Mail versandt. In dieser E-Mail ist der Link zur Freigabe enthalten.
Betreff	Betreff der E-Mail.
Nachricht	Nachricht der E-Mail.
Formate	Die ausgewählten Formatvorlagen werden mit der Freigabe verknüpft. Verknüpfte Formatvorlagen stehen als Optionen beim Download der Freigabe bereit. Die Dateien können entsprechend der Formatvorlage konvertiert und heruntergeladen werden.

Wurde die Freigabe wie gewünscht auskonfiguriert kann die Freigabe über die "Speichern"-Buttons erstellt werden. Freigaben können über die reguläre Tabellenansicht von Base erreicht werden. Im Schnellzugriff von DAM sind weitere Optionen vorhanden, darunter:

Von mir freigegeben
- Stellt alle Freigaben dar, dessen Besitzer der derzeit angemeldeten Nutzer ist.
An mich freigegeben
- Stellt alle Freigaben dar, die Empfänger besitzen, welche die E-Mail Adresse des derzeit angemeldeten Benutzers teilen.

Freigabenempfänger

Die Empfänger einer Freigabe können über "Empfänger"-Buttons im Kontextmenü und in der Toolbar der entsprechenden Freigabe erreicht werden. In der Datensatzliste der Empfänger einer Freigabe können weitere Empfänger für eine Freigabe angelegt werden. Die Funktion "Link generieren", erzeugt einen neuen Empfänger ohne eine E-Mail zu versenden. Die Funktion "Empfänger hinzufügen" erzeugt einen Empfängerdatensatz und versendet eine E-Mail.

Download der Freigabe

Die Downloadseite der Freigabe kann auf zwei Wegen erreicht werden. Eine Option ist es, den Freigabelink aus der Freigabemail zu nutzen. Die zweite Option ist es den Freigabelink beim Empfängerdatensatz abzurufen. Der Freigabelink kann über den Button "Link zur Freigabe" im Kontextmenü oder in der Toolbar eines Empfängerdatensatzes abgerufen werden. Wird der Link zur Freigabe aufgerufen, wird die Downloadseite mit den freigegebenen Dateien dargestellt. Die Freigabe und die einzelnen Dateien sind (je nach Konfiguration) im Originalformat und in bestimmten Formaten herunterladbar. Über das Dropdown im Kopfbereich der Downloadseite lässt sich die gesamte Freigabe herunterladen. Wird die gesamte Freigabe heruntergeladen, wir die Freigabe in einem ZIP-Archiv verpackt und bereitgestellt.

Konfiguration

Freigaben verfügen über eine dedizierte Konfigurationstabelle, in der Einstellungen für alle Freigaben vorgenommen werden können. Die Einstellungsmöglichkeiten werden im Folgenden beschrieben.
Es kann ein benutzerdefiniertes Hintergrundbild über den Konfigurations-Datensatz "Landingpage" hinterlegt werden.

Feld	Bescheibung

Feld	Bescheibung
Sicherheitsstufe	Auswahlfeld. Die Sicherheitsstufe bestimmt die Komplexität des Tokens, mit dem die Freigabe validiert wird.
Vorschaulose Ansicht (Schwellwert)	Ganzzahl. Dieser Wert definiert, ob auf der Freigabenseite Vorschaubilder für Dateien dargestellt werden. 0 bedeutet, dass Vorschaubilder immer dargestellt werden. Es sollte ein Schwellwert eingerichtet werden, wenn mit großen Freigaben hantiert wird.