PEIQ Knowledge Base

[1-14-2] OUTBOUND Doxis-Archivierung von Seiten-PDFs (Print und EPaper) mit Metadaten und Anzeigen-PDFs mit Metadaten

Owned by Violetta Stegen
Last updated: 2023-04-04 by Daniela Nguyen
9 min read

übergeordnete ID

Transportverfahren

sFTP (Abruf/Abräumen aus der PEIQ Cloud durch Dritte)

Objekt

Seiten: Seiten-PDFs von Print und EPaper, FIPS-Datei mit Metadaten der Seite, JINFO-Datei mit allen exportierten PDFs je Seite, RDY-Datei nach abgeschlossenem Export je Seite
Anzeigen: Anzeigen-PDFs, FIPS-Datei mit Metadaten aller Anzeigen je Seite, JINFO-Datei mit allen exportierten PDFs je Seite, RDY-Datei nach abgeschlossenem Export je Seite

Trigger

Automatisch

Typische Drittsysteme

Doxis

 

Mit dem vorliegenden Export von Seiten sowie Anzeigen 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, Artikel und Bilder

  • Export von Seiten-PDFs von Print und EPaper, FIPS-Datei mit Metadaten der Seite, JINFO-Datei mit allen exportierten PDFs je Seite, RDY-Datei nach abgeschlossenem Export je Seite

  • Export von Anzeigen-PDFs, FIPS-Datei mit Metadaten aller Anzeigen je Seite, JINFO-Datei mit allen exportierten PDFs je Seite, RDY-Datei nach abgeschlossenem Export je Seite

  • Übertragung via sFTP

Inhaltsverzeichnis

Aufbereitung und Übertragung der Daten

Für den Export von Seiten sowie Anzeigen werden über die hier vorliegende Standard-Schnittstelle Daten 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 ist zeitlich gesteuert.

Printseiten

Beim Stufen der Printseiten auf Produzieren werden die PDFs der Seiten an die Druckerei zur Belichtung geschickt. Um genau diesen Stand der Printseiten zu archivieren, werden im selben Workflow die Printseiten-PDFs auch zur Archivierung auf den sFTP-Server exportiert.

E-Paper-Export mit Transformation

Beim Fertigstufen der Seiten eines redaktionellen Druckprodukts oder beim Ändern von Printseiten wird automatisch ein “E-Paper-Produkt” angelegt bzw. aktualisiert.

Dieses E-Paper-Produkt enthält die Seiten und dient als Grundlage für den Export. Hierüber können in der GUI (Graphical User Interface) die Daten vor dem Export noch einmal betrachtet werden.

Nachts läuft ein Workflow, der zum Erscheinungstag heute alle EPaper-Produkte exportiert und transformiert. Die transformierten Dateien umfassen die PDF-, FIPS-, JINFO-, RDY-Dateien der Seiten und Anzeigen.

Übertragung der Daten

Bereits beim Stufen der Printseiten werden die PDFs der Printseiten in ein Verzeichnis auf dem sFTP-Server übertragen.

Nachts im Workflow werden die PDFs der EPaper-Seiten, die FIPS-Dateien mit den Metadaten der Seiten (Print und EPaper), die JINFO-Dateien mit einer Liste der exportierten PDFs je Seite (d.h. Angabe der PDF-Datei für Print und EPaper) und die RDY-Dateien nach abgeschlossenem Export je Seite exportiert.

Updates sind bei dieser Schnittstelle nicht vorgesehen.

Der Zeitpunkt des nächtlichen Exports kann konfiguriert werden.

Für Informationen bezüglich der Information die wir von Ihnen benötigen, schauen Sie bitte auf die Mitwirkungspflichten.

Default Werte

Falls die Frist für die Belieferung der Mitwirkungen nicht eingehalten wurde, wird PEIQ den Export für ein beliebiges Objekt einrichten. Die Funktionalität der Schnittstelle bleibt dabei garantiert, jedoch ist die nachfolgende Anpassung der Objekte vom Kunden kostenpflichtig zu beantragen.


Aufruf (automatischer Trigger)

