DocumentaçãoAPI de disponibilização e renderização de imagens do Dynamic Media

Solicitações de conjunto de mídia media-set-requests

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined

O Servidor de imagens 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 de um registro específico.

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

Sintaxe da solicitação section-d72b1d95e4ce4bb1b332ce096c2b99f1

A resposta definida para catalog::ImageSet pode ser recuperada usando o modificador req=set e referenciando a id de registro de catálogo no caminho de rede. Como alternativa, o conjunto de imagens pode ser especificado diretamente na URL usando o modificador imageset=. Se o modificador imageset= for usado para especificar o imageset, o valor inteiro deverá ser delimitado por chaves para escapar o valor do conjunto de imagens e garantir que nenhum modificador incluído seja interpretado como parte da cadeia de caracteres de consulta da URL.

Tipos de respostas definidas section-93eb0a1f70344da2a888e56372ad3896

O mecanismo de definição é compatível com os seguintes tipos de respostas:

imagens simples
Um registro de imagem sem o 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árquicos, conjuntos de amostras, 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 section-3dd6e453528d46898e559d31458a59ba

Quando uma solicitação req=set é recebida, o tipo de resposta para gerar é 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

    • Assumir o conjunto de e-catalog se pelo menos uma entrada no campo Registrar Imageset contiver dois pontos
    • Suponha que a mídia esteja definida se pelo menos uma entrada no campo Conjunto de imagens contiver dois pontos e vírgulas.
    • Suponha que a imagem esteja 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).
    • Considere o conjunto desconhecido se nenhuma entrada contiver dois pontos, ponto e vírgula, ou o conjunto referenciado ou o conjunto em linha (ou seja, lista de imagens separada por vírgulas).

  • Se o registro for encontrado nos catálogos de imagem E conteúdo estático

    • Assume o vídeo se a extensão de arquivo estiver no seguinte conjunto: mp3, mp4, flv, f4v, swf, xml
    • Supor 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

    • Assume o vídeo se a extensão de arquivo estiver no seguinte conjunto: mp3, mp4, flv, f4v, swf, xml
    • Assumir estática 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

    • Assumir vídeo baseado em arquivo se a extensão de arquivo estiver no seguinte conjunto: mp3, mp4, flv, f4v, swf, xml
    • Assumir imagem baseada em arquivo de outra forma

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

Detecção de tipo de conjunto interno section-8f46490e467247e69ce284704def06f3

Quando o conjunto externo é detectado como um conjunto de mídia do tipo, a resposta contém um conjunto de itens do conjunto de mídia correspondentes a cada entrada do conjunto de mídia em catalog::ImageSet. Se o parâmetro de tipo opcional for especificado para uma determinada entrada do conjunto de mídia, 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 determinada entrada do conjunto de mídia não for especificado ou corresponder a um tipo sem suporte, o tipo de item do conjunto de mídia será detectado automaticamente usando as mesmas regras aplicadas no nível do conjunto de mídia.

Especificação XML section-c1bd60948ef545759a16885bb6fcc607

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

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

LabelKey section-bf565de6f7294cf89620343c9071f415

O modificador labelkey= é usado junto com o campo catalog::UserData para gerar rótulos para imagens e amostras. O campo catalog:UserData é analisado como um conjunto de pares de chave/valor e os índices labelkey neste conjunto para recuperar o valor da chave fornecida. Este valor é então retornado no atributo l para s e i.

Restrições impostas section-b9f042873bee45a5ae11b69fd42f2bca

Para limitar o tamanho da resposta e evitar problemas de autorreferência, 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 conjuntos de catálogos eletrônicos grandes, os metadados privados são suprimidos para itens de conjunto de folhetos de acordo com a propriedade de servidor PS::fvctx.brochureLimit. Todos os metadados privados associados ao folheto são exportados até que o limite do folheto seja atingido. Quando o limite é excedido, os mapas privados e os dados do usuário são suprimidos, e um sinalizador correspondente é 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 section-588c9d33aa05482c86cd2b1936887228

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

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

Consulte também section-625ec466c948476e800dc0c52a4532d3

req= , imageset=, catalog::ImageSet, Referência de Catálogo de Imagens

recommendation-more-help
a26166cd-f2f4-45ce-996d-96a0f0d6cf49