[0-15] OUTBOUND Online-Export CREATE-Artikel

Transportverfahren	sFTP (Abruf/Abräumen aus der PEIQ Cloud durch Dritte)
Objekt	XML, JPG
Trigger	manuell
Unterstützte Drittsysteme	z. B. huGO
Beispieldaten	siehe untenstehend

Mit dem vorliegenden Export von CREATE-Artikeln inklusive der zugehörigen Bilder 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, Artikeln und Bildern

Export von CREATE-Artikeln inkl. Bilddaten
Übertragung via sFTP

Inhaltsverzeichnis

Inhaltsverzeichnis anzeigen

Aufbereitung und Übertragung der Daten

Für den Export von CREATE-Artikeln und deren Bilder werden XML-Files und Bilddaten über die hier vorliegende Standard-Schnittstelle 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 Kanal-Status “Online” der Artikel-Ausprägung.

XML-Generierung

Beim Publizieren eines Online-Kanals in einer Ausprägung wird automatisch ein XML-File geschrieben. Dabei finden zunächst Standard-Transformationen der Inhaltselemente statt, bevor anschließend noch einmal (kundenspezifische) Stylesheets weitere Anpassungen vornehmen.

Das fertige Artikel-XML enthält die relevanten Inhaltselemente, deren Formatierungen sowie die Metadaten der Ausprägung und der Bilder.

Übertragung der Daten

Für jeden publizierten Online-Kanal einer Artikel-Ausprägung wird jeweils ein article-XML erzeugt und übertragen. Enthält ein CREATE-Artikel Bilder oder Bildergalerie(n), werden diese ebenfalls als JPG-Datei mitgeliefert.

Es werden immer zuerst die Bilddateien exportiert, danach folgen die XML-Files.

Bei einer Aktualisierung werden erneut die geänderten article-XMLs (inkl. Bilder) übertragen. Dies kann beliebig oft erfolgen.

Beim Depublizieren eines Online-Kanals wird ein article-XML exportiert, das lediglich die Änderung des Kanalstatus zu “Offline” beinhaltet. So kann das Fremd-System erkennen, dass der Kanal der Ausprägung in CREATE Offline genommen wurde.

Der Zeitpunkt der Übertragung auf den sFTP wird als Timestamp im Dateinamen des XML bzw. der Bilddateien gespeichert.

Aufruf (manueller Trigger)

Standardmäßig wird die Übertragung der Daten manuell durch das Stufen des Online-Kanals in CREATE veranlasst, sobald ein Kanal den OnlineStatus “Online” erhält, was durch das Klicken des Publizieren-Buttons in der Kanalsteuerung ausgelöst wird.

Content

Die Strukturen der Inhalte und die entsprechende Wandlung in HTML-Tags werden von PEIQ als Standards festgelegt und in einem separaten Dokument aufgelistet. Sollten neue Tags benötigt werden, muss PEIQ diese zunächst prüfen und festlegen, ob sie in den Standard aufgenommen werden.

Bildbereiche/Geometrie

In CREATE gibt es keine eigenständigen Bildbereiche. An den Bildern können allerdings Bildschwerbereiche festgelegt werden. Der Bildschwerbereich ist als Rechteck auf dem Bild definiert. Die linke obere Ecke des Rechtecks sowie Breite und Höhe (Koordinaten x, y bzw. w, h) werden als Attribute des Bilds im article-XML übertragen. Die Bildbereiche werden in ihrem Breiten-Höhen-Verhältnis also so angepasst, dass der Bildexport die im CMS verwendeten Breiten-Höhen-Verhältnis annähernd widerspiegelt.

Ü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 dem/der Abnehmer:in (Dritten) “abzuräumen”.

Namenskonvention

Die Dateien werden immer mit einem Timestamp übergeben. Anhand dessen 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"

XML

article_<ID>_<timestamp>.xml

Bild

image_<ID>_<timestamp>.jpg

Übertragung der Metadaten

Die Metadaten der Artikel-Ausprägungen und Bilder werden in den article-XMLs gespeichert und mitgeschickt.

Besondere Tags im article-XML

Fett

