Solicitações de conjunto de mídia

A Exibição de imagem fornece um mecanismo para buscar uma resposta de texto hierárquica (xml ou json) que representa todos os recursos e metadados associados a catalog::ImageSet para um registro específico.

Os visualizadores podem usar esse mecanismo para gerar respostas para informar a apresentação de imagens simples, vídeos, conjuntos de vídeos, conjuntos de amostras, conjuntos de rotação, conjuntos de páginas (e-catálogos) e conjuntos de mídia.

Sintaxe da solicitação

A resposta definida para um catalog::ImageSet podem ser recuperadas usando o req=set modificador e referenciando a id de registro do catálogo no caminho de rede. Como alternativa, o conjunto de imagens pode ser especificado diretamente no URL usando o imageset= modificador. Se a variável imageset= modificador é usado para especificar o conjunto de imagens, o valor inteiro deve ser delimitado em chaves para evitar o valor do conjunto de imagens e garantir que todos os modificadores incluídos não sejam interpretados como parte da string de consulta de URL.

Tipos de respostas definidas

O mecanismo de definição oferece suporte aos seguintes tipos de respostas:

imagens simples	Um registro de imagem sem catálogo::ImageSet definido.
vídeos simples	Um registro de vídeo no catálogo de conteúdo estático.
conjuntos de amostras	Um conjunto de itens que consiste em uma referência a um registro de imagem e uma referência separada opcional a um registro de imagem usado como amostra.
conjuntos de amostras hierárquicas	Um conjunto de itens que consiste em um item de amostra básico ou uma referência a um registro de conjunto de amostras.
conjuntos de rotação	Um conjunto de itens que consiste em uma lista simples de IDs de imagem.
conjuntos de rotação bidimensionais	Um conjunto de itens que consiste em uma imagem simples ou uma referência a um conjunto de rotação básico.
conjuntos de páginas	Um conjunto de itens que consiste em uma lista de até três imagens de página
conjuntos de mídia	Um conjunto de itens que consiste em imagens simples, conjuntos de vídeos, conjuntos de amostras, conjuntos de amostras hierárquicas, conjuntos de rotação, conjuntos de rotação bidimensionais, conjuntos de páginas e ativos de vídeo. Cada item do conjunto de mídia também pode conter uma amostra opcional.
conjuntos de vídeos	Um conjunto de itens que consiste em uma lista de vídeos simples.

Detecção de tipo de conjunto externo

Quando uma req=set for recebida, o tipo de resposta a ser gerada é determinado pelo valor de catalog::AssetType. If catalog::AssetType não estiver definido, o tipo de resposta será determinado pelas seguintes regras:

Se o registro for encontrado no catálogo de imagens AND catalog::ImageSet está definido
- Suponha que o catálogo eletrônico seja definido se pelo menos uma entrada no campo Registrar Conjunto de Imagens contiver dois pontos
- Suponha que a mídia seja definida se pelo menos uma entrada no campo Gravar Imageset contiver dois ponto e vírgula.
- Suponha que a imagem seja definida se pelo menos uma entrada no campo Registrar conjunto de imagens contiver um ponto e vírgula.
- Considere o conjunto de rotação se nenhuma entrada contiver dois pontos ou ponto e vírgula, mas pelo menos uma entrada contiver um conjunto referenciado ou um conjunto em linha (esse é um conjunto de rotação 2D).
- Suponha que o conjunto seja desconhecido se nenhuma entrada contiver dois pontos, ponto e vírgula ou um conjunto referenciado ou um conjunto em linha (ou seja, lista de imagens separada por vírgulas).
Se o registro for encontrado em catálogos de imagem E conteúdo estático
- Suponha vídeo se a extensão de arquivo estiver no seguinte conjunto: mp3, mp4, flv, f4v, swf, xml
- Assumir imagem de outra forma
Se o registro for encontrado no catálogo de conteúdo estático, mas NÃO no catálogo de imagens
- Suponha vídeo se a extensão de arquivo estiver no seguinte conjunto: mp3, mp4, flv, f4v, swf, xml
- Suponha estático caso contrário
Se o registro for encontrado no catálogo de imagens, mas NÃO no catálogo de conteúdo estático
- Assumir imagem
Se o registro NÃO for encontrado no catálogo de imagens e NÃO for encontrado no catálogo de conteúdo estático
- Suponha que o vídeo baseado em arquivo esteja no seguinte conjunto: mp3, mp4, flv, f4v, swf, xml
- Caso contrário, considere uma imagem baseada em arquivo

Em todos os casos, a resposta xml resultante estará em conformidade com o documento XML especificado com o nó raiz definido correspondente ao tipo detectado.

Detecção de tipo de conjunto interno

Quando o conjunto externo for detectado como conjunto de mídia de tipo, a resposta conterá um conjunto de itens de conjunto de mídia correspondentes a cada entrada de conjunto de mídia em catalog::ImageSet. Se o parâmetro de tipo opcional for especificado para uma entrada de conjunto de mídia específica, ele será mapeado para um tipo de saída de acordo com a seguinte tabela:

Tipo de entrada	Tipo de saída
`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`

Se o parâmetro de tipo opcional para uma entrada de conjunto de mídia específica não for especificado ou corresponder a um tipo não suportado, o tipo de item do conjunto de mídia será detectado automaticamente usando as mesmas regras que foram aplicadas no nível do conjunto externo.

Especificação XML

A resposta xml retornada está em conformidade com a seguinte especificação:

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

LabelKey

O labelkey= modificador é usado junto com o catalog::UserDatapara gerar rótulos para imagens e amostras. O catalog:UserData é analisado como um conjunto de pares de chave/valor e os índices de chave de rótulo em desse conjunto para recuperar o valor de determinada chave. Esse valor é retornado no l para o s e i.

Restrições impostas

Para limitar o tamanho da resposta e evitar problemas referenciais, a profundidade máxima de aninhamento é controlada pela propriedade do servidor PS::fvctx.nestingLimit. Se esse limite for excedido, um erro será retornado.

Para limitar o tamanho das respostas xml para grandes conjuntos de catálogos eletrônicos, os metadados privados são suprimidos para itens do conjunto de brochuras de acordo com a propriedade de servidor PS::fvctx.brochureLimit. Todos os metadados privados associados à brochura são exportados até que o limite da brochura seja atingido. Depois que o limite é excedido, mapas privados e dados do usuário são suprimidos e um sinalizador correspondente é definido para indicar qual tipo de dados foi suprimido.

Não há suporte para conjuntos de mídia aninhados. Um conjunto de mídia aninhado é definido como um conjunto de mídia que contém um item de conjunto de mídia do tipo conjunto de mídia. Se essa condição for detectada, um erro será retornado.