Definición de las consultas
Para crea una nueva consulta genérica en el panel de control añadir un registro a la tabla CONSULTA. Los campos necesario son:
Nombre y descripción de la consulta: indicar el nombre de la consulta y una descripción acerca de su funcionamiento. Se recomienda no utilizar descripciones largas para el nombre ya que este valor se utilizará dentro del menú de consultas del panel de control para identificar la consulta.
Procedimiento almacenado: nombre del procedimiento almacenado en la base de datos asociado a la consulta.
Agrupación: este campo permite ubicar el informe dentro de los sub-menús dentro del menú de "Informes" del panel de control. Se permite anidar o crear sub-categorías nuevas utilizando el caracter ".", por ejemplo: "Categoría.Sub-categorías"
PermisoClave: dejar sin rellenar para que el informe sea accesible por todos los usuarios de la licencia. En el caso que se desee establecer acceso por permisos añadir un valor y definir los permisos para cada usuario o grupo de usuarios
Definición de parámetros de la consulta
Los parámetros de la consulta se obtienen a partir de los definidos en el procedimiento almacenado y el tipo de control "se calcula" en función del tipo y su nombre, por ejemplo para un parámetro del tipo "Varchar(n)" se mostrará un textbox, para un "bit" un checkBox, para un "decimal" un NumericTextBox,... y estos se añaden de forma dinámica en forma de parámetros al formulario de la consulta.
Parámetros de selección o selección múltiple con buscador:
Para definir un parámetros de selección crear el parámetro con el nombre "@ID" + "Nombre de la entidad". Ejemplos: @IDCliente, @IDProveedor,....
Para añadir parámetros de selección múltiples crear el parámetro con el nombre "@IDMulti" + "Nombre de la entidad". Ejemplos: @IDMultiCliente, @IDMultiProveedor,....
Si no se define un origen de datos personalizado para el parámetro en la tabla "CONSULTAPARAMETRO" que se explica a continuación el sistema utilizará la vista definida para esta entidad: "Nombre entidad" + "_VF".
(ejemplo de control de selección múltiple con buscador)
Personalización de parámetros de la consulta
La consulta funcionará sin necesidad de definir los parámetros en esta tabla "CONSULTAPARAMETRO", pero podemos mejorar el aspecto o añadir funcionalidades si queremos definir por ejemplo: nombre/etiqueta del parámetro, ayuda o tooltip que se muestra al pasar el cursor sobre el control, valor por defecto, origen de datos,....
Campos de la tabla: CONSULTAPARAMETRO
NombreParametro: Nombre del parámetro del procedimiento almacenado sin el carácter "@". Ejemplo para el parámetro "@IDCliente" indicar "IDCliente"
Nombre: texto que se mostrará como nombre del parámetro en el formulario de la consulta.
Descripción: texto que se mostrará como ayuda o aclaración en forma de tooltip al pasar el cursor del ratón sobre el control.
Tipo: (sin utilidad en esta versión). Como se ha comentado en puntos anteriores el tipo de parámetro se calculará por el nombre y el tipo del parámetro.
OrigenDatos: utilizar para personalizar el origen de datos del control. Se puede utilizar las siguientes opciones:
a) Cadena de texto/Enumerado: definido de la siguiente forma: {valor_1}:{descripcion_1};{valor_2}:{descripcion_2};...
Ejemplos: '1:Resumido;2:Desglosado', '1:Español;21:Inglés'
donde el primer campo será el que se pase a la consulta y el segundo campo el que se muestre en el formulario.
b) Consulta con SELECT: Se puede definir una consulta, empezando por la clausula "SELECT ". También se pueden añadir las clausulas permitidas como: TOP, WHERE, ORDER,...
c) Consulta con procedimiento almacenado: si se define un valor en este campo "OrigenDatos" y su contenido no es una consulta tipo "SELECT" o un enumerado, el sistema lo tomará como un procedimiento almacenado.
Una vez definido el valor para el procedimiento almacenado o la consulta tipo SELECT, será necesario indicar que campo se muestra al usuario y que campo es el que se pasa al parámetro de la consulta indicándolo de la siguiente forma:
OrigenDatosText: nombre del campo a mostrar al usuario
OrigenDatosValue: nombre del campo con el valor a pasar a la consulta
Obligatorio: (sin utilidad en esta versión)
Orden: orden de representación de los parámetros en el informe.
Default value: valor por defecto que se quiere mostrar para el parámetro en el informe.
Default value SQL: valor por defecto que se quiere mostrar para el parámetro en el informe a obtener de una consulta. Ejemplos:
Primer día del mes actual: SELECT DATEADD(month, DATEDIFF(month, 0, getdate()), 0)
Último día del mes actual: SELECT DATEADD(month, ((YEAR(getdate()) - 1900) * 12) + MONTH(getdate()), -1)
Día actual: SELECT getdate()
Formulario y acceso a la información de la consulta
Ahora es posible acceder a la información de la consulta desde el mismo formulario del panel de control. Para ello hacer "doble click" en el nombre de la consulta.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.