Objekt-ID-Übersetzung object-id-translation
Image Serving bietet einen Mechanismus zum Übersetzen externer Objekt-IDs in Gebietsschema-spezifische Objekt-IDs (Katalog). Die primäre Anwendung dient der Bereitstellung von gebietsschemaspezifischen Inhalten und Inhalten, die von mehreren Gebietsschemas gemeinsam genutzt werden, ohne dass die Client-Anwendung die gebietsschemaspezifischen Objekt-IDs kennen muss.
Die Anwendung kann nur mit globalen Objekt-IDs geschrieben werden, und Image Serving ersetzt automatisch gebietsschemaspezifische Bilder und andere Inhalte, sofern verfügbar.
Die locale wird in Image Serving-Anforderungen mit dem Befehl locale= angegeben.
Anwendungsbereich section-66fcd5bd467c4eeaa1574583cbe9756d
Alle Verweise auf Einträge in Bild-, SVG- und statischen Inhaltskatalogen werden für Übersetzungs-Schriftarten berücksichtigt und ICC-Profilverweise werden nicht übersetzt. Zusätzlich zu den object im Pfad von /is/image und /is/static requests unterliegen diese Befehle und Katalogattribute der ID-Übersetzung: src=, mask=, template=, defaultImage=, attribute::DefaultImage und attribute::Watermark.
ID-Übersetzungszuordnung section-9e417b352c314dfe94e831fdd62cddc8
attribute::LocaleMap definiert die Regeln, die vom Server zur Bestimmung der ID des lokalisierten Inhalts verwendet werden, wobei die generische Objekt-ID und der locale= -Wert eingegeben werden.
attribute::LocaleMap besteht aus einer Liste von Eingabe-Gebietsschemas (entspricht den mit locale= angegebenen Werten) mit jeweils keinem oder mehreren Gebietsschema-Suffixen für die Ausgabe ( *locSuffixes*).
Beispielsweise könnte attribute::LocaleMap wie folgt aussehen:
en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,_E,
Die Anfrage /is/image/myCat/myImg?locale=de_de gibt das Bild zurück, das mit dem Katalogeintrag myCat/myImg_D verknüpft ist (vorausgesetzt, ein solcher Katalogeintrag ist vorhanden).
Weitere Informationen finden Sie in der Beschreibung von attribute::LocaleMap .
Der Übersetzungsprozess section-1f64db17e9f644d88e09853670e14a16
Beim obigen Beispiel sucht der Server zunächst in der ID-Übersetzungszuordnung nach dem Wert locale "de_de". Anschließend wird die mit diesem Eintrag verknüpfte locSuffixes wiederholt, in diesem Fall "_D"und "" (leeres Suffix). Für jede Iteration wird das Suffix an die Bild-ID und die resultierende ID angehängt, die auf Existenz im Katalog getestet wurde. Wenn dieser Katalogeintrag gefunden wird, wird er verwendet, andernfalls wird der nächste getestet. In diesem Beispiel werden diese Einträge aktiviert: myCat/myImg_D und myCat/myImg. Wenn keine Übereinstimmung gefunden wird, gibt der Server einen Fehler oder ein Standardbild zurück (sofern konfiguriert).
Unbekannte Gebietsschemata section-b2f3c83f2dc845d69b5908107b775537
Im obigen Beispiel enthält attribute::LocaleMap ein leeres locale , das die standardmäßige Übersetzungsregel definiert, die für unbekannte locale= Werte verwendet wird (d. h. für Werte, die nicht explizit in der Übersetzungskarte aufgeführt sind). Wenn diese Übersetzungszuordnung auf die Anfrage /is/image/myCat/myImg?locale=ja angewendet würde, würde sie in myCat/myImg_E aufgelöst, sofern sie vorhanden ist, oder anderweitig in myCat/myImg.
Wenn in einer Übersetzungszuordnung keine standardmäßige Übersetzungsregel angegeben ist, wird für alle Anforderungen mit unbekannten locale= -Werten ein Fehler zurückgegeben.
Beispiele section-cc40bb00ee9248bb8cb23e17d7a5984c
mehrstufige Suche
Es ist oft wünschenswert, Gebietsschemata (z. B. europäisch, mittelöstlich, nordamerikanisch) zu gruppieren, um regionale Standards zu erreichen. Dies kann mit einer mehrstufigen Suche erreicht werden.
In diesem Beispiel möchten wir Sammlungen für die Verwendung im Westen und im Nahen Osten unterstützen. Beide Sammlungen basieren auf der generischen Bildsammlung und in beiden werden einige Bilder hinzugefügt oder angepasst. Beide Sammlungen werden dann weiter auf bestimmte Gebietsschemata verfeinert ( m1, m2 für zwei Varianten des mittleren Ostens und w1, w2 und w3 für drei westliche Gebietsschemata), bis auf die Tatsache, dass Bilder für w1 und w3 freigegeben werden. Unbekannte Gebietsschemata werden nur der generischen Sammlung zugeordnet und haben keinen Zugriff auf gebietsschemaspezifische Bilder.
attribute::LocaleMap: w1,-W,|w2,-W2,-W,|w3,-W,|m1,-M1,-M,|m2,-M2,-M,|,
Die folgende Tabelle zeigt, welche Katalogeinträge berücksichtigt werden und in welcher Reihenfolge sie für die generische Eingabe-ID myImg berücksichtigt werden:
Suche nach bestimmten IDs
Einige Bildbenennungskonventionen unterstützen möglicherweise interne generische Bild-IDs nicht. Die generischen IDs aus der Anfrage müssen immer einer bestimmten ID im Katalog zugeordnet werden. Oft ist die genaue spezifische ID nicht bekannt.
In diesem Beispiel können Bilder für alle Sprachen das Suffix _1, _2 oder _3 aufweisen. Für französische Gebietsschemata spezifische Bilder können das Suffix _22 oder _23 aufweisen und für deutsche Gebietsschemas spezifische Bilder können das Suffix _470 oder _480 aufweisen.
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
Die folgende Tabelle zeigt, welche Katalogeinträge berücksichtigt werden und in welcher Reihenfolge sie für die generische Eingabe-ID myImg berücksichtigt werden:
Verwandte Themen section-05893816c66a406d89f9bfd6ace8d47a
attribute::LocaleMap , attribute::DefaultLocale, locale=, req=xlate