Manual GeneXus Query Manager

Febrero 2002
Copyright  ARTech Consultores S.R.L. 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 y GeneXus Query son marcas o marcas registradas de ARTech

Consultores S.R.L.

Microsoft y Microsoft Excel son marcas o marcas registradas de Microsoft Corp.

Todos los productos mencionados en este documento son propiedad de sus

respectivos dueños.
 Tabla de contenido
INTRODUCCION............................................................................................................................................1

METADATA.....................................................................................................................................................2

GENEXUS QUERY MANAGER......................................................................................................................3

Creación del Catálogo ...............................................................................................................................3
Crear Metadata ..........................................................................................................................................3
Carga/Impacto de la Metadata ..................................................................................................................5
Reglas de Inferencia - Loading Options ................................................................................................6
Selection .................................................................................................................................................8
Selección de Atributos........................................................................................................................8
Análisis de Creación - Impacto...............................................................................................................9
Restaurar Metadata anterior..............................................................................................................10
Impresión del Análisis de Impacto ...................................................................................................10
Ver Detalle de Consultas ..................................................................................................................10
Exportación/Importación de Metadatas...................................................................................................10
Export Metadata ...................................................................................................................................11
Import Metadata ...................................................................................................................................11
Ejemplo de utilización......................................................................................................................12
Consideraciones....................................................................................................................................13
GENEXUS QUERY Settings .........................................................................................................................13
ANEXO I – INTEGRACION CON GENEXUS ..........................................................................................14
DESCRIPCIÓN ................................................................................................................................................14
¿ Cómo funciona GENEXUS QUERY desde GENEXUS? .............................................................................15
Catálogos y Metadatas.............................................................................................................................16
Consideraciones .......................................................................................................................................16
ANEXO II – GENERACION DE TRACE...................................................................................................18
 Tabla de figuras

Figura 1 – Nueva Metadata ................................................................................. 4

Figura 2 - Reglas de Inferencia............................................................................ 7
Figura 3 – Análisis de Impacto ............................................................................ 9
Figura 4 – Selección del directorio para exportar una metadata ..............................11
Figura 5 - Ubicación de la metadata "Producción Ventas".......................................12
Figura 6 - Exportación de la metadata “Producción Ventas”....................................12
Figura 7 - Importar Reorganización metadata “Producción Ventas” .........................13
Figura 8 - Nuevas opciones ................................................................................14
Figura 9 - Reorganización de una Metadata..........................................................15
Figura 10 – Opciones de Ejecución de GeneXus Query ...........................................15
INTRODUCCION
El propósito de este documento es guiar al usuario en el uso del GENEXUS QUERY
Manager.

El GENEXUS QUERY Manager administra la Metadata, la cual es usada por las

herramientas GENEXUS QUERY Settings y GENEXUS QUERY para la especificación de
las consultas por parte del usuario.

1
GeneXus Query Manager

METADATA
La Metadata es una base de datos que contiene toda la información necesaria para
permitir al usuario la especificación con GENEXUS QUERY de sus consultas.

La herramienta GENEXUS QUERY y la Metadata son dos partes de la misma solución,

ya que el primero requiere de la información contenida en la Metadata, y es
justamente ésta la que le brinda la inteligencia necesaria para que el usuario pueda
especificar sus consultas en su lenguaje, en forma totalmente transparente al diseño
físico de la base de datos.

Toda la información necesaria para la Metadata está contenida en la base de

conocimiento GENEXUS donde se define el sistema operacional. Las bases de
conocimientos GENEXUS son en sí Metadatas (contienen información de cómo son los
datos).
Esta información debe poder ser accedida en tiempo de ejecución (cuando el usuario
final está especificando sus consultas), por lo tanto, es necesario liberar el
conocimiento contenido en la Base de conocimiento GENEXUS al usuario final.

La herramienta que permite realizar esto es el GENEXUS QUERY Manager.

La Metadata del GENEXUS QUERY contiene dos niveles de información:

Metadata – Contiene todo el conocimiento de la base de conocimiento asociada al

