{"id":76,"date":"2011-07-13T23:29:36","date_gmt":"2011-07-13T21:29:36","guid":{"rendered":"http:\/\/hasselba.ch\/blog\/?p=76"},"modified":"2012-02-02T13:15:27","modified_gmt":"2012-02-02T11:15:27","slug":"erzwungene-locale-einstellung","status":"publish","type":"post","link":"https:\/\/hasselba.ch\/blog\/?p=76","title":{"rendered":"Erzwungene „Locale“-Einstellung"},"content":{"rendered":"

Bei der Entwicklung einer Web-Applikation f\u00fcr ein britisches Unternehmen fiel auf, da\u00df die Landeseinstellungen der XPage immer auf Deutsch eingestellt waren. Dies \u00e4u\u00dferte sich dahingehend, da\u00df das Dojo Toolkit z.B. die Datumsauswahl des Datepickers immer im falschen Format angezeigt hat. Stellt man die Landeseinstellung des Browsers um, \u00e4ndert sich auch die Clientseitige Darstellung der XPage.<\/p>\n

Der Effekt ist darauf zur\u00fcck zu f\u00fchren, da\u00df die Einstellung des Browsers herangezogen wird, um die XPage zu rendern. Welche Sprach- bzw. Landeseinstellung herangezogen wird, definiert der Client in seiner Anfrage: Beim Seitenaufruf sendet der Client eine Liste der bevorzugten Landeseinstellungen im HTTP-Request, die vom Domino-Server entsprechend interpretiert wird.<\/p>\n

Hier ein Beispiel eines HTTP-Requests (weitere Details finden sich hier<\/a>):<\/p>\n

GET \/ HTTP\/1.1\r\nHost: www.google.de\r\nUser-Agent: Mozilla\/5.0 (X11; U; Linux i686; ...\r\nAccept: text\/html,application\/xhtml+xml,appl...\r\nAccept-Language: de-de,de;q=0.8,en-us;q=0.5 ... <\/strong>\r\nAccept-Encoding: gzip,deflate\r\nAccept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7\r\nKeep-Alive: 115\r\nConnection: keep-alive<\/pre>\n
[Fett hervorgehoben: Liste der aktzeptierten Sprachen, nach Pr\u00e4ferenz (gek\u00fcrzt)]<\/em><\/p>\n
Im generierten HTML-Codes findet man die Landeseinstellung f\u00fcr das Dojo-Toolkits in der Property „djConfig“, die beim Einbinden der JavaScript-Library ausgewertet wird:<\/p>\n
<script type=\"text\/javascript\" src=\"\/domjs\/dojo-1.4.3\/dojo\/dojo.js\"\r\ndjConfig=\"locale: 'de', parseOnLoad: true\"<\/strong>>\r\n<\/script><\/pre>\n
[Fett markiert: „djConfig“-Variable mit Angabe der Landeseinstellung „de“]<\/em><\/p>\n
Will man verhindern, da\u00df die Locale-Einstellung des Browsers herangezogen wird, reicht es nicht aus, das „xsp.properties“-File zu bearbeiten, denn das „locale“-Attribut wird von der XPages-Engine falsch interpretiert:<\/p>\n
Der Eintrag<\/p>\n
xsp.client.script.dojo.djConfig=locale: 'en'<\/pre>\n
f\u00fchrt zu folgendem HTML-Code:<\/p>\n
<script type=\"text\/javascript\" src=\"\/domjs\/dojo-1.4.3\/dojo\/dojo.js\"\r\ndjConfig=\"locale:'de', parseOnLoad: true, locale:\\'en\\'<\/span>\">\r\n<\/script><\/pre>\n
[Fett: generierte Variable, in Rot: Doppelter Eintrag mit Escape-Zeichen]<\/em><\/p>\n
Es gibt keinen Weg, die fehlerhafte Konvertierung des Anf\u00fchrungszeichen zu verhindern. Alle denkbaren Kombinationen und Wege werden nicht korrekt umgesetzt (z.B. die Angabe in Anf\u00fchrungszeichen, HTML-encodiert etc), so da\u00df es auf diesem Weg nicht m\u00f6glich ist, die Einstellung zu beeinflussen.<\/p>\n
Um dennoch eine Vorgabe der Landesvorgabe zu erzwingen, mu\u00df in den Application Properties im Domino Designer die Landeseinstellung fest vorgegeben werden.<\/p>\n
Dazu legt man in den „Localization Options“ auf dem Reiter „XPages Properties“ eine Einstellung an, die man als Standardeinstellung wie im folgenden Screenshot definiert:<\/p>\n
\"\"<\/p>\n
Nach einem „Clean“ des Projektes ist dies die einzige Landeseinstellung der Applikation, egal welche „W\u00fcnsche“ der Browser vorgibt. Im HTML-Code wird die gew\u00fcnschte Vorgabe eingef\u00fcgt.<\/p>\n
<script type=\"text\/javascript\" src=\"\/domjs\/dojo-1.4.3\/dojo\/dojo.js\"\r\ndjConfig=\"locale:'en'<\/span>, parseOnLoad: true\"<\/strong>>\r\n<\/script><\/pre>\n
[Fett hervorgehoben: djConfig-Variable \/ In Rot: die erzwungene Landeseinstellung]<\/em><\/p>\n

\n<\/em><\/p>\n
Nachtrag:<\/strong><\/p>\n
Tritt der Fehler „Can’t find resource for bundle javax.faces.Messages, key [ISOCODE]<\/em>„, liegt dies daran, da\u00df der entsprechende Languagepack nicht installiert ist.<\/p>\n
Ist KEINE Locatlization-Einstellung vorhanden, gibt der Browser vor, welches Sprachbundle verwendet werden soll. Sobald eine Localization-Einstellung vorhanden ist, tritt der Fehler nicht mehr auf (das Bundle vorausgesetzt).<\/p>\n","protected":false},"excerpt":{"rendered":"
Bei der Entwicklung einer Web-Applikation f\u00fcr ein britisches Unternehmen fiel auf, da\u00df die Landeseinstellungen der XPage immer auf Deutsch eingestellt waren. Dies \u00e4u\u00dferte sich dahingehend, da\u00df das Dojo Toolkit z.B. die Datumsauswahl des Datepickers immer im falschen Format angezeigt hat. … Weiterlesen →<\/span><\/a><\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1,75,9,74],"tags":[14,7,11,16,12,3],"class_list":["post-76","post","type-post","status-publish","format-standard","hentry","category-allgemein","category-dojo","category-javascript","category-xpages","tag-designer","tag-domino","tag-http","tag-server","tag-web","tag-xpages"],"_links":{"self":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/76","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=76"}],"version-history":[{"count":14,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/76\/revisions"}],"predecessor-version":[{"id":520,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=\/wp\/v2\/posts\/76\/revisions\/520"}],"wp:attachment":[{"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=76"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=76"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/hasselba.ch\/blog\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=76"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}