PEIQ Knowledge Base
[0-22] INBOUND Bilder (Archiv)
- Former user (Deleted)
- Melanie Lutz
- Former user (Deleted)
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
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 https://peiq.atlassian.net/wiki/spaces/PPSD/pages/938016816
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 https://peiq.atlassian.net/wiki/spaces/PPSD/pages/1050247173 verwendet werden.Drittsystem bevorzugt die Übertragung per sFTP gegenüber der Übertragung per API über den Endpunkt POST /images der DAM API, vgl. https://peiq.atlassian.net/wiki/spaces/PPSD/pages/915701820
Mapping Metadaten
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: