Configurando el idioma, región y zona horaria de la interfaz gráfica de O3

Todos los componentes de O3 incluyen soporte de múliples idiomas.

Cuando se ejecuta O3 se determina el idioma y región indicado en la configuración regional de la máquina (comunmente llamada locale) y en el caso de ser alguno de los idiomas indicados antes O3 se ajusta en forma automática para dicho idioma. En el caso de los separadores de miles y decimales Java y en consecuencia O3 toma para la configuración de los mismos la región, sin importar los definidos por nostros. Por lo cual si queremos cambiar esto deberemos de hacerlo por properties.

Sin embargo, es posible configurar en forma manual cuál de los idiomas utilizar y como son los separadores de miles y decimeles.

Esta tablita muestra los idiomas soportados junto con su identificador.

Esta otra muestra las regiones que definen los separadores de miles y decimeles

Para cambiar el valor de Time Zone cuando Java no interpreta el definido en el Sistema Operativo.

Dependiendo de la forma en que se ejecuta O3 (ejecutables de la carpeta bin, o scripts de la carpeta bat/sh) se deben seguir las siguientes instrucciones:

Usando scripts de la carpeta bat o sh (windows o linux respectivamente)

Cada módulo de O3 cuenta con un script en la carpeta bat o sh que se utiliza para ejecutarlo.

Estos archivos incluyen una sección en la que se definen una serie de variables de ambiente que son luego utilizadas como parámetros del proceso java que ejecuta el módulo de O3. No es necesario cambiar o poner las 2 properties, dependerá de las necesidades

Ejemplo para archivos .bat

Por ejemplo para configurar el O3 Browser se debe localizar la siguiente sección del archivo Browser.bat

rem Add Application System Properties
set PROPERTIES=%PROPERTIES% -mx200M

A esta sección se le debe agregar una nueva línea de modo que quede de la siguiente forma

rem Add Application System Properties
set PROPERTIES=%PROPERTIES% -mx200M
set PROPERTIES=%PROPERTIES% -Duser.language=XX
set PROPERTIES=%PROPERTIES% -Duser.region=YY
set PROPERTIES=%PROPERTIES% -Duser.timezone=ZZ

Donde XX corresponde al identificador del idioma
Donde YY corresponde al identificador de región
Donde ZZ corresponde al valor de la zona horaria

Ejemplo para archivos .sh

Por ejemplo para configurar el O3 Browser se debe localizar la siguiente sección del archivo Browser.sh

# Add Application System Properties
PROPERTIES="$PROPERTIES -mx200M"

A esta sección se le debe agregar una nueva línea de modo que quede de la siguiente forma

# Add Application System Properties
PROPERTIES="$PROPERTIES -mx200M"
PROPERTIES="$PROPERTIES -Duser.language=XX"
PROPERTIES="$PROPERTIES -Duser.regiom=YY"
PROPERTIES="$PROPERTIES -Duser.timezone=ZZ"

Donde XX corresponde al identificador del idioma
Donde YY corresponde al identificador de región
Donde ZZ corresponde al valor de la zona horaria

Usando ejecutables de la carpeta bin

De forma similar al caso anterior, módulo de O3 cuenta con un ejecutable en la carpeta bin acompañado por un archivo con extensión .lax que sirve para configurarlo.

Para configurar el idioma de cada uno de estos módulos es necesario localizar la línea similar a la siguiente:

lax.nl.java.option.additional=-Xmx100m -Djava.library.path=C:\\IdeaSoft\\O3\\classes\\bin

y agregarle la configuración del idioma -Duser.language=XX donde XX y/o la región -Duser.region=YY donde YY  corresponde al identificador del región;
y/o la zona horaria -Duser.timezone=ZZ donde ZZ corresponde al valor de la zona horaria.

Esta línea quedará entonces de la siguiente forma:

lax.nl.java.option.additional=-Xmx100m -Duser.language=XX -Duser.region=YY -Duser.timezone=ZZ -Djava.library.path=C:\\IdeaSoft\\O3\\classes\\bin

Para el jboss.sh

En el caso del jboss.sh la modificación es diferente, buscar las siguientes líneas

JAVA_OPTS="-server -Xms128m -Xmx512m"
JAVA_OPTS="$JAVA_OPTS -XX:MaxPermSize=128m"
JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true"

 y agregarles :

JAVA_OPTS="-server -Xms128m -Xmx512m"
JAVA_OPTS="$JAVA_OPTS -XX:MaxPermSize=128m"
JAVA_OPTS="$JAVA_OPTS -Djava.awt.headless=true"
JAVA_OPTS="$JAVA_OPTS -Duser.language=XX"
JAVA_OPTS="$JAVA_OPTS -Duser.region=YY"

O3Report web

Modificar el locate (en-US) definido en <o3-install>\jboss\server\default\deploy\o3report.war\WEB-INF\web.xml

<context-param>
	<param-name>BIRT_VIEWER_LOCALE</param-name>
	<param-value>en-US</param-value>
</context-param>

Para cuando se baja por JWS

Procedimiento:

1. ir al directorio donde está instalado O3
2. de ahí ir al directorio jboss/server/default/deploy/gserver/Oo3.ear
3. localizar el archivo o3-installer-X.X.XXX.war y renombrarlo ej #o3-installer-X.X.XXX.war (puede variar el número de acuerdo a la versión)
4. crear ahí mismo una carpeta con el nombre o3-installer-X.X.XXX.war
5. descomprimir el archivo o3-installer-X.X.XXX.war en la carpeta creada
6. localizar el archivo o3-installer.jnlp, y abrirlo con un editor de texto

7. agregar las siguientes property en la parte correspondiente (casi al final del archivo)

   <property name="user.language" value="XX">
   </property>
   <property name="user.region" value="YY">
   </property>
   <property name="user.timezone" value="ZZ">
   </property>
   

8. reiniciar el jboss y volver a correr la aplicación