Traduzione ID oggetto

Image Server fornisce un meccanismo per convertire gli ID degli oggetti esterni in ID di oggetti (catalogo) specifici per le impostazioni internazionali. L'applicazione principale prevede la fornitura di contenuto e contenuto specifici per le impostazioni internazionali condivisi tra più lingue 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 Server sostituirà automaticamente le immagini specifiche per le impostazioni internazionali e altri contenuti, se disponibili.

La locale viene specificata nelle richieste Image Server con il comando locale=.

Ambito

Tutti i riferimenti alle voci nei cataloghi di immagini, SVG e contenuti statici vengono considerati per i font di traduzione e i riferimenti ai profili ICC non vengono tradotti. Oltre alla 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, in quanto fornisce l'ID oggetto generico e il locale= valore.

attribute::LocaleMap è costituito da un elenco di impostazioni internazionali di input (corrispondenti ai valori specificati con locale=), ognuna 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 questo tipo).

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. Viene quindi ripetuto il locSuffixes associato 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 trovata, viene utilizzata la voce del catalogo, altrimenti viene verificata la voce successiva. Per questo esempio, le voci seguenti sono verificate: 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 per quelli non elencati esplicitamente nella mappa di traduzione). Se questa mappa di traduzione fosse applicata alla richiesta /is/image/myCat/myImg?locale=ja, si risolverebbe in myCat/myImg_E, se esiste, o in altro modo in 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 consigliabile raggruppare le impostazioni internazionali (ad esempio, Europa, Medio Oriente, Nord America) per soddisfare gli standard regionali. Questo può essere ottenuto con una ricerca a più livelli.

Per questo esempio, vogliamo supportare le raccolte per l'uso occidentale e mediorientale. Entrambe le raccolte sono basate sulla raccolta di immagini generica e per entrambe alcune immagini sono aggiunte o modificate. Entrambe le raccolte vengono quindi ulteriormente perfezionate per specifiche lingue ( m1, m2 per due varianti mediorientali e w1, w2 e w3 per tre lingue occidentali), fatta eccezione 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,|,

Nella tabella seguente sono illustrate le voci del 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 delle impostazioni internazionali francesi possono avere il suffisso _22 o _23 e le immagini specifiche delle 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

Nella tabella seguente sono illustrate le voci del catalogo da considerare e l'ordine in cui vengono considerate per l'ID di input generico myImg:

Consultate anche

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