sistema operacional (tablas, atributos, relaciones, etc.). Dicho de otra forma,
contiene la definición del modelo físico de la Base de Datos.

Metadata del Usuario – Contiene el mapping entre las definiciones físicas (Base de
datos) y el lenguaje del usuario (Atributos), así como también las consultas
catalogadas por el usuario y preferencias de cada usuario.

Las funciones principales del GENEXUS QUERY Manager son las siguientes:

• Transfiere el conocimiento contenido en la base de conocimiento GENEXUS donde

se definió el Sistema operacional a la metadata.
• Genera automáticamente el lenguaje del usuario (Atributos) y genera
automáticamente el mapping entre el diseño físico del Sistema operacional y el
lenguaje del usuario.
• Crea y reorganiza la Metadata ante cambios en la estructura del Sistema
operacional.
• Impacta las consultas catalogadas por los usuarios ante cambios en la estructura
del Sistema operacional.

Cada vez que se modifica la base de conocimiento del Sistema operacional,

se debe impactar la Metadata, de la misma forma que se impacta la base de
datos correspondiente. En caso que sea necesario realizar varios impactos
deberá respaldar los diferentes impactos (exportando la metadata) para su
posterior actualización en las estaciones cliente.

2
GeneXus Query Manager

GENEXUS QUERY MANAGER

El GENEXUS QUERY Manager tiene cuatro grandes puntos:

1. Creación del Catálogo: Permite crear catálogos para administrar las

metadatas de los diferentes clientes.

2. Creación de la Metadata: Permite crear varias metadatas en un catálogo.

3. Carga de la Metadata: Lee la base de conocimiento en la cual se definió el

Sistema Operacional, se infieren los atributos y el mapping de éstos al modelo
físico.

4. Exportación de la Metadata: Cuando se trabaja con varias instalaciones

independientes sobre una misma Metadata (distribuida físicamente), es
posible exportar la Metadata desde una instalación para luego importarla en
otra.

Veamos con profundidad cada uno de los puntos anteriores.

Creación del Catálogo

Una empresa generalmente tendrá un único catálogo con varias metadatas (por
ejemplo: Ventas, Sueldos, etc.) que pueden corresponderse a diferentes bases de
conocimiento. Los usuarios se darán de alta una única vez (se guardan en el
catálogo) y se les da derecho a ver N metadatas. En este caso no es necesario crear
un nuevo catálogo, se puede usar el creado por defecto y definir luego las Metadatas
para el mismo.

Pero otras empresas, principalmente las Software Houses, posiblemente requieran

utilizar diferentes catálogos, cada uno para sus diferentes clientes con sus usuarios.
En este caso se requiere entonces manejar varios Catálogos, uno por cada empresa
cliente.

Por defecto el catálogo es creado en el directorio “GXQuery Catalog” con el nombre

Gxplcat.gpc. Una vez creado el catálogo sobre el mismo se puede crear todas las
metadatas necesarias como se explica en Crear Metadata. A su vez se podrá cambiar
el catálogo de trabajo en la opción Catalog/Open Catalog, se deberá seleccionar un
archivo con extensión .gpc

Crear Metadata
Es posible crear varias metadatas en un mismo catálogo, lo cual permite una mejor
administración.

El tener varias metadatas implica que se comparta cierta información entre ellas,

3
GeneXus Query Manager

como ser: Usuarios, Supervisor, etc. Esta información compartida se agrupa en un

Catálogo que se crea automáticamente la primera vez que se entra al GENEXUS
QUERY Manager con el nombre GxplCat.gpc en el directorio GXQuery Catalog.

Una vez creado el catálogo se puede crear tantas metadatas como se desee. Para ello
se puede seleccionar la opción “New Metadata” del Menú File o sino mediante el
icono de la barra de herramientas. Una vez seleccionada esa opción se muestra
una ventana como la siguiente:

Figura 1 – Nueva Metadata

Al presionar esta opción se le pide al usuario un nombre para la metadata a crear y

