PORTAL und PPS Knowledge Base
Download (einzelnen Beitrag inkl. Inhaltsbilder herunterladen)
Die Funktion Download (einzelner Beitrag) ermöglicht berechtigten Benutzer:innen, einen Beitrag im PORTAL zu exportieren und als ZIP-Datei herunterzuladen. Die Generierung des Downloads wird vom Export-Logging erfasst.
Die generierte ZIP-Datei ist im Benutzermenü unter "Meine Downloads" für 24 Stunden zu finden und kann dort mit einem Klick heruntergeladen werden.
Funktionalitäten des Downloads einzelner Beiträge inkl. Inhaltsbilder
Export eines Beitrags als TXT-Datei
Export einzelner Bilder inkl. zugehörigen Bild-Metadaten, welche an einem Beitrag hängen
Inhaltsverzeichnis
Allgemeine Beschreibung
Bei der Download-Funktion einzelner Beiträge inkl. Inhaltsbilder handelt es sich um eine Adminfunktion, die allen Benutzer:innen mit der Berechtigungsrolle Export-Funktionen (unter Datenaustausch-Modul) für Beiträge zur Verfügung steht, für welche sie Bearbeitungsrechte haben.
Über “Exportieren” im Kontextmenü eines Beitrags kann ein Beitrag im PORTAL exportiert und als ZIP-Datei heruntergeladen werden. Die Generierung des Downloads wird vom Export-Logging erfasst.
In der ZIP-Datei enthalten ist der Text als TXT-Datei sowie optional die Bilder in NATIVE-Auflösung und deren Meta-Daten (ebenfalls als TXT). TXT-Dateien können von jedem Textverarbeitungsprogramm oder Texteditor (z. B. Microsoft Word, Google Docs, Wordpad) geöffnet und angezeigt werden. Auch die gängigen Browser (z. B. Firefox, Google Chrome) sind in der Lage TXT-Dateien anzuzeigen.
Die generierte ZIP-Datei ist im Benutzermenü unter "Meine Downloads" für 24 Stunden zu finden und kann dort mit einem Klick heruntergeladen werden.
Austauschformat & Datenstrukturen
Der Beitrag, die ggf. ausgewählten Beitragsbilder, die dazugehörigen Bild-Metadaten sowie die Informationen verknüpfter Medienstreams werden gemeinsam in eine Zip-Datei verpackt. Beitrag, Medienstream-Informationen und Bild-Metadaten werden als separate TXT-Dateien ausgeben. Bei den Bildern wird das NATIVE-Format exportiert.
Die Zip-Datei ist immer nach folgendem Muster benannt: article_download_[ID des Beitrags auf dem PORTAL].zip
, z. B. article_download_58017.zip
.
Bild-Dateien im NATIVE-Format
Für die ausgewählten Bilder werden die hinterlegten NATIVE-Auflösungen verpackt. Die Bilder selbst werden mit ihrer ID benannt, z. B. 89418.jpg
.
Bild-Metadaten als TXT-Datei
Für jedes ausgewählte Bild werden die dazugehörigen Metadaten in eine eigene TXT-Datei verpackt. Die Dateien sind immer nach dem folgenden Muster benannt: [Bild-ID]_meta.txt, z. B 89418_meta.txt
.
Bei den Bild-Metadaten werden “hochgeladen von”, der Vermerk auf Urheber:in sowie die Bildunterschrift ausgegeben. Der Aufbau des TXTs ist folgender:
user: [hochgeladen von; entspricht dem bzw. der PORTAL-Benutzer:in, welche:r das Bild hochgeladen hat]
copyright: [Vermerk auf Urheber:in]
[Bildunterschrift]
Medienstream-Informationen als TXT-Datei
Für jeden verknüpften Medienstream werden die dazugehörigen Informationen in eine eigene TXT-Datei verpackt. Die Dateien sind immer nach dem folgenden Muster benannt: streaming_media_[ID des Medienstreams].txt
, z. B. streaming_media_196.txt
.
Bei den Informationen werden der bzw. die Ersteller:in des Medienstreams, die URL zum externen Medienstream-Hoster, der Medienstream-Typ, der Titel des Medienstreams und - soweit angegeben - der Vermerk auf den bzw. die Urheber:in sowie die Beschreibung des Medienstreams ausgegeben.
Der Aufbau des TXTs ist folgender:
user: [PORTAL-Benutzer:in, welche:r den Medienstream erstellt hat]
url: [URL zum externen Medienstream-Hoster]
type: [Medienstream-Typ: video | audio]
title: [Titel des Medienstreams]
copyright: [Vermerk auf Urheber:in]
[description = Beschreibung des Medienstreams]
Optionale Informationen (copyright
, description
) werden weggelassen, sofern sie nicht ausgefüllt sind. Hier kann ein Beispiel einer TXT-Datei angesehen werden:
user: Franziska Renner
url: https://www.youtube.com/watch?v=0Lbfuv6Ji_k
type: video
title: Visit Jotunheimen - The Northern Playground - Jotunheimen 4K
copyright: Visit Jotunheimen
Jotunheimen ist ein Eldorado für Naturerlebnisse. Der Nationalpark beherbergt Norwegens beide höchsten Berge; Galdhøpiggen und Glittertind sowie eine der beliebtesten Wanderungen Norwegens – der Besseggen-Grat.
Beitrag als TXT-Datei
Der Beitrag beinhaltet den bzw. die Autor:in des Beitrags, die Dachzeile, die Überschrift und den Text und wird als separate TXT-Datei in die ZIP-Datei verpackt. Die Datei hat folgenden Namen: article_[ID des Beitrags auf dem PORTAL].txt
, z. B. article_58017.txt
.
Der Aufbau des TXTs ist immer gleich:
Beispiel einer Beitrag-TXT-Datei:
Hinweise zur Ausgabe der eingegebenen Textformatierungen und Einbettungen
Beim Speichern eines Inhalts wird dessen Text konvertiert und in der Datenbank abgelegt.
Die vom Editor unterstützten Textformatierungen (z. B. Zwischenüberschrift, Fett, Kursiv, etc.) werden in HTML-Tags konvertiert.
Bei Einbettungen (Embeds) von internen Elementen (z. B. Aktionen (Mitmachaktionen), eingebetteten Codes) sowie bei Einbettungen von externen Diensten (z. B. Social-Media-, Video- & Karten-Embeds) wird entweder
der eingegebene BBCode als Platzhalter beibehalten oder
ein HTML-Platzhalter (
<div>
) generiert.
→ Das führt dazu, dass bei verschiedenen Export-Workflows eine Mischung aus HTML-Tags, HTML-Platzhaltern (<div>
) und BBCode-Platzhaltern ausgegeben wird.
Für weitere Infos siehe Ablage des BBCode-Textes in der Datenbank.
Workflow
Über “Exportieren” im Kontextmenü eines Beitrags kann die Option “Download” ausgewählt werden:
Falls es sich um einen Beitrag ohne Bilder handelt, gibt es keine weiteren Auswahlmöglichkeiten und der Beitrag kann direkt exportiert werden:
Falls der Beitrag über Bilder verfügt, öffnet die Auswahl der Export-Funktion “Download” ein Accordion, welches die Anzahl der zum Download ausgewählten Bilder anzeigt. Sofern keine Auswahl getroffen wurde, sind alle Bilder des Beitrags für den Download selektiert.
Mit Anwahl des Toggles können nur bestimmte Bilder für den Download selektiert werden:
Sofern keine Bilder ausgewählt werden, wird nur der Beitragstext exportiert.
Mit Klick auf den Button “Exportieren” werden Beitrag und ggf. ausgewählte Bilder zu einer Zip-Datei verpackt. Der bzw. die Benutzer:in erhält eine Erfolgsmeldung mit direktem Link zu seinen bzw. ihren Downloads.
Der Anstoß des Downloads wird zudem vom Export-Logging geloggt und in der Export-Historie als “Download” angezeigt.
Über das Benutzermenü gelangt der bzw. die Benutzer:in auf seine bzw. ihre Downloads. Dort steht die ZIP-Datei für 24 Stunden zum Download zur Verfügung. Das URL-Muster für den Download-Trigger lautet /download/get/[ID]
.
Verwandte Seiten
Nur für PEIQ-Mitarbeiter:innen
https://peiq.atlassian.net/wiki/x/Z4F1L