PDF de programación - Data View Generator - Manual de Usuario

Data View Generator

Manual de Usuario

Versión 1.2

Julio de 1999

Data View Generator

Manual de Usuario

CONTENIDO

GENERALIDADES.......................................................................................................................................................... 3
DISTRIBUCIÓN E INSTALACIÓN .................................................................................................................................. 4
REQUERIMIENTOS........................................................................................................................................................ 4
GENEXUS DATA VIEW GENERATOR WIZARD ......................................................................................................... 5
Página 1 ...................................................................................................................................................................5
Página 2 ...................................................................................................................................................................6
Página 3 ...................................................................................................................................................................7
Página 4 .................................................................................................................................................................10
Conflictos: Nombres duplicados ......................................................................................................................... 11
Conflictos: Problemas de normalización ............................................................................................................. 11
Conflictos: Interpretación de los tipos de datos .................................................................................................. 11
Funcionamiento de las reglas .............................................................................................................................. 11
Modificación del alcance de una regla ................................................................................................................ 19
Modificación del orden de aplicación de las reglas ............................................................................................ 20
Reglas de sustitución de tipo/largo de los atributos. ........................................................................................... 21
Página 5 .................................................................................................................................................................23
TRACE CONFIGURATION (GENEXUS DB ACTIVITY TRACE)................................................................................ 24
Modo de activación..............................................................................................................................................24

2

Data View Generator

Manual de Usuario

Generalidades

Esta herramienta es la sucesora del File View Generator. Sustituye tanto al ODBC File View Generator
como al AS/400 File View Generator.
El objetivo es similar a su predecesor, es decir, poder aplicar ingeniería inversa sobre bases de datos
existentes. A partir de la definición de las tablas, índices, etc. de una base de datos, se pueden generar
objetos GeneXus (Data Views y/o transacciones, atributos, tablas, índices, etc.).

Las principales mejoras respecto a su predecesor son:

1. Puede ser ejecutado independientemente de GeneXus.
De este modo esta aplicación puede ser utilizada en cualquier máquina, incluso que no tenga GeneXus
instalado. Luego, los XPWs (archivos de distribución de conocimiento) pueden ser consolidados en
cualquier otra máquina que si tenga GeneXus.

2. La interfaz es muy superior.
Se provee de un wizard de generación de objetos GeneXus, de este modo resulta mas fácil e intuitiva la
aplicación de la ingeniería inversa.

3. Puede utilizarse tanto con ODBC como con OLEDB.
La tecnología ODBC es bien conocida por los clientes GeneXus, sin embargo esta herramienta incluye la
posibilidad de conexión vía OLEDB.
Además en un futuro soportará otras fuentes de datos no relacionales (mainframe ISAM/VSAM,
servidores de e-mail, custom business objects, etc.)

4. Es una herramienta 32 bits.
Resulta particularmente importante ya que, en AS/400, se elimina el requerimiento de tener Client Access
con Soporte 16 bits instalado, con cualquier driver ODBC 32 bits que tenga conexión al AS/400 se puede
utilizar esta herramienta.

5. Permite la resolución de conflictos por nombres de objetos y tipos de datos de los atributos.
Por ejemplo: se puede establecer que todos los atributos cuyo nombre empiece por “Cli” se sustituya por
“Cus”, etc.
Es similar al “Adapt From” (feature incluída en la versión 6 Ev 1 de GeneXus), sin embargo a diferencia de
la misma no accede a la Knowledge Base. O sea, toda la detección de conflictos, corrección de los mismos,
rename de objetos, etc., se lleva a cabo en el XPW que se produce al final del proceso. En el Adapt From se
establecen las reglas y luego se procesa (consolida) el XPW, dando posibles conflictos con el conocimiento
que ya existía en la KB.
Por mas detalle al respecto referirse a las Release Notes de la Versión 6 Ev 1, en la parte referente al
Adapt From

3

Data View Generator

Manual de Usuario

Distribución e instalación

Esta herramienta consta de un SETUP independiente de GeneXus. Una vez ejecutado el mismo se crean
dos íconos: “GeneXus Data View Generator” y “Trace Configuration”.
El primero de ellos es la herramienta en si, el segundo es un EXE provisto para realizar trace de los
posibles errores, solo en este caso debería ser utilizado.
Se puede ejecutar tanto desde dentro de GeneXus (opción Tools\Data View Generator, estando en el
modelo de diseño) como por afuera (a través del icono).

Requerimientos

Se requiere tener instalado el MicroSoft Data Access 2.0 o superior. El mismo puede ser obtenido
gratuitamente de http://www.microsoft.com/data/mdac2.htm.

NOTAS:
• muchos productos (ODBCPack de Microsoft,Developer Studio 6.0, drivers de Intersolv 3.0, etc.)
instalan todo lo necesario. Como consecuencia es muy probable que Ud. ya cuente con la tecnología
necesaria sin necesidad de obtener productos extra.

• En esta versión del DVG el driver de Oracle no es soportado, se debe utilizar el driver de Intersolv

para acceder a Oracle.

Tip: un modo fácil de saber si se tienen los requerimientos para ejecutarlo es utilizar el ODBC
Administrator, en el tab “About” los “ODBC core components” deberán ser versión 3.5 o superior.

4

Data View Generator

Manual de Usuario

GeneXus Data View Generator Wizard

Este es un wizard que consta de 5 páginas, a continuación se detallan las mismas y las funcionalidades
que se pueden obtener de cada una.

Página 1

Objetivo: establecer la conexión.

Figura 1 - Página 1 del Data View Generator Wizard

En esta primer página se selecciona el modo de conexión a utilizar (ODBC u OLEDB) así como todo lo
necesario para realizar la conexión a la base de datos que contiene las tablas a “importar”.
Al seleccionar el modo de conexión aparecerán todos los DataSources disponibles (si se eligió ODBC) o
los OLEDB Providers (si se eligió OLEDB).
Se debe seleccionar uno de la lista, ingresar el usuario/password y presionar el botón “Next”.

En caso de haber utilizado previamente el DVG y haber salvado la información de conexión, entonces se

5

Data View Generator

Manual de Usuario

puede utilizar el botón OPEN con el cual se recuperará dicha información.
Página 2

Objetivo: Seleccionar las tablas y vistas lógicas a “importar”

Figura 2 - Página 2 del Data View Generator Wizard

En esta página aparecen dos ventanas, la de la izquierda muestra las tablas base de datos, schemas, tablas,
vistas lógicas, etc. disponibles para ser importadas.

Tip: La información que aparece en la ventana izquierda depende del usuario que se ha conectado a la
base de datos y del DBMS que se esté utilizando.
En particular en AS/400 se verán las tablas de aquellas bibliotecas que se hayan especificado, a nivel de
DataSource, en la opción “Default Libraries” del Tab “Server”. Recuerde comenzar la lista de bibliotecas
con una coma “,”, en caso contrario puede presentarse el siguiente error: “SQL0204 – QCMDEXC in
XXX type *N not found”

En la ventana derecha se mostrarán las tablas seleccionadas para importar. El usuario debe seleccionarlas
en la ventana izquierda (doble click). Es posible seleccionar el schema (o biblioteca en el caso del

6

Data View Generator

Manual de Usuario

AS/400) en cuyo caso se incluirán todas las tablas del mismo.

El botón SAVE tiene como objetivo salvar la información ingresada hasta el momento (conexión y lista
de tablas seleccionadas). El archivo donde se salvará dicha información tiene extensión GDC (GeneXus
DVGenerator Configuration).
En futuras utilizaciones del DVG se podrá abrir dicho archivo (botón OPEN de la página 1) y no hay
necesidad de repetir la operación de selección.

Tip: Si se está utilizando el DVG con el DB2/400 recuerde configurar el DataSource para que utilice el
“System naming Convention (*SYS)” en la página “Format” la opción “Naming convention”.
En caso contrario puede aparecer el error “SQL5016 Object name GXRCDFMT not valid for naming
option” o “SQL0204 – QCMDEXC in XXX type *N not found”
Ademas, dependiendo de la versión del Client Access utilizada (por ejemplo: 3.2) aparecerá un “tab”
llamado “Other (2)” en el cual se puede configurar el tipo de conexión (normalmente están los valores:
“read/write”, “read/call” y “read Only”) se debe utilizar “read/write” o “read/call”.

Página 3

Objetivo: Configurar los parámetros de importación

Figura 3 - P