el directorio donde crearla. Si no se modifica el directorio donde se crea, GENEXUS
QUERY Manager asume por defecto un directorio con igual nombre que el nombre de
la metadata, bajo el directorio del catálogo. En ese directorio se creará el archivo
GXplData.gpm, que contendrá información de la metadata. El nombre de la metadata
es único por catálogo.

Se asume que el directorio de una metadata es relativo al directorio del catálogo

cuando:

• Se ingresa un path sin drive. (O sea si en el dir del catálogo, se pone

Metadata1\Ventas, la metadata se creará en \catalogPath\Metadata1\Ventas
\GXplData.gpm; por lo que queda relativa)
• El directorio que se digita se encuentra subordinado al directorio donde se
encuentra el catálogo (como es el caso por defecto).

En cualquier otro caso, se asume el path absoluto. En este último caso, aunque se
mueva el catálogo con todas sus metadatas, las que tengan path absoluto no
cambiaran de path.

Si se desea mover el catálogo con sus metadatas a otro directorio, se debe copiar el
archivo GxplCat.gpc (o equivalente) y todos los subdirectorios debajo de este que
tengan metadatas.
Luego con GENEXUS QUERY Manager, se debe utilizar la opción Open-Catalog y
seleccionar el archivo GxplCat.gpc recién movido.

Se recomienda siempre manejar las metadatas relativas al catálogo para facilitar su

4
GeneXus Query Manager

manipulación y compartición entre instalaciones.

Una vez creada la metadata, sobre ellas se pueden realizar las siguientes acciones:

Select Metadata: Se le despliega al usuario la lista de metadatas contenidas en el

catálogo para que seleccione una.

Edit Metadata: Edita la metadata actual para poder modificar el nombre o directorio
de la misma.

Delete Metadata: Borra la metadata seleccionada del catálogo. Se da la posibilidad

de borrar toda la estructura de directorios subordinada o solo borrar la metadata. En
caso de utilizar la opción “Borrar toda la estructura de directorios” se recomienda que
verifique la estructura pues esta operación no puede deshacerse.

Carga/Impacto de la Metadata
La carga de la metadata realiza fundamentalmente 2 cosas:

• Realiza una copia de un subconjunto de la base de conocimiento al

subdirectorio KB debajo del directorio de la metadata (solo aquel
conocimiento que describe, tablas, atributos, relaciones, etc.).
• Crea o impacta la metadata (agrupación de atributos, seguridad, consultas
catalogadas, etc.).

Para realizar la Carga o Impacto de la metadata deberá seleccionar la opción Load.

Posteriormente podrá seleccionar la opción “Load Metadata”.
Se desplegará un wizard de 6 pasos para obtener toda la información necesaria para
crear la metadata.

1. Directorio de la Base de Conocimiento: En este punto se debe seleccionar

el directorio de la raíz de la base de conocimiento, a partir de la cual se desea
crear o impactar la metadata. Además se debe seleccionar si se está
realizando una Creación o un Impacto de Metadata. En caso de impacto se
sugiere la última ubicación seleccionada.

2. Modelo: Se debe seleccionar el modelo del cual se desea obtener la

información. Se debe seleccionar un modelo de PROTOTIPO o PRODUCCIÓN
para poder operar luego con GENEXUS QUERY, ya que en el modelo de diseño
no se tiene un modelo físico asociado (Data Source, Base de datos, etc.). De
todas formas se deja habilitada la opción de seleccionar un modelo de
DISEÑO, por si sólo se quiere chequear los atributos consultables que genera
GENEXUS QUERY.

3. Data Source: Se debe configurar el data source con el cual la herramienta se

conecta a la base de datos. En caso de que aplique, la herramienta le sugiere
el Data Source definido en el modelo seleccionado, pero el usuario podrá

5
GeneXus Query Manager

modificar esta opción ingresando un Data Source válido. Para los modelos
asociados a Microsoft Access se crea automáticamente el Data Source
asociado a la Base de datos. Para los demás DBMSs deberá configurarlo
manualmente.

4. Selection: Se debe de seleccionar las transacciones que integrarán la

metadata, pudiendo seleccionar todas las transacciones (opción All) o una
subselección mediante la opción Selection, permitiendo seleccionar que
transacciones se quieren analizar por la herramienta.

