Manual - Administrador 10 : Crear consulta

ara crear una consulta

1. Haga clic en la opción "Consultas SQL" del menú lateral Fuentes de datos externas.
   Aparece la siguiente pantalla en el área de trabajo. Haga clic en el botón Crear consulta que aparece en la parte inferior derecha.

1. Aparece la siguiente pantalla en donde debe diligenciar los datos que ésta le pide.

Para registrar una nueva consulta se deben especificar los siguientes datos: 

• En el campo "Consulta" ingrese un nombre que permita identificar la consulta SQL.
• En el campo "Descripción" puede ingresar información complementaria sobre lo que realiza la consulta SQL.
• En el campo "Sentencia" ingrese la consulta SQL. Ésta puede contener parámetros de usuario que deberán ser ingresados al utilizar esta consulta. Además se encuentran disponibles parámetros del Sistema para el manejo de fechas.

En la sección Parámetros de usuario y Parámetros de Sistema, se despliega información de ayuda para la configuración de estos parámetros:

Un parámetro de usuario es un argumento (variable) definido por el usuario para la realización de la consulta en una fuente de datos externa. En la consulta SQL de la consulta este tipo de parámetro debe incluirse especificando el nombre de la variable delimitado por el signo $.

Nota: Para conocer las restricciones de estos parámetros en detalle consulte la ayuda que se encuentra en pantalla.

Al hacer clic en Parámetros del sistema encuentra la siguiente información:

Los parámetros del sistema son argumentos (variables) predefinidos en la Suite que representa por ejemplo fechas para la realización de consultas en las fuentes de datos externas. Para incluir algún parámetro del sistema en la consulta SQL, haga clic sobre el botón del parámetro que desea incluir.
Para un mejor entendimiento del uso de estos parámetros usaremos un ejemplo en un mensaje de captura, ya que las consultas a crear se usan para obtener valores de las variables externas.
Para un mensaje de captura diario con fecha de dato (05/may/2012 00:00:00), cuya fuente tiene el formato de fecha yyyyMMdd los parámetros de sistema se aplicarían de la siguiente manera:

1. _fPrimerDiaAnno: la fecha quedará 20120101, ya que toma el primer día del año de la fecha que se está formateando; el orden de esta, depende del formato de la fuente mencionado anteriormente (yyyyMMdd). Este formato aplica para todos los parámetros con excepción de: _dMes2, _dAnno2, _dDia2, _dHora2, _dAnno4.
2. _fPrimerDiaMes: 20120501
3. _fDesde: 20120505
4. _fPrimerDiaMesAnterior: 20120401
5. _fhHasta: Para este parámetro se mira la fecha de validez del mensaje de captura, incluye la hora a diferencia del parámetro _fHasta, quedando de la siguiente manera: 20120506.
6. _fUltimoDiaAnno: 20121231
7. _fUltimoDiaMes: 20120531
8. _fPrimerDiaAnnoAnterior: 20110101

La sentencia podrá estar compuesta por varias consultas configuradas secuencialmente.

1. Haga clic en el botón Validar, para verificar cuales son los parámetros de usuario que han sido incluidos en la consulta SQL; los parámetros de usuario encontrados se muestran en una ventana emergente, si los parámetros de usuario incluidos en la consulta SQL son los correctos presione el botón Aceptar de esta ventana, en caso contrario, presione el botón Cancelar, realice las correcciones necesarias y vuelva a validar la consulta.
2. Una vez se validan los parámetros de usuario empleados en la consulta SQL, aparece el botón Guardar.

jsp=/base/xcreateQuery.jsp