Transportverfahren | sFTP (Anlieferung in der PEIQ Cloud durch Dritte) |
---|---|
Objekt | Metadaten-XML, 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, optional manuell, große Datenmengen sind vorher abzustimmen |
Unterstützte Drittsysteme | Typische Anbindungen sind Bild-Archive in Drittsystemen und Drittsysteme zur Content-Erstellung (Bild-Anlieferung vom Drittsystem) |
Beispieldaten | siehe unten |
Typische Drittsysteme | -- |
...
Expand | ||||
---|---|---|---|---|
| ||||
|
Mitwirkungspflichten der Kund:innen
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).
Bereitstellung der Bilder im importierfähigen Format.
Allgemeine Beschreibung
Zur Übernahme von Bildern inkl. Metadaten in den IPTC-Daten aus einem Drittsystem nach PRINT NGEN werden zunächst die Bilder inkl. ihrer IPTC-Daten von einem sFTP-Server abgeholt.
...
Code Block |
---|
<?xml version="1.0" encoding="utf-8"?> <image> <id>251-2298349</id> <status>Original</status> <object>mz</object> <underline>"Bridgerton" zählt zu den erfolgreichsten Netflix-Serien aller Zeiten.</underline> <source>privat</source> <caption>Bridgerton</caption> <filename>Beispielbild.jpg</filename> <honorar_id>mm</honorar_id> <origin>Archiv A</origin> <by_line>Max Mustermann</by_line> <edition>ma</edition> <category>pol</category> <location>Bergkirchen</location> <credit>Getty Images/iStockphoto</credit> <country>Deutschland</country> <date_time_created>31.05.2022 11:27</date_time_created> <object_name>Kulturzentrum</object_name> <service_identifier>dpa</service_identifier> <special_instructions>Kommentar</special_instructions> <title>Erfolgreiche Netflix-Serie</title> <urgency>3</urgency> <keywords> <keyword type="person" priority="1">Patrick Dempsey</keyword> <keyword type="organisation" priority="5">American Broadcasting Company</keyword> <keyword type="location" priority="3">USA</keyword> <keyword type="topic" priority="5">Serie</keyword> </keywords> <usage_instructions></usage_instructions> </image> |
Fehler beim Import
Allgemein
Tritt beim Import einer Datei ein Fehler auf, wird diese auf dem sFTP-Server in ein Unterverzeichnis “$fehler$” verschoben. Gibt es die Datei bereits im Fehler-Ordner, wird am Dateinamen eine Nummerierung mit “#1” angehängt, die entsprechend hochgezählt wird mit “#2” etc. , zum Beispiel:
image_123_0512174535345.xml
image_123_0512174535345#1.xml
image_123_0512174535345#2.xml etc.
Fehler hinsichtlich der Namenskonvention
Die Namenskonvention für die Bilddateien und XMLs ist oben detailliert definiert.
Entspricht eine Datei nicht dieser Namenskonvention, wird die Datei ins Fehler-Verzeichnis verschoben.
D.h. damit eine Datei importiert wird, muss der Dateiname:
bei einer Bilddatei der Struktur image_<externe ID>_<timestamp>.<Endung des Dateiformats z.B. “jpg”>
bzw. beim XML der Struktur image_<externe ID>_<timestamp>.xml entsprechen.
mit “image_” starten.
nach “image_” die externe ID enthalten, die nur aus folgenden Zeichen bestehen darf: a-z, A-Z, 0-9, “-” (D.h. z.B. Umlaute und andere Sonderzeichen als “-” sind nicht erlaubt.)
nach der externen ID mit “_” vom Timestamp getrennt sein.
als Timestamp13-Ziffern enthalten.
als Datei Extension eine Bilddatei-Endung oder “.xml” enthalten.
Ausnahmen:
Dateiname fängt mit einem Punkt “.” an: Diese Dateien bleiben liegen, da NGEN davon ausgeht, dass die Datei noch geschrieben wird.
XMLs, die der Namenskonvention image_<externe ID>_<timestamp>__<angehängter Timestamp>.xml (angehängter Timestamp, z.B. "20241017142203Z", entspricht dem Timestamp: "2024-10-17 14:22:03Z") entsprechen. bleiben auch liegen. Den angehängten Timestamp erstellt NGEN, wenn ein XML mit einer externen ID angeliefert wird, zu der es in NGEN noch kein Bild gibt. Wird während der Wartezeit von 10min kein zugehöriges Bild angeliefert, wird auch dieses XML ins Fehler-Verzeichnis verschoben.
Entspricht eine Datei nicht dieser Namenskonvention oder einer der Ausnahmen, wird sie nicht importiert und ins Fehler-Verzeichnis verschoben.
Mehr als ein Bild zur externen ID in NGEN vorhanden
Beim Import wird an den importierten Bildern (Bilder mit Status “Original”) in NGEN die Eigenschaft “DBildImportArt=BilderMitMetadatenXML” gesetzt. Andere Bildimporte setzen diese Eigenschaft nicht. Daher sollten nur über den Bildimport mit Metadaten-XML Bilder Bilder im Status “Original” mit dieser Eigenschaft importiert werden.
Zudem werden bei Updates über den Bildimport mit Metadaten-XML nur Bilder im Status “Original” mit der Eigenschaft “DBildImportArt=BilderMitMetadatenXML” upgedatet.
Daher sollte es in der Praxis nicht vorkommen, dass bei einem Import mit Metadaten-XML mehr als Bild zu dieser externen ID mit Status “Original” und der Eigenschaft “DBildImportArt=BilderMitMetadatenXML” gefunden werden. Sollte es doch einmal vorkommen (z.B. da ein Bild von einem anderen System repliziert wurde, der Status “Original” oder “DBildImportArt=BilderMitMetadatenXML” nachträglich gesetzt wurden), wird das Bild bzw. XML ins Fehler-Verzeichnis verschoben.
Maßgebliche DB-Tabellen
“DBild”
...
Include Page | ||||
---|---|---|---|---|
|
Nur für PEIQ-Mitarbeiter:innen