Medienset-Anforderungen

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.

Anforderungssyntax

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.

Typen der eingestellten Antworten

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.

Erkennung des äußeren Einstellungstyps

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
- Angenommen, ein E-Katalog-Satz enthält mindestens einen Eintrag im Bildsatz-Datensatzfeld einen Doppelpunkt
- Nehmen Sie an, dass ein Medienset mindestens einen Eintrag im Bildsatz-Feld zwei Semikolons enthält.
- Angenommen, ein Bildsatz enthält mindestens einen Eintrag im Bildsatz-Feld ein Semikolon.
- Angenommen, ein Rotationsset enthält keinen Eintrag mit Doppelpunkt oder Semikolon, aber mindestens ein Eintrag enthält referenzierten Satz oder einen Inline-Satz (dies ist ein 2D-Rotationsset).
- Nehmen Sie einen unbekannten Satz an, wenn kein Eintrag Doppelpunkt, kein Semikolon oder einen Referenzsatz oder einen Inline-Satz enthält (d. h. eine kommagetrennte Liste von Bildern).
Wenn Datensätze in beiden Bild- UND statischen Inhaltskatalogen gefunden werden
- Gehen Sie von Video aus, wenn die Dateierweiterung in folgendem Satz liegt: mp3, mp4, flv, f4v, swf, xml
- Ansonsten Bild annehmen
Wenn Datensatz im statischen Inhaltskatalog, aber NICHT im Bildkatalog gefunden wird
- Gehen Sie von Video aus, wenn die Dateierweiterung in folgendem Satz liegt: mp3, mp4, flv, f4v, swf, xml
- Ansonsten statisch annehmen
Wenn Eintrag im Bildkatalog, aber NICHT im statischen Inhaltskatalog gefunden
- Abbildung annehmen
Wenn der Datensatz NICHT im Bildkatalog und NICHT im statischen Inhaltskatalog gefunden wird
- Nehmen Sie ein dateibasiertes Video an, wenn die Dateierweiterung in folgendem Satz liegt: mp3, mp4, flv, f4v, swf, xml
- Ansonsten dateibasiertes Bild

In allen Fällen entspricht die resultierende XML-Antwort dem angegebenen XML-Dokument, wobei der Set-Stammknoten dem erkannten Typ entspricht.

Innen-Set-Typerkennung

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.

XML-Spezifikation

Die zurückgegebene XML-Antwort entspricht der folgenden Spezifikation:

http://crc.scene7.com/is-docs/examples/mediaset.dtd

LabelKey

Der Modifikator labelkey= wird zusammen mit dem Feld catalog::UserDataverwendet, 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.

Erzwungene Beschränkungen

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.