[2-2] OUTBOUND CREATE zu PRINT NGEN

Funktionalitäten des Exports von PEIQ CREATE nach PRINT NGEN

• Bruchfreie Abgabe von CREATE-Artikeln nach PRINT NGEN

• Aktualisieren exportierter Printausprägungen/-versionen

Inhaltsverzeichnis

Allgemeine Beschreibung

Über eine PEIQ Standard-Schnittstelle können CREATE-Artikel bei der Übergabe nach Print bruchfrei in Printartikel transformiert werden. Print-spezifische Metadaten, die das Auffinden und Weiterverarbeiten auf einer Seite erleichtern, werden vorher in der CREATE-Kanalsteuerung vergeben.

Wird ein Inhalt einmal in CREATE erfasst und daraus eine Variante für Print generiert, steht dieser unmittelbar nach dem Publizieren im PRINT-NGEN-Redaktionssystem zur Weiterverarbeitung im Layout zur Verfügung.

Sobald ein für den Printkanal vorgesehener Artikel in CREATE per Klick auf “Publizieren” auf “Fertig” gestuft wird, erfolgt der Aufruf eines ActiveX in der NGenWebServices.dll, das den CREATE-Artikel automatisch direkt am NWAS in einen Printartikel transformiert. Vorab wird geprüft, ob am CREATE-Artikel die Eigenschaft „Für Print=true” (Standard=ja) sowie die Pflicht-Metadaten gesetzt sind.

Die Verknüpfung zwischen dem Print- und CREATE-Artikel erfolgt mittels bestehender Eigenschaft “DTextRefMedium”. Dabei wird am Printartikel die Referenz zum CREATE-Artikel gesetzt.

Welche Standard-Werte, Status usw. der Printartikel beim Anlegen erhalten soll und welche Elemente übernommen werden sollen, ist in einer Abbildung bzw. einem Stylesheet, welches die inhaltliche XML-Struktur des Printartikels definiert, einstellbar.

Bei der Transformation von CREATE nach PRINT NGEN findet ein Print-spezifisches XSL Anwendung. Tags im CREATE-Artikel werden dabei für Print in entsprechende Bereiche bzw. XML-Tags transformiert. Artikel-Elemente, die nicht für Print vorgesehen sind, wie z. B. Teaser, SEO-Titel und -Beschreibung, verlinkte Artikel, inline verlinkte Bilderlisten (Galerien), Teaserbilder, Embeds, Onlineboxen etc., werden automatisch aus dem Text entfernt.

Das Aussteuern des Inhalts für PRINT NGEN findet in der CREATE Kanalsteuerung statt. Dort können Kanal-spezifische Metadaten wie Erscheinungstag, Ausgabe, Ressort, Ressort-Index oder Honorarinformationen hinterlegt werden.

Nach dem Fertigstellen des Printartikels in PRINT NGEN kann aus Print heraus der CREATE-Artikel, falls gewünscht, auch erneut aktualisiert werden. Soll der Inhalt der ursprünglichen Ausprägung nicht überschrieben werden, kann optional automatisch eine zweite Ausprägung angelegt werden.

Anlegen von Printartikeln aus CREATE heraus

Standard-Werte beim Anlegen von Printartikeln

Gemäß der PRINT NGEN-Logik gibt es bestimmte Attribute, die beim Anlegen eines Clusters, wie Artikeln oder Bildern, in der Datenbank nicht leer sein dürfen (z. B. DTextObjekt/DBildObjekt). Aus diesem Grund gibt es eine Logik, dass diese erforderlichen Standard-Werte automatisch gesetzt werden. Beim Anlegen von Printartikeln in CREATE wird auf diese PRINT NGEN-Logik zurückgegriffen.

An folgenden Stellen und in dieser Reihenfolge werden die Standards ermittelt:

• Benutzerkontext

  • Eigenschaften Defaults - Anlegen:Masken

• Artikelvorlage

  • Cluster “Texte“