5. Finish: GENEXUS QUERY Manager tiene toda la información necesaria para la

carga /impacto de la metadata. En este paso muestra un resumen de todos
los seteos hechos en los pasos anteriores pudiéndose volver atrás para su
modificación. También se dispone del botón “Options” para configurar las
reglas de inferencia en el análisis de los atributos (ver Reglas de Inferencia).
Al presionar Load Metadata comienza la creación o impacto de la metadata. El
tiempo insumido dependerá del tamaño de la base de conocimiento. Al final
de la misma se presenta un análisis de impacto donde se detalla la lista de
atributos obtenida.

Nota: En todas las pantallas del wizard se incluye la opción Finish la cual permite
crear la metadata con los valores que se infieren por defecto o en caso que la
metadata ya haya sido creada trae los valores seleccionados en su creación.

Reglas de Inferencia - Loading Options

Cuando se carga la metadata quedarán disponibles para consultar por la herramienta
todos aquellos atributos que pertenezcan a las transacciones seleccionadas (ver
Selection).

Sin embargo, un atributo puede tener diferentes agregaciones en una consulta,

cuando la misma se va a visualizar en una “Pivot Table”.
Las Pivot Table, tienen 2 tipos de elementos: los ejes y los datos.
Los ejes son los elementos por los cuales se corta la información, que se pueden
pivotear, etc., mientras que los datos se sumarizan según los ejes y toman valores
para cada combinación de ejes.

Ejemplo: Ventas por Mes y por Marca. El Mes y la Marca, son ejes. Las Ventas son
datos y se sumarizan para cada Mes y Marca.

Cuando hablamos de la agregación predeterminada de un atributo en una Pivot

Table, nos referimos a si el mismo interviene como eje o como dato.

GENEXUS QUERY Manager realiza ciertas inferencias para determinar la agregación

predeterminada que tendrán los atributos en la Pivot Table.

Se determina para cada atributo lo siguiente:

6
GeneXus Query Manager

• Agregación None: Determina que el rol predeterminado del atributo será eje.
Por defecto los atributos tipo carácter, no pueden actuar con agregación
default Sum por restricción de las Pivot Tables, y porque en la gran mayoría
de los casos carece de sentido.
• Agregación Sum: Determina que el rol predeterminado del atributo será dato.
Por ejemplo los atributos con decimales seguramente tendrán como
agregación por defecto Sum. Aunque podrían seleccionarse sin agregación, es
poco probable que se quiera analizar por un valor continuo.

Figura 2 - Reglas de Inferencia

Tener en cuenta que en cualquiera de los casos lo único que se infiere es la

agregación predeterminada, o sea dónde se coloca el atributo (en los ejes o datos de
la Pivot Table) cuando se lo selecciona con doble clic en la consulta, pero siempre se
podrá ubicarlo en el rol diferente a su valor predeterminado utilizando el botón
derecho seleccionando el atributo seleccionado con la opción “Agregación”.
(exceptuando el caso de atributos del tipo carácter, a los que no se les permitirá
poner agregación alguna)

Estas inferencias se pueden manejar configurando lo siguiente:

Las posibilidades son:

• Table Keys: Indica el tipo de agregación predeterminada que se le aplicará a

los atributos que son llaves de alguna tabla. Se recomienda dejar esta
agregación en None, ya que en la gran mayoría de los casos los atributos
llaves participan sin agregación, o sea, como ejes de la consulta.
• Attributes with Decimals: Indica el tipo de agregación predeterminada que se
le aplicará a los atributos numéricos decimales. Se recomienda dejar la
agregación Sum en este caso, ya que en la mayoría de los casos participan de
esa forma en las consultas.
• No Key Integer Attributes: Indica el tipo de agregación predeterminada que se
le aplicará a los atributos enteros que no son llaves de ninguna tabla.

7
GeneXus Query Manager

Este es el caso donde no es generalizable la agregación. En los sistemas hay

