Solicitudes de conjuntos de medios

Image Serving 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 en particular.

Los visualizadores pueden utilizar este mecanismo para generar respuestas que informen a la presentación de imágenes simples, vídeos, conjuntos de vídeos, conjuntos de muestras, conjuntos de giros, conjuntos de páginas (catálogos electrónicos) y conjuntos de medios.

Sintaxis de solicitud

La respuesta establecida para un catalog::ImageSet se puede recuperar utilizando la variable req=set modificador y referencia al id de registro de catálogo en la ruta de acceso de red. De forma alternativa, el conjunto de imágenes se puede especificar directamente en la dirección URL utilizando la variable imageset= modificador. Si la variable imageset= se utiliza para especificar el conjunto de imágenes, todo el valor debe escribirse entre llaves para omitir el valor del conjunto de imágenes y asegurarse de que los modificadores incluidos no se interpreten como parte de la cadena de consulta de URL.

Tipos de respuestas definidas

El mecanismo de conjunto admite los siguientes tipos de respuestas:

imágenes simples	Un registro de imagen sin catálogo::ImageSet definida.
vídeos simples	Un registro de vídeo en el catálogo de contenido estático.
conjuntos de muestras	Conjunto de elementos que consta de una referencia a un registro de imagen y una referencia opcional independiente a un registro de imagen utilizado como muestra.
conjuntos de muestras jerárquicos	Conjunto de elementos que consta de un elemento de muestra básico o una referencia a un registro de conjunto de muestras.
conjuntos de giros	Conjunto de elementos que consta de una lista sencilla de ID de imagen.
conjuntos de giros bidimensionales	Conjunto de elementos que consta de una imagen simple o una referencia a un conjunto de giros básico.
conjuntos de páginas	Conjunto de elementos que consta de una lista de hasta tres imágenes de página
conjuntos de medios	Conjunto de elementos que consta de imágenes simples, conjuntos de vídeos, conjuntos de muestras, conjuntos de muestras jerárquicas, conjuntos de giros, conjuntos de giros bidimensionales, conjuntos de páginas y recursos de vídeo. Cada elemento del conjunto de medios también puede contener una muestra opcional.
conjuntos de vídeos	Conjunto de elementos que consta de una lista de vídeos sencillos.

Detección de tipo de conjunto exterior

Cuando una req=set se recibe la solicitud, el tipo de respuesta que se va a generar se determina por el valor de catalog::AssetType. If catalog::AssetType no está definida, el tipo de respuesta está determinado por las siguientes reglas:

Si el registro se encuentra en el catálogo de imágenes Y catalog::ImageSet está definido
- Supongamos que el catálogo electrónico está configurado si al menos una entrada del campo de conjunto de imágenes del registro contiene dos puntos
- Supongamos que el conjunto de medios contiene al menos una entrada en el campo de conjunto de imágenes de registro que contiene dos punto y coma.
- Supongamos que el conjunto de imágenes contiene al menos una entrada en el campo de conjunto de imágenes de registro que contiene un punto y coma.
- Supongamos que el conjunto de giros no contiene dos puntos ni punto y coma, pero al menos una entrada contiene un conjunto o conjunto en línea al que se hace referencia (se trata de un conjunto de giros 2D).
- Supongamos que no se conoce el conjunto si ninguna entrada contiene dos puntos o punto y coma, no se hace referencia al conjunto ni al 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 AND de imagen
- Supongamos que el vídeo está en el siguiente conjunto: mp3, mp4, flv, f4v, swf, xml
- Suponer imagen de otro modo
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 está en el siguiente conjunto: mp3, mp4, flv, f4v, swf, xml
- Supongamos que es estático de lo contrario
Si el registro se encuentra en el catálogo de imágenes pero NO en el catálogo de contenido estático
- Suponer 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 el vídeo basado en archivos está en el siguiente conjunto de extensiones de archivo: mp3, mp4, flv, f4v, swf, xml
- Supongamos que la imagen basada en archivos no es así

En todos los casos, la respuesta xml resultante se ajustará al documento XML especificado con el nodo raíz configurado correspondiente al tipo detectado.

Detección de tipo de conjunto interior

Cuando el conjunto exterior se detecta como conjunto de medios de tipo , la respuesta contiene un conjunto de elementos de conjunto de medios correspondientes a cada entrada de conjunto de medios en catalog::ImageSet. Si se especifica el parámetro de tipo opcional para una entrada de conjunto de medios en particular, se asigna a un tipo de salida según la siguiente tabla:

Tipo de entrada	Tipo de salida
`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 determinada o corresponde a un tipo no admitido, el tipo de elemento de conjunto de medios se detecta automáticamente utilizando las mismas reglas que se aplicaron en el nivel de conjunto exterior.

Especificación XML

La respuesta xml devuelta se ajusta a la siguiente especificación:

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

LabelKey

La variable labelkey= el modificador se usa junto con la variable catalog::UserDatapara generar etiquetas para imágenes y muestras. La variable catalog:UserData se analiza como un conjunto de pares clave/valor y la clave de la etiqueta se indexa en este conjunto para recuperar el valor de la clave dada. Este valor se devuelve en la variable l para la variable s y i.

Restricciones aplicadas

Para limitar el tamaño de la respuesta y evitar problemas de referencia automática, la profundidad máxima de anidación está controlada por la propiedad server PS::fvctx.nestingLimit. Si se supera este límite, se devuelve un error.

Para limitar el tamaño de las respuestas xml para grandes conjuntos de catálogos electrónicos, se eliminan los metadatos privados para los elementos de conjuntos de folletos de acuerdo con la propiedad server PS::fvctx.brochureLimit. Todos los metadatos privados asociados con el folleto se exportan hasta que se alcance el límite de folletos. Una vez superado el límite, se suprimen los mapas privados y los datos de usuario y se establece un indicador correspondiente para indicar qué tipo de datos se suprimieron.

No se admiten conjuntos de medios anidados. Un conjunto de medios anidado se define como un conjunto de medios que contiene un elemento de conjunto de medios de tipo conjunto de medios. Si se detecta esta condición, se devuelve un error.