Traduzione ID oggetto

Image Serving fornisce un meccanismo per tradurre gli ID oggetti esterni in ID oggetto (catalogo) specifici per le impostazioni internazionali. L’applicazione principale consiste nel fornire contenuto specifico per le impostazioni internazionali e contenuto condiviso tra più impostazioni internazionali senza che l’applicazione client debba conoscere gli ID oggetto specifici per le impostazioni internazionali.

L’applicazione può essere scritta utilizzando solo ID oggetto globali e Image Serving sostituisce automaticamente le immagini specifiche delle impostazioni internazionali e altri contenuti, se disponibili.

Il locale viene specificato nelle richieste di Image Server con il comando locale= .

Ambito

Tutti i riferimenti alle voci nei cataloghi di immagini, SVG e contenuti statici sono considerati per i font-traduzione e i riferimenti di profilo ICC non sono tradotti. Oltre al object nel percorso di /is/image e /is/static requests, questi comandi e attributi del catalogo sono soggetti alla traduzione ID: src=, mask=, template=, defaultImage=, attribute::DefaultImage e attribute::Watermark.

Mappa di traduzione ID

attribute::LocaleMap definisce le regole utilizzate dal server per determinare l'ID del contenuto localizzato, dato che come input l'ID dell'oggetto generico e il locale= valore.

attribute::LocaleMap è costituito da un elenco di impostazioni internazionali di input (corrispondenti ai valori specificati con locale=), ciascuna con uno o più suffissi internazionali di output ( *locSuffixes*).

Ad esempio, attribute::LocaleMap potrebbe essere simile al seguente:

en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,_E,

La richiesta /is/image/myCat/myImg?locale=de_de restituirebbe l'immagine associata alla voce di catalogo myCat/myImg_D (supponendo che esista una voce di catalogo simile).

Per ulteriori informazioni, fare riferimento alla descrizione di attribute::LocaleMap .

Il processo di traduzione

Dato l'esempio precedente, il server cerca prima il locale " de_de" nella mappa di traduzione ID. Esegue quindi l'iterazione sui valori locSuffixes associati a questa voce, in questo caso " _D" e "" (suffisso vuoto). Per ogni iterazione, il suffisso viene aggiunto all’ID immagine e l’id risultante viene verificato se è presente nel catalogo. Se trovato, viene utilizzata la voce di catalogo, altrimenti viene testata la voce successiva. Per questo esempio, vengono verificate le seguenti voci: myCat/myImg_D e myCat/myImg. Se non viene trovata alcuna corrispondenza, il server restituisce un errore o un'immagine predefinita (se configurata).

Impostazioni internazionali sconosciute

Nell’esempio precedente, attribute::LocaleMap include un locale vuoto che definisce la regola di traduzione predefinita, utilizzata per valori locale= sconosciuti (ovvero quelli non elencati esplicitamente nella mappa di traduzione). Se questa mappa di traduzione è stata applicata alla richiesta /is/image/myCat/myImg?locale=ja, viene risolta in myCat/myImg_E, se esiste, o in altro modo myCat/myImg.

Se una mappa di traduzione non specifica una regola di traduzione predefinita, verrà restituito un errore per tutte le richieste con valori locale= sconosciuti.

Esempi

Ricerca a più livelli

Spesso è opportuno raggruppare le impostazioni internazionali (ad esempio, europee, mediorientali, nordamericane) per soddisfare gli standard regionali. Questo può essere ottenuto con una ricerca a più livelli.

Per questo esempio, vogliamo supportare le raccolte per uso occidentale e medio orientale. Entrambe le raccolte sono basate sulla raccolta di immagini generica e per entrambe alcune immagini sono aggiunte o modificate. Entrambe le raccolte vengono quindi perfezionate ulteriormente per specifiche impostazioni internazionali ( m1, m2 per due varianti medio-orientali e w1, w2 e w3 per tre impostazioni internazionali occidentali), tranne per il fatto che le immagini sono condivise per w1 e w3. Le lingue sconosciute sono associate solo alla raccolta generica e non hanno accesso alle immagini per lingue specifiche.

attribute::LocaleMap: w1,-W,|w2,-W2,-W,|w3,-W,|m1,-M1,-M,|m2,-M2,-M,|,

La tabella seguente illustra le voci di catalogo da considerare e l’ordine in cui vengono considerate per l’ID di input generico myImg:

Ricerca di ID specifici

Alcune convenzioni di denominazione delle immagini potrebbero non supportare internamente ID immagine generici. Gli ID generici della richiesta devono sempre essere mappati su un ID specifico nel catalogo; spesso l'ID specifico esatto potrebbe non essere noto.

In questo esempio, le immagini per tutte le lingue possono avere il suffisso _1, _2 o _3. Le immagini specifiche per le impostazioni internazionali francesi possono avere il suffisso _22 o _23 e le immagini specifiche per le impostazioni internazionali tedesche possono avere il suffisso _470 o _480.

attribute::LocaleMap: ,_1,_2,_3|fr,_22,_23,_1,_2,_3|de,_470,_480,_1,_2,_3| de_at,_470,_480,_1,_2,_3| de_de,_470,_480,_1,_2,_3

La tabella seguente illustra le voci di catalogo considerate e l’ordine in cui vengono considerate per l’ID di input generico myImg:

Consultate anche

attributo::LocaleMap , attributo::DefaultLocale, locale=, req=xlate