Definiendo Parámetros
En el O3 Designer es posible definir un grupo de parámetros para:
- Controlar el proceso de construcción.
- Sustituir valores en la definición de fuentes de datos.
El parámetro usa valores por defecto, o valores asignados en el momento que se dispara el proceso de construcción.
La definición de un parámetro de construcción incluye las siguientes declaraciones:
- Nombre
- Valor por defecto
- Tipo (Cadena de caracteres, Fecha, Entero, Doble, Hora)
- Si se usará para controlar una construcción incremental o no (controla si el valor es diferente al valor del parámetro del datamart anterior)
Los valores de los parámetros pueden ser constantes o expresiones. Si usa una expresión, el valor debe comenzar con = (signo de igual).
Puede usar operadores y funciones de campos virtuales en la expresión.
Por ejemplo, puede definir un valor de parámetro como:
=Hoy()
En este caso su valor será la fecha de la construcción del datamart.
También es posible usar parámetros de construcción definidos previamente en valores de parámetro refiriéndose a ellos como $NombreParámetro$.
Por ejemplo:
RUTA_INSTALACION = C:\IdeaSoft\O3 RUTA_DATOS = $RUTA_INSTALACION$\files
En este caso, el valor de RUTA_DATOS será C:\IdeaSoft\O3\files.
También puede usar un parámetro de construcción definido previamente en una expresión que asigna un valor a otro parámetro. En este caso se debe referenciar al parámetro directamente con su nombre sin encerrarlo entre símbolos $ cuando usa un parámetro dentro de una expresión.
FECHA_ACTUAL=Hoy() FECHA_PROXIMA_CONSTRUCCION=SumarDia(FECHA_ACTUAL, 1)
Definición de Parámetros de Construcción en las Fuentes de Datos
Es posible referirse a los parámetros de construcción definidos en la definición de una Fuente de Datos de Texto, o en una consulta SQL refiriéndose al $Nombre Parámetro$.
Por ejemplo:
SELECT * FROM Facturas WHERE Fecha > $AYER$
También es posible utilizar parámetros en construcciones incrementales para referenciar a valores de parámetros de la anterior construcción. En dicho caso se agrega el sufijo .OLD al nombre del parámetro.
Por ejemplo:
SELECT * FROM Facturas WHERE Fecha > $FECHA_ACTUAL.OLD$
Durante la construcción del datamart, los valores de parámetros se sustituyen. Los mismos pueden ser valores por defecto (asignados en el modelo), o valores reasignados durante la construcción.
Los valores de los parámetros asignados en el momento de la construcción pueden ser leídos de un archivo de configuración con el siguiente formato:
<Nombre Parámetro 1> = <Valor Parámetro 1> <Nombre Parámetro 2> = <Valor Parámetro 2> <Nombre Parámetro 3> = <Valor Parámetro 3> ...
Este tipo de archivo de configuración debe ser generado con la extensión .cfg y llamado en la construcción del datamart con la opción -cfg= del comando builder.
Los valores definidos en el modelo se sustituyen con los que se especifican en el archivo. Pueden ser constantes o expresiones.
Para definir parámetros de construcción:
En la solapa General del Datamart se definen los parámetros de construcción.
- Seleccionar la rama principal del modelo en el Árbol de Diseño. Aparece el Panel de Propiedades del mismo.
- Seleccionar la solapa General.
- Presionar el botón Agregar en el cuadro de grupo de Parámetros. Aparece un nuevo parámetro de construcción.
- Para editar el nombre del parámetro de construcción, hacer doble clic en el campo del nombre.
- Ingresar el nombre del nuevo parámetro de construcción.
- Para editar el valor del parámetro de construcción hacer doble clic en el campo Valor.
- Ingresar el valor del nuevo parámetro de construcción.
- Para cambiar el tipo de parámetro de construcción haga doble clic en el campo Tipo. Aparece la lista de tipos.
- Para usar el parámetro de construcción para controlar una construcción incremental marcar la opción Controlador.