como usar genexus query

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


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.


¿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.


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.


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.


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.


¡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.


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.


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”).


Tarea 4. Graficar consulta

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


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 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.

http://www.gxquery.com/

como usar genexus query

Documents

Transcript of como usar genexus query