atributos numéricos y enteros que representan montos o cantidades que se
desea agregar (o sea que participe como data en la consulta).
Pero por otro lado puede haber una cantidad e atributos que representan
códigos o identificadores, y que a su vez no son llaves de tablas (banderas por
ejemplo), para los cuales se desea que participen como ejes (agregación
None). En estos casos se debe poner la agregación que resulte más común
para este tipo de atributos, y a los atributos que no cumplan con esto,
cambiarle en forma individual su agregación (en el GENEXUS QUERY
Settings).

Importante: Estas inferencias y asignación de agregación por defecto se realizan

solamente cuando un atributo nuevo se agrega en la metadata, o sea se realiza para
todos los atributos en una creación de la metadata, pero para los impactos sucesivos
solo se asigna agregación por defecto a los atributos que agrega el impacto (los que
ya existían quedarán como estaban en la metadata anterior).

Generación de Folders - Loading Options

Permite indicar como se agregan los atributos en la metadata.

• One Folder per Level Transaction: genera un grupo por cada nueva
transacción.
• Flat List of attributes: Es el valor por defecto y agrega los atributos en forma
plana.

Cuando se está realizando una creación, los atributos se ordenanan alfabéticamente.

En un impacto, los atributos que ya existen, no son modificados, sólo los nuevos
atributos se ubican teniendo en cuenta la preference sin tener en cuenta el orden.
Selection
Esta opción permite seleccionar la lista de transacciones sobre las cuales desea
realizar reportes.
Las opciones son las siguientes

• All: Se cargan todas las transacciones de la base de conocimiento

seleccionada.
• Selection: Se da la posibilidad al usuario de seleccionar la lista de
transacciones cuyos atributos se desea consultar por la herramienta GENEXUS
QUERY. El usuario podrá seleccionar manualmente la lista de transacciones a
analizar.

Selección de Atributos
GENEXUS QUERY Manager filtra todos los atributos fórmulas sobre los cuales no se
van a poder realizar consultas, a continuación se detalla la lista de las mismas:

• Fórmulas Aggregate Select (Sum, Max, Min, Count, Find).

• Fórmulas expresiones condicionales (que tengan un if en su especificación).

8
GeneXus Query Manager

• Fórmulas expresiones que tengan alguna UDP en su especificación.

• Cualquier fórmula que depende de algunas de las anteriores

Esto quiere decir que sólo se cargan las siguientes fórmulas:

• Sum y Count Verticales

• Expresiones no condicionales (sin If) sin UDP

Análisis de Creación - Impacto

Al final de la generación de la metadata se mostrará el análisis de impacto o
creación donde básicamente se informa lo siguiente (ver Figura 3):

• Atributos nuevos, iguales o que dejaron de existir.

• Consultas catalogadas que ya no son válidas con la nueva estructura de la
metadata.

Figura 3 – Análisis de Impacto

Cuando existen consultas catalogadas por los usuarios, se chequean que éstas
sean válidas con la nueva metadata.

9
GeneXus Query Manager

De no ser válidas, se eliminan, pudiendo ver su especificación con el botón de

View Query Specification.

Las consultas catalogadas pueden quedar inválidas luego de un impacto por las
siguientes causas:

• Algún Atributo de la consulta ya no existe.

• No existe en la nueva Metadata relación válida entre los Atributos
especificados en la consulta.

En el diálogo del Análisis de Impacto se observan cuatro botones (ver Figura 3)

Restaurar Metadata anterior

Recupera la Metadata anterior al impacto o creación realizada.

Impresión del Análisis de Impacto

Permite imprimir el Análisis de Impacto.

Ver Detalle de Consultas

Muestra la especificación de la consulta seleccionada previamente.

Exportación/Importación de Metadatas
Cuando se implanta la solución de GENEXUS QUERY, en la organización se debe
colocar la metadata en un servidor de archivos, de forma tal que todos los usuarios
accedan al mismo directorio.

Esto tiene las siguientes ventajas:

• Centralizar el mantenimiento de la Metadata, o sea, cuando haya un cambio en el

Sistema operacional y sea necesario impactar la Metadata, esto se hará en un
único lugar y por una única vez de forma tal que quede disponible para todos los
usuarios.
• Permite compartir consultas. Las consultas se almacenan en la Metadata, por lo
tanto al tener la misma centralizada, todos los usuarios tendrán acceso a las
consultas realizadas por otros usuarios.

Sin embargo existen instalaciones donde es inviable implantar la solución de esta

manera. Un ejemplo de esto es el siguiente:

• El Sistema operacional está distribuido en varias ciudades o países y cada uno

accede a su Metadata local.
• Todos las Metadatas de las diferentes ciudades tienen la misma estructura.

10
GeneXus Query Manager

• El mantenimiento de la estructura del Sistema operacional (o sea de la base de

conocimiento GENEXUS) se realiza en forma centralizada. Cuando se realiza una
reorganización al Sistema operacional, se hace en la base de conocimiento
centralizada y se distribuye la reorganización a las diferentes ciudades.

En estos casos es necesario realizar algo similar con la Metadata.

La Metadata se mantendrá en forma centralizada también, se cargará una única vez
(cada vez que cambie la estructura del Sistema operacional y sea necesario reflejar
el cambio) y se distribuirá a las diferentes ciudades.

Cuando se trabaja con varias instalaciones independientes sobre una misma

Metadata (distribuída físicamente), es posible exportar la Metadata desde una
instalación para luego importarla en otra.

En los siguientes puntos se explica el procedimiento de Exportación e Importación.

Export Metadata
Permite exportar una metadata, se debe de seleccionar el directorio donde se ubicará
la exportación. La metadata exportada se crea en un subdirectorio denominado
MetaExp donde se almacena la siguiente información:

• MetaExp.XML: Archivo en formato XML donde se almacena la lista de

usuarios, grupos existentes en el catálogo, información relativa a la metadata
que debe ser almacenado en el catálogo como por ejemplo nombre de la
metadata, versión, paradigma, identificación de la Base de conocimiento,
modelo desde el cuál se realizó la carga de la metadata.
• GXplData.gpm: parte de la Metadata exportada incluyendo lenguaje de
usuario, configuraciones.
• PivotDir: Formato de consultas catalogadas.
• KB: Parte de la metadata.

Figura 4 – Selección del directorio para exportar una metadata

Import Metadata
Permite importar completamente una metadata, sobreescribiendo la metadata
existente. Se debe seleccionar un directorio donde se encuentra la exportación. Es
importante resaltar que al seleccionar un directorio el programa verifica que exista el

11
GeneXus Query Manager

subdirectorio MetaExp con toda la información detallada en el paso anterior.

Se actualiza el catálogo con la información relacionada en la metadata, y se actualiza
la lista de usuarios en caso de ser necesario. En caso que los usuarios válidos de la
metadata no existan en el catálogo importado se dan de alta automáticamente.

Ejemplo de utilización
Supongamos que en la casa Central se realiza una actualización de una metadata. A
continuación se detalla los pasos a seguir para actualizar las demás instalaciones a la
estructura de la nueva metadata.

Central
Se realiza un impacto de la Metadata generando una nueva versión de la misma.
Después de verificar los cambios se decide exportar la reorganización para actualizar
las sucursales. Para ello desde el producto GENEXUS QUERY Manager se selecciona
del catálogo la metadata “Producción Ventas” (por ejemplo) y se presiona Export
Metadata.

Figura 5 - Ubicación de la metadata "Producción Ventas"

En este caso se exporta la Metadata a la siguiente ubicación:

Figura 6 - Exportación de la metadata “Producción Ventas”

A continuación, es necesario distribuir físicamente el directorio

“C:\GXQuery\Exportaciones\Producción Ventas” a las distintas sucursales.

Sucursales
En cada una de las sucursales se debe de seleccionar la opción "Importar

12
GeneXus Query Manager

reorganización" (GENEXUS QUERY Settings) como se detalla en la siguiente figura:

Figura 7 - Importar Reorganización metadata “Producción Ventas”

Al presionar Aceptar se realizan las siguientes operaciones:

• Se actualizan todas las tablas asociadas a la base de datos (atributos y

asociación con la KB).
• Se actualizan los usuarios en caso de ser necesario.
• Impacta las consultas, derechos y restricciones.
• Se detalla un análisis de impacto.

