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

übergeordnete ID	[1-14] OUTBOUND Ausgaben mit Seiten, Artikel und Bilder (Content-Syndication und E-Paper)
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

1 Aufbereitung und Übertragung der Daten
2 Optionale, weitergehende Infos (auf Anfrage)
3 Verwandte Seiten

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.

Hilfestellung: [2-01-1] Customizing E-Paper

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