{scrollbar}

----
Para visualizar el tablero es necesario generarlo a partir del modelo definido. Una vez que se ha generado el tablero es posible visualizarlo con el componente O3 Scorecard Viewer.

Es posible generar el tablero de control de dos formas:
# Desde O3 Scorecard Editor mientras se edita el modelo que define el Tablero.
# Ejecutando un comando desde la línea de comandos del sistema operativo.

h1. Generando el Tablero desde el Editor

Para generar o construir el Tablero se deben seguir los siguientes pasos:
# Elegir el botón correspondiente de la barra de Herramientas que permite realizar la operación !bsEditorGenerate.gif!.  Si sobrepasamos con el ratón los distintos elementos de la barra de Herramientas, aparece una descripción (tooltip) que indica la funcionalidad de cada uno de ellos.
# Indicar dónde almacenar el tablero generado en el diálogo que se presenta a continuación del paso 1. Para ello se debe elegir un tipo de ubicación para el tablero que se va a generar dentro de las siguientes opciones:

* Archivos Locales: El tablero se genera en el sistema de archivos.
* Archivos Remotos: El tablero se genera en O3 Server.
* Recientes: El tablero se genera en el sistema de archivos. Esta opción facilita generar un tablero ya generado previamente.

# Definir el nombre del tablero que se genera en la ubicación previamente indicada:

* Archivos Locales: Se debe elegir un directorio e ingresar el nombre que se le quiere dar al tablero.
* Archivos Remotos: se debe ingresar el nombre del tablero. La primera vez que se accede al servidor se debe ingresar usuario y clave para conectarse al mismo.
* Recientes: Elegir un nombre de la lista presentada. Esta opción es útil cuando se actualiza un tablero ya existente.

  !O3Scorecard-GuardarVisualizadorTablero.png|align=center!\\
\\
\\
\\
El archivo generado que contiene el tablero tiene extensión bsDat  y el nombre ingresado por el usuario. En caso de elegir un nombre existente se pide al usuario la confirmación para sobrescribirlo.
\\
Una vez que se ha generado el tablero, queda disponible para ser visualizado con O3 Scorecard Viewer o en su versión HTML desde un navegador de Internet.
\\
\\

h1. Generando el Tablero desde la línea de comandos

Existe el comando *BSCGen* para actualizar tableros desde la línea de comando.

Tanto en Windows como en otros sistemas operativos se puede correr el ejecutable *{_}BSCGen.exe{_}* que se encuentra en el directorio *{_}bin{_}* ubicado bajo el directorio de instalación.

Además es posible ejecutar el script correspondiente tanto en sistemas Windows como en otros sistemas:
* En Windows el script se denomina *{_}BSCGen.bat{_}* que se encuentra en el directorio *{_}bat{_}* ubicado bajo el directorio de instalación.
* En otros sistemas el script se denomina *{_}BSCGEN.sh{_}* que se encuentra en el directorio *{_}sh{_}* ubicado bajo el directorio de instalación.

En el directorio de instalación hay un archivo de propiedades de generación de tableros de control llamado *{_}O3BSCGenerator.properties{_}*, conteniendo las siguientes propiedades:
| *Propiedad* | *Descripción* |
| gclient.server.port | Puerto donde escucha *O3 Server* |
| gclient.server.name | Nombre del Servidor |
| gclient.server.host | Nombre o dirección IP dela maquina donde corre *O3 Server* |
| gclient.singleSignOn | Mantener el valor en *true * |
| indicatorsXML | Ubicación del modelo del Tablero. Puede estar en el sistema de archivos o en el servidor. |
| resultFileName | Nombre del archivo  con el que se genera el archivo. Puede generarse en el sistema de archivos o en el servidor |
| secFilePath | Ubicacion del archivo que contiene el usuario y clave de *O3 Server* |
Por defecto el archivo tiene las propiedades que permiten generar el tablero de ejemplo que se llama Ventas Mundiales. Tanto la definición del Tablero como el Tablero generado se encuentran bajo el  directorio "*<Directorio Instalación>/files/VentasMundiales*".
| \

...

Para visualizar el tablero es necesario generarlo a partir del modelo definido. Una vez que se ha generado el tablero es posible visualizarlo con el componente O3 Scorecard Viewer.

Es posible generar el tablero de control de dos formas:

1. Desde O3 Scorecard Editor mientras se edita el modelo que define el Tablero.
2. Ejecutando un comando desde la línea de comandos del sistema operativo.

Generando el Tablero desde el Editor

Para generar o construir el Tablero se deben seguir los siguientes pasos:

1. Elegir el botón correspondiente de la barra de Herramientas que permite realizar la operación Image Added.
2. Indicar dónde almacenar el tablero generado en el diálogo.
   Para ello se debe elegir un tipo de ubicación para el tablero que se va a generar dentro de las siguientes opciones:
   • Archivos Locales: El tablero se genera en el sistema de archivos.
   • Archivos Remotos: El tablero se genera en O3 Server.
   • Recientes: El tablero se genera en el sistema de archivos. Esta opción facilita generar un tablero ya generado previamente.
