Archives: 09/09/2015

Armado

Todas las grillas del sistema serán completadas mediante el uso de stored procedure que luego serán registrados como consultas disponibles en el módulo DataTables. A continuación detallamos la nomenclatura del armado de los mismos:

• El stored procedure será nombrado de al siguiente manera: Co_[abreviatura de gestión]_SP_[nombre de la entidad]. Ejemplo: Co_MK_SP_Eventos. Dentro del stored procedure se incluirán todas las restricciones propias que corresponden al SP específicamente (joins, where, etc.). Además incluirá como parámetros opcionales todos los rangos asociados al mismo. De ser necesario, podremos incluir toda la lógica específica para armar la salida del store procedure en custión.

• El stored procedure realizará la invocación a una función cuyo retorno será de tipo tabla. Nombraremos a esta función utilizando la nomenclatura: Co_[abreviatura de gestión]_FX_[nombre de la entidad]. Dicha función recibirá como parámetro todos los rangos asociadas a la misma que serán inyectados desde el stored procedure que la invoca. La función NO contendrá ninguna lógica en particular sólo la clausula de WHERE específica acorde a los rangos a utilizar. Ejemplo: Co_MK_FX_Eventos. ATENCIÓN: las columnas de la tabla de retorno deberán ser iguales a los alias asignados a las columnas de la vista invocada.

• Dentro de la función se hará un “SELECT * FROM” de una vista que nombraremos así: Co_[abreviatura de gestión]_FX_[nombre de la entidad]. Ejemplo: Co_MK_VW_Eventos. En la misma haremos la proyección correspondiente, incluyendo una columna para las etiquetas (_tags) y el estado de la fila (_state) y toda la lógica común que podríamos llegar a compartir con diferentes stored procedures/funciones que utilicen dicha función.

Registro en vistas del sistema

A continuación detallaremos los pasos para registrar los stored procedures de las grillas como vistas del sistema:

• En caso de una nueva grilla: utilizar el SP Codigos_Seg_Vistas_Sistema_insert para el registro de la misma completando los parámetros según corresponda:
  • @Id: dejar en null para que el SP devuelva un ID correlativo.
  • @Modulo: indicar abreviatura de gestión/módulo (ver tabla Codigos_Gestion, columna Abrebiatura)
  • @Descripcion: objetivo de la consulta en cuestión. SER LO MAS PRECISO EN LA REDACCIÓN.
  • @FromTabla: dejar en ” (vacío).
  • @EsStoredProcedure: colocar 1 (true).
  • @NombreStoredProcedure: colocar el nombre del stored procedure.
  • @Tipo: dejar en ” (vacío).
  • @TipoResultado: colocar ‘multiple’ (sin acento).
  • @TipoEntidad: dejar en ” (vacío).
  • @TipoAccionNet: dejar en ” (vacío).
  • @EjecucionSobreInformac: colocar 0 (false) ó 1 (true) según corresponda.
  • @Consolida: colocar 0 (false).
  • @EnviarACache: colocar 0 (false).

• En caso de ser una grilla existente, modificar la columna NombreStoredProcedure colocando el nuevo nombre de SP a utilizar.

• En ambos casos, se deberán colocar los rangos del SP en la tabla Codigos_Seg_Vistas_Rangos.

• Verificar las claves de los rangos y los nombre de los parámetros en la tabla Codigos_DefinicionesRangos_Net. Donde:
  • CLAVE: es el identificador único del rango.
  • DDFORMULACRYSTAL: valor a tomar en cuenta para el nombre del parámetro DESDE del SP. Ejemplo: DDFecha.
  • HHFORMULACRYSTAL: valor a tomar en cuenta para el nombre del parámetro HASTA del SP. Ejemplo: HHFecha.

En caso de necesitar un nuevo rango coordinar con LPERDOMO y FHERMO.

Registro en DataTables

A continuación detallaremos los pasos para registrar los stored procedures de las grillas como DataTables en el módulo Analytics:

• Incorporar un nuevo registro en la tabla Codigos_Query de la base de datos INFORMAC_DESARROLLO. El id del query se armará: [número de gestión]0000, siendo estos últimos números establecidos de manera correlativa a medida que agregamos consultas. Ejemplo: 90002 – Eventos. Colocaremos en la columna GestionId el número de gestión correspondiente (ver tabla Codigos_Gestion).

• A continuación ingresaremos en la tabla Codigos_Query_Columnas las columnas que devuelve la consulta, indicando el orden y el alias de las columnas. Para éstos casos, en la columna Tabla_Id pondremos el mismo valor que colocamos en la columna Alias.

• Finalmente, ingresaremos los rangos asociados a la consulta en la tabla Codigos_Query_Rangos, los cuales, serán los mismos que definimos anteriormente en la tabla Codigos_Seg_Vistas_Rangos