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.
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.
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. |
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
Se il record viene trovato sia nei cataloghi di contenuto statico che in quelli di immagini
Se il record viene trovato nel catalogo dei contenuti statici ma NON nel catalogo delle immagini
Se il record in è stato trovato nel catalogo immagini ma NON nel catalogo contenuti statici
Se il record NON viene trovato nel catalogo immagini e NON 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 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.
La risposta xml restituita è conforme alle seguenti specifiche:
http://crc.scene7.com/is-docs/examples/mediaset.dtd
Il labelkey=
il modificatore viene utilizzato insieme al catalog::UserData
per 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
.
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.
Per risposte XML di esempio per req=set
, fai riferimento alla pagina Proprietà sotto l’intestazione Esempi di HTML.
http://crc.scene7.com/is-docs/examples/properties.htm
req= , imageset= insieme di immagini, catalogo::ImageSet, Riferimento catalogo immagini