CAPÍTULO

VII

ENQUIRIES
Autor: Leo Basabe Calderón

Fecha de Impartición: Noviembre 18, 2014

Última Actualización:

Versión: Inicial 01.00

Manual Pertenece a:

Institución Financiera: Banco Multiva S.A.

Instructor: Leo Basabe Calderón.

Página 1 Curso de T24 Noviembre de 2014

Contenido del Capítulo VII
Pág.
Objetivo de este capítulo: ........................................................................................................................ 3
Introducción. .......................................................................................................................................... 3
Procedimiento. ....................................................................................................................................... 4

Página 2 Curso de T24 Noviembre de 2014

Objetivo de este capítulo:

Guiar paso a paso a los nuevos desarrolladores durante el proceso de creación de enquiries (consul-
tas) en el ambiente de T24.
Comprender el procedimiento para la creación de enquiries simples y, al mismo tiempo, ser capaz de
crear y manejar los objetos que intervienen en la creación de un enquiry simple.

Introducción.
Tener la información en una base de datos es de muy poco valor a menos que se puede extraer y utili-
zar. El poder de una base de datos se encuentra en el aprovechamiento de la experiencia y conoci-
mientos de los datos, así como en la presentación de la información correcta y completa.

Un Enquiry es una pregunta que se hace al sistema de datos. Se utilizan criterios de búsqueda para ob-
tener la información requerida y presentar los datos en cualquier formato requerido.

Utilidad de los enquiries:

• Despliegan información de aplicaciones.

• Se pueden ejecutar consultas más detalladas a partir de una consulta principal.

• Despliegan y ordenan los datos en diferentes formatos.

• Se pueden exportar los resultados en Excel.

Página 3 Curso de T24 Noviembre de 2014

Procedimiento.
Para la creación de la consulta, nos valdremos de la versión ENQUIRY,DESIGNER. Es necesario abrir
una sesión de GLOBUS y escribir en la barra de comando:
ENQUIRY,DESIGNER

En la barra de ID debemos escribir el nombre de nuestro ENQUIRY, vea la Figura 1.1

Figura 1.1

La versión ENQUIRY,DESIGNER es un método de creación de consultas en GLOBUS, utilizando las

pestañas, para diseñar una nueva consulta o la modificación de una ya existente.

La versión ENQUIRY,DESIGNER contiene las siguientes pestañas:

1. Main Details.

En esta pestaña se ingresa el nombre de la aplicación en la que se basa la consulta y también los cri-
terios de búsqueda que se usaran, vea la figura 1.2.

Campos de la pestaña Main Details.

FILE NAME
Este es el nombre de la tabla o aplicación en que se basará la consulta. El archivo debe tener una en-
trada valida en F.FILE.CONTROL y no debe contener el prefijo ‘F’ o ‘FBNK’.

ENQUIRY TITTLE
Este campo nos permite capturar el nombre de la consulta.

PREDEFINED SEL
Identifica los criterios de selección fijados para el Enquiry. Esta selección se llevará a cabo cuando un
Enquiry se invoca. Su funcionalidad es similar a la de la cláusula "where" en una declaración "Select".

Ejemplo:
CUSTOMER NE “” (esto significa que el campo Customer deberá ser “Diferente” a vacío)

PREDEFINED SORT
Especifica los campos que servirán de base para ordenar la información. Su funcionalidad es similar a
la de “order by” dentro de una declaración "Select". El ordenamiento puede ser ascendente o des-
cendente de campos simples o múltiples.

Ejemplos:
CUSTOMER (Ascendente, ordenado por número de cliente)
ACCOUNT DSND (Descendente, ordenado por número de cuenta.)

Página 4 Curso de T24 Noviembre de 2014

SELECTION FIELD
Especifica los campos de selección que se usarán en el ENQUIRY, los cuales determinan las condicio-
nes de búsqueda de la consulta. Si no se define ningún campo de selección, por default, se presenta-
rán todos los nombres del STANDARD.SELECTION cuando se ejecute el Enquiry.

OPERAND
Define qué operadores son permitidos para el Enquiry en concordancia al campo “SELECTION FIELD”.
Operadores válidos: EQ, NE, RG, NR, LK, UL, GT, GE, LT, LE o cualquier combinación separada por una
espacio.

Ejemplo:
SELECTION.FIELD OPERAND
CUSTOMER EQ LK.GT
PAIS.ORIGEN NE UL NR

MANDATORY
Nos permite hacer obligatorio un campo de búsqueda de la consulta. El valor “Y” hace obligatorio el
uso del criterio de selección; si el campo se deja vacio se tomara como no obligatorio.

Figura 1.2

Página 5 Curso de T24 Noviembre de 2014

2. Data Columns.

Se deben ingresar en esta pestaña los campos que se desea presentar como resultado de la búsque-
da, los cuales estarán ordenados por numero de columna. La figura 2.1 muestra un ejemplo de estos
campos.

Campos de la pestaña Data Columns:

NAME
Identifica individualmente cada campo que será utilizado en el Enquiry. En caso de que el valor en
“NAME” de un campo sea el mismo especificado en el STANDARD.SELECTION, entonces tendrá el
mismo valor que se registrará en el campo OPERATION.

HEADING
En este campo se ingresa la etiqueta de cada columna que se presentará al ejecutar la consulta.

COL (Columna)
Organiza el resultado de la búsqueda por el número de columna de forma ascendente. Si se deja va-
cio este campo, no se presentara este dato en la salida del enquiry.

