Skip to content

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 — Engelska
  • ResBundle_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.

  1. 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.
  2. flexiteWEB söker efter strängen för MainMenu.Initiate.Caption i 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.
  3. flexiteWEB söker efter strängen för MainMenu.Initiate.Caption i 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:

  1. Skapa en fil med samma namn som den fil den ska agera komplement till, ResBundle_se.properties, under katalogen C:\tomcat\webapps\flexite\WEB-INF\classes\language\customer.

  2. Redigera den nya ..\language\customer\ResBundle_se.properties och 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:

    properties
    example.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 — Engelska
  • sv.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.

  1. 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.
  2. flexiteAdmin söker efter strängen för main.menu.home.caption i 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.
  3. flexiteAdmin söker efter strängen för main.menu.home.caption i 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:

  1. Skapa en fil enligt formatet för den fil den ska agera komplement till, exempelvis mycustomfile.sv.lang.ini, under katalogen C:\tomcat\webapps\flexiteAdmin\WEB-INF\classes\languages\custom.

  2. Redigera den nya ..\languages\custom\mycustomfile.sv.lang.ini och 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:

    ini
    example.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.