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:

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:

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.

Esempi

Per le risposte XML di esempio per la richiesta req=set, fare riferimento alla pagina Proprietà nell'intestazione Esempi HTML.

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

Consultate anche

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