Page Comparison

{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*".
| \# O3 Scorecard Generator configuration File \\
\\
\# CS Properties \\
gclient.server.port&nbsp; = 1099 \\
gclient.server.name&nbsp; = O3Server \\
gclient.server.host&nbsp; = localhost \\
gclient.singleSignOn = true \\
\\
\# Sample entries for local scorecards \\
indicatorsXML&nbsp; = $\{ideasoft.home\}/files/VentasMundiales/VentasMundiales.bsDef \\
resultFileName = $\{ideasoft.home\}/files/VentasMundiales/VentasMundiales.bsDat \\
\\
\# Sample entries for remote scorecards \\
\#indicatorsXML&nbsp; = istore:scorecard/Ventas Mundiales \\
\#resultFileName = istore:scorecard/Ventas Mundiales \\
\\
secFilePath = $\{ideasoft.home.path\}/files/VentasMundiales/VentasMundiales_UserSecFile.properties \\ |

Para generar otro tablero deberá modificar los valores de indicartorsXML y resultFileName, así como también el path y nombre de secFilePath que.

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 usario 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 VentasMundiales_UserSecFile.properties se genera desde el panel asociado al elemento Raíz de propiedades Scorecard en el Editor del elemento RaízScorecard.

h2. Generando Más de un Tablero

Para Decada acuerdotablero a generar, lose vistonecesita anteriormentecrear debemosun realizararchivo las.properties modificacionesque alidentifique archivo *{_}O3BSCGenerator.properties{_}* para generar un tablero distinto al Ventas Mundiales.

Si tenemos más de un Tablero a generar se deberán seguir los siguientes pasos:
* Generar unel 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{_}* por cada Tablero, por ejemplo. Supongamos que al nuevo archvo .properties le llamáramos  *{_}bscVentas.properties{_}*, donde modificaremos. Los cambios a realizar sobre el valor de las propiedadesmismo son los siguientes:

* _indicartorsXML_: debe indicar la URL (filesystem o remota) de la definición del tablero (archivo con extensión .bsDef),
* _resultFileName_ y _secFilePath_.
* Generar un *{_}NombreTablero_User.properties{_}* por cada Tablero, por ejemplo *{_}Ventas_User.properties{_}*, que se genera desde el panel de propiedades del elemento Raíz.
* Generar cada Tablero con: 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. Este archivo contiene el usuario y la password que se utilizarán para acceder a datos y para publicar el nuevo tableto en el servidor. Este archivo 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 el + archivo .properties definido previamente (path ycompleto nombre delal archivo ).properties+, porPor ejemplo: *bscgen.bat c:\bsc\ventas\bscVentas.properties* o *bscgen.sh /data/o3/scorecard/bscVentas.properties*.


----
{children}

----
{scrollbar}