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.
Mit diesem Mechanismus können Viewer Antworten generieren, um die Präsentation einfacher Bilder, Videos, Videosets, Mustersets, Rotationssets, Seitensätze (E-Kataloge) und Mediensets zu informieren.
Die festgelegte Antwort für eine catalog::ImageSet
kann mithilfe der req=set
-Modifikator und Verweis auf die Katalogdatensatz-ID im Netzpfad. Alternativ kann das Bildset direkt in der URL angegeben werden, indem Sie die imageset=
-Modifikator. Wenn die Variable imageset=
-Modifikator zum Angeben des Bildsatzes verwendet wird, sollte der gesamte Wert in geschweifte Klammern eingeschlossen sein, um den Bildsatzwert zu maskieren und sicherzustellen, dass eingeschlossene Modifikatoren nicht als Teil der URL-Abfragezeichenfolge interpretiert werden.
Der festgelegte Mechanismus unterstützt die folgenden Arten von Antworten:
einfache Bilder |
Ein Bilddatensatz ohne catalog::ImageSet definiert wurde. |
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 |
Ein Satz von Elementen, bestehend aus einem grundlegenden Musterelement oder einem Verweis auf einen Musterset-Datensatz. |
Rotationssets |
Ein Satz von Elementen, der aus einer einfachen Liste von Bild-IDs besteht. |
zweidimensionale Rotationssets |
Ein Satz von Elementen, der aus einem einfachen Bild oder einem Verweis auf ein einfaches Rotationsset besteht. |
Seitensätze |
Ein Satz von Elementen, bestehend aus einer Liste mit bis zu drei Seitenbildern |
Mediensets |
Eine Gruppe 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 Muster enthalten. |
Videosets |
Ein Satz von Artikeln, bestehend aus einer Liste einfacher Videos. |
Wenn ein req=set
-Anfrage empfangen wird, wird der Typ der zu generierenden Antwort durch den Wert von catalog::AssetType
. Wenn catalog::AssetType
nicht definiert ist, wird der Antworttyp durch die folgenden Regeln bestimmt:
Wenn der Datensatz im Bildkatalog UND gefunden wird catalog::ImageSet
definiert ist
Wenn Datensatz sowohl in Bild- als auch in statischen Inhaltskatalogen gefunden wird
Wenn Datensatz im statischen Inhaltskatalog, NICHT jedoch im Bildkatalog gefunden wird
Wenn Eintrag im Bildkatalog, aber NICHT im statischen Inhaltskatalog gefunden wird
Wenn der Datensatz NICHT im Bildkatalog gefunden wird und NICHT im statischen Inhaltskatalog zu finden ist
In allen Fällen entspricht die resultierende XML-Antwort dem angegebenen XML-Dokument mit dem festgelegten Stammknoten, der dem erkannten Typ entspricht.
Wenn der äußere Satz als Mediensatz vom Typ erkannt wird, enthält die Antwort einen Satz von Medienset-Elementen, die jedem Medienset-Eintrag in catalog::ImageSet
. 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 Mediensatz-Elementtyp automatisch anhand der gleichen Regeln erkannt, die auf der äußeren Satzebene angewendet wurden.
Die zurückgegebene XML-Antwort entspricht der folgenden Spezifikation:
http://crc.scene7.com/is-docs/examples/mediaset.dtd
Die labelkey=
-Modifikator zusammen mit dem catalog::UserData
-Feld zum Generieren von Beschriftungen für Bilder und Muster. Die catalog:UserData
-Feld wird als Satz von Schlüssel/Wert-Paaren analysiert und die Beschriftungsschlüssel indiziert in diesen Satz, um den Wert für den angegebenen Schlüssel abzurufen. Dieser Wert wird dann im l
-Attribut für s
und i
.
Um die Größe der Antwort zu begrenzen und selbstreferenzierende Probleme zu vermeiden, wird die maximale Verschachtelungstiefe von der Servereigenschaft gesteuert PS::fvctx.nestingLimit
. 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 begrenzen, werden private Metadaten für Prospektset-Elemente gemäß der Servereigenschaft unterdrückt PS::fvctx.brochureLimit
. Alle privaten Metadaten, die mit der Broschüre verknüpft sind, werden exportiert, bis die Prospektbegrenzung erreicht ist. Nach Überschreiten des Grenzwerts werden private Maps und Benutzerdaten unterdrückt und ein entsprechendes Flag festgelegt, das angibt, welcher Datentyp unterdrückt wurde.
Verschachtelte Mediensets werden nicht unterstützt. Ein verschachteltes Medienset ist definiert als ein Medienset, das ein Medienset-Element vom Typ Medienset enthält. Wenn diese Bedingung erkannt wird, wird ein Fehler zurückgegeben.
Beispiel-XML-Antworten für req=set
-Anfrage finden Sie auf der Seite Eigenschaften unter HTML-Beispiele .
http://crc.scene7.com/is-docs/examples/properties.htm
req= , imageset=, catalog::ImageSet, Referenz zum Bildkatalog