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

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.

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

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

Versionierung

Optionale, weitergehende Infos (auf Anfrage)

Verwandte Seiten

Mit der Schnittstelle [0-10] INBOUND Seiten, Artikel, Bilder (jeweils für Archiv oder Produktion) können neben den einzelnen Artikeln inkl. Bilder auch

• Archivseiten mit zugehörigen Artikeln und Bildern [0-10-1]

• fertig gelayoutete Printseiten für die Produktion [0-10-2] und

• einzelne Bilder (für Archiv oder Produktion) [0-10-4]

importiert werden. Mehr Informationen finden Sie unter den verlinkten Seiten.

• Page:
  [0-17] INBOUND Schnittstelle zu Livingdocs API | Artikel mit Bilder
• Page:
  [0-20] INBOUND / OUTBOUND via SFTP
• Page:
  [1-28] INBOUND Anzeigenimport von kaufmännischem System
• Page:
  [0-2] INBOUND Agenturmeldungen, Agenturbilder
• Page:
  [0-8] INBOUND Azure AD / SAML App
• Page:
  [0-18] INBOUND Schnittstelle zu huGO API | Artikel (als Agenturmeldungen) mit Bildern
• Page:
  Mitwirkungspflichten: [0-17] Livingdocs API - Artikelvorlagen und Autor:innen
• Page:
  Mitwirkungspflichten: [0-17] Livingdocs API - Formatname
• Page:
  Customizing Livingdocs
• Page:
  [0-8] Redaktionelle Eingangskanäle
• Page:
  [0-10-4] INBOUND Bilder mit Metadaten-XML