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
Der Bildimport mit Metadaten-XML dient zur Übernahme von Bildern inkl. Metadaten aus einem Drittsystem nach PRINT NGEN. Zunächst werden die Bilder inkl. ihrer in den Binärdaten enthaltenen IPTC-Metadaten vom sFTP-Server abgeholt. 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.
...
Sonderzeichen im Dateinamen
Im Idealfall sollte die Die externe ID im Dateinamen der Bilder und XMLs darf nur aus den Zeichen 0-9, a-z, A-Z und “-” bestehen, um Probleme mit Sonderzeichen zu vermeiden.
Prüfungen beim Import
...
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.
Die Bilddateien (ohne zugehöriges Metadaten-XML):
...
Beim Import werden die angelieferten Files hinsichtlich der Namenskonvention geprüft. 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.
Import der Daten
Zum Import läuft in PRINT NGEN eine Warteschlange, die die Bilder und XMLs in folgenden in zwei Blöcken importiert:
Block 1 - Import der Bilder mit/ohne zugehörige XMLs:
Zunächst werden alle Bilder mit oder ohne zugehörigen XMLs importiert. Hierbei wird je angelieferter Bilddatei geprüft, ob es bereits ein Bild zur externen ID Status “Original” und “DBildImportArt=BilderMitMetadatenXML” gibt. Falls ja, 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.
Mapping Metadaten
Übertragung der Metadaten
Im nächsten Schritt müssen die Metadaten im gleichen Verzeichnis des sFTP-Servers abgelegt werden. Die XML-Datei muss dabei bildweise geschickt werden. Mit dem Import dieses XMLs werden die Metadaten am Bild upgedatet.
Übernahmelogik von Metadaten nach NGEN
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 “<leer>” 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.
Image
...
Nr.
...
Tag
...
Beschreibung
...
PRINT NGEN Eigenschaft
...
1
...
<id>
...
ID des Bildes (beim Archivimport die externe ID des Drittanbieters)
...
DBildArchivID
...
2
...
<status>
...
Status
...
Status
...
3
...
<object>
...
Objekt
...
DBildObjekt und ggf. auch Mandant
...
4
...
<underline>
...
Bildunterschrift
...
Text/BU
...
5
...
<source>
...
Bildquelle innerhalb der BU
...
Text/BU/Bildquelle
...
6
...
<caption>
...
Caption
...
"Text/TagName!=BU,Beschreibung, IptcUeb"
...
7
...
<filename>
...
Bilddateiname
...
BildDateiName
...
8
...
<honorar_id>
...
Honorarkürzel
...
DBildHonEmpfaenger
...
9
...
<origin>
...
Bildursprung
...
BildUrsprung
...
10
...
<by_line>
...
Autorname
...
IptcAN
...
11
...
<edition>
...
Ausgabe
...
DBildAusgabe
...
12
...
<category>
...
Ressort
...
IptcRes
...
13
...
<location>
...
Ort
...
IptcStadt
...
14
...
<credit>
...
Objektrecht/Copyright
...
IptcOR
...
15
...
<country>
...
Land
...
IptcLand
...
16
...
<date_time_created>
...
Aufnahmedatum
...
IptcED
...
17
...
<object_name>
...
Objektname
...
IptcON
...
18
...
<service_identifier>
...
Dienst
...
IptcDie
...
19
...
<special_instructions>
...
Kommentar
...
IptcKom
...
20
...
<title>
...
Titel/Überschrift
...
IptcUeb
...
21
...
<urgency>
...
Priorität
...
IptcPri
...
22
<keywords>
Zudem wird geprüft, ob auf dem sFTP-Server XMLs zu dieser externen ID vorhanden sind. Sind mehrere XMLs vorhanden, werden diese nach Timestamp aufsteigend sortiert.
Hierbei werden auch die XMLs geprüft, die beim letzten Durchlauf der Warteschlange nicht importiert werden konnten, da es in NGEN noch kein Bild zur externen ID gab und auch noch keine zugehörige Bilddatei auf dem sFTP-Server vorhanden war.
Diese XMLs entsprechen der Namenskonvention image_<externe ID>_<timestamp>__<durch NGEN angehängter Timestamp>.xml. Der durch NGEN angehängte Timestamp wird in UTC (Greenwich mean Time; Universal Time Coordinates), z.B. 20241115101530Z (auf Sekunden genau) mit zwei Unterstrichen getrennt an den angelieferten Dateinamen angehängt.
Das XML mit dem kleinsten Timestamp wird zuerst importiert. Alle weiteren XMLs werden anschließend entsprechend ihrer Reihenfolge mit aufsteigenden Timestamps herangezogen, um die Eigenschaften am NGEN-Bild zu aktualisieren.
Metadaten, die aus den IPTC-Infos ausgelesen wurden, werden somit in den PRINT NGEN Eigenschaften ggf. durch die Metadaten aus dem Metadaten-XML überschrieben.
Block 2 - Import der einzelnen Metadaten-XMLs ohne Bilddateien#
Ein einzelnes Metadaten-XML sollten nur in dem Fall angeliefert werden, wenn bereits ein Originalbild mit “DBildImportArt=BilderMitMetadatenXML” zu dieser externen ID in PRINT NGEN vorliegt oder wenn direkt im Anschluss die zugehörige Bilddatei auf dem sFTP Server angeliefert wird.
Im Anschluss an den Import der Bilddateien mit oder ohne Metadaten-XMLs werden die einzelnen Metadaten-XMLs ohne Bilddateien importiert.
Zunächst werden die XMLs geprüft, die beim letzten Durchlauf der Warteschlange nicht importiert werden konnten, da es in NGEN noch kein Bild zur externen ID gab und auch noch keine zugehörige Bilddatei auf dem sFTP-Server vorhanden war.
Diese werden entsprechend ihres Timestamps sortiert und nacheinander abgearbeitet. XMLs mit kleineren Timestamps werden zuerst importiert.
Bei jedem Durchlaufen der Warteschlange wird geprüft, ob es ein Bild zur externen ID in NGEN gibt mit “Status=Original” und “DBildImportArt=BilderMitMetadatenXML”. Bilder mit zugehöriger Bilddatei zur externen ID wurden bereits in Block 1 berücksichtigt.
Falls es in NGEN bereits ein entsprechendes Bild zur externen ID gibt, werden die Eigenschaften an diesem NGEN Bild anhand der im XML mitgelieferten Metadaten aktualisiert.
Gibt es zu einer im Dateinamen des XMLs angegebenen externen ID in NGEN noch kein Bild mit Status “Original" und “DBildImportArt=BilderMitMetadatenXML”, wird die Datei zunächst umbenannt, wobei an den ursprünglichen Dateinamen ein weiterer Timestamp angehängt wird.
Diese XMLs entsprechen der Namenskonvention image_<externe ID>_<timestamp>__<durch NGEN angehängter Timestamp>.xml. Der durch NGEN angehängte Timestamp wird in UTC (Greenwich mean Time; Universal Time Coordinates), z.B. 20241115101530Z (auf Sekunden genau) mit zwei Unterstrichen getrennt an den angelieferten Dateinamen angehängt.
Für den durch NGEN angehängten Timestamp ist in NGEN eine Wartedauer hinterlegt. Diese liegt bei 10min. Ist die 10min-Wartedauer abgelaufen und immer noch kein entsprechendes Bild in NGEN vorhanden, wird das XML ins Fehler-Verzeichnis verschoben. Ist die Wartedauer noch nicht abgelaufen, bleibt das XML zunächst auf dem sFTP-Server liegen, bis die Warteschlange das nächste Mal läuft.
B
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.
Mapping Metadaten
Übertragung der Metadaten
Im nächsten Schritt müssen die Metadaten im gleichen Verzeichnis des sFTP-Servers abgelegt werden. Die XML-Datei muss dabei bildweise geschickt werden. Mit dem Import dieses XMLs werden die Metadaten am Bild upgedatet.
Übernahmelogik von Metadaten nach NGEN
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 “<leer>” mitgegeben werden. Das gilt für alle Eigenschaften außer <id>, <underline>, <source>, <caption>, <keywords><keyword priority="" type=""
...
></keywords>
...
Schlagwörter
type=person (für Personen) / location (für Orte) / organisation (für Organisationen) / topic (für allgemeine Schlagwörter)
priority = Priorität von 1 bis 5
...
SchlagwortXml
...
23
...
<usage_instructions>
...
Verwendungshinweis für zurückgezogene Bilder
...
DBildVerwendungsHinweis
Es können Tags weggelassen oder leer übertragen werden, wenn diese nicht benötigt werden. Wichtig hierbei ist, dass die in der Tabelle dokumentierte Reihenfolge der Tags eingehalten wird.
Metadaten werden nicht gesetzt, wenn die übergebenen Werte nicht zum Attributtyp (bspw. Zeichenfolge anstatt Datum/Uhrzeit für <date_time_created>) passen.
Beispiel
| 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.(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.
Image
Nr. | Tag | Beschreibung | PRINT NGEN Eigenschaft |
|---|---|---|---|
1 | <id> | ID des Bildes (beim Archivimport die externe ID des Drittanbieters) | DBildArchivID |
2 | <status> | Status | Status |
3 | <object> | Objekt | DBildObjekt und ggf. auch Mandant |
4 | <underline> | Bildunterschrift | Text/BU |
5 | <source> | Bildquelle innerhalb der BU | Text/BU/Bildquelle |
6 | <caption> | Caption | "Text/TagName!=BU,Beschreibung, IptcUeb" |
7 | <filename> | Bilddateiname | BildDateiName |
8 | <honorar_id> | Honorarkürzel | DBildHonEmpfaenger |
9 | <origin> | Bildursprung | BildUrsprung |
10 | <by_line> | Autorname | IptcAN |
11 | <edition> | Ausgabe | DBildAusgabe |
12 | <category> | Ressort | IptcRes |
13 | <location> | Ort | IptcStadt |
14 | <credit> | Objektrecht/Copyright | IptcOR |
15 | <country> | Land | IptcLand |
16 | <date_time_created> | Aufnahmedatum | IptcED |
17 | <object_name> | Objektname | IptcON |
18 | <service_identifier> | Dienst | IptcDie |
19 | <special_instructions> | Kommentar | IptcKom |
20 | <title> | Titel/Überschrift | IptcUeb |
21 | <urgency> | Priorität | IptcPri |
22 | <keywords> <keyword priority="" type=""> </keywords> | Schlagwörter
| SchlagwortXml |
23 | <usage_instructions> | Verwendungshinweis für zurückgezogene Bilder | DBildVerwendungsHinweis |
Es können Tags weggelassen oder leer übertragen werden, wenn diese nicht benötigt werden. Wichtig hierbei ist, dass die in der Tabelle dokumentierte Reihenfolge der Tags eingehalten wird.
Metadaten werden nicht gesetzt, wenn die übergebenen Werte nicht zum Attributtyp (bspw. Zeichenfolge anstatt Datum/Uhrzeit für <date_time_created>) passen.
Beispiel
| 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.
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.
...
Mehr als ein Bild zur externen ID in NGEN vorhanden
...
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.
Bei Updates über den Bildimport mit Metadaten-XML werden nur Bilder im Status “Original” mit der Eigenschaft “DBildImportArt=BilderMitMetadatenXML” upgedatet. Andere Workflows ändern den Wert der Eigenschaft “DBildImportArt” nicht mehr. D.h. es gibt keine Bilder, die nachträglich noch “DBildImportArt=BilderMitMetadatenXML” erhalten. Zudem sind für Bilder mit “DBildImportArt=BilderMitMetadatenXML” keine Workflows vorgesehen, die an Bildern nachträglich noch den Status “Original” setzen.
Entsprechend 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 sowohl den Status “Original” als auch die Eigenschaft “DBildImportArt=BilderMitMetadatenXML” upgedateterhalten.
Daher In der Praxis sollte es in der Praxis daher nicht vorkommen, dass bei einem Import mit Metadaten-XML mehr als Bild zu dieser zur 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.
...
| Include Page | ||||
|---|---|---|---|---|
|
Nur für PEIQ-Mitarbeiter:innen