Getting Started

Febrero 2002
GeneXus Query Getting Started

TABLA DE CONTENIDO

¿Que es GeneXus Query? ____________________ 4

¿Cómo funciona? ______________________________ 4
Instalación _______________________________ 5
Registración ______________________________ 5
Guia rápida de USO de GENEXUS QUERY __________ 6
Tarea 1. Creando una nueva consulta ______________ 6
Tarea 2. Aplicando filtros o condiciones a la consulta _ 8
Tarea 3. Manipulación de la Pívot Table de Excel ____ 10
Tarea 4. Graficar consulta ______________________ 11
Tarea 5. Publicar consulta______________________ 12
Más Información __________________________ 13
GeneXus Query Getting Started

Copyright  ARTech Consultores SRL 1988-2002.

Todos los derechos reservados. El presente documento no puede ser duplicado de
ninguna forma sin el expreso consentimiento de ARTech Consultores SRL. La
información contenida en este documento es para uso personal del lector.

TRADEMARKS
ARTech, GeneXus, GeneXus Query y GXplorer son marcas o marcas registradas de
ARTech Consultores S.R.L.
Microsoft y Excel son marcas o marcas registradas de Microsoft Corp.
Todas las otras marcas citadas en este trabajo pertenecen a sus respectivos
dueños.
GeneXus Query Getting Started

¿QUE ES GENEXUS QUERY?

GENEXUS QUERY es la respuesta a la necesidad de los usuarios finales de poder
definir sus propias consultas.

A diferencia de las herramientas de consulta tradicionales, GENEXUS QUERY permite

especificar las consultas en el lenguaje del usuario sin necesidad de conocer
absolutamente nada de la forma en que los datos están almacenados, la estructura
de los mismos, ni ningún concepto técnico. Además tiene la inteligencia de guiar al
usuario en el armado de la consulta, permitiendo seleccionar siempre
combinaciones de atributos válidos, asegurando la consistencia de la consulta
definida.

El objetivo que se persigue es sustituir gran parte de los reportes, desarrollados en

forma específica y continua por los programadores, por consultas de carácter
dinámico definidas directamente por el usuario final.

¿Cómo funciona?
GENEXUS QUERY funciona como un complemento de Microsoft Excel. Al abrir Excel,
luego de haber instalado GENEXUS QUERY (o luego de cargar el complemento en
Excel en la opción “Herramientas / Complementos” del menú Herramientas) se
dispondrá de una barra de herramientas (ver Figura 1) y un ítem en el menú
principal de Excel (ver Figura 2), que permite definir consultas directamente desde
cualquier planilla Excel.

Figura 1 – Barra de Herramientas de GeneXus Query

Figura 2 – Nueva Opción del Menu Principal de Excel

Mediante las opciones de esta barra de herramientas, se realiza toda la interacción
con GENEXUS QUERY.
GeneXus Query Getting Started

INSTALACIÓN
Para instalar GENEXUS QUERY ejecute el archivo de instalación GXplQuery.exe que
se encuentra en el CD de GENEXUS QUERY. Aparecerá un asistente que lo guiará en
la instalación del producto.

Importante: Durante la instalación se le solicitará el usuario administrador del

catálogo. Este usuario es el que se utilizará luego para acceder al sistema.

Por más información acerca de la instalación de GENEXUS QUERY consulte el Manual

de Instalación.

REGISTRACIÓN
A continuación se detallan los pasos necesarios para la registración o activación del
producto.

1. Ejecute ‘GeneXus License Manager’ que se encuentra en el menú de

programas de GENEXUS QUERY o el archivo Gxlmgr.exe ubicando en el
directorio Program de instalación del producto.
2. Presione Select Computer e indique si la licencia será utilizada en forma
local o en un servidor.
3. Por medio del botón Authorize y mediante la opción Request Licenses
solicite la clave de activación para el producto GENEXUS QUERY. El registro
se realiza a través de Internet o enviando el código a su distribuidor local.
4. Una vez obtenida la clave de activación (archivo con extensión gxa), debe
copiarlo en la máquina seleccionada en el paso 2 y ejecutar el archivo
desde esa misma máquina, haciendo doble clic sobre el mismo. Luego de
un instante aparecerá una pantalla indicando el estado de la operación.
(También puede activar las claves desde el License Manager. Para esto
presione nuevamente el botón Authorize, seleccione la opción Enter
License, luego Auhtorize from file y finalmente seleccione el archivo con
extensión gxa que contiene las claves de activación)
5. Finalmente, mediante el botón Allowed Users ingrese el/los usuario/s de
acceso al GENEXUS QUERY. Uno de estos usuarios es el administrador del
catalogo, indicado durante la instalación del producto.

Por más información acerca del uso de GeneXus License Manager consulte el
manual de Instalación de GENEXUS QUERY.
GeneXus Query Getting Started

GUIA RÁPIDA DE USO DE GENEXUS QUERY

Este documento intenta mostrar cómo es posible construir consultas de forma muy
sencilla con GENEXUS QUERY, y cómo manipular luego la información obtenida. Se
utiliza la metadata de ejemplos (denominada “CarDealer (Query Sample)”) y la
base de datos incluidas en el setup de instalación de GENEXUS QUERY.
Las tareas a realizar son las siguientes:

Tarea 1. Creando una nueva consulta.

Tarea 2. Aplicando filtros o condiciones a la consulta.
Tarea 3. Manipulación de la Pivot Table de Excel.
Tarea 4. Graficar consulta.
Tarea 5. Publicar consulta.

Tarea 1. Creando una nueva consulta

1. Presione la opción Nueva Consulta de la barra de herramientas de GENEXUS
QUERY. Si se detecta que es la primera vez que se va a realizar una consulta se
desplegará el diálogo de ingreso al sistema (Login). Para autenticarse ante el
mismo es necesario ingresar usuario, contraseña y metadata a la cuál se
conectará. El usuario de acceso por defecto es el solicitado durante la
instalación del producto (sin contraseña). Dicho usuario debe estar en la lista de
usuario habilitados en el License Manager.

Una vez ingresado al sistema aparecerá el diálogo para crear la consulta.

2. Seleccione los atributos que desea visualizar. Para esto debe posicionar el
cursor sobre cada atributo a seleccionar, en la sección Atributos, y presionar el
botón o hacer doble clic sobre los atributos. Los atributos irán apareciendo en
la sección Atributos Seleccionados.

En nuestro ejemplo se desea ver el Total facturado diario por clientes de cada
País. Para esto seleccionamos los campos País (Dsc), Nombre de Cliente, Fecha
de Factura y Total de Factura.
GeneXus Query Getting Started

Cada vez que un atributo es enviado al área de Atributos Seleccionados

GENEXUS QUERY actualiza la lista de atributos relacionados modificando el árbol
de selección.

A su vez le asocia a cada uno de los atributos seleccionados un ícono distintivo

según que el atributo sea agregable o no.
• Icono : no agregable, por defecto Descripciones, fechas y numéricos sin
decimales.
• Icono : agregable, por defecto Numéricos con decimales.

3. Presione el botón Aceptar para ejecutar la consulta. Los datos solicitados se

obtendrán automáticamente de la base de datos. El resultado se puede ver en
la siguiente figura.
GeneXus Query Getting Started

¡Ud. ya ha credo una consulta con GENEXUS QUERY!.

Si desea ver algunas opciones más avanzadas, siga con las siguientes tareas.

Tarea 2. Aplicando filtros o condiciones a la consulta

Existen varias formas de restringir los datos de una consulta: definirlos
directamente en la especificación de la consulta (tanto en las propiedades de los
atributos como en Condición Avanzada) ó directamente en la planilla. Veremos el
primer caso.

1. Edite la consulta mediante la opción Editar Consulta de la barra de

herramientas de GENEXUS QUERY. Aparecerá nuevamente el diálogo de edición
de consulta.
2. Seleccione un atributo sin agregación (identificados con el icono ) de la
sección Atributos Seleccionados (en nuestro ejemplo País(Dsc.)) y haga
doble clic sobre el mismo (o clic derecho y seleccionar Propiedades).
Aparecerá la siguiente pantalla.
GeneXus Query Getting Started

3. En la opción Valores a cargar seleccione Lista de valores y luego,

posicionado sobre los valores disponibles, seleccione algunos valores mediante
el botón o presionando doble clic sobre dicho valor. En nuestro ejemplo
seleccionamos los Países Uruguay y Brasil.

4. Acepte los cambios y ejecute la consulta nuevamente, presionando Aceptar

también en el diálogo de edición. El nuevo resultado se puede ver en la
siguiente figura.
GeneXus Query Getting Started

Luego de resuelta la consulta, la información obtenida se podrá manipular de

diferentes maneras, ya sea directamente desde la tabla dinámica de Excel,
visualizarla en forma gráfica o guardarla para uso posterior. Veremos estas
opciones.

Tarea 3. Manipulación de la Pívot Table de Excel

Las Tablas dinámicas son tablas interactivas de Excel que de un modo sencillo
permiten sumarizar y mostrar en forma cruzada gran cantidad de datos. En este
caso haremos una sumarización por Día, arrastrando el País(Dsc.) y Nombre Cliente
al área de páginas de la tabla dinámica (mediante “drag and drop”).
GeneXus Query Getting Started

Tarea 4. Graficar consulta

Presione la opción Graficar Consulta desde la barra de herramientas de
GENEXUS QUERY para graficar la consulta.
GeneXus Query Getting Started

La gráfica creada es dinámica, ya que se tienen disponibles todas las funciones del
graficador (formato de la gráfica, nombre de ejes, leyendas, título, etc.) como
también las posibilidades de las tablas dinámicas (drag-and-drop, especificar filtros,
eliminar columnas, etc). Los cambios en la especificación de la consulta y
manipulación se pueden hacer también desde el gráfico y los mismos son
automáticamente refrescados en la tabla.

Tarea 5. Publicar consulta

Una de las formas posibles de compartir las consultas con otros usuarios es creando
un archivo HTML. De esta forma cualquier usuario que disponga de un Browser
(como Internet Explorer) podrá visualizar la misma. Publique la consulta mediante
la opción Publicar Consulta.
GeneXus Query Getting Started

GENEXUS QUERY dispone de un catálogo de consultas donde el usuario podrá

almacenar las consultas y no tener que re-definirlas cada vez que quiera utilizarlas.
Mediante la opción Guardar Consulta almacene la consulta creada en el
catálogo.

MÁS INFORMACIÓN
En el ejemplo que se ha visto se han utilizado solo unas pocas características de
GENEXUS QUERY. Con ellas es posible formular muchas consultas útiles. Existe un
importante conjunto de características adicionales que pueden estudiarse
consultando el Manual de Operación de GENEXUS QUERY.

Por más información acerca del producto consulte www.gxquery.com.