...
Expand | ||||
---|---|---|---|---|
| ||||
|
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
Info |
---|
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:
...
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:
...
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.
...
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
Code Block |
---|
<?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> |
...
Diesen Hinweis vor dem Veröffentlichen entfernen (auf Mülleimer-Symbol klicken).
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)
Hier wird auf die Ergänzung zur Dokumentation dieser Schnittstelle im Core-Bereich verwiesen. Der Link wird als Karte angezeigt.
Diesen Hinweis vor dem Veröffentlichen entfernen (auf Mülleimer-Symbol klicken).
Hier wird auf die interne Dokumentation im Core-Bereich verwiesen. Die Vorlage für die Erstellung einer ergänzenden Dokumentation zu dieser Schnittstelle bzgl. interne und sensitive Daten ( z.B. Aufwände, Zugangsdaten etc.) findest du hier.
Sowohl das Anlegen/Konzipieren, als auch das Entwickeln und Aktualisieren von Schnittstellen ist über den Sprint als Vorgang in JIRA in den jeweiligen Produkten einzuplanen.
Diesen Hinweis vor dem Veröffentlichen entfernen (auf Mülleimer-Symbol klicken).
Verwandte Seiten
Das untenstehende Makro “Inhalt nach Stichwort” bearbeiten und in der Seitenleiste unter “Stichwort *” das Label “dummy” durch das Label des Moduls / Features ersetzen.
Dann diesen Hinweis vor dem Veröffentlichen entfernen (auf Mülleimer-Symbol klicken).
Filter by label (Content by label) | ||||||
---|---|---|---|---|---|---|
|
Nachfolgend sind die Disclaimer für die unterschiedlichen Produkte aufgelistet. Vor der Veröffentlichung soll der Disclaimer, der nicht für das hier beschriebene Produkt passt, gelöscht werden.
Dann diesen Hinweis sowie die gesetzten Status-Labels entfernen (auf Mülleimer-Symbol drücken).
Status | ||
---|---|---|
|
...
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
importiert werden. Mehr Informationen finden Sie unter den verlinkten Seiten.
Filter by label (Content by label) | ||||||
---|---|---|---|---|---|---|
|
Include Page | ||||
---|---|---|---|---|
|
...