PEIQ Knowledge Base

[1-6-1] OUTBOUND Standard Planungsdaten-Schnittstelle

Über eine standardisierte XML-Schnittstelle (IfraTrackVersion 4.1.0, PrintProductDefinition 2.1.0) können Planungsdaten (Druckprodukte, Seiten) aus der PRINT NGEN Blattplanung an die Druckmaschinenplanung übergeben, importiert und automatisch an den Leitstand und die Plattenproduktion weitergeleitet werden.

Dies erfolgt als Ablage auf den sFTP-Bereich der PEIQ Cloud durch manuelles Anstoßen des Workflows durch Planer.

Durchgängiger XML Workflow: Druckprodukte und Auftragsdaten müssen nur einmalig angelegt werden. Keine Zwischenplanung notwendig.

Funktionalitäten der Planungsdatenschnittstelle

  • Export der geplanten Druckprodukte als Planungsdaten-XML von PRINT NGEN auf einen unidirektionalen sFTP-Hotfolder (einseitiger Upload Ordner von PRINT NGEN zu Druckmaschine)

  • erfolgreiches Zusammenfügen der PDF-Dateien (Seiteninhalte) mit der Struktur des Druckproduktes

Inhaltsverzeichnis

Allgemein

Über eine standardisierte XML-Schnittstelle werden Planungsdaten an die Druckmaschinenplanung übergeben, importiert und automatisch an Leitstand und Plattenproduktion weitergeleitet.

Die exportierten Planungsdaten enthalten Informationen über die in PRINT NGEN geplanten Druckprodukte mit der Seiten-/ Buchaufteilung und die Seitenplatzierungen mit den zu produzierenden Separationen.

Der Planungsdatenexport erfolgt für jedes Druckprodukt einzeln. Dafür steht im Kontextmenü des Druckproduktes der Menüpunkt “Planungsdaten exportieren” zur Verfügung.

image-20240315-103235.png
Menüpunkt am Druckprodukt

Über den Menüpunkt “Planungsdatenexport aller Druckprodukte” im Kontextmenü des Spiegels können die Planungsdaten aller der im Spiegel befindlichen Druckprodukte gleichzeitig exportiert werden.

image-20240315-112152.png
Menüpunkt am Spiegel

Das Planungsdatenexport-XML enthält immer nur die Beschreibung eines Druckproduktes.

Der Exportzeitpunkt des letzten Planungsdatenexports wird am Druckprodukt in der Spalte “Export“ ausgegeben. Wurde noch kein Planungsdatenexport für das Druckprodukt ausgeführt, so bleibt das Feld leer.

Besonderheiten des Exports

Durchlaufseiten

Handelt es sich um eine Durchlaufseite, so werden nicht die Seiteneigenschaften der Durchlaufseite, sondern die der Mutterseite ausgegeben. Dadurch werden Mutter- und Tochterdurchlaufseite mit den gleichen Separationen verlinkt.

Tabloid

Die Schnittstelle gibt nur das Format „broadsheet“ aus. Das Maschinensystem erhält aus dem internen PRINT NGEN Pairing-Modul die bereits gepairten und montierten Tabloid-Druckformen im Broadsheet-Format. Alle Tabloidumfänge werden automatisch in Broadsheet-Seitenumfänge umgerechnet.

Zusätzlich werden immer nur die Seiteneigenschaften der linken Tabloidseite des zu pairenden Seitenpaares ausgegeben.

Voraussetzung für diese Planungsdaten-Schnittstelle ist der Einsatz des PRINT NGEN Seitenpairing-Moduls für die Tabloid-Produktion.

Panoramaseiten

Die Doppelseitenhälften einer Doppelseite referenzieren die gleichen Separationen (ipo:Separation), da Doppelseiten im Ganzen ausgegeben werden und in NGen ist eine Doppelseite (SeitenTyp=Doppel) ein Seitencluster. Für beide Seitenhälften wird die linke Seiteneigenschaft SeitNr exportiert.

Voraussetzung für diese Planungsdaten-Schnittstelle ist der Export der Doppelseiten als Doppelseiten-PDF (= keine Einzelseiten-PDFs).

Vorteile der Standard Planungsdaten-Schnittstelle

Der Einsatz einer Standard Planungsdaten-Schnittstelle umfasst folgende Vorteile:

  • Durchgängiger XML-Workflow

  • Einmaliges Anlegen der Druckprodukte und Auftragsdaten in PRINT NGEN

  • Automatisierter Prozess nach manuellem Anstoß der Funktion

  • Keine händische Pflege von Strukturen für Druckerei

  • Weniger fehleranfälliger Workflow

sFTP-Export & Dateiname