Gefettete Texte werden beim Online-Export in den Elementen, in denen sie gemäß TextSchema in CREATE erlaubt sind, im Tag <strong></strong> übertragen.

Kursiv

Kursive Texte werden in den Elementen, in denen sie gemäß TextSchema in CREATE erlaubt sind, im Tag <em></em> übertragen.

Bilder

Inline-Bilder werden immer in der nachfolgenden Struktur inkl. der Metadaten übertragen:

<ImageSection type="Image">
<Image>
<Filename>image_<id>_<timestamp>.jpg</Filename>
<Area x="0" y="0" w="1000" h="1000"/>
<Title>Bildunterschrift</Title>
<Source>Foto: Inhaber Bildrechte</Source>
<SHA1><eindeutiger Hashwert></SHA1>
</Image>
</ImageSection>

Bildergalerie

Inline-Bildergalerien werden immer in der nachfolgenden Struktur inkl. der Metadaten übertragen:

<ImageSection type="Gallery">
<Image>
<Filename>image_<id><timestamp>.jpg</Filename>
<Area x="0" y="0" w="1000" h="1000"/>
<Title>Bildunterschrift</Title>
<Source>Foto: Inhaber Bildrechte</Source>
<SHA1><eindeutiger Hashwert></SHA1>
</Image>
<Image>
<Filename>image<id><timestamp>.jpg</Filename>
<Area x="0" y="0" w="1000" h="1000"/>
<Title>Bildunterschrift</Title>
<Source>Foto: Inhaber Bildrechte</Source>
<SHA1><eindeutiger Hashwert></SHA1>
</Image>
<image>
...
</image>
...
</ImageSection>

Aufmacherbild

Inline-Bilder werden immer in der nachfolgenden Struktur inkl. der Metadaten übertragen:

<ImageSection type="Lead">
<Image>
<Filename>image_<id>_<timestamp>.jpg</Filename>
<Area x="0" y="0" w="1000" h="1000"/>
<Title>Bildunterschrift</Title>
<Source>Foto: Inhaber Bildrechte</Source>
<SHA1><eindeutiger Hashwert></SHA1>
</Image>
</ImageSection>

Teaserbild

Inline-Bilder werden immer in der nachfolgenden Struktur inkl. der Metadaten übertragen:

<ImageSection type="Teaser">
<Image>
<Filename>image_<id>_<timestamp>.jpg</Filename>
<Area x="0" y="0" w="1000" h="1000"/>
<Title>Bildunterschrift</Title>
<Source>Foto: Inhaber Bildrechte</Source>
<SHA1><eindeutiger Hashwert></SHA1>
</Image>
</ImageSection>

Autorenprofil und Autor frei

Da die Tag-Struktur für “Autorenprofil” und “Autor frei” gleich ist, kann im Export-XML - sofern beides im Artikel verwendet wird - nicht unterschieden werden, was das Profil und was der Autor ist. Das neue Element “Autor frei” wird somit in der Standard XML-Schnittstelle im bestehenden Tag “Author” übergeben:

<Author><Email/><Name>AlexS</Name></Author> → Autor frei
...
<Author><Email>peter.lustiger@web.de</Email><Name>Peter Lustiger</Name></Author> → Autorenprofil

Ortsangabe

Die Ortsangabe wird im Tag <Location></Location> übertragen.

Quelle

Die Quelle wird im XML als <Source></Source> übertragen.

Zitat

Zitate werden im Tag <Quote></Quote> in folgender Struktur übertragen:

<Quote>
<Text>Zitattext</Text>
<Source>Zitatquelle</Source>
</Quote>

Aufzählung

Aufzählungen werden im Tag <List></List> in folgender Struktur übertragen:

<List>
<ListElement>Aufzählung 1</ListElement>
<ListElement>Aufzählung 2</ListElement>
<ListElement>Aufzählung 3</ListElement>
...
</List>

Frage & Antwort

Die Elemente Interview-Frage und das darauf folgende Element Interview-Antwort werden folgendermaßen übertragen:

<Question>Interview-Frage</Question> 
<Answer>Interview-Antwort</Answer>

