PEIQ Knowledge Base

[0-22] INBOUND Bilder (Archiv)

Transportverfahren

sFTP (Anlieferung in der PEIQ Cloud durch Dritte)

Objekt

Original-Bilder Dateigröße: >500 KB, Bilder als JPG, PNG, PDF, TIF, TIF, Gif, Bmp, SVG, RAW, WEBP, HEIC, EMF (inkl. IPTC-Infos)

Trigger

automatisch, große Datenmengen sind vorher abzustimmen

Unterstützte Drittsysteme

Typische Anbindungen sind Bild-Archive in Drittsystemen

Beispieldaten

siehe unten

Typische Drittsysteme

--

Mit der hier beschriebenen Importfunktion können einzelne Archiv-Bilder (inkl. IPTC Infos) durch Dritte auf dem sFTP-Server zur Verfügung gestellt werden und von dort aus nach NGen importiert werden.

Die Datenanlieferung und der Import nach NGen erfolgen in der PEIQ Cloud im sFTP-Bereich (sftp://data.peiq.cloud/…). Typische Anbindung sind Bild-Archive.

Inhaltsverzeichnis

Funktionalitäten der Schnittstelle

  • Bilder können inkl. Metadaten in den IPTC-Daten aus einem externen Archiv nach NGen übernommen werden. 

  • Dazu werden die Bilder inkl. ihrer IPTC-Daten von einem SFTP-Server abgeholt.

  • Für die Übernahme der Metadaten nach NGen sind fixe Mapping-Logiken definiert.

  • Die aus dem Archiv importierten Bilder können in der Web-Recherche in Create und in der Client-Recherche in NGen gesucht und verwendet werden.

  • Die Archivbilder müssen in objekt- und ausgabenspezifischen Unterverzeichnissen auf dem SFTP-Server, d.h. in Archivimport/Bilder/<DBildObjekt>/<DBildAusgabe> angeliefert werden. Aus dem Dateipfad werden Objekt- und Ausgabenkürzel ausgelesen und in die Eigenschaften des Bildes in PRINT NGEN übernommen.
    Hinweis: Alle Archivbilder müssen in einem Unterordner /<DBildObjekt>/<DBildAusgabe> angeliefert werden und dürfen nicht z.B. direkt in Archivimport/Bilder/ einlaufen. Andernfalls werden fehlerhafte Werte in den Eigenschaften DBildObjekt und DBildAusgabe der importierten Bilder in PRINT NGEN gespeichert bzw. der Import dieser Bilder schlägt fehl.

Mitwirkungspflichten/Beistellung des Kunden

  1. Bereitstellung Textbilder (inkl. diverser Fälle (Metadatum, Format, Farbraum, etc.) zum Kontrollieren und für die Freigabe seitens des Kunden für den Massenimport siehe

  2. Bereitstellung der Bilder im importierfähigen Format

Aufbereitung und Übertragung der Daten

Format

Es werden nur Original-Bilder mit einer Dateigröße: >500 KB für den Archiv-Import vorgesehen.

Importierfähige Datenformate sind: highres png, jpg, pdf, tif (, gif, bmp, svg, raw, webp, heic, emf)

Die Metadaten der Bilder können im Bild selbst in den IPTC Daten mitgegeben werden.

Farbraum

Idealerweise nur RGB (CMYK geht auch, ist aber schlecht, da nicht für autom. Bildoptimierung geeignet und bei Verwendung für Online problematisch)

Namenskonvention im Dateinamen

Im Idealfall sollte der Dateiname nur aus den Zeichen 0-9, a-z, A-Z, “_” und “-” bestehen, um Probleme mit Sonderzeichen zu vermeiden. Auch ä-ü, Ä-Ü und ß können verarbeitet werden.

Werden die nicht erlaubten Zeichen “*”, “?”, “<“, “>”, “&”, “"“ und “'“ im Dateinamen verwendet, können die Eigenschaften BildDateiName und OriginalPfad in NGEN nicht gesetzt werden und bleiben entsprechend leer.

Werden andere Sonderzeichen im Dateinamen verwendet, werden diese beim Import ggf. durch ein “_” ersetzt und mit der ersetzten Schreibweise in der NGEN Eigenschaft BildDateiName und OriginalPfad angegeben.

Usecases

  • Übernahme eines Bildarchivs von einem Drittsystem nach NGen

  • Die zu übertragenden Bilder verfügen über ausreichende Metadaten in den IPTC-Daten.
    Werden Updates bzw. der Import zusätzlicher Metadaten (Metadaten-XML) benötigt, kann alternativ die Schnittstelle verwendet werden.

  • Drittsystem bevorzugt die Übertragung per sFTP gegenüber der Übertragung per API über den Endpunkt  POST /images der DAM API, vgl. 

Mapping Metadaten

vgl.

Workflow

Nach Ablage auf dem übergebenen SFTP-Ordner werden die Bilddateien automatisch importiert und die Metadaten aus den IPTC-Daten ausgelesen und am Bild in den NGen-Eigenschaften gespeichert. Zudem werden aus dem Dateipfad auf dem SFTP-Server (Archivimport/Bilder/<DBildObjekt>/<DBildAusgabe>) die Objekt- und Ausgabenkürzel ausgelesen und in die Eigenschaften des Bildes in PRINT NGEN übernommen.

Hinweis: Alle Archivbilder müssen in einem Unterordner /<DBildObjekt>/<DBildAusgabe> angeliefert werden und dürfen nicht z.B. direkt in Archivimport/Bilder/ einlaufen. Andernfalls werden fehlerhafte Werte in den Eigenschaften DBildObjekt und DBildAusgabe der importierten Bilder in PRINT NGEN gespeichert bzw. der Import dieser Bilder schlägt fehl.

Für den Import wird von einer Zeit von 5 Sekunden pro Bild im Durchschnitt ausgegangen - abhängig von der Größe des Bildes.

Bitte informieren Sie sich bzgl. der Belieferung möglicher großer Datenmengen bei Ihrem/Ihrer Projektmanager:in, um eine Überlastung des Servers zu vermeiden und entsprechende Vorkehrungen vorab seitens PEIQ treffen zu können.

Nur für PEIQ-Mitarbeiter:

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