Page Comparison

{scrollbar}
----

{anchor:pc}

h1. Diccionario de conceptos


h2. Conceptos básicos

Para comprender cabalmente los procesos de desarrollo en Ideasoft O3 Planner descritos, es necesario tener presentes algunas definiciones
{tip}
* Ideasoft O3 Browser
* Ideasoft O3 Budgeting: es cualquier *solución concreta* de presupuestación (Estado de Resultados proyectado, Balance proyectado, Flujo de Caja proyectado, presupuesto de un departamento, etc.) edificada sobre la teconología Ideasoft O3 Planner.
* Ideasoft O3 Planner: es la *plataforma tecnológica de simulación* provista por Ideasoft. La misma tecnología puede ser utilizada para planificar la producción y para estimar la demanda.
{tip}

h2. Conceptos de simulación

Otros conceptos relevantes, referidos a simulación, se pueden encontrar en el diccionario que se proporciona a continuación:
{info:title=Ayuda para el uso del diccionario}
|| Orden temático || Orden alfabético ||
|  1) [O3SOL:Vista inicial de la aplicación web|#vi]\\
   2) [O3SOL:Componentes |#componente]\\
   3) [O3SOL:Estado de cálculo y estado de cierre de un componente|#ec]\\
   4) [O3SOL:Data Mart (Cubo de análisis de O3)|#cubo]\\
   5) [O3SOL:Modelo de Simulación|#ms]\\
   6) [O3SOL:Escenarios|#escenario]\\
   7) [O3SOL:Estado de cálculo y estado de aprobación de un escenario|#ee]\\
   8) [O3SOL:Fuentes de Datos|#fd]\\
   9) [O3SOL:Grupos de Datos|#grupo]\\
   10) [O3SOL:Versiones|#version]\\
   11) [O3SOL:Estado de cierre de una versión|#cversion]\\
   12) [O3SOL:Fórmulas de Cálculo|#formula]\\
   13) [O3SOL:Parámetros|#parametro]\\
   14) [O3SOL:Alcance|#alcance] | [O3SOL:Alcance|#alcance]\\
 [O3SOL:Componentes |#componente]\\
 [O3SOL:Data Mart (Cubo de análisis de O3)|#cubo]\\
 [O3SOL:Escenarios|#escenario]\\
 [O3SOL:Estado de cálculo y estado de aprobación de un escenario|#ee]\\
 [O3SOL:Estado de cálculo y estado de cierre de un componente|#ec]\\
 [O3SOL:Estado de cierre de una versión|#cversion]\\
 [O3SOL:Fórmulas de Cálculo|#formula]\\
 [O3SOL:Fuentes de Datos|#fd]\\
 [O3SOL:Grupos de Datos|#grupo]\\
 [O3SOL:Modelo de Simulación|#ms]\\
 [O3SOL:Parámetros|#parametro]\\
 [O3SOL:Versiones|#version]\\
 [O3SOL:Vista inicial de la aplicación web|#vi] |
Al final de cada punto se presentan las opciones de *SUBIR* (conduce al inicio de esta página) y *VOLVER AL ÍNDICE* (conduce a la página inicial, en la que se encuentra el índice global).
{info}
\\

h2. {anchor:vi} 1) Vista inicial de la aplicación web

Para trabajar con la aplicación web, el procedimiento es el siguiente:

Que la aplicación sea web implica que está instalada en un único servidor y se accede a ella a través de un navegador web. Para su acceso es necesario contar con acceso a una red.
# *Ingresar a O3 Portal mediante un navegador web (por ejemplo, Internet Explorer o Mozilla).*
## Abrir el navegador web
## Ingresar la URL _http://<nombre máquina>:<puerto>/o3portal_, siendo _<nombre máquina>:<puerto>_ el nombre de la máquina y número de puerto donde se encuentra el servidor O3 (consulte al administrador de sistemas).
## Seleccionar el idioma en el que desee trabajar eligiendo una de las opciones presentadas en la última línea.
## Ingresar usuario y contraseña (consulte al administrador de sistemas).
## Presionar *Enviar*. Si el usuario y contraseña son válidos, el resultado es la lista de objetos de análisis y simuladores disponibles para dicho usuario, agrupados por secciones tales como "Cubos y Vistas", "Dashboards", "Scorecards" y "Simuladores".
# *Puesta en funcionamiento de la aplicación web de un simulador*.
## Ir a la sección *Simuladores*.
## Presionar sobre el nombre de la simulación. El resultado de esta acción es la puesta en funcionamiento de la aplicación web correspondiente.

h2. {anchor:componente} 2) Componentes

La simulación se estructura en componentes
Dichos componentes se nutren unos de otros a través de las dependencias.
En Zona de menú >> dependencias se puede observar un mapa de dependencia como el que se muestra en la siguiente figura.

!mapa_dependencias.jpg|align=center,width=32,height=32!\\
\\

Este es un ejemplo de un mapa de dependencias desarrollado para un modelo específico
Cada uno de los nodos de este mapa representa un componente, mientras que las flechas indican la toma de información. Por ejemplo, el componente Indicadores toma para sus proyecciones los resultados de los dos componentes de Estado de Resultados.

Un componente es la unidad básica de un modelo de simulación.
Consiste de:
(1) los elementos a simular
(2) el tiempo de la simulación
(3) las variables de simulación
# Los _elementos a simular_ son caracterizados mediante _atributos_ que son usados para la definición de las [O3SOL:fórmulas de simulación|#formula] de las variables de interés.

Asimismo, una vez calculada la simulación, los atributos estarán presentes para permitir la revisión y análisis del resultado de la simulación. Puede verse en un gráfico, calcularse el crecimiento estimado mes a mes, disgregarse por alguna dimensión, etc.
El simulador extraerá de las [O3SOL:fuentes de datos|#fd] los elementos a simular para realizar los cálculos.
# El _tiempo de la simulación_ corresponde al período en que se simulan las variables. Es necesario conocer el momento de comienzo y fin de la simulación, y la escala que se manejará (por mes, por año, por semana)

# Las _variables de simulación_ representan las medidas simuladas a partir de [O3SOL:fórmulas|#formula] o expresiones de cálculo. Son valores que interesa medir o dan contexto a la simulación.

[O3SOL:*SUBIR*|#pc]
[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]

h2. {anchor:ec} 3) Estado de cálculo y estado de cierre de un componente.

En el contexto de un escenario, un componente tiene asignado en todo momento un estado de cálculo y un estado de cierre.
Considerando el aspecto de cálculo, los estados posibles son: _Calculado_, _No calculado_ y _Necesita recálculo_. El estado inicial es _No calculado_.
* Un componente en estado _Calculado_ se simboliza con el ícono y representa que el último cálculo, de él y de todos sus componentes descendientes, fue exitoso.
* Un componente en estado _No calculado_ se simboliza con el ícono y representa que o bien el último cálculo, de él y/o de sus componentes descendientes, fue fallido o bien que él nunca fue calculado.
* Un componente en estado \_Necesita recálculo _ representa que algún dato que toma el escenario cambió o que algún componente del cual depende fue recalculado. En este caso la cruz que indica la necesidad de recálculo es de color negro.

Los íconos de calculado, no calculado y necesita recálculo, se pueden apreciar en el menú, junto con la lista de componentes, o en la propia descripción del componente.

Considerando el aspecto de cierre, los estados posibles son: _Abierto_ y _Cerrado_. El estado inicial es _Abierto_.
* Un componente _Abierto_ significa que el componente se encuentra disponible para ser modificado por los usuarios que posean los permisos de hacerlo (En este caso aparecerá con alguno de los íconos de estado de cálculo: calculado, no calculado, necesita recálculo).
* Un componente _Cerrado_ significa que el componente no puede ser modificado. Los componentes de los cuales él depende también se encuentran en estado _Cerrado_ y [O3SOL:las versiones de los grupos|#grupo] de las cuales él depende también se encuentran en estado _Cerrado_. El componente tiene deshabilitada su acción de calcular.
Si el componente está cerrado y un usuario desea modificarlo debe primero volverlo a abrir, lo cual podrá hacer si cuenta con los permisos.

Para cerrar un componente es necesario primero calcularlo, o sea que no es posible cerrar un componente no calculado.
El ícono que representa que el componente está cerrado es un candado.

[O3SOL:*SUBIR*|#pc]
[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]

h2. {anchor:cubo} 4) Data Mart

Un componente calculado tiene asociado _un data mart_ conteniendo el resultado de la simulación.
Dimensiones: fecha, escenario y una dimensión por cada atributo de los elementos que se simularon.
Medidas = variables del componente
Este data mart puede ser manipulado desde un navegador (Internet Explorer, Mozilla Firefox) por lo que se puede trabajar conectándose desde cualquier ubicación.

[O3SOL:*SUBIR*|#pc]
[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]

h2. {anchor:ms} 5) Modelo de Simulación

Un *modelo de simulación* está definido por un conjunto de componentes, con dependencias de cálculo de unos a otros.

[O3SOL:*SUBIR*|#pc]
[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]

h2. {anchor:escenario} 6) Escenario

El presupuesto dará distintos resultados según los datos de entrada que tome.
Cada combinación de datos de entrada distinta dará lugar a un escenario distinto del estado de resultados.
En otras palabras, un escenario es un posible estado de resultados futuro.
El usuario puede definir tantos escenarios como desee, la estructura del modelo (fórmulas, parámetros, variables, dependencias) será siempre la misma, mientras que los datos de entrada y los resultados irán variando para cada escenario.

En esta imágen se pueden apreciar dos escenarios, ambos respetan la misma estructura, pero difieren al menos en una versión de sus datos, por lo que sus salidas serán distintas.

Un escenario refiere a la ejecución de una simulación, una vez definidos todos los otros componentes podemos decir que se ha definido un escenario de simulación, si alteramos alguna de sus hipótesis, estamos generando otro escenario.
Los escenarios son usados para anticiparse al futuro respondiendo preguntas como: ¿Que pasará con mis resultados si el precio por minuto saliente a fijo sube en agosto un ...%? ¿Cómo cambiarán los ingresos y egresos si se incorpora el servicio de terminales aseguradas?, etc.
En resumen, permite obtener conclusiones a preguntas del tipo What If...?
Permite también plantearse distintos escenarios, oficial, optimista, pesimista, etc.
\\
\\

[O3SOL:*SUBIR*|#pc]
[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]

h2. {anchor:ee} 7) Estado de cálculo y estado de aprobación de un escenario

Un escenario tiene asignado en todo momento un estado de cálculo y un estado de aprobación.
Estados de aprobación: _Borrador_, _Tentativo_, _Aprobado_ y _Archivado_. El estado inicial es _Borrador_.
* Un escenario en estado _Borrador_ representa que la simulación está en elaboración. Tiene habilitadas todas las acciones de acuerdo al rol del usuario ingresado.
* Un escenario en estado _Tentativo_ representa que su simulación está pronta pero requiere de una aprobación oficial por el encargado final de ello. Tiene Deshabilitada toda acción de calcular.
* Un escenario en estado _Aprobado_ representa que la simulación está aprobada oficialmente. Un escenario aprobado tiene todos los componentes cerrados así como las versiones de los grupos del escenario. A su vez tiene deshabilitada toda acción de calcular así como la acción de abrir cualquier componente.
* Un escenario en estado _Archivado_ se trata de un escenario que no tiene relevancia actual. Tiene deshabilitada toda acción de calcular y no se ve en el combo de escenarios en el menú.

Cuando el escenario se encuentra en estado borrador o tentativo, sus componentes pueden estar calculados o no.
Para aprobar el escenario es necesario que todos sus componentes estén calculados. Al aprobarlo se podrán ver candados en todos sus componentes y en todas las versiones de datos que éste toma.

[O3SOL:*SUBIR*|#pc]
[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]

h2. {anchor:fd} 8) Fuente de datos

Una _fuente de datos puede ser no versionada o versionada_.

Por su parte, una fuente de datos versionada permite que los datos que contiene pueden agruparse en distintas versiones. Un ejemplo de fuente de datos versionada puede ser el IPC. Las fuentes de datos versionadas pueden ser agrupadas en los llamados *grupos*. Este concepto permite controlar el nivel de complejidad que puede producirse al trabajar con: (1) una gran cantidad de fuentes de datos versionables y (2) una gran cantidad de escenarios para realizar simulaciones. Ver *[O3SOL:*Grupo*|#grupo]* y *[O3SOL:*Escenario*|#escenario]*.

[O3SOL:*SUBIR*|#pc]
[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]

h2. {anchor:grupo} 9) Grupos de Datos

*¿Cómo se conforma un escenario?*
Cada escenario utiliza todas las tablas de datos. Lo que puede variar es la información contenida en las mismas.
Para facilitar el manejo de las hipótesis se introduce el concepto de *grupos de datos*: engloban conjuntos de tablas que evolucionan de manera interrelacionada.
En lugar de versionar las tablas cada una por separado, se versiona el grupo. Es decir, el escenario X se compone de la versión a para el grupo 1 (en lugar de indicar que el escenario X se compone de la versión i para la tabla x, de la versión j para la tabla y, etc.)
Un escenario define _las versiones de los datos fuentes de una simulación_. Las versiones de los datos de una simulación están definidas por la versión de cada uno de los grupos usados por los componentes del simulador.
Un grupo es un conjunto de fuentes de datos versionables. La *versión de un grupo* es un número y un nombre. Un grupo puede tener definido varias versiones. Eligiendo las versiones de los grupos se conforman distintos escenarios.
\\
\\

[O3SOL:*SUBIR*|#pc]
[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]

h2. {anchor:version} 10) Versión

_El concepto de versión es definido a nivel de un grupo_. La versión de un grupo tiene un impacto hacia todas las fuentes de datos del grupo. Por un lado, los datos de esas fuentes de datos deben asociarse necesariamente a alguna de las versiones definidas para el grupo al cual la fuente pertenece. Por otro lado, al definir un escenario se indica solamente la versión del grupo. Esto significa que el cálculo de la simulación para ese escenario se hará tomando como datos aquellos de dicha versión.

h2. {anchor:cversion} 11) Estado de cierre de una versión

Una _versión de un grupo_ tiene asignado en todo momento un estado de cierre siendo los estados posibles: _Abierto_ y _Cerrado_. El estado inicial es _Abierto_.
* Una versión de un grupo en estado _Abierto_ significa que los datos de las fuentes de datos del grupo correspondientes a dicha versión pueden ser eliminados, agregados y/o modificados.
* Una versión de un grupo en estado _Cerrado_ significa que los datos de las fuentes de datos del grupo correspondientes a dicha versión NO pueden ser eliminados y/o modificados. Nuevos datos para esa versión NO pueden ser agregados.

Las fuentes versionables se encuentran en los grupos de datos, puesto que lo que se versiona son los propios grupos. Las fuentes no versionables, por definición, no están asociados a ningun grupo.

[O3SOL:*SUBIR*|#pc]
[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]

h2. {anchor:formula} 12) Fórmula de cálculo

(También llamada _Fórmula de simulación_, _Expresión de cálculo_, _Expresión de simulación_)
* *Fórmulas*: Expresiones con las que se modela la realidad y cómo ésta se desarrolla. Expresión aritmética utilizada para definir la simulación.

Las fórmulas:

\* se pueden ubicar en el modelo (no versionables, no pueden ser editadas por el usuario)

\* se pueden ubicar en formularios de datos (versionables, sí editables por los usuarios que dispongan de los permisos)

h4. Fórmulas versionables (en datos)

Ejemplos de fórmulas versionables, son las que se ingresan para el cálculo de los indicadores de gestión, tanto proyectados como reales.

En el menú >> Catálogos y Fuentes de Datos >> Indicadores >> Fórmulas Indicadores Proyectados se accede a la tabla donde se cargan las fórmulas de los indicadores proyectados.
\\
\\

h4. Fórmulas en el modelo

Ejemplo de fórmula que se ubica en el modelo, es la fórmula de ingresos P*Q.

La notación es la misma si se encuentra en el modelo o si está definida en datos.
Algunas de las expresiones de cálculo que se pueden observar son:
** _Ingreso = Precio * Cantidad_
** _Indemnización por rescisión = valor inicial(MES) * factor de variación IPC_
\\

h4. Fórmula Inicial y Fórmula de Paso

La _simulación en el tiempo de una variable está definida por dos fórmulas_: la fórmula inicial y la fórmula de paso.
Por ejemplo, considerando la variable "ingreso" del componente Otros Ingresos, para el concepto Multas, Recargos e Intereses:
* en enero, se toma el dato inicial y se lo multiplica por el factor de variación IPC enero (dado que la proyección comienza en enero, es necesario ingresar un dato inicial "como si fuera" el valor a diciembre del año anterior)
* para los siguientes meses, se toma el dato del mes anterior y se lo multiplica también por el factor de variación IPC.

En este ejemplo la fórmula inicial es:
Parameter("ResultadoInicial", "year", AnioBase)*IPC

Va a buscar el dato de resultado inicial del rubro, ingresado como *dato* para el año base y lo multiplica por "IPC" que es el factor de crecimiento del IPC.

y la fórmula de paso:
Ingreso * IPC
Busca el resultado de la *variable* ingreso para el mes anterior (si no se indica período toma el cálculo de 1 mes hacia atrás)

En otros casos, los cálculos de un mes no dependen de los resultados del mes anterior, como es el caso de P*Q, por lo tanto, la fórmula de inicialización y la de paso será la misma (tanto la fórmula inicial como la de paso puede ser definida por "cantidad * precio", donde "cantidad" y "precio" son parámetros que, dados el producto y una fecha, devuelven la cantidad y precio, respectivamente)
\\

h4. Funciones

Una fórmula usada en un [#componente]&nbsp;puede contener
* constantes
* variables de simulación del componente
* atributos de los elementos del componente
* atributos de la dimensión tiempo
* funciones (e.g. matemáticas y manejo de fechas)
* funciones específicas (_Parameter_ y _Variable_)
\\

h5. Funciones _Parameter_ y _Variable_

*Función parameter*: se busca el valor de un parámetro únicamente para un concepto, rubro, elemento, ... determinado.
El parámetro refiere a datos ingresados en el modelo o a resultados de otros componentes&nbsp;
* Ejemplo: Parameter("IngresosMensuales", "Concepto Ingreso", 181)
Devuelve el valor del parámetro IngresosMensuales, para el concepto ingreso código 181.
Es decir, que se puede hacer referencia explícita a otros valores que no sean los asociados con el elemento y momento corriente de acuerdo al paso de la simulación.

*Referencias directas a parámetros*: En algunos casos se escribe directamente el nombre del parámetro. Por ejemplo, en el porcentaje de cargas sociales: se carga el dato en un campo para todo el año a simular, por lo que basta con escribir el nombre del parámetro - CargasSociales\-

*Función Variable*: se busca el valor de una variable únicamente para un concepto, rubro, elemento, ... determinado.
La variable es el resultado de otro cálculo anterir del mismo componente.
* Variable("Gasto", "Rubro", "70")
Devuelve el valor de la variable Gasto para el rubro 70.
Uno de los filtros utilizado en la función variable puede ser el tiempo, en meses, pudiendo ir a buscar valores proyectados de la misma variable o de otras variables en períodos anteriores.

Como se puede apreciar en la definición de las funciones, la diferencia entre la función _parameter_ y la función _variable_ es la ubicación del dato que se busca.
Parameter: Fuentes de datos, variables de otros componentes
Variable: variables del mismo componente

La notación básica de las funciones parameter y variable&nbsp;se ilustra en la siguiente&nbsp;imágen.
\\

En la descripción de cada componente se puede apreciar
* La lista de parámetros y la lista de resultados de otros componentes usados como parámetros (los cuales se referencian con la función parameter)
* La lista de variables o cálculos de la simulación (los cuales se referencian con la función variable)

h3. Requisitos necesarios para incluir un&nbsp;dato de una fuente en los cálculos de un componente

\# Crear la Fuente de datos (tabla con sus campos) y en caso necesario catálogo correspondiente

ejemplo:

Catálogo: código, concepto

Fuente de datos: año, mes, código, monto

\# Crear el parámetro que hace referencia al campo deseado de ese formulario, dándole el/los alcances (filtros)&nbsp;que corresponda/n

En el ejemplo anterior:

Parámetro: monto

Nombre del filtro: concepto

\# En el componente, agregar el nombre del parámetro en la lista de componentes creados
\\

h3. [O3SOL:*SUBIR*|#pc]

[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]

h2. {anchor:parametro} 13) *Parámetro*

Los parámetros intervienen en la definición de las [O3SOL:fórmulas|#formula].

Un parámetro se utiliza para representar y referenciar dentro del modelo de simulación las 2 situaciones siguientes:
# datos que son externos al modelo de simulación en cuestión, es decir que si ingresan como hipótesis en el modelo.
# datos que son externos al componente en donde se utiliza, es decir que son resultados de cálculos de otros componentes, y para este componente se utilizan como dato.

En el primer caso se habla simplemente de _parámetro_ mientras que en el segundo caso se habla de _parámetro de componente_.

Un *ejemplo* de la primera situación son los parámetros que representan índices económicos tales como el IPC (índice de precios al consumo) y el IMS (índice medio de salarios) Un *ejemplo* de la segunda situación es un parámetro "CantidadVenta" que ofrece a un componente "Ingresos P*Q" la cantidad estimada de los productos calculada en otro componente.

Los parámetros se hacen corresponder con las [O3SOL:fuentes de datos|#fd] o componentes de donde el simulador extraerá valores para realizar los cálculos. En esta correspondencia se indican los argumentos y el atributo de retorno. Para ello se usa el concepto de alcance.

Todo lo antedicho se puede apreciar en la descrición para cada componente:
\\
\\

[O3SOL:*SUBIR*|#pc]
[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]

h2. {anchor:alcance} 14) *Alcance y evaluación de un parámetro*

* *Alcance de los Parámetros*: Para permitir que un mismo parámetro tenga distintos valores según por ejemplo si se está preguntando para un rubro o para todos los rubros es necesario introducir la idea de alcance.
Con esta noción podemos justamente manejar que en el ejemplo anterior hay dos alcances: global o por rubro y consultar luego el valor del parámetro en cualquiera de ellos.
Un *{_}alcance de un parámetro{_}* se hace corresponder con una fuente de datos y en él se definen los nombres de los argumentos y del atributo de retorno así como la correspondencia con los atributos de la fuente asociada. Un parámetro puede tener definido uno o más alcances. En el caso de un parámetro con varios alcances es importante el orden de los mismos.
{tip:title=Notas}
* Diferentes parámetros pueden ser definidos sobre una misma fuente de datos o componente.
* Los parámetros pueden devolver como resultado [O3SOL:fórmulas|#formula].
* Los parámetros (sus alcances) definidos sobre datos versionables tienen a la versión como argumento implícito.
* En el caso de parámetros de componentes existe un sólo alcance.
{tip}
[O3SOL:*SUBIR*|#pc]
[*VOLVER AL ÍNDICE*|Guia de desarrollo 2008]]

----
{children}

{scrollbar}