Embeds

Embeds werden im Tag <Embed></Embed> in folgender Struktur übertragen:

<Embed type="Embed Typ, z. B. Facebook, YouTube usw.">
<Url>https://[URL]</Url> 
<Title>Titel des Embeds</Title>
</Embed>

Infobox

Der Inhalt der CREATE-Infobox wird innerhalb des Textes an der entsprechenden Stelle in das Tag <SubArticle type="Infobox"></SubArticle> geschrieben. Die XML-Struktur innerhalb von <SubArticle> ist genauso, wie innerhalb von <Text>.

Für Unterartikel (Infoboxen) wird dasselbe XSLT-Stylesheet wie beim Hauptartikel angewendet.

Das XML-Schema Create.ArtikelExport wurde so angepasst, dass das Tag <SubArticle> erlaubt ist.

Onlinebox

Die Übertragung der CREATE-Onlinebox erfolgt analog zur CREATE-Infobox. Somit wird der Inhalt der CREATE-Onlinebox innerhalb des Textes an der entsprechenden Stelle in das Tag <SubArticle type="Onlinebox"></SubArticle> geschrieben.

Übertragung der Werte für Online-Ressorts

Über die Eigenschaft DMappeDigitalNameExtern (siehe https://peiq.atlassian.net/wiki/spaces/PPSD/pages/993624101/Rubrikenbaum#NameExtern-(DMappeDigitalNameExtern)) an den Pfadmappen im /wiki/spaces/CORE/pages/991166570 des jeweiligen Kanals (hier: Online) kann definiert werden, welcher Wert für das Online-Ressort beim Online-Export übertragen werden soll:

...
<Categories>
	<Category>
		<Path>anzeigensonder</Path>
	</Category>
</Categories>
...

Wenn die Eigenschaft befüllt ist, so gilt diese an der Schnittstelle. Ist die Eigenschaft leer, dann gilt wie bisher die Eigenschaft DMappeDigitalName für die Schnittstelle.

Aktualisieren von exportierten Online-Ausprägungen / -Versionen

Beim Exportieren eines Online-Kanals einer digitalen Ausprägung entsteht eine Version im jeweiligen Zielsystem (analog Print). Diese kann auch nachträglich noch aktualisiert werden, wenn die Version im Zielkanal nicht für Aktualisierungen gesperrt ist. Änderungen im Zielsystem werden nicht nach CREATE zurück geschrieben.

Validierung der Tagstruktur mittels XSD-File

Damit externe CMS-Systeme (Content-Management-Systeme) die XML-Daten, die über die Schnittstelle geliefert werden, vor dem Import aus CREATE auf Korrektheit prüfen können, kann die XML-Struktur der Export-Files gegen ein XML-Schema (.xsd-File) Create.ArtikelExport geprüft werden. So kann das Fremd-System sicherstellen, dass Export- und Import-Seite stets abgestimmt und versioniert auf demselben Level unterwegs sind.

Beispiel eines article-XML

<?xml version="1.0" encoding="utf-8"?>
<Article>
	<ID>DText/202-2096867</ID>
	<Status>Online</Status>
	<Client/>
	<Type>Story</Type>
	<PublishStart>2021-04-27T21:41:00+02:00</PublishStart>
	<PublishStop>2021-04-29T22:00:00+02:00</PublishStop>
	<PaidContent>ja</PaidContent>
	<Categories>
		<Category>
			<Path>anzeigensonder</Path>
		</Category>
	</Categories>
	<Keywords>
		<Keyword type="person" priority="5">Gesundheitsminister</Keyword>
		<Keyword type="organisation" priority="5">Arvena Hotel</Keyword>
		<Keyword type="organisation" priority="5">CSU</Keyword>
	</Keywords>
	<Text>
		<Catchline>Dachzeile</Catchline>
		<Title>Titel</Title>
		<SEOTitle>SEO-Titel</SEOTitle>
		<SEODescription>SEO-Beschreibung</SEODescription>
		<Subline>Untertitel</Subline>
		<Teaser>Teaser</Teaser>
		<Author>
			<Email/>
			<Name>Autor frei</Name>
		</Author>
		<Location>Ortsangabe</Location>
		<Source>Quelle</Source>
		<ImageSection type="Image">
			<Image>
				<Filename>image_202-2096903_0427215242198.jpg</Filename>
				<Area x="0" y="0" w="1000" h="1000"/>
				<Title>Politik der ruhigen Hand? Für Innenminister Horst Seehofer (CSU) ist in Sachen Corona alles beim Alten.</Title>
				<Source>Foto: Michael Kappeler/dpa</Source>
				<SHA1>rca2U68rR97zcffKj0foj6fpxf4</SHA1>
			</Image>
		</ImageSection>
		<Paragraph>Bei zehn Unternehmen in <Hyperlink Url="https://www.sueddeutsche.de/thema/Bayern">Bayern</Hyperlink> soll noch in dieser Woche in Modellprojekten eine Corona-Betriebsimpfung für die Mitarbeiter erprobt werden. "Gemeinsam mit der Vereinigung der Bayerischen Wirtschaft (vbw) haben wir eine ausgewogene Auswahl getroffen mit unterschiedlich großen Betrieben aus Hochinzidenzgebieten und aus allen Regierungsbezirken sowie unterschiedlichen Branchen", sagte Gesundheitsminister Klaus Holetschek (CSU) am Dienstag in München. Der Bund plant, die Betriebsärzte erst ab Juni in das Impfgeschehen einzubeziehen.</Paragraph>
		<Paragraph>Bei den zehn Unternehmen handele es sich um: Arvena Hotel in Nürnberg, <Hyperlink Url="https://www.sueddeutsche.de/thema/Baywa">BayWa</Hyperlink> Münchberg, Brückner Maschinenbau in Siegsdorf, die Fränkischen Rohrwerke in Königsberg, Jopp Automotive in Bad Neustadt, Magnet-Schultz in Memmingen, Mann + Hummel in Marklkofen, Novartis Pharma in Nürnberg, Siemens-Werk in Cham sowie Wacker Chemie in Burghausen. Für das Modellprojekt werden run 50 000 Impfdosen unterschiedlicher Hersteller bereitgestellt.</Paragraph>
		<Quote>
			<Text>Zitat</Text>
			<Source>mit Quelle</Source>
		</Quote>
		<List>
			<ListElement>Aufzählung 1</ListElement>
			<ListElement>Aufzählung 2</ListElement>
			<ListElement>Aufzählung 3</ListElement>
		</List>
		<Subtitle>Zwischentitel</Subtitle>
		<Embed type="YouTube">
			<Url>https://www.youtube.com/watch?v=jY9vM25UvdA</Url>
			<Title>YouTube Embed</Title>
		</Embed>
		<Embed type="Facebook">
			<Url>https://www.facebook.com/FCAugsburg/posts/10157860197431994</Url>
			<Title>Facebook-Embed</Title>
		</Embed>
		<Embed type="Twitter">
			<Url>https://twitter.com/faznet/status/1386946720739778565</Url>
			<Title>Twitter-Embed</Title>
		</Embed>
		<Embed type="Instagram">
			<Url>https://www.instagram.com/p/COK9S_KKDkE/?utm_source=ig_web_copy_link</Url>
			<Title>Instagram-Embed</Title>
		</Embed>
		<ImageSection type="Gallery">
			<Image>
				<Filename>image_202-2096897_0427215242198.jpg</Filename>
				<Area x="0" y="0" w="1000" h="1000"/>
				<Title/>
				<Source/>
				<SHA1/>
			</Image>
			<Image>
				<Filename>image_202-2096898_0427215242198.jpg</Filename>
				<Area x="0" y="0" w="1000" h="1000"/>
				<Title/>
				<Source/>
				<SHA1/>
			</Image>
			<Image>
				<Filename>image_202-2096899_0427215242198.jpg</Filename>
				<Area x="0" y="0" w="1000" h="1000"/>
				<Title/>
				<Source/>
				<SHA1/>
			</Image>
			<Image>
				<Filename>image_202-2096900_0427215242198.jpg</Filename>
				<Area x="0" y="0" w="1000" h="1000"/>
				<Title/>
				<Source/>
				<SHA1>sc1Zrcemlge5o3aJl8a4lhaPxf0</SHA1>
			</Image>
			<Image>
				<Filename>image_202-2096901_0427215242198.jpg</Filename>
				<Area x="0" y="0" w="1000" h="1000"/>
				<Title/>
				<Source/>
				<SHA1>rca2U68rR97zcffKj0foj6fpxf4</SHA1>
			</Image>
		</ImageSection>
		<Author>
			<Email>peter.lustiger@web.de</Email>
			<Name>Peter Lustiger</Name>
		</Author>
		<SubArticle type="Infobox">
			<Title>Das ist der Titel der Infobox</Title>
			<Paragraph>Hier steht der Text der Infobox.</Paragraph>
			<ImageSection type="Image">
			Image>
				<Filename>image_202-2104977_1124171120087.jpg</Filename>
				<Area x="0" y="0" w="1000" h="1000"/>
				<Title>BU Infobox</Title>
				<Source>Quelle Infobox</Source>
				<SHA1>A9c780cP7ae-khb-Uc2Zr2h4ec2</SHA1>
			</Image>
			</ImageSection>
			<Author>
				<Email>peter.lustiger@web.de aaw</Email>
				<Name>Peter Lustiger</Name>
			</Author>
			<Author>
				<Email/>
				<Name>Autor frei</Name>
			</Author>
		</SubArticle>
		<SubArticle type="Onlinebox">
			<Title>Das ist der Titel der Infobox</Title>
			<Paragraph>Hier steht der Text der Infobox.</Paragraph>
		</SubArticle>
	</Text>
</Article>

Mitwirkungspflichten der Kund:innen

Keine.

Maßgebliche DB-Tabellen

DText, DBild.

[Link Assetklassen]

Versionierung

Aktuelle CMSExternDPS Version: 1.0.0

Aktuelle NGenWebServices.dll Version: 1.0.7867.16645

Disclaimer

Für die vorliegende Systemübersicht/Publikation behalten wir uns alle Rechte vor. Nachdruck, Vervielfältigung und Verbreitung (auch auszugsweise) ist nur mit schriftlicher Genehmigung der PEIQ GmbH erlaubt. Wir behalten uns vor, die Systemübersicht/Publikation jederzeit ohne vorherige Ankündigung zu ändern und/oder zu erweitern. Die vorliegenden Angaben dienen lediglich Informationszwecken. Die PEIQ GmbH übernimmt keinerlei Haftung und/oder Garantie für Fehler und/oder unvollständige Angaben in der Systemübersicht/Publikation, mit Ausnahme von vorsätzlich falschen oder arglistig verschwiegenen Angaben. Da unsere Software laufend weiter entwickelt wird, handelt es sich bei den vorliegenden nur um allgemeine Angaben. Es handelt sich weder um eine Zusicherung von Mindestvertragsinhalten, noch um Beschaffenheitsgarantien im Sinne des § 443 BGB.

Nur für PEIQ-Mitarbeiter:

/wiki/spaces/CORE/pages/612466697

[0-15] OUTBOUND Online-Export CREATE-Artikel

Aufbereitung und Übertragung der Daten

XML-Generierung

Übertragung der Daten

Aufruf (manueller Trigger)

Content

Bildbereiche/Geometrie

Übertragungsart: sFTP

Namenskonvention

Timestamp

XML

Bild

Übertragung der Metadaten

Besondere Tags im article-XML

Fett

Kursiv

Bilder

Bildergalerie

Aufmacherbild

Teaserbild

Autorenprofil und Autor frei

Ortsangabe

Quelle

Zitat

Aufzählung

Frage & Antwort

Embeds

Infobox

Onlinebox

Übertragung der Werte für Online-Ressorts

Aktualisieren von exportierten Online-Ausprägungen / -Versionen

Validierung der Tagstruktur mittels XSD-File

Beispiel eines article-XML

Mitwirkungspflichten der Kund:innen

Maßgebliche DB-Tabellen

Versionierung

Verwandte Seiten

Disclaimer