Page Comparison

...

Mitwirkungspflichten der Kund:innen

1. Bereitstellung Textbilder inkl. diverser Fälle (Metadatum, Format, Farbraum etc.) zur Kontrolle und für die kund:innenseitige Freigabe für den Massenimport (siehe Mitwirkungspflichten: [7-15] Archiv - Bereitstellung Testbilder und DAM-Größe).

2. Bereitstellung der Bilder im importierfähigen Format.

Allgemeine Beschreibung

Zur Der Bildimport mit Metadaten-XML dient zur Übernahme von Bildern inkl. Metadaten in den IPTC-Daten aus einem Drittsystem nach PRINT NGEN. Zunächst werden zunächst die Bilder inkl. ihrer in den Binärdaten enthaltenen IPTC-Daten von einem Metadaten vom sFTP-Server abgeholt. Zu jedem Bild kann auf Die Übernahmelogik der IPTC-Metadaten aus den Binärdaten der Bilddateien in die entsprechenden NGEN Eigenschaften ist in der separaten Doku Auslesen der IPTC-Tags bei Bildern beschrieben.

Zu jedem Bild kann auf dem sFTP ein begleitendes Metadaten-XML abgelegt sein, das ebenfalls Metadaten enthalten kann und nach/mit dem Import des Bildes importiert wird.

...

Das Update eines Bildes erfolgt nur an einem PRINT NGEN Bild mit dem Status “Original” und “DBildImportArt=BilderMitMetadatenXML” - auch wenn das Originalbild in PRINT NGEN bereits nachbearbeitet wurde (z. B. durch Vergabe von Metadaten, Verschlagwortung).

...

• Initiale, einmalige Übernahme eines Bildarchivs von einem Drittsystem nach PRINT NGEN.

• Die zu übertragenden Bilder verfügen nicht über ausreichende oder die gewünschten Metadaten in den IPTC-Daten. Entsprechend sollen zusätzliche Metadaten per Metadaten-XML angeliefert werden.

• Zusätzliche oder die gewünschten Metadaten sollen bei der Übertragung der Bilder anhand von zugehörigen Metadaten-XMLs in PRINT NGEN an den Bildern gesetzt werden.

• Updates der Bilder und Metadaten sollen per Schnittstelle möglich sein. Werden keine Updates bzw. der Import zusätzlicher Metadaten (Metadaten-XML) benötigt, kann alternativ die Schnittstelle [0-22] INBOUND Bilder (Archiv) verwendet werden.

Import

...

Trigger

Standardmäßig erfolgt der Import durch eine Warteschlange, die folgende Daten importiert:

...

Die Bilddateien mit zugehörigen Metadaten-XMLs:

• Gibt es bereits ein Bild zur externen ID des Bildes mit “DBildImportArt=BilderMitMetadatenXML”, wird das bestehende Bild in PRINT NGEN aktualisiert.

• Wenn es noch kein Bild gibt, wird ein neues angelegt.

• Die Metadaten werden aus den IPTC-Infos ausgelesen und in die PRINT NGEN Eigenschaften übernommen. Im Anschluss an das Auslesen der IPTC-Infos werden die Metadaten aus dem mitgelieferten Metadaten-XML ausgelesen und in die PRINT NGEN Eigenschaften übernommen. Metadaten, die aus den IPTC-Infos ausgelesen wurden, werden somit in den PRINT NGEN Eigenschaften ggf. durch die Metadaten aus dem Metadaten-XML überschrieben. XMLs mit kleinerem Timestamp werden zuerst importiert. Sollt beim Import zu einem Bild mehr als ein XML auf dem sFTP-Server leigen, wird zuerst das XML mit dem kleineren Timestamp und danach das Bild mit dem größeren Timestamp importiert.

...

Die Bilddateien (ohne zugehöriges Metadaten-XML):

• Gibt es bereits ein Bild zur externen ID des Bildes mit “DBildImportArt=BilderMitMetadatenXML”, wird das bestehende Bild in PRINT NGEN aktualisiert.

• Wenn es noch kein Bild gibt, wird ein neues angelegt.

• Die Metadaten werden aus den IPTC-Infos ausgelesen und in die PRINT NGEN Eigenschaften übernommen.

Metadaten-XMLs ohne Bilddateien:

...

Im Anschluss an den Import der Bilddateien mit oder ohne Metadaten-XMLs werden die einzelnen Metadaten-XMLs ohne Bilddateien importiert.

...

Ein einzelnes Metadaten-XML darf nur in dem Fall angeliefert werden, wenn bereits ein Originalbild mit “DBildImportArt=BilderMitMetadatenXML” zu dieser externen ID in PRINT NGEN vorliegt.

...

im 1min-Takt abgearbeitet wird.

Übertragungsart: sFTP

