Appearance
Anpassning — Språktermer
Det är möjligt att skräddarsy de textsträngar som visas i flexiteWEB och flexiteAdmin efter egna önskemål.
Anpassa språktermer i flexiteWEB
I flexiteWEB anges anpassade textsträngar per språk och fungerar som komplement till ordinarie språkfiler.
Ordinarie språkfiler
Ordinarie språkfiler ligger i katalogen C:\tomcat\webapps\flexite\WEB-INF\classes\language:
ResBundle_en.properties— EngelskaResBundle_se.properties— Svenska
Anpassade språkfiler
Anpassade språkfiler placeras i katalogen C:\tomcat\webapps\flexite\WEB-INF\classes\language\customer. flexiteWEB stödjer en fil per språk, med samma namn som den fil den ska agera komplement till.
Hur flexiteWEB väljer textsträngar
flexiteWEB nyttjar variabler för att ange vilka textsträngar som ska visas i gränssnittet. Variabeln är densamma oavsett visningsspråk, och de faktiska textsträngarna hämtas från de individuella språkfilerna, baserat på valt språk.
Förlopp
Som exempel på förlopp kan vi ta textsträngen för menyalternativet Registrera i huvudmenyn på språket Svenska. Variabeln för denna sträng är MainMenu.Initiate.Caption.
- flexiteWEB inleder med att ta reda på huruvida det existerar en anpassad språkfil för aktuellt språk;
C:\tomcat\webapps\flexite\WEB-INF\classes\language\customer\ResBundle_se.properties.
Om en anpassad språkfil existerar, gå till punkt 2.
Om en anpassad språkfil INTE existerar, gå till punkt 3. - flexiteWEB söker efter strängen för
MainMenu.Initiate.Captioni den anpassade språkfilen.
Om strängen existerar i den anpassade språkfilen hämtas den och visas i gränssnittet.
Om strängen inte existerar i den anpassade språkfilen, gå till punkt 3. - flexiteWEB söker efter strängen för
MainMenu.Initiate.Captioni standard-språkfilen (C:\tomcat\webapps\flexite\WEB-INF\classes\language\ResBundle_se.properties) och visar den i gränssnittet.
Tillvägagångssätt för att ange egna termer
Språkfilerna i flexiteWEB är uppbyggda med key-value pairs i följande format:
properties
nyckel=värde- nyckel — Unikt ID för textsträngen. Denna nyckel används i flexiteWEB för att ange var textsträngen ska nyttjas. Denna nyckel FÅR INTE ändras.
- värde — Den textsträng som visas i gränssnittet. Det är detta värde som kan anpassas med egna termer.
Procedur
Proceduren för att ange skräddarsydda strängar för Svenska ser ut på följande vis:
Skapa en fil med samma namn som den fil den ska agera komplement till,
ResBundle_se.properties, under katalogenC:\tomcat\webapps\flexite\WEB-INF\classes\language\customer.Redigera den nya
..\language\customer\ResBundle_se.propertiesoch lägg till de strängar som ska ändras. Det enklaste förfarandet är att söka upp strängarna i standard-språkfilen, kopiera in dem i den nya filen, och där utföra önskade ändringar.Notera att varje sträng anges på endast en rad. För att infoga en ny rad inuti en sträng används uttrycket
/r. Exempel:propertiesexample.string=Information på rad ett./rInformation på rad två.Detta ger följande utseende i gränssnittet:
Information på rad ett. Information på rad två.
Anpassa språktermer i flexiteAdmin
I flexiteAdmin anges anpassade textsträngar per språk och fungerar som komplement till ordinarie språkfiler.
Ordinarie språkfiler
Ordinarie språkfiler ligger i katalogen C:\tomcat\webapps\flexiteAdmin\WEB-INF\classes\languages:
en.lang.ini— Engelskasv.lang.ini— Svenska
Anpassade språkfiler
Anpassade språkfiler placeras i katalogen C:\tomcat\webapps\flexiteAdmin\WEB-INF\classes\languages\custom.
flexiteAdmin stödjer flera språkfiler per språk, där filerna måste namnges efter följande format:
{valfritt namn}.{språk}.lang.ini
Exempel för språkfil på svenska:
mycustomfile.sv.lang.ini
Filerna läses i alfanumerisk ordning, där den senast lästa filen har företräde.
Hur flexiteAdmin väljer textsträngar
flexiteAdmin nyttjar variabler för att ange vilka textsträngar som ska visas i gränssnittet. Variabeln är densamma oavsett visningsspråk, och de faktiska textsträngarna hämtas från de individuella språkfilerna, baserat på valt språk.
Förlopp
Som exempel på förlopp kan vi ta textsträngen för menyalternativet Startsida i huvudmenyn på språket Svenska. Variabeln för denna sträng är main.menu.home.caption.
- flexiteAdmin inleder med att ta reda på huruvida det existerar anpassade språkfiler för aktuellt språk;
C:\tomcat\webapps\flexiteAdmin\WEB-INF\classes\languages\custom\*.sv.lang.ini.
Om anpassade språkfiler existerar, gå till punkt 2.
Om anpassade språkfiler INTE existerar, gå till punkt 3. - flexiteAdmin söker efter strängen för
main.menu.home.captioni de anpassade språkfilerna.
Om strängen existerar i en av de anpassade språkfilerna hämtas den och visas i gränssnittet.
Om strängen existerar i flera av de anpassade språkfilerna hämtas den från den sista filen, enligt alfanumerisk ordning, och visas i gränssnittet.
Om strängen inte existerar i de anpassade språkfilerna, gå till punkt 3. - flexiteAdmin söker efter strängen för
main.menu.home.captioni standard-språkfilen (C:\tomcat\webapps\flexiteAdmin\WEB-INF\classes\languages\sv.lang.ini) och visar den i gränssnittet.
Tillvägagångssätt för att ange egna termer
Språkfilerna i flexiteAdmin är uppbyggda med key-value pairs i följande format:
ini
nyckel=värde- nyckel — Unikt ID för textsträngen. Denna nyckel används i flexiteAdmin för att ange var textsträngen ska nyttjas. Denna nyckel FÅR INTE ändras.
- värde — Den textsträng som visas i gränssnittet. Det är detta värde som kan anpassas med egna termer.
Procedur
Proceduren för att ange skräddarsydda strängar för Svenska ser ut på följande vis:
Skapa en fil enligt formatet för den fil den ska agera komplement till, exempelvis
mycustomfile.sv.lang.ini, under katalogenC:\tomcat\webapps\flexiteAdmin\WEB-INF\classes\languages\custom.Redigera den nya
..\languages\custom\mycustomfile.sv.lang.inioch lägg till de strängar som ska ändras. Det enklaste förfarandet är att söka upp strängarna i standard-språkfilen, kopiera in dem i den nya filen, och där utföra önskade ändringar.Notera att varje sträng anges på endast en rad. För att infoga en ny rad inuti en sträng används uttrycket
/r. Exempel:iniexample.string=Information på rad ett./rInformation på rad två.Detta ger följande utseende i gränssnittet:
Information på rad ett. Information på rad två.
Begränsningar och rekommendationer
När nya textsträngar författas måste följande punkter beaktas:
- Den nya textsträngen BÖR INTE överskrida antalet tecken i den befintliga textsträngen. En textsträng som är för lång kan förstöra både layout och funktionalitet. För textsträngar för knappar är detta kritiskt.
- Den nya textsträngen BÖR avslutas på samma vis som den befintliga. Om den befintliga textsträngen exempelvis avslutas med ett kolon (
:) så bör även den nya göra det. Detta för att behålla konsekvent formatering. - Ha i åtanke att en och samma textsträng kan nyttjas på flera ställen i applikationerna.
Vid frågor gällande författande av textsträngar, vänligen kontakta Flexite AB Helpdesk.
Ansvar vid uppgradering och hotfix-patchning
Vid uppgradering och hotfix-patchning kan det ske förändringar kring nyttjande och utformning av textsträngar. Det är därför kritiskt att efter varje uppgradering och hotfix-patchning som innefattat förändringar av språkfiler gå igenom samtliga anpassade termer och jämföra dem med de nya språkfilerna.
För information om ansvarsfrågan gällande anpassade språktermer i språkfiler, vänligen kontakta Flexite AB Helpdesk.