• Abbildung Änderungen#DText#NeuPVonDS

Konfiguration der Printvorlage

Über eine CREATE-Abbildung lässt sich - abhängig von den Eigenschaften des CREATE-Artikels, wie z. B. Kanal oder TemplateType - (kundenspezifisch) konfigurieren, welches Layout ein Printartikel beim Export nach Print erhalten soll.

Übertragung des Rubrikenpfads aus der Kanalsteuerung

Die Werte von Ausgabe, Ressort, RessortIndex bzw. optional RessortLang werden aus dem Rubrikenpfad der Kanalsteuerung in die entsprechenden Eigenschaften des Printartikels geschrieben. Standardmäßig ist folgende Konfiguration eingestellt:

• CREATE-Kanalinfo: Ausgabe → DTextAusgabe

• CREATE-Kanalinfo: Ressort/RessortLang → DTextRessort

• CREATE-Kanalinfo: RessortIndex → DTextGeplSeite

Infobox

Beim PRINT-Export von CREATE nach PRINT NGEN werden CREATE-Artikel mit Infobox berücksichtigt. Beim Export entstehen im Print dabei jeweils eigene Artikel (2). Für die Transformation der Tags von Infoboxen in die Printstruktur werden dieselben Stylesheets durchlaufen wie bei den CREATE-Artikeln.

Wenn aus CREATE heraus ein Artikel inkl. Infobox nach Print abgegeben wird, werden in PRINT NGEN die beiden generierten Artikel (Haupt- und Unterartikel) automatisch miteinander verlinkt. Wird ein Infoboxartikel anschließend im Print im Hauptartikel platziert, ist es wichtig, dass am Container der Infobox die Eigenschaft “DTextFormatName=Infobox” gesetzt wird, damit beim Erstellen/Aktualisieren des CREATE-Artikels dieser als Unterartikel erkannt und im CREATE-Artikel platziert wird.

Beim Export werden Hauptartikel und Infobox wie ein Artikel behandelt, d. h. Hauptartikel und Infobox werden stets zusammen übertragen/bearbeitet/aktualisiert. Eine CREATE-Infobox landet in Print standardmäßig in einem Standard-Layout.

Die Bilder aus der Infobox werden ebenfalls berücksichtigt. Sind mehrere Bilder enthalten, wird auch bei Infoboxen zusätzlich das Attribut “CMS” gefüllt.

Beim Aktualisieren des CREATE-Artikels aus Print werden sowohl Haupt- als auch Unterartikel berücksichtigt.

Bei der Aktualisierung einer Infobox aus CREATE wird der Infobox-Container im Hauptartikel immer ans Ende gesetzt.

Transformation von Tags

Autor

Im CREATE-Artikel gibt es das Tag <TextAutor> für ein hinterlegtes Autorenprofil. Außerdem gibt es das Tag <Autor> mit einem/einer frei eingegebenen Autor:in.

Vor dem Anwenden des XSLT-Stylesheets “Create.DS_zu_Print” wird <TextAutor> umgewandelt, sodass der/die Autor:in stets im Tag <Autor> steht. Da auch im Printartikel das Tag gleich heißt, wird im Stylesheet nichts umgewandelt.

Quelle

Auch wenn es in CREATE eine Quelle, jedoch keinen Ort gibt, wird in Print trotzdem ein <Ort>-Tag generiert. Die Struktur ist dabei immer gleich. <Quelle></Quelle> befindet sich innerhalb eines Orts-Tags, auch wenn es eigentlich gar keinen Ort gibt. Demnach gibt es folgende Möglichkeiten:

• <Ort>Ortsname</Ort>

• <Ort>Ortsname<Quelle>Quelle</Quelle></Ort>

• <Ort><Quelle>Quelle</Quelle></Ort>

Zitat/Zitatquelle

Im CREATE-Artikel steht das Zitat in einem <Zitat>-Tag mit folgender Struktur:

• <Zitat><ZitatInhalt></ZitatInhalt><ZitatQuelle></ZitatQuelle></Zitat>

Die Tag-Struktur im Printartikel sieht wie folgt aus:

• <Zitat></Zitat><ZitatAutor></ZitatAutor>

Hyperlink

Wird ein Hyperlink nach Print übergeben, entsteht ein <Link>-Tag. Die Struktur ist folgendermaßen:

• <Link> verlinkter Begriff <LinkURL> URL </LinkURL> </Link>

Funktionsweise kundenspezifischer Stylesheets

Standardmäßig gibt es folgende Stylesheets:

• “Create.Print_zu_DS”

• “Create.DS_zu_Print”

• “Create.DS_zu_CMS”

Diese sind in den nachstehenden Abbildungen wie folgt konfiguriert:

• Abbildung “Default#Master.Create_DSToPrintXsltStylesheets”

EIGENSCHAFTEN
DTextFormatName {}
*	{"Create#Master.Create.DS_zu_Print"}

• Abbildung “Default#Master.Create_PrintToDSXsltStylesheets”

EIGENSCHAFTEN
DTextFormatName {}
*	{"Create#Master.Create_Print_zu_DS"}

• Abbildung “Default#Master.Create_ServerSettings#Default”

DSToCMSXsltName, * {"Create.DS_zu_CMS"}

Bei kundenspezifischen Umwandlungen kann in der jeweiligen Kundenbibliothek in den Abbildungen “Create_DSToPrintXsltStylesheets” oder “Create_PrintToDSXsltStylesheets” ein Eintrag ergänzt werden:

EIGENSCHAFTEN
DTextFormatName {}
*	{"Create#Master.Create_DS_zu_Print","_GEAOnline.DS_zu_Print_Custom"}

Das bedeutet, dass die angegebenen Stylesheets der Reihe nach angewendet werden.

Ziel ist es auf dem Weg von Print nach CREATE zuerst ein kundenspezifisches XSLT-Stylesheet anzuwenden, welches Printartikel in unsere “Standard”-Form für Printartikel bringt. Danach kann das Standard-PEIQ-Stylesheet Create_Print_zu_DS ablaufen.

Für den Weg von CREATE nach Print wird zuerst das PEIQ-Stylesheet angewendet - somit ein Standard-Printartikel erstellt - und danach kann optional ein weiteres Stylesheet ablaufen, welches kundenspezifische Änderungen umsetzt.

Des Weiteren können in den Stylesheets der Parameter “DTextFormatName” des Printartikels verwendet werden. Dazu muss dieser jedoch im XSLT-Stylesheet definiert sein. Im XSLT-Stylesheet “Create_DS_zu_Print” ist dieser bereits eingetragen:

<xsl:param name="DTextFormatName"></xsl:param>

So können innerhalb eines Stylesheets mehrere Varianten für die einzelnen Printvorlagen definiert werden (Beispiel: Autor:in soll im Text stehen vs. Autor:in soll in eigenen Bereich).

Bilder-Handling

Es ist fest ausprogrammiert, dass alle Bilder des CREATE-Artikels zusätzlich in das “CMS”-Attribut des Printartikels geschrieben werden, falls sie doch im Print verwendet werden sollen (z. B. Teaserbild).

Siehe dazu auch https://peiq.atlassian.net/wiki/spaces/PPSD/pages/971604186/2-3+INBOUND+PRINT+NGEN+zu+CREATE#Beibehalten-von-Element-Positionen.

Bildänderungen beim Update durch CREATE bleiben erhalten

Bei Bildänderungen im Print wird nicht analog zu Textänderungen automatisch eine eigene Print-Ausprägung in CREATE erstellt. Dennoch werden Bildänderungen im Print nicht durch Abgeben in CREATE überschrieben. Einige mögliche Bildänderungen sind beispielsweise:

• Bildtext ändern (BU, Quelle)

• Ausschnitt setzen, Drehen, Kontern