Die Übertragung der Daten wird automatisiert zu einem festgelegten Zeitpunkt veranlasst (abhängig vom Erscheinungstag). Diese Übertragung wir je Ausgabe einmal angestoßen. Somit sind Updates ausgeschlossen.

Folgende Metadaten der Seiten können übertragen werden

Tags beim Export an Doxis

Beschreibung

Eigenschaften/Tags beim EPaper-Export mit Transformation

<attribute attributeDefinition="DOKTYP">

fester Wert

-- (ausprogrammierte Struktur)

<attribute attributeDefinition="AUSGABE">

Kürzel der Ausgabe (kann im Archiv zum Langnamen gemappt werden)

Ausgaben-Kürzel der Printseite DLayAusgabe

<attribute attributeDefinition= "DATEINAME">

Dateiname

Dateiname des page-PDFs (web + ET + Seitenname)

<attribute attributeDefinition="ET">

Erscheinungstag im Format YYYYMMDD

PPErschAm am EPaper-Produkt oder DLayErschAm der Seite

<attribute attributeDefinition="RESSORT">

Kürzel des Ressorts (kann im Archiv zum Langnamen gemappt werden)

Ressort-Kürzel DLayRessort

<attribute attributeDefinition="KUERZEL">

Kürzel aus dem Seitennamen

--

<attribute attributeDefinition="NAME">

Seitenname (Kürzel + Nummer)

Name der Printseite DLayName

<attribute attributeDefinition= "AUSGABE_SEITE">

Kombi aus Ausgabe zzgl. Seitennummer

Ausgaben-Kürzel und Seitennummer im EPaper-Produkt (DLayAusgabe + “- Seite” + SeitNr) (bei Doppelseiten nur Angabe der linken Seitennummer)

<attribute attributeDefinition="FORMAT">

Festwert

-- (ausprogrammierte Struktur)

<attribute attributeDefinition="INFO">

Weitere Informationen

--

<representation number="0">

Dateiname der Web-PDF - Referenziert über jinfo-Dateiliste

Dateiname des page-PDFs aus dem EPaper-Export (web + ET + Seitenname)

<representation number="1">

Dateiname der Druck-PDF - Referenziert über jinfo-Dateiliste

Dateiname des PDFs vom Print-Export (druck + ET + Seitenname)

Folgende Metadaten der Anzeigen können übertragen werden

Tags beim Export an Doxis

Beschreibung

NGen-Eigenschaft

<attribute attributeDefinition= "AUFTRAGSNR"><value>

Auftragsnummer

Auftrag:DAufNummer

<attribute attributeDefinition= "BESCHREIBUNG"><value>

Beschreibung

DAnzeigeName

<attribute attributeDefinition= "DATEINAME"><value>

Dateiname der Anzeige aus AdFlow

DAnzeigeNr + ".pdf"

<attribute attributeDefinition="ET"><value>

Erscheinungstag im Format YYYYMMDD

PPErschAm am EPaper-Produkt oder DLayErschAm der Seite

<attribute attributeDefinition="NAME">
<value>

Seitenname (Kürzel + Nummer) auf der die Anzeige erschienen ist

DLayName der Printseite und Seitennummer im EPaper-Produkt

<attribute attributeDefinition="RUBRIK">
<value>

Rubrik

DAnzeigeRessort

<attribute attributeDefinition="KUNDE">
<value>

Kundenname

Auftrag:Kunde:HauptAdresse: DAdrName1, Auftrag:Kunde:HauptAdresse: DAdrName2, Auftrag:Kunde:HauptAdresse: DAdrName3, Auftrag:Kunde:HauptAdresse: DAdrNameZusatz

<attribute attributeDefinition= "KUNDENID">
<value>

Kunden-ID

Auftrag:Kunde:DKunNummer

<attribute attributeDefinition= "WERBENDER">
<value>

Werbender

Auftrag:Kunde2:HauptAdresse: DAdrName1, Auftrag:Kunde2:HauptAdresse: DAdrName2, Auftrag:Kunde2:HauptAdresse: DAdrName3, Auftrag:Kunde2:HauptAdresse: DAdrNameZusatz

<attribute attributeDefinition= "WERBENDERID">
<value>

Werbender-ID

