Omzetten van object-id object-id-translation
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.
Toepassingsgebied section-66fcd5bd467c4eeaa1574583cbe9756d
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 onderhevig aan id-omzetting: src=, mask=, template=, defaultImage=, attribute::DefaultImage, en attribute::Watermark.
De vertaalkaart voor id section-9e417b352c314dfe94e831fdd62cddc8
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.
Het vertaalproces section-1f64db17e9f644d88e09853670e14a16
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.
Onbekende landinstellingen section-b2f3c83f2dc845d69b5908107b775537
In het bovenstaande voorbeeld: attribute::LocaleMap bevat een lege locale waarmee de standaardvertaalregel wordt gedefinieerd die voor onbekend wordt gebruikt locale= waarden (dat wil zeggen waarden die niet expliciet in de vertaalkaart worden vermeld). Als deze vertaalkaart op de aanvraag is toegepast /is/image/myCat/myImg?locale=ja, wil zij 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.
Voorbeelden section-cc40bb00ee9248bb8cb23e17d7a5984c
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:
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. Het is vaak mogelijk dat de exacte specifieke id niet bekend is.
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:
Zie ook section-05893816c66a406d89f9bfd6ace8d47a
kenmerk:LocaleMap , kenmerk::DefaultLocale, locale=, req=xlate