3. Definir el nombre del tablero que se genera en la ubicación previamente indicada:
   • Archivos Locales: Se debe elegir un directorio e ingresar el nombre que se le quiere dar al tablero.
   • Archivos Remotos: se debe ingresar el nombre del tablero. La primera vez que se accede al servidor se debe ingresar usuario y clave para conectarse al mismo.
   • Recientes: Elegir un nombre de la lista presentada. Esta opción es útil cuando se actualiza un tablero ya existente.

Image Added

El archivo generado que contiene el tablero tiene extensión bsDat y el nombre ingresado por el usuario. En caso de elegir un nombre existente se pide al usuario la confirmación para sobrescribirlo.

Una vez que se ha generado el tablero, queda disponible para ser visualizado con O3 Scorecard Viewer o en su versión HTML desde un navegador de Internet.

Generando el Tablero desde la línea de comandos

Existe el comando BSCGen para actualizar tableros desde la línea de comando.

Tanto en Windows como en otros sistemas operativos se puede correr el ejecutable BSCGen.exe que se encuentra en el directorio bin ubicado bajo el directorio de instalación.

Además es posible ejecutar el script correspondiente tanto en sistemas Windows como en otros sistemas:

• En Windows el script se denomina BSCGen.bat que se encuentra en el directorio bat ubicado bajo el directorio de instalación.
• En otros sistemas el script se denomina BSCGEN.sh que se encuentra en el directorio sh ubicado bajo el directorio de instalación.

En el directorio de instalación hay un archivo de propiedades de generación de tableros de control llamado O3BSCGenerator.properties, conteniendo las siguientes propiedades:

Por defecto el archivo tiene las propiedades que permiten generar el tablero de ejemplo que se llama Ventas Mundiales.

Tanto la definición del Tablero como el Tablero generado se encuentran bajo el directorio <O3>/files/VentasMundiales.

# O3 Scorecard Generator configuration File
\\
\\
\# CS Properties \\
gclient.server.port   = 1099 \\
gclient.server.name   = O3Server \\
gclient.server.host   = localhost
\\
gclient.singleSignOn = true \\
\\
\# Sample entries for local scorecards \\
indicatorsXML 
indicatorsXML        = $\{ideasoft.home\}/files/VentasMundiales/VentasMundiales.bsDef
\\
resultFileNameresultFileName       = $\{ideasoft.home\}/files/VentasMundiales/VentasMundiales.bsDat \\
\\
\# Sample entries for remote scorecards \\
\#indicatorsXML 
#indicatorsXML       = istore:scorecard/Ventas Mundiales
#resultFileName    \\ \#resultFileName = istore:scorecard/Ventas Mundiales
\\
\\
secFilePath 
secFilePath          = $\{ideasoft.home.path\}/files/VentasMundiales/VentasMundiales_UserO3BSCSecFile.properties
\\ |

Para

...

generar

...

otro

...

tablero

...

deberá

...

modificar

...

los

...

valores

...

de

...

indicartorsXML

...

y

...

resultFileName.

El archivo de seguridad, es típicamente compartido entre varios tableros, a menos que los mismos deban construirse con distintos priviliegios de acceso a modelos. Este archivo contiene el usuario y password para conectarse al O3 Server donde esté publicado el BSC y para acceder a los datos de O3 durante la carga de datos en el mismo.

El archivo O3BSCSecFile.properties se genera desde el panel asociado al elemento Raíz de Scorecard en el Editor del Scorecard.

Generando Más de un Tablero

Para cada tablero a generar, se necesita crear un archivo .properties que identifique el tablero a generar y cual es el archivo de seguridad (usuario y password a utilizar para publicarlo y acceder a datos en el servidor).

Dicho archivo puede crearse tomando como modelo el archivo O3BSCGenerator.properties. Supongamos que al nuevo archvo .properties le llamáramos bscVentas.properties. Los cambios a realizar sobre el mismo son los siguientes:

• indicartorsXML: debe indicar la URL (filesystem o remota) de la definición del tablero (archivo con extensión .bsDef),
• resultFileName: debe indicar la URL (filesystem o remota) del archivo con datos del tablero (archivo con extensión .bsDat).
• secFilePath: ruta al archivo de seguridad, que contiene la declaración de usuario y password a utilizar.
  Este archivo puede ser compartido entre varios tableros, de hecho esta es la forma recomendada de uso.
  Puede ser generado mediante el Editor del Scorecard (O3 Browser), mediant el panel asociado al nodo raíz del Scoreacard. En el cuadro llamado Parámetros Batch es posible ingresar un usuario, password e indicar donde grabar el archivo. En el mismo, la password quedará encriptada.

Para construir el tablero, se debe utilizar el comando BSCGen (bscgen.bat o bscgen.sh), pasando como argumento archivo .properties definido previamente (path completo al archivo).

Por ejemplo: bscgen.bat c:\bsc\ventas\bscVentas.properties o bscgen.sh /data/o3/scorecard/bscVentas.properties.

...

{scrollbar}