Page Comparison

Funktionalitäten des Exports von Ausgaben mit Seiten, Artikel und Bilder

• Export von Ausgaben inkl. Seiten, Artikel und BilderZip-Dateien, die jeweils ein Ausgabe-XML mit zugehörigen Ganzseiten-PDFs und Bildern enthält (keine Übertragung von Updates)

• Übertragung via sFTP

Inhaltsverzeichnis

...

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}ist zeitlich gesteuert.

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 Artikel 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 jedes dieser fertigen E-Paper-Seiten Produkte wird ein pageZIP-XML übertragen. Dieses File übertragen, das ein XML der Ausgabe enthält, sowie die zugehörigen Bilddateien und Ganzseiten-PDFs. Das XML enthält die Artikelinhalte, Artikel Bilder Metadaten und den Verweis auf die Bilddateien (in beschnittener Form, JPG) und die Ganzseiten PDFs.Bei einer Aktualisierung werden erneut die geänderten page

-XMLs (inkl. Bilder,PDF) Updates sind bei dieser Schnittstelle ausgeschlossen und werden nicht übertragen.

Der Export kann typischerweise neben den Objekten (innerhalb der E-Paper Objekte) auch mit folgenden Parametern (per Ausgabe-Datei) konfiguriert werden:

• Artikel-Id - Enthält die Id der Ausgabedes Artikels.

• Lizenzgeber Lieferant - Enthält die Id des VerlagesLieferanten.

• Quelle - Enthält die Id der Quelle.

• Kürzel Erscheinungstag - Enthält das Kürzel den Erscheinungstag 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.

...

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

...

Trigger)

Standardmäßig wird die Die Übertragung der Daten wird automatisiert veranlasst, sobald eine Seite in den E-PaperStatus “Fertig” kommt (unabhängig zu einem festgelegten Zeitpunkt veranlasst (abhä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. Diese Übertragung wir je Ausgabe einmal angestoßen. Somit sind Updates ausgeschlossen.

Folgende Metadaten der Artikel können übertragen werden

• Ort

• Ressort

• Autor-Name

Folgende Inhaltsdaten der Artikel können übertragen werden

• Dachzeile

• Titel

• Untertitel

• Text mit Formatierungen:

  • Absatz

  • Umbrüche <br>

  • Kursiv <i>

  • Bold <b>

  • Links <a href=""></a>

  • Zwischentitel

  • Listen <ul>, <li>

  • Initial <big>

• Verweis auf zugehörige Bilddateien mit Angabe der Beschriftung / Bildunterschrift und dem Fotonachweis

Ü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

ZIP-/XML-Dateien

Die ZIP-Dateien werden immer mit einem Timestamp übergeben. Anhand von diesem kann der zuletzt exportierte Datensatz identifiziert werden.

...

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"und das Ausgaben-XML werden immer nach dem Schema (<Lieferanten-ID>-)<Quelle-ID>-<Erscheinungstag> übertragen, d.h.:

• (<Lieferanten-ID>-)<Quelle-ID>-<Erscheinungstag>.zip

• (<Lieferanten-ID>-)<Quelle-ID>-<Erscheinungstag>.xml

Bild-Dateien

image_<ID>_<timestamp>.jpg

...

Ganzseiten-PDF

articlepagepdf_<ID>_<timestamp>.xml

Übertragung der Binärdaten mit Metadaten

Beim Export der E-Paper-Produkte werden zunächst die Binärdaten wird in ein entsprechendes Verzeichnis auf dem sFTP-Server ein ZIP-File je Ausgabe abgelegt. Dies umfasst die Artikellisten und alle enthaltenen enthält je ein Ausgaben-XML, alle 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.

...

und die Ganzseiten-PDFs.

Ausgaben-XML

Das Wurzelelement der XML-Datei heißt publicationartikel-liste. 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:

https://docs.google.com/spreadsheets/d/1kL6mfh1qM1CZj33AGoDCRsXxfeh8cvxgjx_iGlwlAy4/edit#gid=1150586356

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.

• dachzeile - Enthält die Dachzeile des Artikels.

• titel - Enthält den Titel des Artikels.

• untertitel - Enthält den Untertitel des Artikels.

• text - Enthält den Text des Artikels mit folgenden möglichen Formatierungen:

  • absatz - Enthält Artikel-Text.

  • br - Umbrüche.

  • i - Kursiv.

  • b - Bold.

  • a href="" - Links.

  • zwischentitel - Enthält Zwischentitel.

  • ul, li - Enthält Listen.

  • big - Enthält Initiale.

  • bild - Angabe des Dateinamens des mitgelieferten Bildes.

  • beschriftung - Angabe der Bildunterschrift.

  • fotonachweis - Angabe des Fotonachweises.

Beispiel eines Article-XML

...