Der Import der Daten erfolgt von einer Destination im sFTP-Bereich (sftp://data.peiq.cloud/…) in der PEIQ Cloud. Diese Daten müssen vom Anlieferer (Dritten) zur Verfügung gestellt werden und werden durch PRINT NGEN “abgeräumt” (d. h. nach dem Import werden die entsprechenden Daten auf dem sFTP-Server gelöscht).

Namenskonvention

Timestamp

Der Timestamp ist folgendermaßen aufgebaut:

Monat (2-stellig), Tag (2-stellig), Stunde (2-stellig), Minute (2-stellig), Sekunde (2-stellig), Millisekunde (3-stellig)

Beispiel: "0512174535345"

Der Timestamp darf nicht für mehrere Bilder identisch sein.

Bild-Dateien

image_<externe ID>_<timestamp>.<Endung des Dateiformats z.B. “jpg”>

XML

image_<externe ID>_<timestamp>.xml 

Sonderzeichen im Dateinamen

Im Idealfall sollte die externe ID im Dateinamen der Bilder und XMLs nur aus den Zeichen 0-9, a-z, A-Z und “-” bestehen, um Probleme mit Sonderzeichen zu vermeiden.

Import der Daten

Zum Import läuft in PRINT NGEN eine Warteschlange, die folgende Daten importiert:

• Die Bilddateien mit zugehörigen Metadaten-XMLs:

  • Gibt es bereits ein Bild zur externen ID des Bildes mit “DBildImportArt=BilderMitMetadatenXML”, wird das bestehende Bild in PRINT NGEN aktualisiert.

  • Wenn es noch kein Bild gibt, wird ein neues angelegt.

  • Die Metadaten werden aus den IPTC-Infos ausgelesen und in die PRINT NGEN Eigenschaften übernommen. Im Anschluss an das Auslesen der IPTC-Infos werden die Metadaten aus dem mitgelieferten Metadaten-XML ausgelesen und in die PRINT NGEN Eigenschaften übernommen. Metadaten, die aus den IPTC-Infos ausgelesen wurden, werden somit in den PRINT NGEN Eigenschaften ggf. durch die Metadaten aus dem Metadaten-XML überschrieben. XMLs mit kleinerem Timestamp werden zuerst importiert. Sollt beim Import zu einem Bild mehr als ein XML auf dem sFTP-Server leigen, wird zuerst das XML mit dem kleineren Timestamp und danach das Bild mit dem größeren Timestamp importiert.

• Dateien, die mit einem Punkt im Dateinamen starten:

  • Dateien, die mit einem Punkt im Dateinamen starten, z. B. “.image_9876543210_08081000000.xml” werden noch geschrieben und dürfen daher von PRINT NGEN noch nicht importiert werden. Daher ignoriert PRINT NGEN beim Import alle Dateien, die mit einem Punkt starten und lässt diese im Import-Verzeichnis liegen.

• 0 KB große Dateien:

  • 0 KB große Dateien werden direkt ins Fehler-Verzeichnis verschoben, da davon ausgegangen wird, dass z. B. die Verbindung beim Schreiben der Dateien unterbrochen wurde und die Dateien damit kaputt bzw. nicht vollständig sind.

  • Ausnahme - 0 KB große Dateien, die mit einem Punkt starten: Diese bleiben entsprechend der Regelung “Dateien die mit einem Punkt im Dateinamen starten” im Import-Verzeichnis liegen.

Der Import läuft im 1-Minuten-Takt. Je Durchlauf der Warteschlange werden maximal 100 Bilder / einzelne Metadaten-XMLs importiert.

Import Trigger

Standardmäßig erfolgt der Import durch eine Warteschlange, die im 1min-Takt abgearbeitet wird.

Übertragungsart: sFTP

Der Import der Daten erfolgt von einer Destination im sFTP-Bereich (sftp://data.peiq.cloud/…) in der PEIQ Cloud. Diese Daten müssen vom Anlieferer (Dritten) zur Verfügung gestellt werden und werden durch PRINT NGEN “abgeräumt” (d. h. nach dem Import werden die entsprechenden Daten auf dem sFTP-Server gelöscht).

Namenskonvention

Timestamp

Der Timestamp ist folgendermaßen aufgebaut:

Monat (2-stellig), Tag (2-stellig), Stunde (2-stellig), Minute (2-stellig), Sekunde (2-stellig), Millisekunde (3-stellig)

Beispiel: "0512174535345"

Der Timestamp darf nicht für mehrere Bilder identisch sein.

Bild-Dateien

image_<externe ID>_<timestamp>.<Endung des Dateiformats z.B. “jpg”>

XML

image_<externe ID>_<timestamp>.xml 

Sonderzeichen im Dateinamen

Im Idealfall sollte die externe ID im Dateinamen der Bilder und XMLs nur aus den Zeichen 0-9, a-z, A-Z und “-” bestehen, um Probleme mit Sonderzeichen zu vermeiden.

Übertragung der Binärdaten

• Die Bilddateien (ohne zugehöriges Metadaten-XML):

  • Gibt es bereits ein Bild zur externen ID des Bildes mit “DBildImportArt=BilderMitMetadatenXML”, wird das bestehende Bild in PRINT NGEN aktualisiert.

  • Wenn es noch kein Bild gibt, wird ein neues angelegt.

  • Die Metadaten werden aus den IPTC-Infos ausgelesen und in die PRINT NGEN Eigenschaften übernommen.

• Metadaten-XMLs ohne Bilddateien:

  • Im Anschluss an den Import der Bilddateien mit oder ohne Metadaten-XMLs werden die einzelnen Metadaten-XMLs ohne Bilddateien importiert.

  • Ein einzelnes Metadaten-XML darf nur in dem Fall angeliefert werden, wenn bereits ein Originalbild mit “DBildImportArt=BilderMitMetadatenXML” zu dieser externen ID in PRINT NGEN vorliegt.

  • Gibt es noch kein Bild mit dieser externen ID und “DBildImportArt=BilderMitMetadatenXML” in PRINT NGEN, tritt beim Import ein Fehler auf, da noch kein entsprechendes Bild zu dieser externen ID gefunden wird. Das XML wird somit auf dem FTP-Server in das Fehler-Verzeichnis verschoben. XMLs mit kleinerem Timestamp werden zuerst importiert. Sollt beim Import zu einem Bild mehr als ein XML auf dem sFTP-Server leigen, wird zuerst das XML mit dem kleineren Timestamp und danach das Bild mit dem größeren Timestamp importiert.

• Dateien, die mit einem Punkt im Dateinamen starten:

  • Dateien, die mit einem Punkt im Dateinamen starten, z. B. “.image_9876543210_08081000000.xml” werden noch geschrieben und dürfen daher von PRINT NGEN noch nicht importiert werden. Daher ignoriert PRINT NGEN beim Import alle Dateien, die mit einem Punkt starten und lässt diese im Import-Verzeichnis liegen.

• 0 KB große Dateien:

  • 0 KB große Dateien werden direkt ins Fehler-Verzeichnis verschoben, da davon ausgegangen wird, dass z. B. die Verbindung beim Schreiben der Dateien unterbrochen wurde und die Dateien damit kaputt bzw. nicht vollständig sind.

  • Ausnahme - 0 KB große Dateien, die mit einem Punkt starten: Diese bleiben entsprechend der Regelung “Dateien die mit einem Punkt im Dateinamen starten” im Import-Verzeichnis liegen.

Der Import läuft im 1-Minuten-Takt. Je Durchlauf der Warteschlange werden maximal 100 Bilder / einzelne Metadaten-XMLs importiert.

Übertragung der Binärdaten

Beim Export der Daten durch den Anlieferer auf den sFTP-Server müssen zunächst die Binärdaten in ein entsprechendes Verzeichnis gelegt werden.  Dies umfasst die Bilder als JPG, PNG, PDF, TIF, TIF, Gif, Bmp, SVG, RAW, WEBP, HEIC oder EMF.

...

Zunächst werden beim Import eines Bildes die IPTC-Metadaten aus der Bilddatei ausgelesen und in die NGEN-Eigenschaften gemäß der Doku Auslesen der IPTC-Tags bei Bildern übernommen. Für NGEN Eigenschaften sind maximale Zeichenlängen definiert, die nicht überschritten werden dürfen/können. Sind in einem IPTC Feld mehr Zeichen enthalten, als in der entsprechenden NGEN-Eigenschaft gesetzt werden können, wird die Zeichenlänge entsprechend abgeschnitten und die abgeschnittene Zeichenlänge nach NGEN übernommen. Das gleiche gilt auch für die Übernahme von Metadaten aus dem Metadaten-XML. Beim Überschreiten der maximal erlaubten Zeichenlänge wird auch hier der String verkürzt und anschließend in verkürzter Form nach NGEN in die Eigenschaft übernommen.

Bei Updates zu einem bereits in NGEN bestehenden Bild gilt folgendes:

• Metadaten-Updates erfolgen nur über das Metadaten-XML. D.h. wenn eine Bilddatei zu einer externen ID erneut mit erweiterten Metadaten angeliefert wird, erfolgt hier kein Update der Eigenschaften in NGEN.

• Wird ein Metadaten-XML für ein Update angeliefert, werden alle befüllten Tags für das Update der NGEN Eigenschaften herangezogen. Leere oder nicht mitgelieferte Tags werden nicht berücksichtigt. D.h. diese Eigenschaften bleiben in NGEN auf ihrem bisherigen Stand.

• Soll eine Eigenschaft in NGEN leergesetzt werden, kann im entsprechenden Tag des XMLs der Wert “&lt;leer&gt;” mitgegeben werden. Das gilt für alle Eigenschaften außer <id>, <underline>, <source>, <caption>, <keywords><keyword priority="" type=""></keywords> (vgl. Tabelle unten).

Metadaten-XML

Das Wurzelelement der XML-Datei heißt “image”. Es folgt der Aufbau der XML-Struktur mit den Metadaten des Bildes.

...

^{Nur für PEIQ-Mitarbeiter:innen}

/wiki/spaces/CORE/pages/1050345477