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.
locale wordt opgegeven in verzoeken om afbeeldingsserver met de opdracht locale= .
Toepassingsgebied section-66fcd5bd467c4eeaa1574583cbe9756d
Alle verwijzingen naar items in afbeeldings-, SVG- en statische inhoudcatalogi worden beschouwd als verwijzingen naar vertaallettertypen en ICC-profielen worden niet vertaald. Naast 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 .
De vertaalkaart voor id section-9e417b352c314dfe94e831fdd62cddc8
attribute::LocaleMap definieert de regels die door de server worden gebruikt om de id van de gelokaliseerde inhoud te bepalen, opgegeven als invoer voor de algemene object-id en de locale= -waarde.
attribute::LocaleMap bestaat uit een lijst van input scènes (die de waarden aanpassen met locale= worden gespecificeerd), elk met geen of meer achtervoegsels van de outputscène ( * locSuffixes *).
attribute::LocaleMap ziet er bijvoorbeeld als volgt uit:
en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,_E,
De aanvraag /is/image/myCat/myImg?locale=de_de retourneert de afbeelding die aan de catalogusvermelding myCat/myImg_D is gekoppeld (ervan uitgaande dat een dergelijke catalogusvermelding bestaat).
Zie de beschrijving van attribute::LocaleMap voor meer informatie.
Het vertaalproces section-1f64db17e9f644d88e09853670e14a16
In het bovenstaande voorbeeld zoekt de server eerst naar locale " de_de" in de vertaalkaart van de id. Vervolgens wordt herhaald over de locSuffixes die aan deze vermelding is gekoppeld, 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 bevat attribute::LocaleMap een lege locale die de standaardvertaalregel definieert die wordt gebruikt voor onbekende locale= -waarden (die dus niet expliciet in de vertaalkaart worden vermeld). Als deze vertaalkaart op de aanvraag /is/image/myCat/myImg?locale=ja wordt toegepast, wordt de aanvraag omgezet in myCat/myImg_E , als deze bestaat, of anders in myCat/myImg .
Als een vertaalkaart geen standaardvertaalregel specificeert, is een fout teruggekeerd voor alle verzoeken met onbekende locale= waarden.
Voorbeelden section-cc40bb00ee9248bb8cb23e17d7a5984c
multi-tiered raadpleging
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 :
Onderzoek naar specifieke IDs
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 het achtervoegsel _1 , _2 of _3 hebben. Afbeeldingen die specifiek zijn voor Franse landinstellingen, kunnen het achtervoegsel _22 of _23 hebben en afbeeldingen die specifiek zijn voor Duitse landinstellingen kunnen het achtervoegsel _470 of _480 hebben.
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
attributen::LocaleMap , attributen::DefaultLocale , locale= , req=xlate