Nota: La primera vez que se realiza la operación se debe seleccionar la opción

Importar Metadata Completa desde GENEXUS QUERY Settings.

Consideraciones
Las exportaciones de la Metadata, de la misma manera que las exportaciones de las
reorganizaciones de GENEXUS, no se pueden saltear. Cuando se realiza un impacto
de la Metadata, existe un estado anterior y un estado actual (estado ‘antes de
impactar’ y estado ‘después de impactar’). Cuando se exporta una metadata de la
central a las diferentes instalaciones, lo que se exporta es la reorganización de la
misma, por lo que se debe verificar que el estado anterior del último impacto en la
central sea el mismo que el estado de las ciudades. En caso que GENEXUS QUERY
Settings detecte que no coincide la reorganización que se desea aplicar se
desplegará un mensaje de error adecuado.

GENEXUS QUERY Settings

El GENEXUS QUERY Settings es un módulo de administración de las herramientas
GENEXUS QUERY. Sus tareas principales son setear las propiedades del ambiente
(DBMS, Data Source etc.), propiedades de los atributos y seguridad, o sea el acceso
permitido a cada usuario a los atributos existentes.
(Ver el manual del GENEXUS QUERY Settings, para información detallada de sus
funciones).

13
GeneXus Query Manager

ANEXO I – INTEGRACION CON GENEXUS

Es posible trabajar con GENEXUS QUERY desde GENEXUS 7.5 o superior de forma
integrada. De esta forma incorporamos a las consultas dinámicas como parte
integrante del desarrollo de nuestras aplicaciones.

Para ello cada vez que se realiza un impacto en la base de datos en un modelo
GENEXUS, se permite generar/impactar la metadata de GENEXUS QUERY, asociada al
modelo, en forma transparente para el usuario.
Se podrá invocar en cualquier momento al GENEXUS QUERY permitiendo realizar
consultas dinámicas sobre todos los atributos del modelo GENEXUS.

Descripción
Desde GENEXUS se invoca automáticamente o a pedido el GENEXUS QUERY Manager
(para generar la metadata) y el GENEXUS QUERY (para realizar consultas dinámicas).

Se agregan nuevas opciones a GENEXUS en la barra de herramientas Tools.

Figura 8 - Nuevas opciones

• Query Manager: Ejecuta GENEXUS QUERY Manager.

• GX Query: Ejecuta Excel para utilizar GENEXUS QUERY.

14
GeneXus Query Manager

¿ Cómo funciona GENEXUS QUERY desde GENEXUS?

Prototipo
Para los modelos de tipo “Prototipo” el funcionamiento de la herramienta es a pedido.
Una vez realizada la instalación, la primera vez que se genere un impacto/creación
de cada modelo, al finalizar la misma, se desplegará un mensaje indicando si se
desea ejecutar el producto GENEXUS QUERY Manager para crear una metadata
asociada al modelo, como detalla la siguiente figura:

Figura 9 - Reorganización de una Metadata

Las posibilidades son las siguientes

• Yes: Procede a ejecutar GENEXUS QUERY Manager desplegando en la Status

Bar de GENEXUS el siguiente mensaje .
• No: Se saltea la ejecución de GENEXUS QUERY Manager.
• Don’t ask me again: Esta opción decide si se desplegará nuevamente esta
opción ante un nuevo impacto o creación de la base de datos asociada al
modelo. Esta opción implica que no se ejecute nunca o ejecutarlo siempre.

Es importante resaltar que esta opción se configura por Base de conocimiento /

modelo.

Si desea cambiar esta configuración podrá acceder a GENEXUS QUERY Manager y

seleccionar la opción Tools, Options.

Figura 10 – Opciones de Ejecución de GeneXus Query

15
GeneXus Query Manager

Es importante resaltar que esta opción sólo es válida en caso de acceder al producto
desde GENEXUS. Por defecto en la instalación se configura el valor Ask me.

• Ask me: Despliega la Figura 9 al finalizar una reorganización.