• Bilddaten ändern (Bild beschneiden)

Aktualisieren von exportierten Printausprägungen/-versionen

Beim Zurücknehmen und erneuten Abgeben der Printausprägung in CREATE wird der Printartikel so lange geupdated, bis er in PRINT NGEN einen bestimmten Status erhalten oder zum Bearbeiten gesperrt wurde. Das Setting erfolgt in einer CREATE-Abbildung.

Mit dem Abgeben des Printkanals einer Ausprägung wird auch gleich eine Printversion (eigenes Cluster in der PRINT NGEN Datenbank) erzeugt, in welcher die Inhalte auf Basis der Printausprägung in CREATE kopiert/transformiert werden. Diese Inhalte werden zwischen der Printausprägung in CREATE und dem referenzierten Printartikel in PRINT NGEN synchronisiert, solange

• die Ausprägung in CREATE bearbeitet werden kann (Status: “Erfassung”),

• die Printversion in PRINT NGEN bearbeitet werden kann (Status: “Erfassung”),

• in der Printversion in PRNT NGEN keine Änderungen am Text vorgenommen wurden.

Der PRINT NGEN Artikel erhält eine Kennzeichnung auf der Seite, dass dieser keine weiteren Updates aus CREATE erhält.

Übertragung von Ausgabe/Ressort/Ressort-Index

Über die Eigenschaft “DMappeDigitalNameExtern” (siehe https://peiq.atlassian.net/wiki/spaces/PPSD/pages/993624101/Rubrikenbaum#NameExtern-(DMappeDigitalNameExtern)) an den Pfadmappen im Rubrikenbaum des jeweiligen Kanals (hier: Print) kann gesteuert werden, welcher Wert für die jeweilige Ausgabe/Ressort-Kombination beim Print-Export nach PRINT NGEN übertragen werden soll.

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

XML-Struktur

Die XML-Struktur des Printartikels, der aus einem CREATE-Artikel mit allen möglichen Elementen erstellt wurde, sieht (Stand 04/2022) wie folgt aus:

<xml>
	<Titel>Titel</Titel>
	<Vorspann>Teaser</Vorspann>
	<Unterzeile>Untertitel</Unterzeile>
	<Dachzeile>Dachzeile</Dachzeile>
	<Text>
		<Autor>Autor</Autor>
		<Ort>Ort<Quelle>Quelle</Quelle>
		</Ort>
		<Zitat>Zitattext</Zitat>
		<ZitatAutor>Zitatquelle</ZitatAutor>
		<Liste>
			<ListeE>Liste 1</ListeE>
			<ListeE>Liste 2</ListeE>
			<ListeE>Liste 3</ListeE>
		</Liste>Lorem ipsum dolor sit amet...</Text>
</xml>

Komponenten der Schnittstelle

Legende:

DLLs

NGenWebServices.dll

Customizing

Abbildungen

• Änderungen#DText#NeuPVonDS

• Create_PrintartikelErstellen

• Create_PrintartikelAktualisieren

• Create_PrintartikelTemplateName

• Create_ServerSettings#Default

• Create_ServerSettings#Custom

XSLT-Stylesheets

• Create_DS_zu_Print

• DS_zu_Print_Custom

Mitwirkungspflichten der Kund:innen

Definition, welche Layouts (Printvorlagen) beim Erstellen des Printartikels pro CREATE-Template verwendet werden sollen.

Verwandte Seiten

• Page:
  [2-3] INBOUND PRINT NGEN zu CREATE
• Page:
  [2-2] OUTBOUND CREATE zu PRINT NGEN
• Page:
  Schnittstellen zu anderen PEIQ-Produkten
• Page:
  XML-Schnittstelle
• Page:
  SOAP Schnittstelle
• Page:
  [2-4] INBOUND OUTBOUND CREATE API
• Page:
  PEIQ CREATE - Schnittstellen

Nur für PEIQ-Mitarbeiter:

/wiki/spaces/CORE/pages/818970649