Der Export der Daten erfolgt auf die Destination “Planungsdaten” in objektspezifischen Verzeichnissen im sFTP-Bereich in der PEIQ Cloud. Diese Daten sind dann von Dritten “abzuräumen”. Bei mehreren Druckstandorten liegen die Daten in druckortspezifischen Verzeichnissen und darin wiederum in objektspezifischen Verzeichnissen.  

Pfad bei nur einem Druckort: /Planungsdaten/<Objektkürzel>

Pfad bei mehreren Druckorten: /Planungsdaten/<Druckort>/<Objektkürzel>

 

Der Dateiname der Planungsdaten-XMLs wird zusammengesetzt aus folgenden Druckprodukt-Eigenschaften:

<Erscheinungstag MMTT>-<Objektkürzel>______<Ausgabe>____<Produkttyp>______<Exportversion>.xml

Aufbau des Planungsdaten-XMLs

Folgend wird der Aufbau des Planungsdaten-XMLs beschrieben:

imf:lmf

<imf:Imf xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:isd="http://www.ifra.com/IfraTrack/isd/4.1" xmlns:ipo="http://www.ifra.com/IfraTrack/ipo/4.1" xmlns:icv="http://www.ifra.com/IfraTrack/icv/4.1" xmlns:imf="http://www.ifra.com/IfraTrack/imf/4.1">

 imf:Head

Der Head des Planungsexport-XMLs enthält bis auf den aktuellen Export-Zeitpunkt <imf:Time> folgende feste Informationen:

<imf:Head> <imf:IfraTrackVersion>4.1.0</imf:IfraTrackVersion>  <imf:Interface> <imf:ID>1</imf:ID> <imf:Name>Print Product Definition</imf:Name>  <imf:Version>2.1.0</imf:Version>  <imf:Supplier>multicom</imf:Supplier>    </imf:Interface> <imf:Source supplier="multicom" application="Blattplanung" /> <imf:Time>JJJ-MM-DDTHH:MM:SS</imf:Time>  <imf:MessageID>1001</imf:MessageID> <imf:Meta>undef</imf:Meta>  </imf:Head>

imf:Body

Innerhalb des Body (imf:Body) werden die verschiedenen Objekt-Klassen für die strukturierte Beschreibung der geplanten Produktion aufgeführt. Die Objekte werden einzeln beschrieben und über die Angabe von IDs miteinander verknüpft. Dabei wird die gleiche Seperation:Group-Id mit mehreren Seiten verlinkt, wenn es sich um eine Durchlaufseite handelt.

<imf:Body> <isd:Object xsi:type="ipo:Issue" action="put"> [Druckproduktinformationen] <isd:Object xsi:type="ipo:Product" action="put"> [Druckproduktinformationen] <isd:Object xsi:type="ipo:Book" action="put"> [Buchaufteilung der Produkte] <isd:Object xsi:type="ipo:PagePlacement" action="put"> [Seitenstruktur] isd:Object xsi:type="ipo:Separation" action="put"> [Seiteninformationen] <isd:Object xsi:type="ipo:SeparationGroup" action="put"> [Auflistung der zu produzierenden Separationen] </imf:Body>

Inhalt von imf:Body

XML Attributname

Wert

NGEN Eigenschaft

Beschreibung

ipo:Issue (Druckprodukt) - Attribute

isd:ObjectUID

Zeichen

“multicom:NGen<Servernummer>:<Objektkürzel><Erscheinungstag DDMMJJJJ><Produkttyp>”

z.B.: “multicom:NGen204:ta31122024hp”

ID enthält die Information, welches System das Objekt und dessen ID generiert hat, inkl. Druckprodukt-informationen

ipo:Name

Zeichen

PPObjekt

Name des Objektes

ipo:ShortLabel

Zeichen

PPObjekt

Name des Objektes

ipo:Date

Datum

JJJJ-MM-TT

PPErschAm

Erscheinungsdatum des Druckproduktes

ipo:Product (Druckprodukt) - Attribute

isd:ObjectUID

Zeichen

“multicom:NGen:<Servernummer>:<ID>”

ID des Druckproduktes

ipo:Name

Zeichen 

PPName

Name des Druck­pro­duktes

ipo:ShortLabel

Zeichen

PPAusgabe

Ausgabe des Druck­pro­duktes

ipo:ProductType

Zeichen

PPProduktTyp

z.B.: “hp”, “vp1”

Produkttyp des Druck­produktes

ipo:ShortProductType

Zeichen

PPProduktTyp

z.B.: “hp”, “vp1”

Produkttyp des Druck­produktes

ipo:PlannedCopies

Ganzzahl

PPAuflage

Auflage des Druck­pro­duktes

ipo:Remark

Zeichen