• Always: Siempre ejecuta GENEXUS QUERY Manager; es equivalente a
responder Yes y marcar Don’t ask me again.
• Never: Nunca se ejecuta; equivalente a responder No y marcar Don’t ask me
again.

Producción
Para los modelos de tipo “Producción” el valor por defecto es ejecutar GENEXUS
QUERY Manager siempre; por lo que al finalizar la actualización del modelo
directamente se crea/actualiza la metadata. Si desea modificar esta configuración
deberá modificar el parámetro de la Figura 10.

Catálogos y Metadatas
Cada Base de Conocimiento GENEXUS mantenida con la versión 7.5 tiene un
identificador de Kb único. GENEXUS QUERY Manager accede a esta información al
realizar un impacto por lo que le permite saber sobre que metadata hacer el impacto.
Por defecto, se genera una metadata por cada para KB/Modelo, sobre el catálogo que
se encuentre activo.

El nombre de la metadata que se asigna es la descripción de diseño con la

descripción del modelo que se está impactando.

Consideraciones
• La integración sólo es válida para cualquier Base de Conocimiento mantenida
con GENEXUS 7.5 o superior.
• La llamada a GENEXUS QUERY Manager se realiza en las siguientes
condiciones en caso que esté configurada:
o Después de realizar el impacto.
o Llamando explícitamente desde Tools / Query Manager.
• La llamada a GENEXUS QUERY es a pedido y permitirá consultar todos los
atributos de la base de conocimiento.
• Al ejecutar GENEXUS QUERY Manager a pedido desaparece GENEXUS, y hasta
que no se cierre esta aplicación no se activa nuevamente.
• No es posible definir qué atributos se van a exportar desde GENEXUS. El valor
predeterminado es Todos los Atributos, sin embargo, se puede configurar
desde el GENEXUS QUERY Manager, mediante el Wizard de Carga de
metadatas. Una vez seteado esto en el GENEXUS QUERY Manager, se
mantendrá siempre que se impacte esa metadata.
• Si GENEXUS QUERY no se encuentra correctamente instalado aparecerá el
siguiente error al intentar seleccionar las herramientas desde el diálogo
asociado “Error: Tool interface not supported”, debiendo realizar una
reparación de la instalación desde el Panel de Control.

16
GeneXus Query Manager

• No es posible modificar el catálogo si se trabaja integrado a GENEXUS.

Como el GENEXUS QUERY Manager analiza todas las transacciones en cada
impacto, para modelos grandes, el tiempo de carga de la metadata puede ser
importante. En este caso se recomienda realizar la carga de la metadata a
pedido y no en cada impacto.
• Cuando se crea la metadata se infiere automáticamente de las preferences del
modelo GENEXUS las propiedades de conexión. En caso de utilizar Microsoft
Access se configura automáticamente un Data Source con nombre “KBName-
ModelName" referenciando la base de datos.

17
GeneXus Query Manager

ANEXO II – GENERACION DE TRACE

En caso de necesitar realizar un análisis detallado de las operaciones realizadas por

GENEXUS QUERY Manager podrá generar un archivo de trace con los pasos
realizados.

La forma de establecer opciones de trace es mediante la inclusión de la sección

[Tracing] en el archivo Config.ini del directorio PROGRAM donde está instalado el
producto.
Las opciones que se pueden setear en la sección anterior son:

ManagerLevel=0/4 Esto genera trace sobre GENEXUS QUERY Manager. Hay

cuatro niveles de detalle diferentes. 0 significa no generar
trace, 4 es el de mayor información.
TraceTime=0/1 Si se setea en 1, imprime para cada mensaje del trace la
fecha y hora en que se realizó cada llamada.
ManagerTraceFile=XXX Se especifica el directorio y el nombre del archivo donde
se generará la salida.
De no especificarse esta línea, la salida se genera en el
archivo GxplTrace.txt y queda ubicado en el mismo
directorio PROGRAM de la instalación. En caso que el
directorio al cual se hace referencia no exista, no se
genera trace. En caso que el archivo ya exista, la
información generada será anexada al archivo.

18