Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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
titleInhaltsverzeichnis anzeigen
Table of Contents
maxLevel4

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 Ü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>&quot;Bridgerton&quot; 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
Disclaimer der PEIQ PRINT NGEN - Produktdokumentation
Disclaimer der PEIQ PRINT NGEN - Produktdokumentation

Nur für PEIQ-Mitarbeiter:innen

/wiki/spaces/CORE/pages/1050345477