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 particolare record.

I visualizzatori possono utilizzare questo meccanismo per generare risposte che informino la presentazione di immagini semplici, video, set di video, set di campioni, set 360 gradi, set di pagine (eCatalogs) e set di contenuti multimediali.

Sintassi della richiesta

La risposta impostata 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 il modificatore imageset= viene utilizzato per specificare il set di immagini, l’intero valore deve essere racchiuso tra parentesi graffe per evitare il valore del set di immagini e assicurarsi che 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	Un record immagine senza catalogo::ImageSet definito.
video semplici	Record video nel catalogo dei contenuti statici.
set di campioni	Un insieme di elementi costituito da un riferimento a un record immagine e da un riferimento separato facoltativo a un record immagine 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 set di campioni.
set 360	Un set di elementi costituito 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 insieme di elementi costituito da un elenco di fino a tre immagini di pagina
set di file multimediali	Un set di elementi costituito 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 costituito 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 si trova nel catalogo immagini E catalog::ImageSet è definito
- Si supponga di aver impostato un catalogo elettronico se almeno una voce nel campo Immagine record contiene due punti
- Si supponga di aver impostato un supporto se almeno una voce nel campo Imageset record contiene due punti e virgola.
- Si supponga di aver impostato l'immagine se almeno una voce nel campo Imageset record contiene un punto e virgola.
- Supponiamo di usare 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-line (questo è 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 riferimento né un set in-line (ad esempio un elenco di immagini separato da virgole).
Se il record si trova sia nei cataloghi di contenuti statici E immagine
- Supponi video se l’estensione del file è nel seguente set: mp3, mp4, flv, f4v, swf, xml
- Ipotizza immagine altrimenti
Se il record si trova nel catalogo dei contenuti statici ma NON nel catalogo delle immagini
- Supponi video se l’estensione del file è nel seguente set: mp3, mp4, flv, f4v, swf, xml
- Supponiamo di essere statici in caso contrario
Se il record si trova nel catalogo immagini ma NON nel catalogo dei contenuti statici
- Ipotizza immagine
Se il record NON viene trovato nel catalogo immagini e NON viene trovato nel catalogo dei contenuti statici
- Supponi video basati su file se l'estensione del file è nel seguente set: mp3, mp4, flv, f4v, swf, xml
- Supponi immagini basate su file in caso contrario

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

Rilevamento del tipo di set interno

Quando il set esterno viene rilevato come set di file multimediali di tipo , 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 per una particolare voce del set di file multimediali è specificato il parametro opzionale type, questo verrà mappato su un tipo di output in base alla tabella seguente:

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

Specifica XML

La risposta xml restituita è conforme alla seguente specifica:

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 set di coppie chiave/valore e l’etichetta indicizza questo set per recuperare il valore per la chiave specificata. Questo valore viene quindi restituito nell'attributo l per s e i.

Restrizioni imposte

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

Al fine di limitare le dimensioni delle risposte xml per i set di catalogo elettronico di grandi dimensioni, i metadati privati vengono soppressi per gli elementi del set di brochure in base alla proprietà del server PS::fvctx.brochureLimit. Tutti i metadata privati associati all'opuscolo saranno esportati fino al raggiungimento del limite della brochure. Una volta superato il limite, le mappe private e i dati utente verranno soppressi e verrà impostato un flag corrispondente per indicare quale tipo di dati è stato soppresso.

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 elemento set di file multimediali di tipo set di file multimediali. Se viene rilevata questa condizione, viene restituito un errore.