Richieste set di file multimediali

Image Serving fornisce un meccanismo per recuperare una risposta testuale gerarchica (xml o json) che rappresenta tutte le risorse e i metadati associati al catalogo::ImageSet per un record particolare.

I visualizzatori possono usare questo meccanismo per generare risposte che informano la presentazione di semplici immagini, video, set di video, set di campioni, set 360 gradi, set di pagine (e-Catalog) e set di file multimediali.

Sintassi richiesta

La risposta del set per un catalog::ImageSet può essere recuperata utilizzando il modificatore req=set e facendo riferimento all'ID del record del catalogo nel percorso di rete. In alternativa, il set di immagini può essere specificato direttamente nell'URL utilizzando il modificatore imageset=. Se per specificare il set di immagini si utilizza il modificatore imageset=, l'intero valore deve essere racchiuso tra parentesi graffe per sfuggire al valore del set di immagini e assicurarsi che gli eventuali modificatori inclusi non vengano interpretati come parte della stringa di query URL.

Tipi di risposte impostate

Il meccanismo set supporta i seguenti tipi di risposte:

immagini semplici

Record di immagini senza catalogo::ImageSet definito.

video semplici

Un record video nel catalogo di contenuti statici.

set di campioni

Set di elementi costituito da un riferimento a un record di immagini e da un riferimento separato facoltativo a un record di immagini utilizzato come campione.

set di campioni gerarchici

Un insieme di elementi costituito da un elemento campione di base o da un riferimento a un record di set di campioni.

set 360 gradi

Un set di elementi composto da un semplice elenco di ID immagine.

set 360 gradi bidimensionali

Set di elementi costituito da un’immagine semplice o da un riferimento a un set 360 gradi di base.

set di pagine

Un set di elementi composto da un elenco di fino a tre immagini di pagina

set di file multimediali

Set di elementi costituiti da immagini semplici, set di video, set di campioni, set di campioni gerarchici, set 360 gradi, set 360 gradi bidimensionali, set di pagine e risorse video. Ogni elemento del set di file multimediali può anche contenere un campione opzionale.

set video

Un set di elementi composto da un elenco di video semplici.

Rilevamento del tipo di set esterno

Quando viene ricevuta una richiesta req=set, il tipo di risposta da generare è determinato dal valore di catalog::AssetType. Se catalog::AssetType non è definito, il tipo di risposta è determinato dalle seguenti regole:

  • Se il record è trovato nel catalogo immagini e catalog::ImageSet è definito

    • Si supponga di aver impostato un e-Catalog se almeno una voce nel campo del set di immagini del record contiene due punti
    • Si supponga di aver impostato un supporto se almeno una voce nel campo set di immagini del record contiene due punti e virgola.
    • Si supponga di aver impostato un'immagine se almeno una voce nel campo set di immagini del record contiene un punto e virgola.
    • Si supponga di aver impostato un set 360 gradi se nessuna voce contiene due punti o un punto e almeno una voce contiene un set di riferimento o un set in linea (si tratta di un set 360 gradi 2D).
    • Si supponga di aver impostato un valore sconosciuto se nessuna voce contiene due punti o un punto e virgola, né un set di riferimenti né un set in-line (ad esempio un elenco di immagini separato da virgole).
  • Se il record è presente nei cataloghi di contenuti statici e di immagini

    • Supponete video se l’estensione del file è impostata come segue: mp3, mp4, flv, f4v, swf, xml
    • Presupponi immagine altrimenti
  • Se il record si trova nel catalogo di contenuti statici ma NON nel catalogo immagini

    • Supponete video se l’estensione del file è impostata come segue: mp3, mp4, flv, f4v, swf, xml
    • Presupponi statici in caso contrario
  • Se il record si trova nel catalogo immagini ma NON nel catalogo del contenuto statico

    • Presupponi immagine
  • Se il record NON viene trovato nel catalogo immagini e NON viene trovato nel catalogo del contenuto statico

    • Supponete video basato su file se l’estensione del file è impostata nel seguente set: mp3, mp4, flv, f4v, swf, xml
    • Presupponi immagine basata su file in caso contrario

In tutti i casi, la risposta xml risultante sarà conforme al documento XML specificato con il nodo principale set corrispondente al tipo rilevato.

Rilevamento del tipo di set interno

Quando il set esterno viene rilevato come tipo di set di file multimediali, la risposta conterrà un set di elementi del set di file multimediali corrispondenti a ciascuna voce del set di file multimediali in catalog::ImageSet. Se il parametro opzionale type è specificato per una particolare voce del set di supporti, verrà mappato su un tipo di output secondo la tabella seguente:

Tipo di ingresso Tipo di output
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 il parametro opzionale del tipo per una particolare voce di set di supporti non è specificato o corrisponde a un tipo non supportato, il tipo di elemento del set di supporti viene rilevato automaticamente utilizzando le stesse regole applicate al livello del set esterno.

Specifica XML

La risposta xml restituita è conforme alle seguenti specifiche:

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

LabelKey

Il modificatore labelkey= viene utilizzato insieme al campo catalog::UserDataper generare etichette per immagini e campioni. Il campo catalog:UserData viene analizzato come un insieme di coppie chiave/valore e gli indici di labelkey in questo set per recuperare il valore per la chiave specificata. Questo valore viene quindi restituito nell'attributo l per s e i.

Limitazioni applicate

Al fine di limitare le dimensioni della risposta e prevenire problemi di autoreferenza, la profondità massima di nidificazione è controllata dalla proprietà server PS::fvctx.nestingLimit. Se questo limite viene superato, viene restituito un errore.

Per limitare la dimensione delle risposte xml per i set di eCatalog di grandi dimensioni, per gli elementi dei set di brochure vengono soppressi i metadati privati in base alla proprietà del server PS::fvctx.brochureLimit. Tutti i metadati privati associati alla brochure saranno esportati fino al raggiungimento del limite di brochure. Una volta superato il limite, le mappe private e i dati utente verranno eliminati e verrà impostato un flag corrispondente per indicare quale tipo di dati è stato eliminato.

I set di file multimediali nidificati non sono supportati. Un set di file multimediali nidificati è definito come un set di file multimediali che contiene un set di file multimediali di tipo set di file multimediali. Se questa condizione viene rilevata, viene restituito un errore.

Esempi

Per un esempio di risposte XML per la richiesta req=set, consultate la pagina Proprietà nell'intestazione Esempi HTML.

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

Consultate anche

req= , imageset=, catalogo::ImageSet, Riferimento catalogo immagini

In questa pagina