Data View Generator Manual de Usuario
Contents
1. 21 Data View Generator Manual de Usuario lx Data Yiew Generator Wizard 4 of 5 j e Y No objects pa lt Back Cancel Help Figura 13 Ejemplo de di logo sin conflictos NOTA recuerde utilizar el bot n SAVE para salvar las reglas ingresadas en caso contrario si necesita volver a importar el conocimiento de esa base de datos deber ingresar todas las reglas nuevamente Tip A pesar de no existir conflictos se pueden aplicar reglas de renombre Opci n Rename del men popup de objetos para cumplir con el est ndar de la KB que consolidar ese XPW o por cualquier otro motivo que se requiera cambio de idioma atributos que se llaman diferente se deber an llamar igual etc MODIFICACI N DEL ORDEN DE APLI CACI N DE LAS REGLAS Es importante destacar que las reglas aplican sobre los nombres internos Por este motivo es fundamental el orden de aplicaci n de las mismas Supongamos que se tienen las reglas sustituir A por B y otra regla que sea sustituir B por C en ese orden Se tienen los objetos A B C y D Al aplicar las reglas suceder lo siguiente A pasar a ser B regla 1 este B pasar a ser C regla 2 B pasar a ser C regla 2 22 Data View Generator Manual de Usuario El resultado final es C C C y D Si se cambia el orden de modo que queden las reglas sustituir B por C y sustituir A por B en2. string reemplazarlo Es decir se buscar n todos los objetos cuyo nombre coincida con lo ingresado en Find What y se reemplazar el nombre interno o parte del mismo por el string ingresado en Replace With El texto ingresado en Find What ser buscado dentro del nombre del objeto en funci n de la selecci n realizada en el recuadro de Modifiers seg n el siguiente detalle e Posici n e Begins with busca los nombres de objeto que empiecen con el texto ingresado e Ends With busca los nombres de objeto que terminen con el texto ingresado ver GIK Word e Contains busca los nombres de objetos que contienen en cualquier parte el texto ingresado e sEqualto busca los nombres de objeto que coincidan exactamente con el texto ingresado esto ser a similar a una regla particular las cuales se detallan m s adelante en este documento e GIK word se reconoce el formato GIK para los nombres es decir las letras may sculas se asumen como separadores Ejemplo si se busca el string CLI y se marca este check box entonces el objeto CliCod cumplir con el patr n mientras que ClientesNac no ya que CliCod cumple el formato GIK e Match Case la b squeda se realizar considerando exactamente la combinaci n de may sculas y min sculas del texto ingresado 16 Data View Generator Manual de Usuario Stop after apply si est marcado y se aplica la regla el resto de las reglas que
3. existan para el objeto se descartan En nuestro ejemplo solo ingresamos Rule definition Figura 7 Ejemplo de definici n de regla de sustituci n Una vez ingresada la misma bot n OK aparecer en la parte superior de la pantalla y mediante el bot n Apply se aplica ejecuta la regla 17 Data View Generator Manual de Usuario El resultado luego de la ejecuci n se muestra en la figura siguiente Data View Generator Wizard 4 of 5 v Show rules Find Replace Global Applied Case Modiier PK_DGNIW Begins with Save Open Apply _Ststios Add Edit Copy Delete Up Down Database objects name edited y Intemalname Extemalname Description Conflicts with_ Object type DGNIY1_DGNiv1 DGNiv1 No conflict Attribute DGNIY2_DGNivl DGNIivl No conflict Attribute DGNIY2_DGNiv2 DGNiv2 No conflict Attribute DGNIW3_DGNivl DGNivi No conflict Attribute DGNIY3_DGNiv2 DGNiv2 No conflict Attribute DGNIYV3_ DGNiv3 DGNIiv3 No conflict Attribute lt Back Cancel Help Figura 8 Resultado de aplicaci n de regla de sustituci n Como vemos en el ejemplo los conflictos con los objetos PK__DGNIV han desaparecido Si se desea ver como ha quedado resuelto cual es el rename que se producir se puede marcar el check box Modified y se obtendr la siguiente pantalla En este di logo se puede ver cuales ser n los cambios qu
4. 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 mediante el 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 SQLO204 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 Data View Generator Manual de Usuario Data Yiew Generator Wizard Page 3 of 5 E xj Export file Directory CATMP ES Folder Importados m Transactions Attributes Y Generate Data Views Significant name length fro v Retrieve index information s E Magimum numeric length 18 V Generate Transactions 4 i a Attributes Sign Y Identify multilevel
5. una relaci n renombrar ambos atributos para que GeneXus interprete que son dos concetos diferentes CONFLICTOS INTERPRETACI N DE LOS TIPOS DE DATOS Para GeneXus los tipos de datos que existen son Num rico Date DateTime Car cter VarChar y LongVarchar En muchos DBMS no existen esos tipos de datos o existen variaciones a los mismos Por ejemplo en Oracle no existe el tipo de datos Date entonces los Date de GeneXus son creados como DateTime en Oracle Al realizar la ingenier a inversa GeneXus no puede saber que el atributo que Oracle le dice que tiene tipo DateTime debe ser representado como un Date de GeneXus y no como un DateTime de GeneXus Las reglas de transformaci n podr an ser utilizadas para aclarar estas ambig edades FUNCIONAMIENTO DE LAS REGLAS La p gina 4 despliega los objetos que ser n generados El combo Database Objects permite visualizar todos los objetos valor All o solamente los conflictos definiciones de subtipos advertencias modificados o con nombre editado Los posibles mensajes de error o warning a encontrar en la columna Description del di logo son e No Conflict No existe ningun conflicto para ese objeto e Name conflict Dos objetos tienen el mismo nombre interno considerando la 13 Data View Generator Manual de Usuario unicidad de los mismos seg n la cantidad de caracteres indicados en el name length del tipo de objeto p gi
6. Data View Generator Manual de Usuario Versi n 2 2 2 Mayo del 2002 Data View Generator Manual de Usuario CONTENIDO Generalidades Distribuci n e instalaci n Requerimientos GeneXus Data View Generator Wizard P gina 1 P gina 2 P gina 3 P gina 4 Conflictos Nombres duplicados 12 Conflictos Problemas de normalizaci n 13 Conflictos Interpretaci n de los tipos de datos 13 Funcionamiento de las reglas 13 Modificaci n del alcance de una regla 2120 Modificaci n del orden de aplicaci n de las reglas 2224 Reglas de sustituci n de tipo largo de los atributos 2322 P gina 5 2625 unnan A A y Trace Configuration GeneXus DB activity trace 2726 Data View Generator Manual de Usuario Generalidades Esta herramienta permite 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 los objetos GeneXus Data Views y o transacciones atributos tablas ndices etc Utiliza la tecnolog a ODBC para acceder a estos dotos Esta aplicaci n puede ser utilizada desde GeneXus en el modelo de Dise o o tambi n desde cualquier m quina incluso que no tenga GeneXus instalado En este caso se generan los archivos de distribuci n de conocimiento archivos xpw que luego pueden ser consolidados en cualquier otra m quina que si tenga GeneXus Permite tambi n la resoluci n de
7. a cuantas posiciones d gitos tendr el num rico m s grande a importar Si alg n atributo supera ese l mite se importa con la cantidad de posiciones que se incluya en este par metro Ejemplo se tiene un Num rico de 20 y se configura como Maximum numeric Length 15 entonces ese atributo ser definido como N 15 Attributes sign los atributos en la base de datos no tienen signo al importarlos estos check boxes controlan a cuales se les agregar signo y a cuales no Attributes without decimal places los atributos que no tengan decimales se definir n con signo Attributes with decimal places los atributos que tengan decimales se definir n con signo Enlarge Picture se agrandar la picture una posici n Z m s en todos los atributos num ricos General Generate schema se incluir en la informaci n de las tablas e ndices importados el schema al cual pertenecen salvo en AS 400 en el cual no existe el concepto de schema Generate Location se incluir en la informaci n de la tabla e ndices importados el nombre de la base de datos a la cual pertenecen En AS 400 este nombre en realidad es el nombre de la biblioteca Tip si se marca cualquiera de estos dos check boxes las tablas ser n calificadas es decir se utilizar schema tabla o biblioteca tabla Por este motivo es recomendable NO marcar ese check box si se utilizar n las tablas de otros schemas bibliotecas Por ejemplo cuando se importa la informac
8. 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 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 crea el cono GeneXus Data View Generator Adem s se puede ejecutar desde dentro de GeneXus opci n ToolsiData View Generator estando en el modelo de dise o Requerimientos Se requiere tener instalado el MicroSoft Data Access 2 6 o superior El mismo puede ser obtenido gratuitamente de http www microsoft com data NOTA e 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 t
9. de alcance de una regla En este di logo se puede determinar el alcance scope de la regla es decir sobre que objetos se va a aplicar Para ello existen dos grillas la de la izquierda muestra los objetos disponibles y un filtro para acotar dicha lista La de la derecha muestra los objetos sobre los cuales aplicar la regla En este ejemplo se aplicar la regla cambiar BANCOSN por BAN solo para la transacci n PRIMARI1 De este modo se puede acotar el alcance de una regla es decir determinar sobre 20 Data View Generator Manual de Usuario que objeto o grupo de objetos aplicar la misma Tip en cualquier momento se pueden salvar las reglas ingresadas hasta el momento para ello se utiliza el bot n SAVE que crea un archivo con extensi n GMR GeneXus Mapping Rule Set MODIFICACI N DEL ALCANCE DE UNA REGLA Data View Generator Wizard 4 of 5 i x 0 Banco IBANCOS2 Duplicated Na BANCO Index 0 Banco IBANCOS1 Duplicated Na BANCO Index 0 BANCOS BANCOSNAC Duplicated Na BANCOS Table 0 Bancos BANCOS Duplicated Na BANCOS Table lt Back Cancel Help Figura 12 Resultado de aplicaci n de reglas Como se puede ver en este di logo el conflicto a nivel de esas transacciones desapareci sin embargo siguen existiendo otros conflictos Para resolverlos se ingresan reglas globales y particulares de modo tal de llegar al estado No objects en conflict como se ve en el di logo siguiente
10. e se producir n objetos marcados con Ejemplo el ndice cuyo nombre externo es PK__DGNIV1__78D3EB5B quedar con nombre interno P1U_78 18 Data View Generator Manual de Usuario Ejemplo Definici n de Regla Particular Volviendo a la pantalla que muestra solo los conflictos Valor Conflict en Database Objects tenemos lo siguiente Data Yiew Generator Wizard 4 of 5 p x 0 Banco IBANCOS2 Duplicated Na IBANCO IBANCO IBANCOS1 Duplicated Na IBANCO Index 0 BANCOS BANCOSNAC Duplicated Na BANCOS Table 0 Bancos BANCOS Duplicated Na BANCOS Table 0 BANCOS BANCOS Name conflict BANCOSN Transaction 0 BANCOSN BANCOSNAC Name conflict BANCOS Transaction Figura 9 Otros Conflictos luego de aplicar regla de sustituci n En este caso los conflictos con los ndices desaparecieron sin embargo quedan pendientes de resolver otros conflictos Por ejemplo la tabla BANCOS generar una transacci n con el nombre BANCOS al igual que la tabla BANCOSNAC generar una transacci n BANCOSN El problema es que ambas coinciden en sus 6 primeras letras que es el maximo definido para objetos en esta ejecuci n del Data View Generatosr Por este motivo se muestra en la primer l nea de la parte superior que BANCOS genera conflicto con BANCOSN y en la segunda que BANCOSN genera conflicto con BANCOS Podr amos aplicar una regla global como la vista anteriormente tra
11. ecnolog a necesaria sin necesidad de obtener productos extra 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 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 Data View Generator Wizard Page 1 of 5 Enter connection information to access database Open Daesowce ejemplo o A Database connection status Cancel Help Figura 1 P gina 1 del Data View Generator Wizard En esta primer p gina se indica la informaci n necesaria 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 todas las fuentes de datos Data Sources disponibles Se debe seleccionar uno de la lista ingresar el usuario password y presionar el bot n Next Data View Generator Manual de Usuario En caso de haber utilizado previamente el Data View Generator y haber salvado la informaci n de conexi n entonces se 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 importa
12. guientes patrones 1 La llave primaria de cada nivel subordinado debe ser un superset de la llave primaria del nivel superordinado Ejemplo Tabla 1 Nivel superodinado Tabla 2 Nivel subordinado FacNro FacNro FacFch FacNroLin Facl mpLin 2 El nombre de la tabla de las l neas subordinada debe estar contenido en el nombre de la tabla del cabezal superordinada sin considerar los n meros finales en el nombre de ambas Ejemplo que cumple Nombre de tabla Se incluye en transacci n Facturas Facturas Factural Facturas Ejemplo que no cumple Nombre de tabla Se incluye en trn FacCab FacCab Data View Generator Manual de Usuario FacLin FacLin 3 No deben existir atributos redundantes del nivel subordinado en el nivel superordinado NOTA Independientemente de que el Data View Generator reconozca tablas como multilevel el desarrollador puede editar a posteriori las transacciones para dise arlas como mejor representen su realidad Maximum Name Length Esto determina a cuantos caracteres se determinar la unicidad del nombre Por ejemplo si se ingresa 5 la unicidad del nombre de las transacciones se controlar en los 5 primeros caracteres NOTA Esta opci n tanto como la table name length etc existe s lo por compatibilidad con versiones anteriores de GeneXus es recomendable no modificarlas y dejar los valores por defecto Si fue ejecutado desde GeneXus entonces este valor coincide con e
13. i n de una tabla que est en la biblioteca COMPRAS pero luego se quiere utilizar la tabla de la biblioteca VENTAS y se calific no se podr hacer puesto que la apertura de la tabla es biblioteca tabla P gina 4 Objetivo Resolver los conflictos 11 Data View Generator Manual de Usuario Data Yiew Generator Wizard 4 of 5 Find Replace Global Applied Case Moditer Save Open Apply gt Statistics dd Edit Copy Delete Up Down Database objects warming X R Conflicts with_ Object type No objects lt Back Cancel Help Figura 4 P gina 4 del Data View Generator Wizard Al generar objetos GeneXus a partir de una base de datos se pueden generar conflictos principalmente en tres aspectos 1 Nombres duplicados 2 Problemas de normalizaci n nomenclatura 3 Necesidad de cambio de tipo largo CONFLI CTOS NOMBRES DUPLI CADOS Los objetos en GeneXus transacciones procedimientos etc se identifican por la cantidad de caracteres indicados en la preferencia de dise o Significant object name Length por defecto 30 caracteres Los atributos se identifican por la cantidad de caracteres indicados en la preferencia de dise o Significant attribute name Length por defecto 30 caracteres y el resto Data View tablas e ndices se identifican por los caracteres indicados en la preferencia de dise o Significant table name Length Es decir q
14. l ingresado en la preferencia Significant object name Length configurada en el modelo de dise o y aparece deshabilitado Tip se controla que en los nombres de las transacciones los primeros 7 caracteres sean nicos y en el nombre de los data Views los 8 primeros La finalidad de este check no es determinar cuantos caracteres hacen nico el objeto sino cuantos caracteres en total tendr el nombre del objeto Tables Name Length idem que Maximum namelength de transacciones Si fue ejecutado desde GeneXus entonces este valor coincide con el ingresado en la preferencia Tables name Length configurada en el modelo de dise o y aparece deshabilitado Indexes Name Length idem que Maximum name length de transacciones Si fue ejecutado desde GeneXus entonces este valor coincide con el ingresado en la preferencia Tables object name Length configurada en el modelo de dise o y aparece deshabilitado When unknown file type Ignore file Ignore attribute Con este radio button se determina el comportamiento a tener en caso de encontrar un tipo de datos desconocido para GeneXus El primero de los valores produce que no se importe la informaci n de esa tabla y el segundo valor es para importar dicha informaci n pero ignorando el atributo de tipo desconocido Attributes Maximum Name Length idem que Maximum name length de transacciones 10 Data View Generator Manual de Usuario Maximum Numeric Length determin
15. lejas que tomen en cuenta el largo del atributo y agregarle o restarle posiciones cambiar los decimales etc Por ejemplo en AS 400 los atributos tipo Date aparecen almacenados por GeneXus como un Character de 8 Entonces se establece la siguiente regla Rule definition Character E o ol z Figura 15 Ejemplo de sustituci n de tipo Pero esto modificar todos los atributos C 8 y los definir como Date entonces se decide definir el scope de la regla secci n Scope buscando aquellos que digan FCH FEC etc en su nombre como se ve en el siguiente di logo 24 Data View Generator Manual de Usuario Rule definition FCHDOC Figura 16 Ejemplo de definici n de alcance para regla de sustituci n de tipo De este modo la regla se aplicar solo sobre los atributos seleccionados 25 Data View Generator Manual de Usuario P gina 5 Objetivo mostrar un log de la informaci n generada Dataview Generator Wizard Page 5 of 5 GenexXus Dataview Generator Generation report Exporting attribute TMPTIPO Exporting attribute TMPNRO Exporting attribute TMPNOM Exporting index S YS_C00605 Exporting index 4GENTMPN Exporting table SISCLI 4NTECLA1 Exporting attribute ANTID Exporting attribute ANTLINNU M Exporting attribute ANTE MP Exporting attribute ANTRAM Exporting attribute ANTCAR Exporting attribute ANTTAR Exporting att
16. na 3 del DVG e Duplicated Name Dos objetos tienen exactamente el mismo nombre interno independientemente del name length WARNING Aparecer este mensaje cuando exista definida una relaci n de integridad referencial en la base de datos entre dos atributos de diferente nombre y un ndice por clave primaria en uno de ellos e Same name with different type Dos atributos de diferente tipo o largo tienen el mismo nombre interno Esto podria pasar luego de cambiar nombres o definir reglas directamente en el Data View Generator e Duplicated Attribute Dos atributos de diferente nombre y mismo tipo tienen el mismo nombre interno WARNING Habilitando el check box Show Rules se despliega la seccion donde se definen las reglas Secci n Rules En la parte inferior se visualizan las reglas que el desarrollador haya ingresado Las reglas son de dos tipos particulares o globales Las primeras aplican a un objeto o grupo de objetos determinados y las globales a todos los objetos Para crear una nueva regla se puede utilizar el bot n add ver Figura 6Figura o presionando bot n derecho sobre un objeto y seleccionando la opci n Create Rule En el primer caso la regla a establecer por defecto es global en el segundo caso por defecto es particular al objeto seleccionado en ese momento Reglas de sustituci n de nombres Un objeto tiene un nombre interno nombre del objeto en la base de conocimiento GeneXus y un nombre extern
17. o nombre en la base de datos Por defecto ambos se definen iguales incluso el nombre de las transacciones las cuales no existen en la base de datos estar dado por el nombre de la tabla del primer nivel de la misma Estas reglas b sicamente buscan un string en el nombre interno del objeto y lo sustituyen por otro en el nombre interno 14 Data View Generator Manual de Usuario Ejemplo Definici n de Regla Global Data View Generator Wizard 4 of 5 v Show rules Find Feplace Global Applied Case Modifer Save Open Apply gt j Statistics Delete Down Database objects conflict y Description Conflicts with 0 PKU_DG PK_DGNIV4_7BB Duplicated Na 0 PKU_DG PK_DGNIV3_7A4B Duplicated Na OP PKU_DG PK_DGNIY2_79C Duplicated Na PKU_DG PK_DGNIV1_78D Duplicated Na lt Back Cancel Help Figura 5 Conflicto de nombres En esta figura se muestra el conflicto en los nombres de ndices pues sus nombres internos coinciden en los primeros seis caracteres Se decide establecer una regla que sustituya PK__DGNIV por P Para ello se utiliza el bot n add parte inferior de la pantalla con lo cual aparecer el siguiente di logo 15 Data View Generator Manual de Usuario Rule definition Figura 6 Di logo de Definici n de Reglas En la secci n Name Substitution de este di logo se puede establecer qu string buscar y por qu
18. r Data View Generator Wizard Page 2 of 5 i x Available Tables Views V Show Views Selected TablesViews 3 Selected ENRECA ENREER ENREMO ENVCO2 ENVMED ENVREC FACCAB FACLAB FALCAU FMAING GPANRE GRPENU GRPEPE GRPPA1 GRPPA2 GRPPAQ HSTFA1 HSTFAC HSTSD1 HSTSDO IMPGA1 IMPGAL coca o 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 seg n la conexi n definida previamente 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 un Server Recuerde comenzar la lista de bibliotecas con una coma en caso Data View Generator Manual de Usuario contrario puede presentarse el siguiente error SQLO204 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 mediante doble click Es posible seleccionar el schema o biblioteca en el caso del AS 400 en cuyo caso se incluir n todas las tablas del mismo El bot n SAVE tiene como objetivo salvar la informaci n
19. ribute ANTCON Exporting attribute ANTFCHING Exporting attribute ANTFCHEGR Exporting attribute A4NTMOTEGAR Exporting index SYS_C00D608 Exporting index lANTIDFC Cancel Help En esta p gina la ltima del Data View Generator se muestra un log del archivo XPW generado Si el Data View Generator fue ejecutado desde GeneXus al dar Finish el mismo ser consolidado en la KB desde donde se ejecut Si fue ejecutado por fuera de GeneXus simplemente termina la aplicaci n habiendo generado el XPW con la informaci n en el directorio indicado en la pagina 3 Este puede ser consolidado en cualquier KB incluso utilizando versiones 5 6 o 6 0 de GeneXus El bot n SAVE tiene como objetivo salvar la informaci n de conexi n selecci n de tablas y opciones utilizadas NOTA NO salva las reglas las mismas deben haber sido salvadas en la p gina anterior 26 Data View Generator Manual de Usuario Trace Configuration GeneXus DB activity trace Esta facilidad permite generar informaci n de diagn stico trace de forma de hacer m s r pida y efectiva la labor de detecci n y reporte de fallas en el funcionamiento del Data View Generator Para ejecutarlo dar doble click en el archivo gxtrccfg exe que se encuentra en el directorio donde se instal el Data View Generator Por m s informaci n http www artech com uy gxdlsp pub genexus ClientServer Docum ReleaseNotes 7 5 Trace htm 27
20. ructura para cada tabla a importar Retrieve Index Information si este check box est marcado significa que para cada tabla a importar se importar n tambi n todos los ndices de la misma primario claves for neas de usuario etc Adem s al marcarlo se pueden generar tambi n las transacciones asociadas a las tablas en caso de no marcarlo no se recuperar la informaci n de los ndices y por consiguiente no se podr n generar las transacciones Las tablas ser n importadas como Data Views pero no se asociar n a tablas de la KB Tip si NO se importan los ndices o sea que no se asocian las Data Views a tablas de la KB las tablas importadas solo pueden ser accedidas con comando Xs Xfor Each Xnew etc Es recomendable que se asocien a tablas de la KB de modo tal de facilitar el uso de las mismas por mas que luego la transacci n creada no sea usada como tal Generate transaction si se marca este check box se generar una transacci n con la estructura de cada tabla a importar Ver la informaci n referente a Retrieve Index Information e Identify multilevel transactions Identify multilevel transactions si NO se marca este check box cada tabla a importar definir una transacci n y o una Data View diferente Las transacciones generadas ser n entonces todas de un solo nivel Si se marca entonces se buscan ciertos patrones de subordinaci n para definir transacciones de m s de un nivel Se deben cumplir los si
21. tando de reducir el largo del nombre sustituyendo BAN por B o cualquier ejemplo similar Sin embargo se debe considerar que esta regla aplicar a todos los objetos tengan o no conflicto por lo cual pueden renombrarse objetos que no quieren renombrarse 19 Data View Generator Manual de Usuario Lo que haremos es aplicar una regla particular es decir con un alcance scope determinado Para ello presionar el bot n derecho sobre el objeto en conflicto con lo que se puede visualizar un menu pop up como el siguiente Create Rule Rename Properties Figura 10 Menu Popup en objeto con conflicto Las opciones de este men permiten crear una regla Create Rule para crear una regla de alcance particular sobre el tem seleccionado renombrar el objeto opci n Rename y la opci n Properties del tem seleccionado Para generar la regla se puede seleccionar Create Rule o utilizar el bot n Generate Rule que aparece en el di logo de propiedades y seleccionar la secci n Scope del di logo de definici n de reglas visto anteriormente En cualquiera de los dos casos aparecer un di logo similar al siguiente Rule definition x Name substitution Type substitution Scope Rule scope objects Object type External name Y Transac BANCOS Database Objects Table BANCOSNAC Table BANCOS Transaction B4NCOSNAC Cancel Help Figura 11 Ejemplo de definici n
22. tonces el resultado final ser B C C D NOTA no solo el orden de aplicaci n influye sobre el resultado final tambi n existe el check box llamado Stop after apply en el di logo de definici n de reglas explicado con anterioridad en este documento REGLAS DE SUSTITUCI N DE TIPO LARGO DE LOS ATRIBUTOS Hasta el momento hemos visto como cambiar el nombre de los objetos tambi n puede ser necesario cambiar el tipo largo de los atributos a importar Esto normalmente es debido a que los tipos de datos en GeneXus no tiene una correspondencia exacta con los tipos de datos de todos los DBMS Por ejemplo en SQL Server no existe el tipo de dato DATE por lo cual los atributos DATE son creados como DATETIME y luego manejados como date solo se considera la parte de fecha Al importar la informaci n de la base de datos el atributo ser creado como DATETIME y puede darse que se precise manejar como DATE En este caso de puede agregar una regla bot n add como la siguiente Rule definition DateTime y Figura 14 Ejemplo de definici n de regla de sustituci n de tipo largo de atributos En el di logo se establece que los tipo de datos DateTime ser n sustitu dos por el tipo Date es decir que todos los atributos que aparezcan como datetime a nivel de la base de conocimiento ser n creados como Date 23 Data View Generator Manual de Usuario Se pueden establecer reglas mas comp
23. transactions 9 TIR T Attributes without Decimal places Significant name length 30 7 Attributes with Decimal places Tables Significant name length E T Enlarge Picture Indexes Significant name length 20 When unknown field type General C Ignore File I Generate Schema Ignore Altribute Generate Location coca t Figura 3 P gina 3 del Data View Generator Wizard La informaci n a configurar en esta p gina depende de si el Data View Generator se ejecuta por fuera de GeneXus o desde el mismo Los valores marcados mas adelante con un asterisco no pueden ser modificados si se ejecut el Data View Generator desde Genexus La pantalla que se muestra aqu aparecer solo si se ejecuta como un programa independiente Export File Directory Ingresar el directorio donde ser creado el archivo de exportaci n GXW XPW No debe incluir la barra 1 al final El bot n E permite seleccionar el directorio Si fue ejecutado desde GeneXus entonces ese directorio es el de la base de conocimiento y no puede ser modificado aparece deshabilitado Tip dicho directorio debe existir en caso contrario no se habilitar el bot n NEXT Folder Nombre del folder de la knowledge base donde se crear n los objetos importados Data View Generator Manual de Usuario Transactions Generate Data Views con este check se determina si se generar un Data View con la est
24. ue en esos N primeros caracteres los nombres deben ser nicos en caso contrario se dar un conflicto de nombres 12 Data View Generator Manual de Usuario Al importar conocimiento de una base de datos puede darse que no se cumpla con la unicidad en los N primeros caracteres Estos casos aparecer n en esta p gina del DVG y el desarrollador podr establecer reglas para resolverlos CONFLICTOS PROBLEMAS DE NORMALIZACI N Las reglas de transformaci n podr an ser utilizadas para resolver cualquiera de los casos mencionados indic ndole a GeneXus cual es la exacta relaci n de los atributos que componen nuestra base de datos Para GeneXus los atributos que se llaman igual representan lo mismo mientras que los que tienen diferente nombre representan conceptos diferentes Si por ejemplo el atributo que representa el c digo de cliente en la tabla de clientes se llama CliCod mientras que el mismo atributo en la tabla de cabezales de factura se llama FacCliCod Si existe una definici n a nivel de integridad referencial en la base de datos GeneXus infiere que ambos son el mismo atributo En caso contrario GeneXus no podr inferir que ambos son el mismo atributo El contraejemplo ser a el caso de dos atributos con igual nombre en tablas diferentes que no tienen relaci n entre ellos Si existe una definici n de integridad referencial el DVG identifica que los atributos representan el mismo concepto De no existir
Download Pdf Manuals
Related Search