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.
Über den Menüpunkt “Planungsdatenexport aller Druckprodukte” im Kontextmenü des Spiegels können die Planungsdaten aller der im Spiegel befindlichen Druckprodukte gleichzeitig exportiert werden.
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 Druckproduktes |
ipo:ShortLabel | Zeichen | PPAusgabe | Ausgabe des Druckproduktes |
ipo:ProductType | Zeichen | PPProduktTyp z.B.: “hp”, “vp1” | Produkttyp des Druckproduktes |
ipo:ShortProductType | Zeichen | PPProduktTyp z.B.: “hp”, “vp1” | Produkttyp des Druckproduktes |
ipo:PlannedCopies | Ganzzahl | PPAuflage | Auflage des Druckproduktes |
ipo:Remark | Zeichen | Kommentar | Kommentar Druckprodukt |
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 Panoramaseiten, 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.
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: