Introducción

El presente documento tiene por objetivo guiar al usuario en el mantenimiento, soporte e implementación en la plataforma Calipso ERP. A lo largo del mismo, se responderán conceptos fundamentales acerca de la aplicación de herramientas nativas de modelización, que ayudarán a utilizarlas de manera efectiva. 

Se recomienda la lectura previa del Manual de Fundamentos Técnicos.

Contenido 

• Introducción
• Herramientas de Modelización
  • Tipos de herramientas 
• Herramientas de accesibilidad
• Herramientas que modelizan Objetos
  • Objetos de Usuario
  • Métodos adicionales de Objetos
  • Linkeo de Objetos
  • Definición de Flags de Objetos
• Herramientas que modelizan Flujos y Transacciones
• Herramientas que modelizan salida de información
• Herramientas genéricas
  • System Manager
  • Reglas de Negocio
  • Procedimientos Públicos

Herramientas de Modelización

Tipos de herramientas 

Las herramientas de modelización se pueden dividir en diferentes grupos, según la característica a modelizar, así como ordenarlas por su grado de importancia para la organización:

• Herramientas de accesibilidad:

• Carpetas de usuario (copiar/pegar accesos)

• Filtros

• Flags 

• Análisis de información

• Seguridad

• Herramientas que modelizan Objetos: 

• Objeto de usuario

• Métodos adicionales

• Linkeo de Objetos

• Flags de Objetos

• Herramientas que modelizan flujos y transacciones:

• Workflow

  • Documentos

  • Relaciones

•  Básico

• Avanzado >>> Mapeo

• Punteros

• Esquemas (Subempresas, sucursales, etc)

  • Definición

  • Relaciones

  • Perfiles (comportamiento)

  • Seguridad

• Parámetros

  • Punteros >>> Factura electrónica

  • Salidas impresas (DAF2)

• Herramientas que modelizan salida de información (DAF1):

• Vistas de browse

• Esquemas básicos

• Definición de esquemas

• Layouts

  • Impresiones (DAF2)

• Herramientas genéricas:

• System-manager

• Reglas de negocios

• Procedimientos públicos

________________________________________________________________________________________________________

Herramientas de accesibilidad

(en desarrollo)

________________________________________________________________________________________________________

Herramientas que modelizan Objetos

Objetos de Usuario

Ubicación:  Administración del Sistema > Herramientas > Objetos > Objetos de Usuario.    

Función: Permite la creación, mantenimiento y administración de objetos nuevos -en la capa de Modelo Vertical- para atender a requerimientos específicos que no han podido ser cubiertos por las entidades nativas de la implementación original  

Propiedades: para ser creado, un objeto de usuario debe cumplir con dos condiciones mínimas:

• Uno o más campos ID.

• Uno o más campos que identifiquen el Detalle del Objeto.

Creación de entidades: esta herramienta permite crear entidades (objetos) a partir de:

• Tablas del Sistema: basadas en la definición del objeto.

• Querys de usuario: estas pueden ser existentes o de usuario. En ambos casos se requiere contar con el campo “dbschemaid” para indicar que el dato pertenece a un esquema.

• Instancias de objetos ya existentes: cuando el objeto que se está creando, se basa en otro objeto existente, es posible aprovechar la estructura del mismo. Para ello, tener en cuenta:

• El objeto instanciado tiene que disponer de una propiedad que filtra, la cual -a su vez- tiene que tener un valor (Ejemplo Tipo=A). Esto es fundamental para poder indicar -en la tabla general o tabla padre- que el objeto creado (objeto instancia), se filtre a través de esta propiedad. 

• En el objeto instancia -objeto creado- no es necesario declarar las propiedades, ya que su creación se basa en un objeto ya instanciado.

Métodos adicionales de Objetos

Ubicación: Administración del Sistema > Herramientas > Objetos > Métodos adicionales de Objetos 

Función: permite crear métodos lanzados desde el propio objeto y apuntarlos a un flujo (workflow). Es decir, crear un método adicional es crear un “lanzador” a otra acción, por lo que es una herramienta y no la solución en sí.

Tener en cuenta que, de acuerdo al tipo de interfaz visual, las acciones se pueden agrupar por tipo de ícono.

Tipo de Funcionamiento: 

• Genérico:

• Cuando se aplica a todo el objeto. Ejemplo: el método genérico más común es Agregar, por lo cual la acción se mostrará en la barra superior.

• En este caso, se definen sólo el flujo que abrirá y las propiedades de conexión que se requieran como anexo. El lanzador lo indica de forma automática, sin necesidad de agregar la ID de ningún elemento, a través de la invocación: workflow?mod=(flujo)&(propiedades)&_fromobj=(lanzador). La acción se mostrará en la barra de herramientas superior y general.

• Particular:

• Cuando la acción alcanza sólo al elemento seleccionado. Ejemplo: Editar o Eliminar, son métodos particulares a los que se podrá acceder a través de las acciones disponibles en el elemento en particular.

• Además del flujo y las propiedades, es necesario indicar la variable dato con la ID del elemento que se está editando. De esta manera, la invocación será: workflow?mod=(flujo)&dato=(elemento_ID)&(propiedades)&_fromobj=(lanzador). La acción se mostrará como un ícono, dentro de las acciones disponibles del elemento seleccionado.

Linkeo de Objetos

Ubicación: Administración del Sistema > Herramientas > Objetos > Linkeo de Objetos

Función: permite ordenar y definir la jerarquía de los objetos del sistema, a partir de la relación establecida en la estructura o árbol entre objetos “Padres” y objetos “Hijos”. 

De esta manera, es posible:

• Establecer una relación objeto Padre con un objeto Hijo.

• Relacionar un objeto Padre con muchos objetos Hijos (Relación de 1 a N).

• Indicar si se elimina en cascada (Si elimino el Padre, elimino los Objetos Hijos).

• Las relaciones establecidas se visualizan en árboles, formularios y DAF.

Definición de Flags de Objetos

Ubicación: Administración del Sistema > Herramientas > Objetos > Definición de Flags de Objetos

Función:

1. Es una herramienta de terminación, ya que se aplica después de la modelización de un Objeto particular, permitiendo configurar su comportamiento final a través de una lista de estados disponibles, así como la relación y transición entre cada uno.

2. Utilizando condiciones de visualización se pueden crear distintas vistas de acuerdo al perfil de usuario y su grupo.

3. De la misma manera se pueden condicionar acciones.

Elementos principales:

• Estados: los flags permiten anexar una lista de estados definibles para un Objeto particular, pudiendo especificar:

• un Estado inicial (o por default) para los elementos del objeto;

• un Estado para cada elemento de dicho objeto;

• la posibilidad de establecer cambios de Estados, así como definir cómo estos alterarán el valor de una propiedad del objeto.

• una lista de permisos de visualización, que habilite el acceso a un grupo de usuarios, para que puedan ver gráficamente los elementos que se encuentran en un determinado Estado (a través de la herramienta “Visualiza Workflow”).

• Acciones: estos elementos establecen la relación entre los Estados definidos para un Flag, de manera que al ser ejecutadas, permitan la transición de uno a otro, generando un circuito de estadíos para ese Flag en particular.

De esta manera, las Acciones relacionadas, marcan:

• la posibilidad que tiene un usuario de cambiar de un Estado a otro cuando se ejecuta una determinada Acción; 

• las combinaciones posibles entre los distintos Estados y las acciones a ejecutar, generando un circuito o workfkow de Flags que grafique la relación entre estadíos del Flag de un objeto en particular;

• al ejecutar una acción, se dispara un evento programado;

• una lista de permisos para habilitar el acceso a quien ejecuta una acción. 

• Ejemplo: 

________________________________________________________________________________________________________

Herramientas que modelizan Flujos y Transacciones

(tema en desarrollo)

________________________________________________________________________________________________________

Herramientas que modelizan salida de información

(tema en desarrollo)

________________________________________________________________________________________________________

Herramientas genéricas

Se trata de herramientas generales que están implícitas en el sistema -ligadas al Objeto- y que se “disparan” a través del mismo, permitiendo personalizar y ajustar el comportamiento y la apariencia del objeto de usuario, según las necesidades específicas de la organización. 

Se recomienda complementar este tema con la lectura de Scripting - FAQs

System Manager

Ubicación: se puede acceder a esta herramienta desde cualquier objeto o documento, a través del ícono correspondiente; o, seguir la ruta Administración del Sistema > Herramientas > System Manager, y luego seleccionar el objeto a modelizar.

Función: el System Manager es la herramienta que altera el funcionamiento del objeto, tanto de representación gráfica como de proceso. 

Características:

• No tiene una ubicación específica, sino que se trata básicamente de scripts que se ejecutan ante un evento, pudiendo aplicarse a formularios, objetos y transacciones (documentos). La edición debe realizarse antes de que estos sean renderizados, dibujados o procesados, respectivamente.

• Permite “pararse” en cualquier entidad y editar la metadata, cambiar el caption, etc.

• Puede configurarse para que los ajustes sean vistos por el grupo de usuarios; es decir, se puede hacer visible para el groupID.

Reglas de Negocio

Ubicación:

Función: las Reglas de negocios establecen validaciones (script) para lo que puede o no hacer un objeto de acuerdo a la acción particular del mismo. 

Estas acciones son: 

• (A) Alta (o creación), 

• (M) Modificación (o actualización), 

• (B) Baja (o eliminación).  

Procedimientos Públicos

Ubicación: Administración del Sistema > Herramientas > Modelo/Flujo > Procedimientos Públicos.

Función: es el almacén más importante de scripting en Calipso ERP y actúa como un repositorio de código en formato de scripting. Cabe aclarar que Procedimientos Públicos está disponible tanto en Servidor como en Cliente, refiriéndonos en este caso al primero.

Características: 

• Este almacén está conformado por módulos, cada uno con un ID, donde se pueden definir funciones y procedimientos. 

• Deja al scripting en una instancia pública, permitiendo que las funciones y procedimientos puedan ser invocados desde cualquier parte. Para ello, deben ser llamados específicamente, ya que no se ejecutan de forma automática.

• Ejemplo: globalchangeform() es una función que se ejecuta siempre que se construye un formulario y todas las invocaciones las hace el framework.

Versión 1.0 Documentación realizada en base a capacitaciones brindadas por Javier Beleni al equipo de Soporte liderado por Maximiliano Rovner.