Auftrag:Kunde2:DKunNummer

<attribute attributeDefinition= "PRODPROD">
<value>

Produktionsprodukt (pro Wert ein Value-Eintrag)

gebuchte Ausgaben des Erscheinungstages in PPErschAm (enthalten in AnzeigeBuchungen)

<attribute attributeDefinition="VKPROD">
<value>

Verkaufsprodukt

gebuchte Kombi des Erscheinungstages in PPErschAm (enthalten in AnzeigeBuchungen)

<attribute attributeDefinition="INFO">
<value>

Gestaltungsinformationen

DAnzProduktion, DAnzGestaltung, DAnzArtGest, DAnzAnschnitt, DAnzGroesseFest, PlatzierungsVorschrift, DAnzeigeBreiteGebucht, DAnzeigeHoeheGebucht

<attribute attributeDefinition= "KUNDENART">
<value>Anzeigenkunde</value>
</attribute>

Festwert

--

<attribute attributeDefinition= "DOKUMENTTYP">
<value>Anzeige</value>
</attribute>

Festwert

--

<attribute attributeDefinition= "ANZEIGENART">
<value>

Anzeigenart

DAnzTyp, DAnzProduktTyp

<representation number="0">
<content filename="" index="" />
</representation>

Dateiname der Anzeigen-PDF - Referenziert über jinfo-Dateiliste

Dateiname des PDFs der Anzeige beim Archivexport an Doxis

Ü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 Dritten “abzuräumen”.

Namenskonvention

FIPS-/JINFO-/RDY-Dateien

Die Namen der FIPS-, JINFO- und RDY-Dateien beim Seiten- und Anzeigen-Export werden jeweils nach folgendem Schema gebildet:

  • FIPS-Datei: ET (Tag+Monat) + _ + Name der Seite + .fips

  • JINFO-Datei: ET (Tag+Monat) + _ + Name der Seite + .jinfo

  • RDY-Datei: ET (Tag+Monat) + _ + Name der Seite + .rdy

PDF-Dateien

  • Printseiten-PDF: druck + ET (Tag+Monat) + Name der Seite + .pdf

  • EPaper-Seiten-PDF: web + ET (Tag+Monat) + Name der Seite + .pdf

  • Anzeigen-PDF: ET (Tag+Monat) + _ + Name der Seite + _ + Anzeigennummer + .pdf

Übertragung der Binärdaten mit Metadaten

Die PDFs der Printseiten werden bereits vor dem nächtlichen Export beim Stufen der Printseiten exportiert.

Im nächtlichen Workflow werden alle weiteren Dateien je Seite in folgender Reihenfolge exportiert, sodass die RDY-Datei je Seite immer als letztes übertragen wird:

  • FIPS-Datei mit Metadaten der Seite

  • JINFO-Datei mit Liste der Print- und EPaper-Seiten-PDFs

  • PDF-Datei der EPaper-Seite

  • PDF-Dateien der Anzeigen

  • FIPS-Datei mit Metadaten der Anzeigen

  • JINFO-Datei mit Liste der Anzeigen-PDFs

  • leere RDY-Datei für Anzeigen

  • leere RDY-Datei für Seiten

Beispiel einer FIPS-Datei mit Metadaten der Seite

<?xml version="1.0" encoding="utf-8"?> <newDocument xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="ArchiveDocument.xsd"> <document isFinal="false"> <attribute attributeDefinition="DOKTYP"> <value>Zeitungsseite</value> </attribute> <attribute attributeDefinition="AUSGABE"> <value>wn-200_ah</value> </attribute> <attribute attributeDefinition="DATEINAME"> <value>web_3006_1-wn-200_ah-hp-rpo.pdf</value> </attribute> <attribute attributeDefinition="ET"> <value>20220630</value> </attribute> <attribute attributeDefinition="RESSORT"> <value>rpo</value> </attribute> <attribute attributeDefinition="KUERZEL"> <value /> </attribute> <attribute attributeDefinition="NAME"> <value>1-wn-200_ah-hp-rpo</value> </attribute> <attribute attributeDefinition="AUSGABE_SEITE"> <value>wn-200_ah - Seite 1</value> </attribute> <attribute attributeDefinition="FORMAT"> <value>Normal (Rheinisches Format)</value> </attribute> <attribute attributeDefinition="INFO"> <value /> </attribute> <representation number="0"> <content filename="web_3006_1-wn-200_ah-hp-rpo.pdf" index="0" /> </representation> <representation number="1"> <content filename="druck_3006_1-wn-200_ah-hp-rpo.pdf" index="0" /> </representation> </document> </newDocument>

