De Beeldserver biedt een mechanisme om externe objecten-id's te vertalen naar landspecifieke object-id's (catalogus). De primaire toepassing is het aanbieden van landspecifieke inhoud en inhoud die door meerdere landinstellingen wordt gedeeld, zonder dat de clienttoepassing de landspecifieke object-id's moet kennen.
De toepassing kan alleen worden geschreven met behulp van algemene object-id's en Image Serving vervangt automatisch landspecifieke afbeeldingen en andere inhoud, indien beschikbaar.
De locale
wordt opgegeven in aanvragen voor beeldverwerking bij de locale=
gebruiken.
Vertalen van object-id is alleen van toepassing voor gebruik van afbeeldingsserver op basis van catalogus. Bestandsnamen kunnen niet worden vertaald.
Alle verwijzingen naar items in afbeeldings-, SVG- en statische inhoudcatalogi worden beschouwd als verwijzingen naar vertaallettertypen en ICC-profielverwijzingen worden niet vertaald. Naast de object
in het pad van /is/image en /is/static requests, zijn deze opdrachten en cataloguskenmerken afhankelijk van id-omzetting: src=
, mask=
, template=
, defaultImage=
, attribute::DefaultImage
, en attribute::Watermark
.
attribute::LocaleMap
bepaalt de regels die door de server worden gebruikt om identiteitskaart van de gelokaliseerde inhoud te bepalen, gegeven als input generische objecten identiteitskaart en locale=
waarde.
attribute::LocaleMap
bestaat uit een lijst van input landinstellingen (die overeenkomen met de waarden die zijn opgegeven met locale=
), elk met geen of meer achtervoegsels van de uitvoerlandinstelling ( *
locSuffixes*
).
Bijvoorbeeld: attribute::LocaleMap
kan er als volgt uitzien:
en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,_E,
Het verzoek /is/image/myCat/myImg?locale=de_de
retourneert de afbeelding die aan het catalogusitem is gekoppeld myCat/myImg_D
(ervan uitgaande dat een dergelijke vermelding in de catalogus bestaat).
Zie de beschrijving van attribute::LocaleMap
voor meer informatie.
In het bovenstaande voorbeeld zoekt de server eerst naar de locale
" de_de
" in de vertaalkaart van identiteitskaart Vervolgens wordt er herhaald over de locSuffixes
in dit geval" _D
" en "" (leeg achtervoegsel). Voor elke herhaling wordt het achtervoegsel toegevoegd aan de afbeeldings-id en wordt de resulterende id getest op aanwezigheid in de catalogus. Indien gevonden, wordt dat catalogusitem gebruikt, anders wordt het volgende item getest. In dit voorbeeld worden de volgende items gecontroleerd: myCat/myImg_D
, en myCat/myImg
. Als geen gelijke wordt gevonden, keert de server een fout of een standaardbeeld (als zo gevormd) terug.
In het bovenstaande voorbeeld: attribute::LocaleMap
bevat een lege locale
waarmee de standaardvertaalregel wordt gedefinieerd die voor onbekend wordt gebruikt locale=
waarden (d.w.z. waarden die niet expliciet in de vertaalkaart zijn vermeld). Als deze vertaalkaart op de aanvraag is toegepast /is/image/myCat/myImg?locale=ja
zal myCat/myImg_E
, indien deze bestaat of anderszins myCat/myImg
.
Als een vertaalkaart geen standaardvertaalregel specificeert, is een fout teruggekeerd voor alle verzoeken met onbekend locale=
waarden.
Opzoeken op meerdere niveaus
Het is vaak wenselijk om landinstellingen (bijvoorbeeld Europees, Midden-Oosten, Noord-Amerika) te groeperen om regionale normen aan te pakken. Dit kan met een multi-tiered raadpleging worden bereikt.
Voor dit voorbeeld willen we collecties voor gebruik in het Westen en het Midden-Oosten ondersteunen. Beide verzamelingen zijn gebaseerd op de algemene afbeeldingsverzameling en voegen of wijzigen enkele afbeeldingen toe. Beide verzamelingen worden vervolgens verder verfijnd voor specifieke landinstellingen ( m1
, m2
voor twee varianten in het midden-oosten, en w1
, w2
, en w3
voor drie westerse landinstellingen), behalve dat afbeeldingen worden gedeeld voor w1
en w3
. Onbekende landinstellingen worden alleen toegewezen aan de algemene verzameling en hebben geen toegang tot landspecifieke afbeeldingen.
attribute::LocaleMap: w1,-W,|w2,-W2,-W,|w3,-W,|m1,-M1,-M,|m2,-M2,-M,|,
In de volgende tabel wordt aangegeven welke catalogusitems in overweging worden genomen en in welke volgorde ze worden gebruikt voor de generieke invoer-id myImg
:
landinstelling | Te doorzoeken catalogus-id's |
---|---|
w1, w3 |
myImg-W, myImg |
w2 |
myImg-W2, myImg-W, myImg |
m1 |
myImg-M1, myImg-M, myImg |
m2 |
myImg-M2, myImg-M, myImg |
alle andere |
myImg |
Zoeken naar specifieke id's
Sommige naamgevingsconventies voor afbeeldingen bieden mogelijk geen interne ondersteuning voor algemene afbeeldings-id's. De generieke id's van het verzoek moeten altijd worden toegewezen aan een specifieke id in de catalogus. vaak is de exacte specifieke id onbekend.
In dit voorbeeld kunnen afbeeldingen voor alle talen _1
, _2
, of _3
achtervoegsel. Afbeeldingen die specifiek zijn voor Franse landinstellingen kunnen _22
of _23
achtervoegsel en afbeeldingen die specifiek zijn voor Duitse landinstellingen kunnen _470
of _480
achtervoegsel.
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
In de volgende tabel wordt aangegeven welke catalogusitems in overweging worden genomen en in welke volgorde ze worden gebruikt voor de generieke invoer-id myImg
:
landinstelling | Uitvoer-id's die moeten worden doorzocht |
---|---|
fr |
myImg_22, myImg_23, myImg_1, myImg_2, myImg_3 |
de , de_at , de_de |
myImg_470, myImg_480, myImg_1, myImg_2, myImg_3 |
alle andere |
myImg_1, myImg_2, myImg_3 |
kenmerk:LocaleMap , kenmerk::DefaultLocale, locale=, req=xlate