PEIQ Knowledge Base

[2-2] OUTBOUND CREATE zu PRINT NGEN

Transportverfahren

Datei-Export

Objekt

XML

Trigger

manuell

Unterstützte Drittsysteme

PRINT NGEN

Beispieldaten

siehe untenstehend

Mit dem Standard-Printexport können in CREATE erstellte Artikel bruchfrei nach PRINT NGEN zur dortigen Weiterverarbeitung im Print-Layout abgegeben werden. Kund:innen haben so die Möglichkeit, das Publizieren in den Kanal PRINT NGEN zu steuern, um eine effiziente und ressourcenschonende Arbeitsweise zu unterstützen und zusätzliche Arbeitsschritte im Printsystem weitestgehend zu minimieren.

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 bruchfrei in Printartikel transformiert werden. Print-spezifische Metadaten, die das Auffinden und Weiterverarbeiten auf einer Seite erleichtern, werden vorher in der CREATE- 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 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.

Standards, die beim Anlegen von DText-Clustern gelten, sind kundenspezifisch.

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

  • Benutzerkontext

    • Eigenschaften Defaults - Anlegen:Masken

  • Artikelvorlage

    • Cluster “Texte“

  • Abbildung Änderungen#DText#NeuPVonDS

Die Abbildung Änderungen#DText#NeuPVonDS darf nur durch PEIQ angepasst werden.

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. Hier sind sowohl Vorlagen vom Typ Text, als auch vom Typ Layout konfigurierbar.

Ü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:

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:

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 .

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 PRINT NGEN keine Änderungen am Text vorgenommen wurden.

Sobald der Status in PRINT NGEN auf “Fertig” gestellt wurde, lässt sich der Artikel in CREATE nicht mehr nach PRINT abgeben.

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 ) an den Pfadmappen im 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:

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

 

Nur für PEIQ-Mitarbeiter:

https://peiq.atlassian.net/wiki/spaces/CORE/pages/818970649