Solicitudes de conjunto de medios media-set-requests
El servicio de imágenes proporciona un mecanismo para recuperar una respuesta de texto jerárquico (xml o json) que representa todos los recursos y metadatos asociados con catalog::ImageSet para un registro determinado.
Los visualizadores pueden utilizar este mecanismo para generar respuestas que informen a la presentación de imágenes, vídeos, conjuntos de vídeos, conjuntos de muestras, conjuntos de giros, conjuntos de páginas (catálogos electrónicos) y conjuntos de medios sencillos.
Sintaxis de solicitud section-d72b1d95e4ce4bb1b332ce096c2b99f1
La respuesta establecida para un(a) catalog::ImageSet
se puede recuperar mediante el modificador req=set
y haciendo referencia al id. de registro de catálogo en la ruta de acceso siguiente. Como alternativa, el conjunto de imágenes se puede especificar directamente en la dirección URL mediante el modificador imageset=
. Si se usa el modificador imageset=
para especificar el conjunto de imágenes, todo el valor debe incluirse entre llaves para omitir el valor del conjunto de imágenes y garantizar que los modificadores incluidos no se interpreten como parte de la cadena de consulta de la dirección URL.
Tipos de respuestas del conjunto section-93eb0a1f70344da2a888e56372ad3896
El mecanismo de conjunto admite los siguientes tipos de respuestas:
Detección del tipo de conjunto externo section-3dd6e453528d46898e559d31458a59ba
Cuando se recibe una solicitud req=set
, el tipo de respuesta que se va a generar se determina mediante el valor de catalog::AssetType
. Si catalog::AssetType
no está definido, el tipo de respuesta está determinado por las siguientes reglas:
-
Si se encuentra el registro en el catálogo de imágenes Y se ha definido
catalog::ImageSet
- Supongamos que el catálogo electrónico se ha definido si al menos una entrada del campo de registro Conjunto de imágenes contiene dos puntos
- Supongamos que el conjunto de medios está establecido si al menos una entrada del campo de conjunto de imágenes de registro contiene dos punto y coma.
- Supongamos que el conjunto de imágenes está establecido si al menos una entrada del campo de conjunto de imágenes de registro contiene un punto y coma.
- Supongamos que hay un conjunto de giros si ninguna entrada contiene dos puntos ni un punto y coma, pero al menos una entrada contiene un conjunto referenciado o un conjunto en línea (se trata de un conjunto de giros 2D).
- Supongamos que se trata de un conjunto desconocido si ninguna entrada contiene dos puntos o un punto y coma, ni un conjunto al que se hace referencia ni un conjunto en línea (es decir, una lista de imágenes separadas por comas).
-
Si el registro se encuentra en los catálogos de contenido estático Y de imagen
- Supongamos que el vídeo tiene la extensión de archivo en el siguiente conjunto: mp3, mp4, flv, f4v, swf, xml
- Suponer imagen de lo contrario
-
Si el registro se encuentra en el catálogo de contenido estático pero NO en el catálogo de imágenes
- Supongamos que el vídeo tiene la extensión de archivo en el siguiente conjunto: mp3, mp4, flv, f4v, swf, xml
- Suponer estático en caso contrario
-
Si el registro de se encuentra en el catálogo de imágenes pero NO en el catálogo de contenido estático
- Asumir imagen
-
Si el registro NO se encuentra en el catálogo de imágenes y NO se encuentra en el catálogo de contenido estático
- Supongamos que hay un vídeo basado en archivos si la extensión de archivo está en el siguiente conjunto: mp3, mp4, flv, f4v, swf, xml
- De lo contrario, supongamos una imagen basada en archivos
En todos los casos, la respuesta xml resultante se ajusta al documento XML especificado con el nodo raíz establecido correspondiente al tipo detectado.
Detección del tipo de conjunto interno section-8f46490e467247e69ce284704def06f3
Cuando se detecta el conjunto externo como un conjunto de medios de tipo, la respuesta contiene un conjunto de elementos del conjunto de medios correspondientes a cada entrada del conjunto de medios en catalog::ImageSet
. Si se especifica el parámetro de tipo opcional para una entrada de conjunto de medios determinada, se asigna a un tipo de salida según la tabla siguiente:
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 no se especifica el parámetro de tipo opcional para una entrada de conjunto de medios concreta o corresponde a un tipo no admitido, el tipo de elemento del conjunto de medios se detecta automáticamente utilizando las mismas reglas que se aplicaron en el nivel del conjunto externo.
Especificación XML section-c1bd60948ef545759a16885bb6fcc607
La respuesta xml devuelta se ajusta a la siguiente especificación:
http://crc.scene7.com/is-docs/examples/mediaset.dtd
LabelKey section-bf565de6f7294cf89620343c9071f415
El modificador labelkey=
se usa junto con el campo catalog::UserData
para generar etiquetas para imágenes y muestras. El campo catalog:UserData
se analiza como un conjunto de pares clave/valor y los índices labelkey se incluyen en este conjunto para recuperar el valor de la clave dada. Este valor se devuelve en el atributo l
para s
y i
.
Restricciones forzadas section-b9f042873bee45a5ae11b69fd42f2bca
Para limitar el tamaño de la respuesta y evitar problemas de autorreferencia, la profundidad máxima de anidación está controlada por la propiedad del servidor PS::fvctx.nestingLimit
. Si se supera este límite, se devuelve un error.
Para limitar el tamaño de las respuestas xml de los grandes conjuntos de catálogos electrónicos, se suprimen los metadatos privados para los elementos del conjunto de folletos según la propiedad del servidor PS::fvctx.brochureLimit
. Todos los metadatos privados asociados con el folleto se exportan hasta que se alcanza el límite. Una vez superado el límite, los mapas privados y los datos de usuario se suprimen y se establece un indicador correspondiente para indicar qué tipo de datos se suprimió.
No se admiten conjuntos de medios anidados. Un conjunto de medios anidado se define como un conjunto de medios que contiene un elemento del conjunto de medios del tipo conjunto de medios. Si se detecta esta condición, se devuelve un error.
Ejemplos section-588c9d33aa05482c86cd2b1936887228
Para obtener respuestas XML de ejemplo para la solicitud req=set
, consulte la página Propiedades en el encabezado Ejemplos de HTML.
http://crc.scene7.com/is-docs/examples/properties.htm
Véase también section-625ec466c948476e800dc0c52a4532d3
req= , imageset=, catálogo::ImageSet, Referencia de catálogo de imágenes