übergeordnete ID | [1-14] OUTBOUND Ausgaben mit Seiten, Artikel und Bilder (Content-Syndication und E-Paper) |
|---|---|
Transportverfahren | sFTP (Abruf/Abräumen aus der PEIQ Cloud durch Dritte) |
Objekt | XML, PDF, JPG |
Trigger | Automatisch, Manuell |
Typische Drittsysteme | PMG |
Mit dem vorliegenden Export von Ausgaben, Seiten, Artikel sowie Bildern werden diese zur Abholung durch Dritte in der PEIQ Cloud im sFTP-Bereich (sftp://data.peiq.cloud/…) zur Verfügung gestellt.
Funktionalitäten des Exports von Ausgaben mit Seiten, Artikel und Bilder
Export von Ausgaben inkl. Seiten, Artikel und Bilder
Übertragung via sFTP
Inhaltsverzeichnis
Aufbereitung und Übertragung der Daten
Für den Export von Ausgaben und deren Seiten, Artikel sowie Bilder werden über die hier vorliegende Standard-Schnittstelle Daten auf eine Destination im sFTP-Bereich (sftp://data.peiq.cloud/…) in der PEIQ Cloud exportiert. Diese Daten können von Dritten übernommen bzw. abgeräumt werden. Der Trigger für einen Export der Daten ist gekoppelt an den [E-PaperStatus] {Fertig}.
E-Paper-Produkt
Beim Fertigstufen der Seiten eines redaktionellen Druckprodukts wird automatisch ein “E-Paper-Produkt” angelegt bzw. aktualisiert.
Dieses E-Paper-Produkt enthält die Artikelliste und dient als Grundlage für den Export. Hierüber können in der GUI (Graphical User Interface) die Daten vor dem Export noch einmal betrachtet werden.
Übertragung der Daten
Für jede dieser fertigen E-Paper-Seiten wird ein page-XML übertragen. Dieses enthält die Artikelinhalte, Artikel Bilder (in beschnittener Form, JPG) und Ganzseiten PDFs.
Bei einer Aktualisierung werden erneut die geänderten page-XMLs (inkl. Bilder,PDF) übertragen.
Der Export kann typischerweise neben den Objekten (innerhalb der E-Paper Objekte) auch mit folgenden Parametern (per Ausgabe-Datei) konfiguriert werden:
Id - Enthält die Id der Ausgabe.
Lizenzgeber - Enthält die Id des Verlages.
Quelle - Enthält die Id der Quelle.
Kürzel - Enthält das Kürzel der Ausgabe.
Von/Bis Wochentag - Bestimmt die Wochentage des Exports.
Stunde/Minute - Bestimmt die Uhrzeit des Exports.
Nachliefern - Gibt an ob die Ausgabe Nachlieferungen erhält.
Lieferdateien - Beispiel:
Set 1 = XML, Bilder.
Set 2 = PDF.
Set 3 = XML, Bilder und PDF.
Für Informationen bezüglich der Information die wir von Ihnen benötigen, schauen Sie bitte auf die Mitwirkungspflichten.
Mitwirkungspflicht Einrichtung E-Paper
Default Werte
Falls die Frist für die Belieferung der Mitwirkungen nicht eingehalten wurde, wird PEIQ den Export für ein beliebiges Objekt einrichten. Die Funktionalität der Schnittstelle bleibt dabei garantiert, jedoch ist die nachfolgende Anpassung der Objekte vom Kunden kostenpflichtig zu beantragen.
Aufruf (automatischer (default) oder manueller Trigger)
Standardmäßig wird die Übertragung der Daten automatisiert veranlasst, sobald eine Seite in den E-PaperStatus “Fertig” kommt (unabhängig vom Erscheinungstag). (Derzeit: Die Status für die Erzeugung des E-Papers sind an der Seite (DLayout): Status = Produziert UND E-Paper Status = FuerProduktion)
Ergänzend: Die Übertragung der Daten wird manuell vom E-Paper-Produkt ausgehend a) durch erneutes stufen auf “Produziert” oder b) den Aufruf des Menüpunktes „Exportieren mit allen Seiten“ angestoßen. Diese Übertragung kann mehrfach angestoßen werden, der Zeitpunkt der letzten Übertragung wird unter “ExportZeit” am E-Paper-Produkt vermerkt.
Bei der ersten und auch allen weiteren Übertragungen werden immer alle Daten exportiert.
Content
Die Strukturen der Print-Inhalte und die entsprechende Wandlung in HTML-Tags werden von PEIQ als Defaults festgelegt und in einem separaten Dokument aufgelistet. Sollten neue Tags benötigt werden, müsste PEIQ diese zunächst prüfen und festlegen, ob sie in den Default aufgenommen werden.
Bildbereiche/Geometrie
Im E-Paper-Produkt in NGEN gibt es keine eigenständigen Bildbereiche. Die Bilder werden immer als Bestandteil des Artikels mitgegeben und benötigen daher keine Bildgeometrie. Dementsprechend sind für Bilder keine Koordinaten im XML vorgesehen.
Übertragungsart: sFTP
Der Export der Daten erfolgt auf eine Destination im sFTP-Bereich (sftp://data.peiq.cloud/…) in der PEIQ Cloud. Diese Daten sind dann von Dritten “abzuräumen”.
Namenskonvention
Die Dateien werden immer mit einem Timestamp übergeben. Anhand von diesem kann der zuletzt exportierte Datensatz identifiziert werden.
Timestamp
Der Timestamp ist folgendermaßen aufgebaut:
Monat (2-stellig), Tag (2-stellig), Stunde (2-stellig), Minute (2-stellig), Sekunde (2-stellig), Millisekunde (3-stellig)
Beispiel: "0512174535345"
Bild-Dateien
image_<ID>_<timestamp>.jpg
XML
article_<ID>_<timestamp>.xml
Übertragung der Binärdaten
Beim Export der E-Paper-Produkte werden zunächst die Binärdaten in ein entsprechendes Verzeichnis auf dem sFTP-Server abgelegt. Dies umfasst die Artikellisten und alle enthaltenen Bilder (nur “DBild”, nicht “DLogo”) als jpg.
Übertragung der Metadaten
Im nächsten Schritt werden die Metadaten im gleichen Verzeichnis des sFTP-Servers abgelegt. Die XML-Dateien werden dabei seitenweise geschickt.
Article-XML
Das Wurzelelement der XML-Datei heißt publication. Es folgt der Aufbau der XML-Struktur mit den Attributen und den kundenspezifischen Elementen.
Für die Umwandlung der PEIQ Struktur durch XSLT Stylesheets an Drittanbieter können Sie sich an folgendem Dokument orientieren:
Inhalte der Artikel
metadaten - Enthält Metadaten der Quelle und des Artikels.
artikel-id - Enthält die artikelspezifische ID.
quelle - Enthält Metadaten der Quelle und des Artikels
quelle-id - Enthält die quellenspezifische ID
name - Enthält den Namen der Zeitung.
datum - Enthält das Erscheinungsdatum des Artikels.
inhalt- Enthält den Artikel-Inhalt.
titel-liste - Enthält die Titel-Elemente eines Artikels.
titel - Enthält den Titel des Artikels.
absatz - Enthält Artikel-Text.
bild - Angabe des Dateinamens des mitgelieferten Bildes.
Beispiel eines Article-XML
<?xml version="1.0" encoding="UTF-8"?>
<!-- Der Beispiel Artikel enthält nur die XML-Elemente, die für die korrekte Anlieferung bei einem Artikel mindestens vorhanden sein müssen -->
<artikel-liste xsi:noNamespaceSchemaLocation="pmg-artikel-liste.xsd" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<artikel>
<metadaten>
<artikel-id>u1713875747</artikel-id>
<quelle>
<quelle-id>BSZEI</quelle-id>
<name>Beispiel-Zeitung</name>
<datum>15112016</datum>
</quelle>
</metadaten>
<inhalt>
<titel-liste>
<titel>Artikel-Beispiel 2</titel>
</titel-liste>
<text>
<absatz>Artikeltext</absatz>
<bild>beispielbild.jpg</bild>
</text>
</inhalt>
</artikel>
Optionale, weitergehende Infos (auf Anfrage)
/wiki/spaces/CORE/pages/1155530836