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 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, o valor inteiro deverá ser colocado 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 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 estiver 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 tabela a seguir:

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 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 os índices de chave de rótulo são adicionados a esse conjunto para recuperar o valor da chave fornecida. Esse valor é retornado no atributo l para 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 de 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 PS::fvctx.brochureLimit do servidor. Todos os metadados privados associados à brochura serão exportados até que o limite da brochura 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 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.

Exemplos

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

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

Consulte também

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

Nesta página

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now