Gestión de parámetros

La utilización de parámetros y filtros es el sistema utilizado por DataCycle Reporting para reutilizar las Consultas e independizar el trabajo de los diseñadores de Consultas y los diseñadores de Procesos.

Mediante el diseño de Consultas SQL genéricas se reduce drásticamente el número de las mismas, dando más libertad al diseñador de Procesos en su uso al poder discriminar la información devuelta utilizando filtros

Un proceso puede incluir parámetros asociados a Tipos de parámetros definidos a nivel de proyecto, o bien sin tipo de parámetro, por lo que son exclusivos del proceso desde el que se definen.

 Limitaciones

• Si tiene que exportar el proceso, debe utilizar parámetros sin tipo de parámetro asociado, ya que los tipos de parámetros no se exportan.
• La última versión publicada de MyVision (3.0) todavía no soporta los nuevos formatos de parámetros sin tipo de parámetro descritos en el punto 7 de este artículo. Por ello, en caso de tener que publicar informes en MyVision, utilice parámetros con tipo de parámetro asociado. 

Creación de un parámetro 

1. Abrir un proceso

2. Pulsar sobre el icono de parámetros 

 

3. Pusar sobre icono con el símbolo "+" para añadir un nuevo parámetro

 

4. Rellenar el Nombre del parámetro. Es deseable que sea corto, ya que es el valor que se utilizará en las llamadas al parámetro

 

5. Rellenar la Descripción: este texto se verá en la ventana de petición de parámetros cuando se ejecute el informe

 

6. Rellenar la Descripción técnica: no se ve en tiempo de ejecución. Es sólo para uso a nivel de diseñador de informes, donde conviene que se explique lo necesario para que otro diseñador de informes sea capaz de entender fácilmente las principales características del parámetro

 

7. Seleccione el Tipo de parámetro, teniendo en cuenta las indicaciones al inicio de este documento

 

• Parámetro asociado a Tipo de parámetro
• Los tipos de parámetro se definen a nivel de proceso, por lo que permiten su reutilización en varios procesos
• Suelen emplearse para definir listados comunes (lista de vendedores, de productos, etc)
• NO son exportables: un proceso exportado con parámetros de este tipo, requerirá que el usuario que se lo importe, se defina manualmente estos tipos de parámetros
• Escoja un tipo de parámetro de la lista, o bien pulse sobre el botón adjunto para definir nuevos tipos de parámetros. 
• Parámetro sin tipo de parámetro
• Son locales del proceso, por lo que no se podrán reutilizar por otros procesos
• Son totalmente exportables, por lo que un usuario que se importe el proceso, no deberá realizar acción manual alguna
• Desde la versión DCR 9.2.0, los parámetros que no utilizan tipos de parámetros pueden tener diferentes formatos. 
• En caso que desee un parámetro sin tipo de parámetro, escoja la opción <sin tipo de parámetro> 
• En el campo Visualizar y seleccione el formato de parámetro que desee 
• Texto y números:  visualmente aparecerá un campo de texto libre
• Tamaño: determina el número de caracteres que se podrán entrar
• Sólo números:si está marcado, sólo se permitirán introducir números
• Formato: especifique el formato que desea. Por ejemplo, si marca la opción Sólo números y fija como formato el valor "##,#",  en tiempo de ejecución del proceso, tendrá que introducir los datos del parámetro en el formato _ _,_
• Listas y consultas: visualmente se le muestra una lista de valores, ya sea de una lista predefinida o bien de una consulta SQL
• Origen de datos: puede escoger dos opciones
• Lista de valores
• Consulta de base de datos
• Delimitador de texto: en caso que no sea un número, ponga el carácter de delimitación de texto que determine la base de datos a la cual va a acceder. Habitualmente es el carácter " ' ".
• Selección múltiple: si lo marca, podrá seleccionar varios campos de este parámetro.Observe que en este caso, deberá también determinar el separador de campos, que habitualmente es el carácter ",". Recuerde también que a nivel de SQL, deberá utilizar la sentencia IN en lugar de un =. 
• Fecha: aparece un calendario 
• Editable: márquelo si desea que también se pueda escribir manualmente la fecha
• Formato: puede determinar formato configurable (%d/%m/%Y, etc)
• Sí / No: campo para selección de Sí o No

8. Repita la misma operación para cada parámetro que desee incluir en su proceso, y al finalizar pulse el botón Aceptar

9. Ahora debe utilizar dichos parámetros en el proceso, para hacer que el informe resultante dependa de los valores introducidos para cada parámetro. Puede hacerlo incluyéndolos en los SQL de las consultas, en los nombre de informes a generar, o en los filtros de la tarea de insertar datos.  

10. Cuando ejecute el proceso, se le soliciitará que indique valores para cada uno de los parámetros que haya definidos.