COMBINED LOAD RULE / REGLA DE CARGA COMBINADA

English (Español a continuación)

We can create a combined load rule that serves both to upload / modify dimension and to upload data.

The steps to follow are:

1.- Create dimension build rules file

To create a rule file:

  • Right-click on the database and select “Create” / “Rules file” from the drop-down menu.

The “Data Preparation Editor” window opens with a blank template and a menu at the top.

In the top menu of the console we select «File» -> «Open data file» and select the data file that we want to upload.

The first thing we have to do is tell Essbase how the columns are separated in this file (in our example with «;»):

  • In the upper menu of the «Data preparation editor» we select «Data source properties» -> «Delimiter» and select the one that corresponds (in this example, we select «Personalized» and indicate «;»; then «OK”.
  • The different columns that make up the data file are already shown separately in the template.

In the «Data preparation editor» menu we select «Dimension Build Settings». In the menu that opens we select the drop-down «Dimension Build Settings»:

  • We select the dimension whose members we are going to load.
  • The «Build Method» is selected: there are different possibilities, in this example we select «Use references to parent / child».
  • Accept.

In the menu of the «Data preparation editor» the option «Dimension Build Field» is marked.

Next, in the menu of the «Data preparation editor» we click on the option «Field properties».

In the window that opens we select «Dimension Build Properties»; we have to go column by column of the text file defining its characteristics:

  • Those columns that we are not going to use for the dimension we select: «Skip field during dimension creation».
  • Those columns that we are going to use must be assigned to the dimension we want to modify and we must select their type. For example:
    • Principal
    • Secondary
    • Alias
    • Property

Then «Accept».

Finally, in the menu of the «Data preparation editor» we click on «Validate», and finally «Save».

This build rule would already be ready for the dimension. Next, we have to define this same rule so that it also works for data loading.

2.- Create data load rules file

In the menu of the «Data preparation editor» we select «Data load configuration», where we are offered different options:

For example:

  • ”Overwrite existing values”.
  • «Add to existing values».
  • «Subtract from existing values».

In the upper menu of the «Data preparation editor» we select «Data load fields».

Then in that upper menu we select «Field properties» and in the drop-down we select «Data load properties».

Next we have to go column by column assigning them to the corresponding dimensions.

  • For those columns that we are not going to use we select: «Skip field during data loading».

Once all the columns have been assigned to the corresponding dimensions, in the upper menu of the «Data preparation editor» we click on «Validate» and “Save”.

  • We already have the «Rules file» ready for uploading data.

3.- Data upload

If we want to use this rule to upload / modify a dimension:

  • Right click on the database and in the drop-down we select “Load data”.
  • In the window that opens we click on «Mode» and in the drop-down we select «Creation only».

If we want to use this rule to load data:

  • Right click on the database and in the drop-down we select “Load data”.
  • In the window that opens we click on «Mode» and in the drop-down we select «Load only».

We can also use the rule to simultaneously build dimension and load data:

  • Right click on the database and in the drop-down we select “Load data”.
  • In the window that opens we click on «Mode» and in the drop-down we select «Both».

Español

Se puede crear una regla de carga combinada que sirva tanto para subir / modificar dimensión como para subir datos.

Los pasos a seguir son:

1.- Crear regla de carga para la construcción de una dimensión

Para crear una regla de carga:

  • Se hace click con el botón derecho sobre la base de datos y en el desplegable se selecciona “Crear” / “Archivo de reglas”.

Se abre la ventana “Editor de preparación de datos” con una plantilla en blanco y con un menú en la parte superior.

En el menú superior de la consola seleccionamos “Archivo” -> “Abrir archivo de datos” y seleccionamos el fichero de datos que queremos subir.

Lo primero que tenemos que hacer es indicarle a Essbase como vienen separadas en este fichero las columnas (en nuestro ejemplo con “;”):

  • En el menú superior del “Editor de preparación de datos” seleccionamos “Propiedades de origen de datos”-> “Delimitador” y seleccionamos el que corresponda (en este ejemplo, seleccionamos “Personalizado” e indicamos “ ; “; a continuación “Aceptar”.
  • En la plantilla se muestran ya separadas las distintas columnas que configuran el fichero de datos.

En el menú “Editor de preparación de datos” seleccionamos “Configuración de creación de dimensión”. En el menú que se abre seleccionamos el desplegable “Configuración de creación de dimensión”:

  • Seleccionamos la dimensión cuyos miembros vamos a cargar.
  • Se selecciona el “Método de creación”: hay distintas posibilidades, en este ejemplo vamos a seleccionar “Utilizar referencias a principal / secundario”.
  • Aceptar.

En el menú del “Editor de preparación de datos” se marca la opción “Campo de creación de dimensión”.

A continuación, en el menú del “Editor de preparación de datos” hacemos click en la opción “Propiedades de campo”.

En la ventana que se abre seleccionamos “Propiedades de creación de dimensión”; hay que ir columna por columna del fichero de texto definiendo sus características:

  • Aquellas columnas que no vayamos a utilizar para la construcción de la dimensión seleccionamos: “Omitir campo durante la creación de dimensión”.
  • Aquellas columnas que sí vayamos a utilizar las vamos asignando a la dimensión que vamos a cargar y definiendo su tipo. Por ejemplo:
    • Principal
    • Secundario
    • Alias
    • Propiedad

A continuación “Aceptar”.

Finalmente en el menú del “Editor de preparación de datos” hacemos click en “Validar”, y por último “Guardar”.

Ya estaría esta regla de carga preparada para la construcción de la dimensión. A continuación vamos a definir esta misma regla para que también sirva para la carga de datos.

2.- Crear regla de carga para la carga de datos

En el menú del “Editor de preparación de datos” seleccionamos “Configuración de carga de datos”, donde se nos ofrecen diferentes opciones:

Por ejemplo:

  • ”Sobrescribir valores existentes”.
  • “Agregar a valores existentes”.
  • “Restar de valores existentes”.

En el menú superior del “Editor de preparación de datos” seleccionamos “Campos de carga de datos”.

A continuación en ese menú superior seleccionamos “Propiedades de campo” y en el desplegable seleccionamos “Propiedades de carga de datos”.

A continuación hay que ir columna por columna asignándolas a las dimensiones correspondientes.

  • Aquellas columnas que no vayamos a utilizar para la carga de datos seleccionamos: “Omitir campo durante la carga de datos”.

Una vez asignadas todas las columnas a las dimensiones correspondientes, en el menú superior del “Editor de preparación de datos” hacemos click en “Validar” y guardamos.

  • Ya tenemos el “Archivo de reglas” preparado para la subida de datos.

3.- Subida de datos

Si queremos utilizar esta regla para subir / modificar una dimensión:

  • Botón derecho sobre la base y en el desplegable seleccionamos “Cargar datos”.
  • En la ventana que se abre hacemos click en “Modo” y en el desplegable seleccionamos “Sólo creación”.

Si queremos utilizar esta regla para cargar datos:

  • Botón derecho sobre la base y en el desplegable seleccionamos “Cargar datos”.
  • En la ventana que se abre hacemos click en “Modo” y en el desplegable seleccionamos “Sólo carga”.

También podemos utilizar la regla para que simultáneamente construya dimensión y cargue datos:

  • Botón derecho sobre la base y en el desplegable seleccionamos “Cargar datos”.
  • En la ventana que se abre hacemos click en “Modo” y en el desplegable seleccionamos “Ambos”.