Omzetten van object-id

Laatste update: 2023-11-04
  • Gemaakt voor:
  • Developer
    User

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.

OPMERKING

Vertalen van object-id is alleen van toepassing voor gebruik van afbeeldingsserver op basis van catalogus. Bestandsnamen kunnen niet worden vertaald.

Toepassingsgebied

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

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

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

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

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. 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:

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

Zie ook

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

Op deze pagina