Richieste di set di file multimediali

Image Server fornisce un meccanismo per recuperare una risposta di testo gerarchica (xml o json) che rappresenta tutte le risorse e i metadati associati a catalog::ImageSet per un determinato record.

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

Sintassi della richiesta

La risposta impostata per un catalog::ImageSet possono essere recuperati utilizzando req=set e facendo riferimento all’id del record di catalogo nel percorso di rete. In alternativa, il set di immagini può essere specificato direttamente nell’URL utilizzando imageset= modificatore. Se il imageset= Il modificatore viene utilizzato per specificare il set di immagini. L’intero valore deve essere racchiuso tra parentesi graffe al fine di escape dal valore del set di immagini e garantire che tutti i modificatori inclusi non vengano interpretati come parte della stringa di query URL.

Tipi di risposta impostata

Il meccanismo di impostazione supporta i seguenti tipi di risposte:

immagini semplici	Un record di 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 gradi	Un set di elementi costituito da un semplice elenco di ID immagine.
set 360 gradi bidimensionali	Un insieme 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 costituito da un elenco di un massimo di tre immagini pagina
media set	Un set di elementi costituito da immagini semplici, set 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ò contenere anche un campione opzionale.
set video	Un set di elementi costituito da un elenco di video semplici.

Rilevamento del tipo di set esterno

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

Se il record viene trovato nel catalogo immagini E catalog::ImageSet è definito
- Si supponga di avere impostato un catalogo elettronico se almeno una voce nel campo Record Imageset contiene due punti
- Supponiamo che il set di file multimediali sia impostato se almeno una voce nel campo Record Imageset contiene due punti e virgola.
- Si supponga che il set di immagini sia impostato se almeno una voce nel campo Record Imageset contiene un punto e virgola.
- Si supponga che il set 360 gradi non contenga due punti né punto e virgola, ma che almeno una voce contenga un set di riferimenti o un set in linea (set 360 gradi 2D).
- Si supponga che il set sia sconosciuto se nessuna voce contiene due punti, un punto e virgola, un set di riferimento o un set in linea (ovvero un elenco di immagini separato da virgole).
Se il record viene trovato sia nei cataloghi di contenuto statico che in quelli di immagini
- Si supponga che l'estensione file sia nel seguente set: mp3, mp4, flv, f4v, swf, xml
- Ipotizza immagine in caso contrario
Se il record viene trovato nel catalogo dei contenuti statici ma NON nel catalogo delle immagini
- Si supponga che l'estensione file sia nel seguente set: mp3, mp4, flv, f4v, swf, xml
- Presupponiamo statico in caso contrario
Se il record in è stato trovato nel catalogo immagini ma NON nel catalogo contenuti statici
- Immagini
Se il record NON viene trovato nel catalogo immagini e NON nel catalogo dei contenuti statici
- Si supponga che l'estensione file sia nel seguente set: mp3, mp4, flv, f4v, swf, xml
- Supponiamo un’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 impostato corrispondente al tipo rilevato.

Rilevamento tipo 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 corrispondente a ciascuna voce del set di file multimediali in catalog::ImageSet. Se il parametro di tipo opzionale è specificato per una particolare voce di set di file multimediali, viene mappato a un tipo di output in base alla tabella seguente:

Tipo di input	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 di tipo opzionale 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 di set esterno.

Specifica XML

La risposta xml restituita è conforme alle seguenti specifiche:

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

LabelKey

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

Restrizioni applicate

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

Per limitare le dimensioni delle risposte xml per i set di e-catalog di grandi dimensioni, i metadati privati vengono soppressi per gli elementi dei set di brochure in base alla proprietà del server PS::fvctx.brochureLimit. Tutti i metadati privati associati alla brochure vengono esportati fino al raggiungimento del limite della brochure. Una volta superato il limite, le mappe private e i dati utente vengono eliminati e viene 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 nidificato è definito come un set di file multimediali contenente un elemento del set di file multimediali di tipo set di file multimediali. Se questa condizione viene rilevata, viene restituito un errore.