Repositorios MMS

Objetos principales

MMS dispone de un conjunto de objetos que denominamos principales y que se caracterizan por su independencia, pudiéndose almacenar para su posterior uso.

Los objetos principales de MMS son:

• @DataSet: el conjuto de datos o dataset.
• @Model: el modelo.
• @Estimation: la estimación.
• @Forecast: la previsión.
• @Combination: la combinación de variables aleatorias.
• @Fit: el ajuste o resolución de la combinación.

Para almacenar un objeto principal basta con usar su método "Store":

Real @ObjectMain::Store(<filename>);

Este método guarda el objeto con la caché de datos y resultados que esté en uso. Si deseamos guardar el objeto sin datos utilizaremos "Store_Light". Si deseamos, sin embargo, forzar el almacenamiento de los datos usaremos "Store_Heavy".

Conexiones

MMS dispone de repositorios para el almacenamiento localizado de los objetos. Existen dos tipos de repositorios: los repositorios en carpeta (@RepositoryFolder) y los repositorios en base de datos (@RepositoryDatabase).

Para facilitar el acceso a los repositorios MMS se necesita definir (y posteriormente abrir) una conexión al repositorio.

La lista de conexiones se mantiene de una sesión TOL a otra.

La conexión no es otra cosa que un conjunto de información que nos ayuda a localizar un repositorio.

La conexión

Una conexión viene dada por el siguiente conjunto de datos o atributos:

• Text name: El nombre único utilizado para identificar tanto a la conexión como al repositorio al que apunta
• Text type: El tipo del repositorio al que hace referencia la coneción que puede ser "folder" o el nombre de un sistema de gestión de base de datos (DBMS) como "MySQL".
• Text source: La ruta de acceso al repositorio. Para los respositorios en carpete es la ruta del directorio. Para los repositorios en base de datos es la siguiente expresión: "odbc:schema:user:password".
• Text description: La descripción de la conexión o del repositorio con el que conecta.

La conexión por defecto

MMS crea un repositorio local por defecto. Los datos de su conexión (que también se encuentra definida por defecto) son:

Text name = "Default";
Text type = "folder";
Text source = "C:/Users/<user>/AppData/Roaming/tol/MMS/Repositories/Default";
Text description = "Repositorio local por defecto";

Lista de conexiones definidas

Para obtener la lista de conexiones definidas en MMS úsese:

Set MMS::Container::GetConnections(?);

Lista de conexiones disponibles (aún sin abrir)

Para la lista de conexiónes disponibles, es decir que aún están sin abrir, úsese:

Set MMS::Container::GetConnections_Avalaible(?);

Definir una conexión

Para definir una conexión úsese:

Real MMS::Container::DefineConnection(<name>, <type>, <source>, <description>);

Eliminar una conexión

Para eliminar una conexión existente úsese:

Real MMS::Container::RemoveConnection(name);

Repositorios

Los repositorios están representados en MMS por instancias de la clase: MMS::@Repository. El objeto repositorio una vez creado (abierta la conexión) ofrece entre sus métodos mecanismos para el acceso a los objetos principales que contiene y el guardado de nuevos objetos.

Abrir un repositorio Para crear un objeto repositorio (abrirlo o abrir su conexión) se pueden utilizar alguno de estos dos métodos:

Real MMS::Container::OpenConnection(name);
Real MMS::Container::OpenRepository(connectionName);

No ha de confundirse la apertura de la conexión de un repositorio (crear el objeto @Repository) con la creación del repositorio en sí misma.

Obtener un repositorio

Para obtener un repositorio abierto utilícese:

Real index = MMS::Container::FindRepository(connectionName);

para la obtención del índice de un repositorio en el contendor de repositorios abiertos, o

MMS::@Repository rep = MMS::Container::GetRepository(connectionName|index);

para la obtención del objeto repositorio.

Cerrar un repositorio Para cerrar un repositorio o cerrar una conexión (destruir el objeto @Repository) utilícese:

Real MMS::Container::CloseRepository(connectionName|index);

Creación de nuevos repositorios

No hay que confundir la creación de un repositorio (creación de la estructura en archivos o base de datos) con la apertura de una conexión o repositorio (creación del objeto @Repository).

A continuación indicamos cómo crear un repositorio nuevo:

Crear un nuevo repositorio en carpeta

Para crear un nuevo repositorio en carpeta sólo nececsitamos indicar la ruta de un directorio dónde colocar el repositorio.

MMS::@Repository miRepositorio = MMS::@RepositoryFolder::Create([[
  Text _.path = "<ruta_de_carpeta>"
]]);

Para utilizar este repositorio es conveniente definir su conexión:

Real MMS::Container::DefineConnection(<name>, "folder", <ruta_de_carpeta>, <description>);

Eliminar un repositorio en carpeta

Para destruir un repositorio creado (ojo, que no es reversible) hay que utilizar: (aún no operativo)

MMS::@Repository miRepositorio = MMS::@RepositoryFolder::Create([[
  Text _.path = "<ruta_de_carpeta>"
]]);

Uso de los repositorios