Kommentar

Kommentar Druck­­pro­dukt

ipo:Book (Buch) - Attribute

isd:ObjectUID

Zeichen

“<ID><BuchNr>”

ID des Druckproduktes + Nummer des Buches

ipo:BookPos

Ganzzahl

BuchNummer

Position des Buches innerhalb des Druckproduktes (beginnt mit 1)

ipo:NoOfPages

Ganzzahl

BuchSeitenAnzahl

Die Seitenanzahl bzw. die Anzahl der zu produzierenden Druckformen des Buches.

Handelt es ich um ein Tabloid-Produkt oder Tabloid-Buch so wird die Anzahl/2 ausgegeben.

ipo:PageFormat

“broadsheet”

-

Seitenformat des Buches. Es wird immer “broadsheet“ übergeben.

ipo:Stitched

“false”

-

 

Es wird immer “false“ übergeben.

ipo:Book (Buch) - Verlinkung

ipo:ProduktLink

<isd:ObjectUID>

-

Verlinkung zu dem Druckprodukt (product), in welchem das Buch geführt wird.

ipo:PagePlacement (Platzierung der Seite) - Attribute

isd:ObjectUID

Zeichen

“<ID><BuchNr><SeitNr>”

ID der Seite + BuchNr + SeitNr der Seite

 

Bei Durchlaufseiten wird die ID der Mutterseite übergeben. 

ipo:PageNumber

Ganzzahl

RelSeitNr

Relative Seitennummer

ipo:PagePlacement (Platzierung der Seite) - Verlinkungen

ipo:ProduktLink

<isd:ObjectUID>

-

Link des Druckproduktes (product), in dem die Seite platziert ist.

ipo:BookLink

<isd:ObjectUID>

-

Link des Buches, in dem die Seite platziert ist.

ipo:SeparationGroup

<isd:ObjectUID>

-

Link zu der zugehörigen Separations-Gruppe (separation group).

ipo:Separation (Farbplanung der Seite) - Attribute

isd:ObjectUID

Zeichen

“<ID><Index für Separation>”

ID der Seite + Index für Separation abhängig von ColourShortLabel:

ColourShortLabel C=0

ColourShortLabel M=1

ColourShortLabel Y=2

ColourShortLabel K=3

ipo:ColourShortLabel

Zeichen

FarbPlan.Geplant

Es werden die Farben gemäß dem FarbPlan.Geplant exportiert (C, M, Y, K).

ipo:RealPanoRequired

“true” / “false”

“true”, wenn Panorama=echt

Kennzeichnung von echten Panorama­seiten, wenn Panorama=echt

ipo:Panorama

“true” / “false”

“true”, wenn SeitenTyp=Doppel

Kennzeichnung von Panoramaseiten, wenn SeitenTyp=Doppel

 

ipo:SeparationGroup (Seiteninformation) - Attribute

isd:ObjectUID

Zeichen

“<ID>“

ID der Seite.

Bei Durchlaufseiten wird die ID des Basis-Layouts übergeben. 

ipo:Name

Zeichen

DLayName

Name der Seite

ipo:PageFormat

“broadsheet”

-

„broadsheet“ wird immer übergeben.

ipo:Paging

Zeichen

RelSeitNr

Relative Seitennummer. Es werden keine detaillierten Informationen über die PaginaGruppe und den PaginaIndex übergeben.

ipo:Remark

Zeichen

Kommentar

Kommentar der Seite

ipo:SeparationGroup (Seiteninformation) - Verlinkung

ipo:SeparationLink

<isd:ObjectUID>

-

Link zu den Separationen dieser Seite

XML-Beispieldaten

  • Beispielprodukt “Objekt ta, Ausgabe ta-ma, Broadsheet, hp, 8 Seiten, unechtes Panorama an Position 2-3”

  • Dateiname: “1231-TA______ta-ma____hp______1.xml”

 

Planungsdatenexport & Druckort ändern

Im folgenden Video wird gezeigt, wie der KBA-Planungsdatenexport für ein Druckprodukt angestoßen wird und wie optional bei mehreren Druckstandorten der Druckort geändert werden kann.

https://www.youtube.com/watch?v=gakfoT5zLK0

 

Mitwirkungspflicht

Die notwendigen kundenseitigen Mitwirkungspflichten befinden sich unter:
https://peiq.atlassian.net/l/c/rF9QLHjU

Verweis auf Core Dokumentation

Dies ist eine Ergänzung zur Dokumentation der Variante dieser Schnittstelle und befindet sich im Core-Bereich. Sie ist somit exklusiv für berechtigte Nutzer:innen vorbehalten.

Verwandte Seiten

 

Nur für PEIQ-Mitarbeiter:

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