Solicitações de conjunto de mídia

O Serviç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 ao catálogo::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ídeo, conjuntos de amostras, conjuntos de rotação, conjuntos de páginas (e-catalogs) e conjuntos de mídia.

Sintaxe de solicitação

A resposta definida para um catalog::ImageSet pode ser recuperada usando o modificador req=set 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 modificador imageset=. Se o modificador imageset= for usado para especificar o conjunto de imagens, todo o valor deverá estar entre chaves para escapar do valor do conjunto de imagens e garantir que todos os modificadores incluídos não sejam interpretados como parte da string do query URL.

Tipos de respostas definidas

O mecanismo set suporta os 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 hierárquicos de amostras, conjuntos de rotação, conjuntos bidimensionais de rotação, conjuntos de páginas e ativos de vídeo. Cada item de 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 solicitação req=set é recebida, o tipo de resposta a ser gerada é determinado pelo valor de catalog::AssetType. Se 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 E catalog::ImageSet for definido

    • Considere o conjunto de e-catálogos 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 pontos-e-vírgulas.
    • Considere o conjunto de imagens se pelo menos uma entrada no campo Gravar 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 (este é um conjunto de rotação 2D).
    • Considere um conjunto desconhecido se nenhuma entrada contiver dois pontos, ponto-e-vírgula ou conjunto referenciado ou conjunto em linha (isto é, lista de imagens separada por vírgulas).
  • Se o registro for encontrado em catálogos de imagem E conteúdo estático

    • Considere o vídeo se a extensão do arquivo estiver no seguinte conjunto: mp3, mp4, flv, f4v, swf, xml
    • Caso contrário, considere a imagem
  • Se o registro for encontrado no catálogo de conteúdo estático, mas NÃO no catálogo de imagens

    • Considere o vídeo se a extensão do arquivo estiver no seguinte conjunto: mp3, mp4, flv, f4v, swf, xml
    • Considere 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 vídeo baseado em arquivo se a extensão de arquivo estiver no seguinte conjunto: mp3, mp4, flv, f4v, swf, xml
    • Caso contrário, considere a 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 correspondente 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 de conjunto de mídia será detectado automaticamente usando as mesmas regras que foram aplicadas no nível de 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 modificador labelkey= é usado junto com o campo catalog::UserDatapara gerar rótulos para imagens e amostras. O campo catalog:UserData é analisado como um conjunto de pares de chave/valor e a chave de trabalho indexa nesse conjunto para recuperar o valor da chave fornecida. Esse valor é retornado no atributo l para s e i.

Restrições forçadas

Para limitar o tamanho da resposta e evitar problemas autorreferenciais, 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álogo eletrônico, os metadados privados são suprimidos para itens de conjunto de folhetos de acordo com a propriedade do servidor PS::fvctx.brochureLimit. Todos os metadados privados associados ao folheto serão exportados até que o limite do folheto seja atingido. Quando o limite for excedido, os mapas privados e os dados do usuário serão suprimidos e um sinalizador correspondente será definido para indicar que 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.

Exemplos

Para obter exemplos de respostas XML para a solicitação req=set, consulte a página Propriedades no cabeçalho Exemplos HTML.

http://crc.scene7.com/is-docs/examples/properties.htm

Consulte também

req= , imageset=, catálogo::ImageSet, Referência do catálogo de imagens

Nesta página