[0-10-3] INBOUND Artikel für Archiv und Produktion mit Bildern

Transportverfahren	sFTP (Anlieferung in der PEIQ Cloud durch Dritte)
Objekt	XML; Bilder als JPG, PNG, PDF, TIF, TIF, Gif, Bmp, SVG, RAW, WEBP, HEIC, EMF
Trigger	automatisch, optional manuell
Typische Drittsysteme	Typische Anbindungen sind Archive (Artikel-Archive) in Drittsystemen und Drittsysteme zur Content-Erstellung (Artikel-Anlieferung vom Drittsystem)
Beispieldaten	siehe unten
Typische Drittsysteme	--

Mit der hier beschriebenen Importfunktion können einzelne Artikel (für Archiv oder Produktion) mit Bildern durch Dritte auf dem sFTP-Server zur Verfügung gestellt werden und von dort aus nach PRINT NGEN importiert werden.

Die Datenanlieferung und der Import nach PRINT NGEN erfolgen in der PEIQ Cloud im sFTP-Bereich (sftp://data.peiq.cloud/…). Typische Anbindung sind Archive und Drittsysteme zur Content-Erstellung.

Funktionalitäten des/der [Schnittstelle]

Import einzelner Artikel inkl. Bilder (für Archiv oder Produktion)
Übertragung via sFTP

Inhaltsverzeichnis

Import Elemente und Destination

Für den Import von von einzelnen Artikel mit Bildern werden über die hier vorliegende Standard-Schnittstelle Daten von einer Destination im sFTP-Bereich (sftp://data.peiq.cloud/…) in die PEIQ Cloud importiert.

Einzelne Artikel

Übertragung

Für jeden Artikel (für Archiv mit Attribut content="archive" im Tag <publication> oder Produktion optional mit Attribut content="production" im Tag <publication>) wird ein article-XML nach PRINT NGEN importiert. Enthält ein Artikel Bilder, so müssen diese (unbeschnittene Originalbilder) auf dem sFTP-Server vorhanden sein.

Bilder werden im XML als image-Tags übertragen und können innerhalb des article-Tags referenziert werden. Die Bilder, die im article-Tag referenziert werden, werden immer als Bestandteil des Artikels importiert. Alle anderen Bilder werden als eigenständige Bilder importiert.

Bei der Übertragung eines Artikels mit/ohne Bildern sind keine Koordinaten erforderlich, da diese bei der Platzierung der Elemente auf einer Seite in PEIQ festgelegt werden.

Erfolgt ein Update, d.h. in PRINT NGEN ist bereits ein Artikel zu der im article-XML angegebenen externen ID vorhanden, wird der bestehende Artikel in PRINT NGEN upgedatet. Auch die mit dem Artikel übertragenen Bilder werden in PRINT NGEN upgedatet. Änderungen, die in PRINT NGEN am Artikel vorgenommen wurden, werden somit überschrieben.

Usecases

Übernahme eines Artikelarchives von einem Drittsystem nach PRINT NGEN (mit Updates)
Content-Erstellung von Artikeln in einem Drittsystem, die in PRINT NGEN für die Printproduktion z.B. mithilfe von Assist auf Printseiten platziert werden sollen

Eine Weiterbearbeitung/-verwendung der importierten Artikel in CREATE ist nicht vorgesehen. Auch hier müssten zunächst Print-Kopien erstellt werden.

Import der Daten

Zum Import läuft in PRINT NGEN eine Warteschlange, die folgende Daten importiert:

Die article-XMLs und zugehörigen Bilder:
- Für jedes article-XML wird jeweils ein Archiv- oder Printartikel in PRINT NGEN erstellt.
- Auch hier laufen die zugehörigen Bilder in PRINT NGEN als Originalbilder ein und werden am Artikel referenziert.

Der Import läuft im 1-min-Takt.

Import Trigger

Standardmäßig erfolgt der Import durch eine Warteschlange, die im 1min-Takt abgearbeitet wird.

Übertragungsart: sFTP

Der Import der Daten erfolgt von einer Destination im sFTP-Bereich (sftp://data.peiq.cloud/…) in der PEIQ Cloud. Diese Daten müssen vom Anlieferer (Dritten) zur Verfügung gestellt werden und werden durch PRINT NGEN “abgeräumt” (d.h. nach dem Import werden die entsprechenden Daten auf dem sFTP-Server gelöscht).

Namenskonvention

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>.<Endung des Dateiformats z.B. “jpg”>

XML

article_<ID>_<timestamp>.xml (nur bei Übertragung von einzelnen Artikeln, die keiner Seite zugeordnet sind)

Übertragung der Binärdaten

Beim Export der Daten durch den Anlieferer auf den sFTP-Server müssen zunächst die Binärdaten in ein entsprechendes Verzeichnis gelegt werden. Dies umfasst alle enthaltenen Bilder des Artikels als JPG, PNG, PDF, TIF, TIF, Gif, Bmp, SVG, RAW, WEBP, HEIC oder EMF.

Übertragung der Metadaten

Im nächsten Schritt müssen die Metadaten im gleichen Verzeichnis des sFTP-Servers abgelegt werden. Die XML-Datei muss dabei artikelweise geschickt werden.

Article-XML

Das Wurzelelement der XML-Datei heißt publication. Es folgt der Aufbau der XML-Struktur (des Artikels mit zugehörigen Bildern) mit den Attributen und den kundenspezifischen Elementen.

Für die Umwandlung in die PEIQ Struktur durch XSLT Stylesheets beim Import der Daten vom Drittanbieter können Sie sich optional an folgendem Dokument orientieren:

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

Dieses Dokument erhalten Sie auf Anfrage.

publication

name = Objekt
date = Erscheinungstag im Format yyy-mm-dd
edition = Ausgabe (Kürzel)

article

id = ID des Artikels (beim Archivimport die externe ID des Drittanbieters)
ver = Version des Artikels
shareType (optional) = Möglichkeit des Sharings in der App: forbidden für kein Sharing, link für Share über Link in den WebReader und pdf für das gesamte Seiten-PDF
title = Schlagzeile (Hauptzeile/Überschrift) des Artikels (ohne HTML-Struktur)
section = Ressort (Kürzel)
sectionindex = Ressort-Index
pageNumber = Die Seitennummer von der Seite auf der sich der Artikel befindet
keywords/keyword = Schlagwörter am Artikel
- type = person (für Personen) / location (für Orte) / organisation (für Organisationen) / topic (für allgemeine Schlagwörter)
- priority = Priorität von 1 bis 5
content = enthält den Body des Artikels
body = enthält Überschriften, Haupttext und Nebeninhalte
- Inhalte Body:
- h1 class="headline" - Die Hauptzeile bzw. der Titel
- h2 - Die Unterzeile
- p - Paragraph im Haupttext
div
- class = image
- class = imagegallery
- data-id = ID des Bildes

image

image
- id = ID des Bildes (beim Archivimport die externe ID des Drittanbieters)
- ver = Version des Bildes
- underline (optional) = Bildunterschrift
- source (optional) = Quelle / Copyright
- keywords/keyword = Schlagwörter am Bild
  - type = person (für Personen) / location (für Orte) / organisation (für Organisationen) / topic (für allgemeine Schlagwörter)
  - priority = Priorität von 1 bis 5

Beispiel

<?xml version="1.0" encoding="utf-8"?>
<publication name="abc" date="2021-11-05" edition="ab" content="production">
	<article id="251-2318056" ver="2" style="default" shareType="link" title="Ein beliebter Charakter muss sterben " section="son">
		<keywords>
			<keyword type="person" priority="1">Dame Maggie Smith</keyword>
			<keyword type="organisation" priority="5">Universal Pictures</keyword>
			<keyword type="location" priority="3">Großbritannien</keyword>
			<keyword type="topic" priority="5">Serie</keyword>
		</keywords>
		<content>
			<body>
				<h1 class="headline">Ein beliebter Charakter muss sterben</h1>
				<h2>Downton Abbey: A New Era</h2>
				<div class="image-gallery">
					<div class="image" data-id="251-2298349"/>
				</div>
				<p>
					<strong>Die britische Serie „Downton Abbey“ kehrt mit einem weiteren Spielfilm zurück. Doch „A New Era“ - so der Titel des nächsten Kapitels - dürfte vielen Fans das Herz brechen, denn ein Charakter wird fehlen.</strong>
				</p>
				<p>„Downton Abbey“ geht weiter - zwar nicht in Form von Staffel 7, dafür erwartet uns ein weiterer Spielfilm. Bereits 2019 kehrte der Cast der beliebten UK-Serie mit einem eigenen Film in die internationalen Kinosäle zurück. Ein Wiedersehen mit der Crawley-Familie, das zum Glück keine einmalige Angelegenheit bleiben wird.</p>
				<p class="intermediate">Fortsetzung offiziell bestätigt</p>
				<p>Eine Fortsetzung wurde von offizieller Seite bestätigt und wird den Titel „A New Era“ (auf Deutsch: „Eine neue Ära“) tragen. Glaubt man den neuesten Berichten aus Großbritannien, steht uns dieses Mal eine besonders emotionale Geschichte bevor. Mehrere Zeitungen berichten über einen Todesfall in „Downton Abbey: A New Era“ und die Fans haben bereits einen Verdacht.</p>
				<p class="intermediate">Kein Auge bleibt trocken</p>
				<p>„Diejenigen, die die Szenen gesehen haben, berichten, dass sie sehr emotional sind“, schreibt die britische „Sun“ in Hinblick auf den schweren Verlust im neuen „Downton Abbey“-Film. Die Fans werden in Strömen weinen und es bleibt kein Auge im Kinosaal trocken, prophezeit eine Quelle. Welcher Charakter am Ende sterben wird - das ist nicht bekannt, doch die Fans tippen darauf, dass es die Gräfinwitwe, Violet Crawley treffen wird. Die berühmte und sehr beliebte Figur der Serie wird von der 86-jährigen Dame Maggie Smith („Harry Potter“) verkörpert und erfreute sich großer Beliebtheit. Die Fans können sich „Downton Abbey“ nicht ohne ihre schnippischen Bemerkungen vorstellen, aber sollte die Geschichte wirklich eine ganz neue Ära betreten, legt das den Tod von Violet nahe.</p>
				<p class="intermediate">Trifft es Violet Crawley?</p>
				<p>Zahlreiche Fans hatten bereits beim ersten „Downton Abbey“-Film damit gerechnet, dass uns ein Abschied von Dame Maggie Smiths Kult-Figur bevorsteht, doch dann kam alles anders. Die zahlreichen Meldungen von Insidern, die über den Tod eines „ikonischen Charakters“ berichten, schmälern die Hoffnung, dass Violet Crawley ein weiteres Mal dem Tod von der Schippe springt. Eines steht zumindest fest: Sollte sie wirklich sterben, dürften nicht nur auf der Kinoleinwand bei ihrer Familie die Tränen fließen, sondern auch bei den Fans in den Kinosesseln. Für Spannung ist jedenfalls gesorgt, in den sozialen Medien wird bereits heftig über das Thema diskutiert.</p>
				<p class="intermediate">Komplette Besetzung wieder dabei</p>
				<p>Für die Fortsetzung des „Downton Abbey“- Spin-off- Films von 2019 wird die komplette Besetzung wieder zusammenkommen und erwartet dazu noch mehrere neue Darsteller. Der erste Film folgte auf das Finale der Drama-Serie von Julian Fellowes, die zwischen 2011 und 2015 in den USA ausgestrahlt wurde und aus sechs Staffeln besteht. Die britische Fernsehserie handelt vom Schicksal einer Aristokratenfamilie und ihrem Personal am Anfang des 20. Jahrhunderts.</p>
				<p class="intermediate">Historisch markante Ereignisse</p>
				<p>Historisch markante Ereignisse haben ebenfalls den Weg in die Serie geschafft, unter anderem der Untergang der Titanic oder der Ausbruch des Ersten Weltkriegs. Im Jahr 2011 durfte sich die ITV-Produktion über eine ganz besondere Auszeichnung freuen: einen Eintrag im Guinness-Buch der Rekorde als „von Kritikern am besten bewertete Fernsehserie“ des Jahres. aut „NYPost“ ist die Produktion des zweiten Films von “Downton Abbey“ bereits im Gange, das Veröffentlichungsdatum ist für den 22. Dezember geplant. Die Produzenten haben eine Reihe von Neuzugängen zur Originalbesetzung angekündigt.</p>
			</body>
		</content>
	</article>
	<image id="251-2298349" ver="5">
		<keywords>
			<keyword type="person" priority="1">Patrick Dempsey</keyword>
			<keyword type="organisation" priority="5">American Broadcasting Company</keyword>
			<keyword type="location" priority="3">USA</keyword>
			<keyword type="topic" priority="5">Serie</keyword>
		</keywords>
	</image>
</publication>

Mitwirkungspflichten der Kund:innen

Für Informationen bezüglich der Mitwirkungen und Testpflicht, können Sie sich an folgender Dokumentation orientieren:

Textformatierungen und Default-Tags werden durch PEIQ vorgegeben, nach Anfrage kann die Tabelle https://docs.google.com/spreadsheets/d/1kL6mfh1qM1CZj33AGoDCRsXxfeh8cvxgjx_iGlwlAy4/edit#gid=1150586356 zur Verfügung gestelt werden. Zusätzlich benötigte Formatierungen müssen von PEIQ geprüft werden.
Ausgaben und Ressorts sollten bereits entsprechend der in PRINT NGEN eingerichteten Wertelisten übertragen werden. Andernfalls ist in PRINT NGEN ein Mapping erforderlich und es wird eine entsprechende Mappingtabelle vom Kunden benötigt.

Maßgebliche DB-Tabellen

DText, DBild

PRINT NGEN und CREATE Knowledge Base