OPERATION
Este contiene el nombre real del campo tal como se define en el Standard.Selection. Las instruccio-
nes siguientes también son compatibles:

FIELD.NAME Localiza el campo referencia usando el FILE.NAME del STAN-

DARD.SELECTION.
FIELD X Extrae el valor actual del campo del Enquiry X
TOTAL X Total del campo del Enquiry X
CALC X + Y Suma los campos del Enquiry X + Y
CALC X / Y Divide los campos del Enquiry X / Y
CALC X * Y Multiplica los campos del Enquiry X * Y
CALC X – Y Resta los campos del Enquiry X – Y
CALC X : Y Concatena los dos campos del Enquiry
IF A GT B X Y Proceso de decisión.
Si el campo “A” es superior al campo “B” entonces se mostrará en la salida
el valor “X”, en caso contrario el valor de salida será “Y”.

Los operadores válidos en el proceso de decisión son:

EQ, NE, RG, NR, LK, UL, GT, GE, LT, LE

El campo OPERATION es sub-valor para permitir que los criterios de decisión

abarquen más de una sola línea.
"VALOR" Utilice las constantes entre comillas.
!USER Extrae el ID del usuario actual.
!TODAY Extrae la fecha del día de hoy.
!COMPANY Extrae el Id de la empresa.
!LANGUAGE Extrae el código del idioma del usuario.
!LOCAL.CCY Extrae el código de la moneda local.
!LAST.WORKING.DAY Extrae el último día hábil.
!NEXT.WORKING.DAY Extrae el siguiente día hábil.

Página 6 Curso de T24 Noviembre de 2014

TYPE
Permite dar formato a los valores generados en la consulta, basándose en el tipo de dato de cada
campo:
Utilice la función CCY para formatear cantidades de moneda:
Ejemplo:

CAMPO ORIGINAL VALOR ORIGINAL DEFINICION EN EL CAMPO TYPE RESULTADO

CCY WKG.BAL E <1,234,567.62>
CCY WKG.BAL M 1,234,567.62 --
WKG.BAL -1234567.62 CCY WKG.BAL B 1,234,567.62 PP
CCY WKG.BAL N 1,234,567.62
CCY WKG.BAL -1,234,567.62

MASK
Define longitud y la alineación de la máscara.
Ejemplo:
40L Indica que si el dato original tiene una longitud mayor a 40 caracteres, se ajus-
tará hasta a 40 y se alineará a la izquierda (Left).

35R Indica que si el dato original tiene una longitud mayor a 35 caracteres, se ajus-
tará hasta a 35 y se alineará a la derecha (Rigth).

CONVERSION
Permite el manejo de los datos para obtener, fragmentos de cadenas de texto, reemplazo de patro-
nes específicos, conversión de fechas, hasta ejecución de rutinas.
Algunos ejemplos:

ID del CAMPO VALOR CONVERSION APLICADO RESULTADO

SALIDA 10*30*40 FIELD *, 2,1 30
SALIDA 10*30*40 EXTRACT 3, 4 *30*
ID.CUST 12345 LINK CUSTOMER,NAME HERNANDEZ
FECHA.INGRESO 20140706 @ BMV.FORMATEA.FECHA 06 de Julio de 2014

S/M (Single/Multi)
Especifica que la instrucción debe ser procesada por cada multi-valor. Si M es especificada, la instruc-
ción debe ser procesada para todo el multi-valor del registro.

Página 7 Curso de T24 Noviembre de 2014

 Figura 2.1

Página 8 Curso de T24 Noviembre de 2014

3. Drill Down.

Esta pestaña nos permite mostrar registros de otras tablas o ejecutar consultas secundarias.

Campos de la pestaña Drill Down.

ENQUIRY
Define el nombre del siguiente Enquiry, aplicación o versión para ser invocada.

Ejemplo:
ACCOUNT,INGRESO S F3
E.CUENTAS.CUST

SELECTION
Criterio de selección para el siguiente nivel del Enquiry. Es solo valido cuando se invoca otro Enquiry
en el siguiente nivel.

Ejemplo
CUSTOMER EQ Y.CUST.ID

FIELD TO HIGHLIGHT
Especifica el nombre de campo, al cual al dar clic derecho lleva al siguiente nivel del Enquiry versión o
aplicación.

DESCRIPTION
Define la etiqueta que desplegara al dar clic derecho en el registro seleccionado de la consulta.

Figura 3.1

Página 9 Curso de T24 Noviembre de 2014

4. Advanced.

Es posible ingresar rutinas del tipo BUILD.ROUTINE. Estas rutinas nos permiten tomar los campos ba-
se de la tabla para usarlos como parámetros y de esta forma ejecutar otras consultas.

Campo BUILD ROUTINE

Rutina que puede ser invocada antes de la selección real de los datos del archivo, pero después de
la selección de criterios se especifica cuando se ejecuta el Enquiry. Esta rutina debe tener un argu-
mento pasado, que contendrá el texto siguiente:

ENQ <2,1> = Selección de nombres de campo (entrada del usuario)

ENQ <3,1> = operadores asociados (EQ, LK), etc.
ENQ <4,1> = LISTA DE DATOS

Figura 4.1

5. Audit.

Se presentan los campos de auditoría del registro. Estos campos pertenecen a la tabla ENQUIRY; vea
la figura 1.5.

Figura 5.1

Página 10 Curso de T24 Noviembre de 2014