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.
Imposta la risposta per un catalog::ImageSet
può essere recuperato utilizzando req=set
modificatore e 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 imageset=
modificatore. Se la imageset=
Il modificatore 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.
Il meccanismo set 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 |
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. |
Quando un req=set
viene ricevuta una richiesta, il tipo di risposta da generare è determinato dal valore di catalog::AssetType
. Se catalog::AssetType
non è definito, quindi il tipo di risposta è determinato dalle seguenti regole:
Se il record si trova nel catalogo immagini AND catalog::ImageSet
è definito
Se il record si trova sia nei cataloghi di contenuti statici E immagine
Se il record si trova nel catalogo dei contenuti statici ma NON nel catalogo delle immagini
Se il record si trova nel catalogo immagini ma NON nel catalogo dei contenuti statici
Se il record NON viene trovato nel catalogo immagini e NON viene trovato nel catalogo dei contenuti statici
In tutti i casi, la risposta xml risultante sarà conforme al documento XML specificato con il nodo principale impostato corrispondente al tipo rilevato.
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 viene 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.
La risposta xml restituita è conforme alla seguente specifica:
http://crc.scene7.com/is-docs/examples/mediaset.dtd
La labelkey=
viene utilizzato insieme al catalog::UserData
per generare etichette per immagini e campioni. La catalog:UserData
Il campo viene analizzato come un set di coppie chiave/valore e gli indici labelkey in a questo set per recuperare il valore per la chiave specificata. Questo valore viene quindi restituito nella l
attributo per s
e i
.
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 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 soppressi e viene 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.
Per risposte XML di esempio per req=set
fare riferimento alla pagina Proprietà nell’intestazione Esempi di HTML.
http://crc.scene7.com/is-docs/examples/properties.htm
req= , imageset=, catalogo::ImageSet, Riferimento al catalogo delle immagini