Image Serving bietet einen Mechanismus zum Abrufen einer hierarchischen Textantwort (xml oder json), die alle Ressourcen und Metadaten darstellt, die mit catalog::ImageSet für einen bestimmten Datensatz verknüpft sind.
Die Viewer können auf diese Weise Antworten generieren, um die Präsentation einfacher Bilder, Videos, Videosets, Mustersets, Rotationssets, Seitensätze (E-Kataloge) und Mediensets zu informieren.
Die set-Antwort für ein catalog::ImageSet
kann mit dem Modifikator req=set
abgerufen werden und auf die Katalog-Record-ID im Netzpfad verweisen. Alternativ kann der Bildsatz direkt in der URL mit dem Modifikator imageset=
angegeben werden. Wenn der Modifikator imageset=
verwendet wird, um den Bildsatz anzugeben, sollte der gesamte Wert in geschweifte Klammern gesetzt werden, um dem Bildsatzwert zu entkommen und sicherzustellen, dass eingeschlossene Modifikatoren nicht als Bestandteil der URL-Abfrage-Zeichenfolge interpretiert werden.
Der festgelegte Mechanismus unterstützt die folgenden Arten von Antworten:
einfache Bilder |
Ein Bilddatensatz ohne Definition von catalog::ImageSet. |
einfache Videos |
Ein Videodatensatz im statischen Inhaltskatalog. |
Mustersets |
Ein Satz von Elementen, bestehend aus einem Verweis auf einen Bilddatensatz und einem optionalen separaten Verweis auf einen Bilddatensatz, der als Muster verwendet wird. |
Hierarchische Mustersets |
Eine Gruppe von Elementen, die aus einem grundlegenden Musterelement oder einem Verweis auf einen Musterset-Datensatz besteht. |
Rotationssets |
Eine Gruppe von Elementen, die aus einer einfachen Liste von Bild-IDs bestehen. |
zweidimensionale Rotationssets |
Eine Gruppe von Elementen, die aus einem einfachen Bild oder einem Verweis auf ein einfaches Rotationsset bestehen. |
Seitensätze |
Eine Gruppe von Elementen bestehend aus einer Liste von bis zu drei Seitenbildern |
Mediensets |
Eine Reihe von Elementen, die aus einfachen Bildern, Videosets, Mustersets, hierarchischen Mustersets, Rotationssets, zweidimensionalen Rotationssets, Seitensätzen und Video-Assets bestehen. Jedes Medienset-Element kann auch ein optionales Farbfeld enthalten. |
Videosets |
Eine Reihe von Elementen, die aus einer Liste von einfachen Videos bestehen. |
Wenn eine req=set
-Anforderung empfangen wird, wird der Typ der zu generierenden Antwort durch den Wert catalog::AssetType
bestimmt. Wenn catalog::AssetType
nicht definiert ist, wird der Antworttyp durch die folgenden Regeln bestimmt:
Wenn Datensatz im Bildkatalog gefunden wird UND catalog::ImageSet
definiert ist
Wenn Datensätze in beiden Bild- UND statischen Inhaltskatalogen gefunden werden
Wenn Datensatz im statischen Inhaltskatalog, aber NICHT im Bildkatalog gefunden wird
Wenn Eintrag im Bildkatalog, aber NICHT im statischen Inhaltskatalog gefunden
Wenn der Datensatz NICHT im Bildkatalog und NICHT im statischen Inhaltskatalog gefunden wird
In allen Fällen entspricht die resultierende XML-Antwort dem angegebenen XML-Dokument, wobei der Set-Stammknoten dem erkannten Typ entspricht.
Wenn der äußere Satz als Typ-Mediensatz erkannt wird, enthält die Antwort eine Reihe von Medienset-Elementen, die jedem Medienset-Eintrag in catalog::ImageSet
entsprechen. Wenn der optionale Typparameter für einen bestimmten Mediensatzeintrag angegeben ist, wird er einem Ausgabetyp gemäß der folgenden Tabelle zugeordnet:
Eingabetyp | Ausgabetyp |
---|---|
img |
img |
basic |
img |
advanced_image |
img |
img_set |
img_set |
advanced_image_set |
img_set |
advanced_swatchset |
img_set |
spin |
spin |
video |
video |
video_set |
video_set |
static |
static |
ecat |
ecat |
Wenn der optionale Typparameter für einen bestimmten Mediensatzeintrag nicht angegeben ist oder einem nicht unterstützten Typ entspricht, wird der Mediensatzelementtyp automatisch anhand derselben Regeln erkannt, die auf der äußeren Einstellungsebene angewendet wurden.
Die zurückgegebene XML-Antwort entspricht der folgenden Spezifikation:
http://crc.scene7.com/is-docs/examples/mediaset.dtd
Der Modifikator labelkey=
wird zusammen mit dem Feld catalog::UserData
verwendet, um Beschriftungen für Bilder und Muster zu generieren. Das Feld catalog:UserData
wird als Satz Schlüssel/Wert-Paare analysiert und die Schlüssel-Indizes in diesem Satz, um den Wert für den angegebenen Schlüssel abzurufen. Dieser Wert wird dann im l
-Attribut für s
und i
zurückgegeben.
Um die Größe der Antwort zu begrenzen und Probleme mit selbstreferenzierenden Elementen zu vermeiden, wird die maximale Verschachtelungstiefe durch die Servereigenschaft PS::fvctx.nestingLimit
gesteuert. Wenn diese Grenze überschritten wird, wird ein Fehler zurückgegeben.
Um die Größe der XML-Antworten für große E-Katalog-Sets zu beschränken, werden private Metadaten für Prospektset-Elemente entsprechend der Servereigenschaft PS::fvctx.brochureLimit
unterdrückt. Alle mit der Broschüre verknüpften privaten Metadaten werden exportiert, bis die Prospektbeschränkung erreicht ist. Sobald der Grenzwert überschritten wurde, werden private Maps und Benutzerdaten unterdrückt und ein entsprechendes Flag wird gesetzt, um anzugeben, welcher Datentyp unterdrückt wurde.
Verschachtelte Mediensets werden nicht unterstützt. Ein verschachtelter Mediensatz ist definiert als ein Mediensatz, der ein Mediensatzelement vom Typ Mediensatz enthält. Wenn diese Bedingung erkannt wird, wird ein Fehler zurückgegeben.
Beispiel-XML-Antworten für req=set
-Anforderungen finden Sie auf der Seite Eigenschaften unter HTML-Beispiele.
http://crc.scene7.com/is-docs/examples/properties.htm
req= , imageset=, catalog::ImageSet, Bildkatalog-Referenz