Beispiel einer JINFO-Datei mit Liste der Print- und EPaper-Seiten-PDFs

web_3006_1-wn-200_ah-hp-rpo.pdf druck_3006_1-wn-200_ah-hp-rpo.pdf

Beispiel einer FIPS-Datei mit Metadaten der Anzeigen

<?xml version="1.0" encoding="utf-8"?> <newDocument xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="ArchiveDocument.xsd"> <document isFinal="false"> <attribute attributeDefinition="AUFTRAGSNUMMER"> <value>10201</value> </attribute> <attribute attributeDefinition="BESCHREIBUNG"> <value /> </attribute> <attribute attributeDefinition="DATEINAME"> <value>10201-1.pdf</value> </attribute> <attribute attributeDefinition="ET"> <value>20220630</value> </attribute> <attribute attributeDefinition="NAME"> <value>1-wn-200_ah-hp-rpo1</value> </attribute> <attribute attributeDefinition="RUBRIK"> <value>allgemein</value> </attribute> <attribute attributeDefinition="KUNDE"> <value>Obelix GmbH &amp; Co. KG</value> </attribute> <attribute attributeDefinition="KUNDENID"> <value>1110002715</value> </attribute> <attribute attributeDefinition="WERBENDER"> <value /> </attribute> <attribute attributeDefinition="WERBENDERID"> <value /> </attribute> <attribute attributeDefinition="PRODPROD"> <value>10099</value> <value>10101</value> <value>10111</value> <value>10113</value> <value>10123</value> <value>10124</value> <value>10130</value> <value>10140</value> <value>10144</value> <value>10150</value> <value>10160</value> <value>10170</value> <value>10174</value> <value>10180</value> <value>10190</value> <value>10200</value> <value>10364</value> </attribute> <attribute attributeDefinition="VKPROD"> <value>10100</value> </attribute> <attribute attributeDefinition="INFO"> <value>Produktionshinweis Produktion,Breite 90,9mm,Höhe 100mm</value> </attribute> <attribute attributeDefinition="KUNDENART"> <value>Anzeigenkunde</value> </attribute> <attribute attributeDefinition="DOKUMENTTYP"> <value>Anzeige</value> </attribute> <attribute attributeDefinition="ANZEIGENART"> <value>Kundengeliefert Textteil</value> </attribute> <representation number="0"> <content filename="3006_1-wn-200_ah-hp-rpo_10201-1.pdf" index="0" /> </representation> </document> <document isFinal="false"> <attribute attributeDefinition="AUFTRAGSNUMMER"> <value>10192</value> </attribute> <attribute attributeDefinition="BESCHREIBUNG"> <value /> </attribute> <attribute attributeDefinition="DATEINAME"> <value>10192-1.pdf</value> </attribute> <attribute attributeDefinition="ET"> <value>20220630</value> </attribute> <attribute attributeDefinition="NAME"> <value>1-wn-200_ah-hp-rpo1</value> </attribute> <attribute attributeDefinition="RUBRIK"> <value>allgemein</value> </attribute> <attribute attributeDefinition="KUNDE"> <value>Obelix GmbH &amp; Co. KG</value> </attribute> <attribute attributeDefinition="KUNDENID"> <value>1110002715</value> </attribute> <attribute attributeDefinition="WERBENDER"> <value /> </attribute> <attribute attributeDefinition="WERBENDERID"> <value /> </attribute> <attribute attributeDefinition="PRODPROD"> <value /> </attribute> <attribute attributeDefinition="VKPROD"> <value /> </attribute> <attribute attributeDefinition="INFO"> <value>Produktionshinweis Produktion,PlatzierungsVorschrift tt,Breite 90,9mm,Höhe 30mm</value> </attribute> <attribute attributeDefinition="KUNDENART"> <value>Anzeigenkunde</value> </attribute> <attribute attributeDefinition="DOKUMENTTYP"> <value>Anzeige</value> </attribute> <attribute attributeDefinition="ANZEIGENART"> <value>Satzanzeige Textteil</value> </attribute> <representation number="0"> <content filename="" index="0" /> </representation> </document> <document isFinal="false"> <attribute attributeDefinition="AUFTRAGSNUMMER"> <value>9829</value> </attribute> <attribute attributeDefinition="BESCHREIBUNG"> <value>Test2 Richter test2</value> </attribute> <attribute attributeDefinition="DATEINAME"> <value>9829-1.pdf</value> </attribute> <attribute attributeDefinition="ET"> <value>20220630</value> </attribute> <attribute attributeDefinition="NAME"> <value>1-wn-200_ah-hp-rpo1</value> </attribute> <attribute attributeDefinition="RUBRIK"> <value>allgemein</value> </attribute> <attribute attributeDefinition="KUNDE"> <value>Richter Max</value> </attribute> <attribute attributeDefinition="KUNDENID"> <value>1110002719</value> </attribute> <attribute attributeDefinition="WERBENDER"> <value /> </attribute> <attribute attributeDefinition="WERBENDERID"> <value /> </attribute> <attribute attributeDefinition="PRODPROD"> <value /> </attribute> <attribute attributeDefinition="VKPROD"> <value /> </attribute> <attribute attributeDefinition="INFO"> <value>Breite 90,9mm,Höhe 100mm</value> </attribute> <attribute attributeDefinition="KUNDENART"> <value>Anzeigenkunde</value> </attribute> <attribute attributeDefinition="DOKUMENTTYP"> <value>Anzeige</value> </attribute> <attribute attributeDefinition="ANZEIGENART"> <value>Kundengeliefert Anzeigenteil</value> </attribute> <representation number="0"> <content filename="3006_1-wn-200_ah-hp-rpo_9829-1.pdf" index="0" /> </representation> </document> <document isFinal="false"> <attribute attributeDefinition="AUFTRAGSNUMMER"> <value>10195</value> </attribute> <attribute attributeDefinition="BESCHREIBUNG"> <value /> </attribute> <attribute attributeDefinition="DATEINAME"> <value>10195-1.pdf</value> </attribute> <attribute attributeDefinition="ET"> <value>20220630</value> </attribute> <attribute attributeDefinition="NAME"> <value>1-wn-200_ah-hp-rpo1</value> </attribute> <attribute attributeDefinition="RUBRIK"> <value>allgemein</value> </attribute> <attribute attributeDefinition="KUNDE"> <value>Obelix GmbH &amp; Co. KG</value> </attribute> <attribute attributeDefinition="KUNDENID"> <value>1110002715</value> </attribute> <attribute attributeDefinition="WERBENDER"> <value /> </attribute> <attribute attributeDefinition="WERBENDERID"> <value /> </attribute> <attribute attributeDefinition="PRODPROD"> <value /> </attribute> <attribute attributeDefinition="VKPROD"> <value /> </attribute> <attribute attributeDefinition="INFO"> <value>Produktionshinweis Produktion,PlatzierungsVorschrift ti,Breite 90,9mm,Höhe 100mm</value> </attribute> <attribute attributeDefinition="KUNDENART"> <value>Anzeigenkunde</value> </attribute> <attribute attributeDefinition="DOKUMENTTYP"> <value>Anzeige</value> </attribute> <attribute attributeDefinition="ANZEIGENART"> <value>Kundengeliefert Textteil</value> </attribute> <representation number="0"> <content filename="3006_1-wn-200_ah-hp-rpo_10195-1.pdf" index="0" /> </representation> </document> </newDocument>

Beispiel einer JINFO-Datei mit Liste der Anzeigen-PDFs

Optionale, weitergehende Infos (auf Anfrage)

https://peiq.atlassian.net/wiki/pages/createpage.action?spaceKey=CORE&title=%5B1-14-1%5D%20Pressemonitor

Verwandte Seiten

Impressum