Implications for practice and for future research

El comando de O3 Builder permite realizar una construcción completa o incremental desde la línea de comandos, o programando la construcción del datamart a través del programador de tareas del sistema operativo.

El ejecutable para el Builder se encuentra en la carpeta bin de la instalación de O3. Y en script en la carpeta bat (instalación MS-Windows) o sh. La sintaxis de ejecución del Builder es:

Builder [opciones] <modelo | cubo | servercfg>

Las Opciones incluyen:

Opción Descripción

-debug Activa la ejecución más detallada del componente.

-log Activa el envío de log de construcción a la consola. Esta opción está habilitada por defecto

-logfile=<archivo> Activa el envío de log de construcción al archivo indicado. Si bien el archivo no tiene por qué existir, sí la ruta donde será creado.

-logtype=<tipo log>

Configura el tipo de log que se genera cuando la opción logfile está habilitada. Las opciones son:

clear: Borra el archivo de log con cada construcción

append: Agrega información al archivo de log si este ya existe

-help Muestra los posibles parámetros y opciones para el comando. -version Muestra información de versión de los componentes de O3.

-cube=<archivo> Especifica el nombre y la ubicación del datamart que se está generando. Es válido solamente para una construcción completa. Si no especifica un nombre de archivo, la ubicación por defecto y el nombre son los mismos del modelo con la extensión .cube.

-is=<Input Set> Especifique el nombre de un Input Set para usar en la construcción. Si está realizando una construcción completa, especifique un Input Set de tipo Full para esta opción y un archivo .mdl como parámetro.

Si no especifica un Input Set, por defecto se usará el Input Set llamado "Full" que está presente por defecto en todos los modelos.

Si está realizando una construcción incremental, especifique un Input Set Incremental para esta opción y un archivo .cube como parámetro.

-cfg=<archivo> Especifique el nombre y la ubicación del archivo que contiene los parámetros sustitutos de construcción. Por defecto, los parámetros de construcción toman su valor del indicado en el propio O3 Designer.

-server Indica que el O3 Builder se ejecutará como un servidor. Esto permite que un usuario se conecte desde Adm Server al Builder durante el proceso de construcción, para apagarlo usando ShutDown o para ver el registro. Esto es útil cuando el proceso de construcción es largo.

Si ejecuta un ShutDown durante la construcción o actualización del datamart, éste no se realiza hasta que la construcción del datamart esté completa. Si el proceso está esperando para intentar nuevamente, la interrupción es inmediata.

-port=<número> Cuando ejecuta el O3 Builder como un servidor, debe especificar un puerto para la conexión entre el AdmServer y el O3 Builder. El formato es <hostname>:<portnumber>. El puerto por defecto es 1098.

Especifique uno de los siguientes parámetros:

Tipo Descripción

modelo Un archivo .mdl indica que se solicita una construcción completa para el modelo indicado. Si no especifica un Input Set, se usará por defecto el Input Set de tipo Full llamado "Full" Notar que el nombre es sensible a mayúsculas y minúsculas

cubo Un archivo .cube indica que se solicita una construcción incremental del cubo indicado. Si no especifica un Input Set se usará por defecto el Input Set de tipo Incremental llamado "Incremental". Notar que el nombre es sensible a mayúsculas y minúsculas servercfg Un archivo .srv conteniendo la información de actualización de un datamart publicado en un O3 Server. Puede ser utilizado tanto

para construcciones completas o incrementales. El tipo de construcción se especifica usando la opción -is. Con este tipo de construcción el O3 Builder se conecta con el O3 Server, deshabilita el datamart (notificando a los usuarios conectados y cerrando las conexiones), construye o actualiza el datamart y lo habilita.

El datamart generado se encuentra en la URL definida en el O3 Server al momento de publicarlo.

El archivo .srv debe tener el siguiente formato:

# Ejemplo de archivo de configuración para actualizar el cubo Demo

serverHost = localhost serverName = O3Server user = admin password = XXXXXXX cubeName = Demo model = istore:models/Demo.mdl publishType = contents #targetURL = C:\IdeaSoft\O3_50070Test/Files/Demo.cube forceAvailable = true #uploadURL = istore:/o3builder_cubes/Demo.cube deleteDownloadFile = true deletePreviousCube = true donde:

serverHost Es la dirección IP o nombre de la máquina en la que se está ejecutando el O3 Server.

serverName Es el nombre del servidor al que O3 Builder está conectado. El valor de este parámetro debe mantenerse "O3Server" excepto en raras ocasiones en las cuales sea necesario renombrar el servicio del O3 Server

user Es el usuario a través del cual el O3 Builder se conecta al O3 Server para notificar que el datamart será actualizado. Este usuario debe tener privilegios de administrador.

password Es la contraseña para el usuario especificado.

cubeName Es el nombre del datamart que se desea actualizar. Este nombre es aquel usado para publicarlo en el O3 Server y no tiene por qué coincidir con el nombre del archivo físico.

model Es la ruta y nombre del modelo del datamart. Se usa para construcciones completas. publishType Especifica como se hará disponible en el servidor

Las opciones son:

none: Este es el valor por defecto y asegura compatibilidad con las versiones anteriores.

upload: El Builder crea el datamart en un repositorio intermedio que podría ser del file system, ftp o istore contents: El Builder envía el contenido del datamart a través de la red.

targetURL Especifica el lugar donde el datamart sera creado.

No es utilizado si publishType tiene otro valor a "none"

forceAvailable Especifica si el datamart debe quedar visible despues de la construcción

1.

uploadURL Especifica el repositorio intermedio donde el datamart será construído. Esta URL puede ser de file system, fto o istore.

Esta URL tiene que ser visible por el O3 Server.

Esto solo es posible si la propiedad "publishType" fue especificada en "upload".

Por "default" guarda en la carpeta temporal del usuario

deleteDownloadFile Especifica si el datamart tiene que ser borrado del depósito intermedio una vez publicado sobre en el Servidor El valor por "default" es false

deletePreviousCube Especifica si el datamart publicado originalmente tiene que ser suprimido del Servidor después de copiar el nuevo.

Esto se realiza únicamente si la propiedad "o3.publish.mode" estaáseteada en "newfile" en el archivo GServer.properties

Este archivo de actualización de datamarts publicados en el servidor debe ser creado automáticamente por el O3 Server Administrator. Para más detalles referirse a la sección de Información de la Sección Parámetros de Actualización de la página de Administración de Cubos del Manual del O3 Server Administrator.

Ejemplos

Supongamos un datamart de ejemplo con información de ventas para los años 2000, 2001 y 2002