HowTo Formatear números en los tableros

Formato de números

El formato se utiliza para indicar como queremos ver el número, cuantos dígitos decimales y si queremos agruparlos.

La siguiente es una tabla para indicar como se especifica el formato

Símbolo

Significado

0

Dígito

#

Dígito, se muestra cero si no hay un dígito

.

Separador decimal

-

Signo de menos

,

Separador para agrupar

E

Separa mantisa y exponente en notación científica

Número

Formato
(outputMask=)

Configuración Regional
(outputMaskLocale=)

Resultado

0.00

"0.00"

"en"

0.00

0.00

"0.00"

"es"

0,00

0.0

"0.0"

"es"

0.0

0.0

"0.0"

"es"

0,0

1000

",###"

"en"

1,000

1000

",###"

"es"

1.000

1000

",###.0"

"en"

1,000.0

1000

",###.0"

"es"

1.000,0

76.5

",###.0'%'"

"en"

76.5%

76.5%

",###.0'%'"

"es"

76,5%

Configuración Regional

La configuración regional es la forma para indicar qué símbolos utilizar en el número al cual se le aplicó el formato deseado.
Por ejemplo, para el número 1234 si le aplicamos el formato #,###.00 si la configuración regional es español lo veremos como 1.234,00. En cambio si la configuración es ingles lo veremos como 1,234.00

El valor conel cual lo vamos a configurar es uno de los siguientes:

Valor

Significado

default

se toma la configuración regional del servidor.

user

se toma la configuración regional definida por el cliente (por ejemplo cuando se loguea por la web)

es

español

en

ingles

it

italiano

pt

portugués

Procedimiento

A partir de la versión 5.0.050 existe en la interfaz gráfica la capacidad para indicar el formato y la configuración regional.
Las versiones anteriores a la 5.0.050 solo soportan formato especificandolo de la siguiente manera:

  1. Generar el tablero y guardarlo
  2. Buscar el archivo de nombre igual al tablero pero que termina .bsDef
  3. Abrir el archivo y buscar outputMask="0.0" (este es un atributo asociado a cada indicador, por lo que se deberá reemplazar en todos aquellos indicadores a los cuales se desee modificar el formato por defecto)
  4. Remplazar por el formato deseado (ver tabla abajo de formatos)
  5. Guardar el archivo
  6. Generar el tablero

Ejemplo 1:
Supongamos que se quiere ver los números de la siguiente forma : 25,506.0
substituir por

outputMask=",###.0 "

La forma de configurar la configuración regional es parecida al del formateo del número:

  • En la misma linea de outputMask="0.0" tenemos que poner outputMaskLocale="default"