La diffusion d’images fournit un mécanisme permettant de récupérer une réponse de texte hiérarchique (xml ou json) qui représente toutes les ressources et métadonnées associées à catalog::ImageSet pour un enregistrement particulier.
Les visionneuses peuvent utiliser ce mécanisme pour générer des réponses afin d’informer la présentation d’images, de vidéos, de visionneuses de vidéos, d’échantillons, de visionneuses à 360°, de pages (catalogues électroniques) simples et de visionneuses de médias.
La réponse définie pour un catalog::ImageSet
peut être récupéré à l’aide de la fonction req=set
Modifiez et référencez l’identifiant d’enregistrement du catalogue dans le chemin d’accès net. Vous pouvez également spécifier la visionneuse d’images directement dans l’URL à l’aide de la variable imageset=
modifier. Si la variable imageset=
est utilisé pour spécifier le jeu d’images, la valeur entière doit être entourée d’accolades afin d’échapper la valeur de la visionneuse d’images et de s’assurer que les modificateurs inclus ne sont pas interprétés comme faisant partie de la chaîne de requête d’URL.
Le mécanisme d’ensemble prend en charge les types de réponses suivants :
images simples |
Un enregistrement d’image sans catalogue : ImageSet définie. |
vidéos simples |
Enregistrement vidéo dans le catalogue de contenu statique. |
ensembles d’échantillons |
Ensemble d’éléments constitué d’une référence à un enregistrement d’image et d’une référence séparée facultative à un enregistrement d’image utilisé comme échantillon. |
jeux d’échantillons hiérarchiques |
Ensemble d’éléments constitué d’un élément d’échantillon de base ou d’une référence à un enregistrement d’ensemble d’échantillons. |
visionneuses à 360° |
Un ensemble d’éléments constitué d’une liste simple d’identifiants d’image. |
visionneuses à 360° bidimensionnelles |
Ensemble d’éléments constitué d’une image simple ou d’une référence à une visionneuse à 360° de base. |
jeux de pages |
Un ensemble d’éléments constitué d’une liste de trois images de page au maximum. |
visionneuses de médias |
Ensemble d’éléments constitué d’images simples, de visionneuses de vidéos, d’ensembles d’échantillons, d’ensembles d’échantillons hiérarchiques, de visionneuses à 360°, de visionneuses à 360° bidimensionnelles, de pages et de ressources vidéo. Chaque élément de visionneuse de médias peut également contenir un échantillon facultatif. |
visionneuses de vidéos |
Ensemble d’éléments consistant en une liste de vidéos simples. |
Lorsqu’une req=set
est reçue, le type de réponse à générer est déterminé par la valeur de catalog::AssetType
. If catalog::AssetType
n’est pas définie, alors le type de réponse est déterminé par les règles suivantes :
Si l’enregistrement se trouve dans le catalogue d’images ET catalog::ImageSet
est défini
Si l’enregistrement se trouve dans les catalogues d’image ET de contenu statique
Si l’enregistrement se trouve dans le catalogue de contenu statique mais PAS dans le catalogue d’images
Si l’enregistrement se trouve dans le catalogue d’images mais PAS dans le catalogue de contenu statique
Si l’enregistrement est introuvable dans le catalogue d’images et INTROUVABLE dans le catalogue de contenu statique
Dans tous les cas, la réponse XML obtenue sera conforme au document XML spécifié avec le noeud racine défini correspondant au type détecté.
Lorsque l’ensemble externe est détecté comme un ensemble de médias de type, la réponse contient un ensemble d’éléments de visionneuse de médias correspondant à chaque entrée de visionneuse de médias dans catalog::ImageSet
. Si le paramètre de type facultatif est spécifié pour une entrée de visionneuse de médias spécifique, il est mappé à un type de sortie selon le tableau suivant :
Type d’entrée | Type de sortie |
---|---|
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 |
Si le paramètre de type facultatif pour une entrée de visionneuse de médias spécifique n’est pas spécifié ou correspond à un type non pris en charge, le type d’élément de visionneuse de médias est automatiquement détecté à l’aide des mêmes règles que celles appliquées au niveau de l’ensemble externe.
La réponse xml renvoyée est conforme à la spécification suivante :
http://crc.scene7.com/is-docs/examples/mediaset.dtd
Le labelkey=
est utilisé avec la propriété catalog::UserData
pour générer des libellés pour les images et les échantillons. Le catalog:UserData
est analysé sous la forme d’un ensemble de paires clé/valeur et les index de clé de libellé dans cet ensemble pour récupérer la valeur de la clé donnée. Cette valeur est alors renvoyée dans la variable l
pour l’attribut s
et i
.
Pour limiter la taille de la réponse et empêcher les problèmes d’auto-référence, la profondeur d’imbrication maximale est contrôlée par la propriété du serveur. PS::fvctx.nestingLimit
. Si cette limite est dépassée, une erreur est renvoyée.
Afin de limiter la taille des réponses xml pour les jeux de catalogues électroniques volumineux, les métadonnées privées sont supprimées pour les éléments de jeu de brochures en fonction de la propriété du serveur . PS::fvctx.brochureLimit
. Toutes les métadonnées privées associées à la brochure sont exportées jusqu’à ce que la limite de la brochure soit atteinte. Une fois la limite dépassée, les mappages privés et les données utilisateur sont supprimés et un indicateur correspondant est défini pour indiquer le type de données supprimé.
Les visionneuses de médias imbriquées ne sont pas prises en charge. Une visionneuse de médias imbriquée est définie comme une visionneuse de médias qui contient un élément de visionneuse de médias de type visionneuse de médias. Si cette condition est détectée, une erreur est renvoyée.
Pour les exemples de réponses XML pour req=set
Voir la page Propriétés sous l’en-tête Exemples de HTML .
http://crc.scene7.com/is-docs/examples/properties.htm
req= , imageset=, catalogue : ImageSet, Référence du catalogue d’images