PDF de programación - DDBuilder Manual de usuario

Curso de Visual PRO/5 - DDBuilder



DDBUILDER

MANUAL DEL USUARIO



Qué es DDBuilder ?
Creando Un Nuevo Diccionario de Datos
El Archivo de Configuración CONFIG.TPM
El archivo SQL.INI
La Interface de DDBuilder
Barra de Herramientas del DDBuilder
Tree View
Página de Propiedades
Agregando elementos al Diccionario de Datos
Insertando Columnas dentro del Diccionario de datos
Copiando elementos al Clipboard
Pegando elementos desde el Clipboard
Eliminar elementos del Diccionario de Datos
Deshaciendo ó Rehaciendo la última modificación
Renombrando elementos del Diccionario de Datos
Definiendo los atributos generales de una Tabla
Definiendo los atributos generales de Columnas
Definiendo Indices
Ejercicio



Página

102
103
103
104
105
105
106
107
107
108
108
108
109
109
109
109
110
110
111

Traducción al Español y adiciones hechas en Costa Rica
en un trabajo realizado en conjunto por Daniel Ortíz de SPS y Jorge Garro de UniSoft
Derechos reservados de Basis International Ltd.


101

ser usados

Curso de Visual PRO/5 - DDBuilder


Qué es DDBuilder ?


DDBuilder es una herramienta que de una manera rápida y fácil, le permite definir y modificar
diccionarios de datos de BASIS, para
con PRO/5, Visual PRO/5,
BBxPROGRESSION/4, y TAOS (El Workbench del Diseñador), así como también definir Vistas
SQL para ser usadas con el ODBC driver de BASIS.

Un diccionario de datos es una descripción organizada y formal de los archivos de datos.

Un diccionario de datos describe atributos de archivo físicos, como longitudes de registro y tipos de
archivo, y atributos de archivo lógicos, como nombres de columna y máscaras de salida.

El diccionario de datos proporciona la documentación inmediata de estructuras de datos, incluso la
composición del archivo y el tipo de datos. Pueden diseñarse aplicaciones para preguntar en tiempo
de corrida al diccionario de datos, eliminando el utilizar estructuras de datos rígidas en el código de
programa.

Porque el código de la aplicación puede tener datos independientes, los diccionarios de datos
pueden eliminar la necesidad de listas I/O (Iolist) y variables, anteriormente muy utilizados.
Ahora, de una mejor manera, un cambio se hace al diccionario de datos, y un programa simple de
actualización para los datos de la tabla se corre.

Aunque muchos paquetes de software inclusive aquellos escritos en PRO/5 y Visual PRO/5,
incluyan sus propios diccionarios de datos, DDBuilder permite a diseñadores aprovecharse del
poder y conveniencia de un diccionario de datos sin tener que gastar tiempo y recursos en crear una
utilitarios para manejo del diccionario.

DDBuilder corre bajo Windows 95, 98, Windows NT 4.0, Windows 2000 y puede usarse para:

· Crear y Definir la estructura de datos, incluso la composición del archivo.
· Definir diccionarios de datos que se crearon en otras aplicaciones, y modificarlos para el uso
con productos de BASIS.
· Imprimir una representación de la estructura de la base de datos y su contenido.
· Aprovechar la funcionalidad del ODBC Driver de BASIS y de TAOS.



Traducción al Español y adiciones hechas en Costa Rica
en un trabajo realizado en conjunto por Daniel Ortíz de SPS y Jorge Garro de UniSoft
Derechos reservados de Basis International Ltd.


102


1.En el menú Archivo seleccione
"New" para desplegar el diálogo de
"Crear nueva fuente de datos".

2.Muévase al directorio donde el
archivo de configuración, los datos y
subdirectorio del diccionario serán
instalados.

3.Entre el nombre del archivo de
configuración
es
config.tpm) en el campo "File Name".

4.Crear el subdirectorio para los datos
y diccionario presionando el botón
"Create".



estándar

(El

Curso de Visual PRO/5 - DDBuilder


Creando un Nuevo Diccionario de Datos

La creación de un nuevo diccionario de datos envuelve la designación de directorios para el
diccionario y los datos, creando un archivo de configuración. Para crearlo haga lo siguiente.



5.Digite la ruta del directorio de datos y diccionario en los campos apropiados, Si los datos serán
accesados desde una red, digite el ID de usuario en el campo "User ID Login".

6.Una vez que la ruta e información de la fuente de datos ha sido digitada, presione el botón
“Create”. DDBuilder creará el archivo de configuración y los archivos base en el directorio del
Diccionario. La Vista de Árbol (Tree View) aparece desplegando los íconos "Tables", "Typedef",
"Rules", and "Views". Ahora ya puede adicionar tablas a la fuente de datos.

Archivo de Configuración CONFIG.TPM

El archivo de configuración creado por DDBuilder, más conocido como CONFIG.TPM, le dice al
DDBuilder donde encontrar las estructuras con los datos y las definiciones del diccionario de datos.
Debe entonces contener la ruta para el Diccionario y el directorio donde residen los Datos, pero
también puede contener una ruta global e información de Login.
El siguiente es un ejemplo de un archivo estandar de CONFIG.TPM

#Taos Demo Database Configuration

DICTIONARY=c:\basis\ddbuild\examples\taosdemo\bbdict\

DATA=c:\basis\ddbuild\examples\taosdemo\data\



Traducción al Español y adiciones hechas en Costa Rica
en un trabajo realizado en conjunto por Daniel Ortíz de SPS y Jorge Garro de UniSoft
Derechos reservados de Basis International Ltd.


103

Curso de Visual PRO/5 - DDBuilder



Cualquiera, slashes delanteros ( / ) o slashes traseros ( \ ), pueden ser usados para designar las rutas
de directorio. DDBuilder reconoce una línea que empieza con el carácter "#" como un comentario.
Si se agregan definiciones de ruta globales al archivo config.tpm, es más fácil de actualizar las rutas
por cambios en estructuras de directorio.
El siguiente ejemplo ilustra posibles definiciones de rutas globales para ser usadas en el archivo
config.tpm

# Taos Demo Database Configuration

PROJECT= c:\basis\ddbuild\examples\taosdemo\

DICTIONARY=(PROJECT)bbdict\

DATA=(PROJECT)data\

Para utilizar DDBuilder con Pro/5 Data Server, proporcione la información del Login del Usuario
agregando la siguiente línea al archivo Config.tpm

USERID=Loginname

El Archivo SQL.INI

Este es otro archivo necesario para identificar las bases de datos nativas de BASIS que están
disponibles para el motor SQL de BASIS. El SQL.INI da al DDBuilder acceso instantáneo a la lista
de Bases de Datos, el cuál provee rápido acceso a las fuentes de datos y archivos de datos.

El archivo SQL.INI muestra el nombre y ruta del archivo CONFIG.TPM para cada fuente de datos.
Los nombres de fuentes de datos aparecen en el diálogo "Open Data Source" del DDBuilder.

Un archivo SQL.INI también puede ser creado o modificado con cualquier editor de Texto ASCII.
El siguiente es un ejemplo de un típico archivo SQL.INI

[BASIS Data Sources]

TAOS Demo Data
Chile Company
Class Reunion

[TAOS Demo Data]

CONFIG=c:/basis/ddbuild/examples/taosdemo/config.tpm

[Chile Company]

CONFIG=c:/basis/ddbuild/examples/chile/config.tpm

[Class Reunion]

CONFIG=c:/basis/ddbuild/examples/reunion/config.tpm


Traducción al Español y adiciones hechas en Costa Rica
en un trabajo realizado en conjunto por Daniel Ortíz de SPS y Jorge Garro de UniSoft
Derechos reservados de Basis International Ltd.


104

Curso de Visual PRO/5 - DDBuilder


Cualquiera, slashes delanteros ( / ) o slashes traseros ( \ ), pueden ser usados para designar las rutas
de directorio. El archivo SQL.INI debe estar instalado en el directorio de BASIS y debe estar listado
en el archivo c:\windows\win.ini como sigue:

[BASIS]
home=path_to_BASIS_directory

La Interface de DDBuilder



Barra de Herramientas del DDBuilder

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15



1. Despliega el diálogo de creación de una nueva fuente de datos
2. Despliega el diálogo Abrir, dando la posibilidad de abrir un archivo de configuración
3. Despliega una lista de las fuentes de datos existentes que están identificadas en el archivo

SQL.INI

4. Guarda el diccionario de datos actual
5. Reversa la más reciente modificación
6. Adiciona un nuevo elemento al diccionario de datos



Traducción al Español y adiciones hechas en Costa Rica
en un trabajo realizado en conjunto por Daniel Ortíz de SPS y Jorge Garro de UniSoft
Derechos reservados de Basis International Ltd.


105

7. Copia un elemento del diccionario de datos, incluyendo sus propiedades, al portapapeles

8. Borra el elemento seleccionado del diccionario de datos
9. Inserta una nueva columna inmediatamente antes de la columna seleccionada
10. Pega el elemento del Clipboard de Windows dentro de otro diccionario de datos
11. Crea un nuevo archivo de datos vacío, de Visual Pro/5 (No use la opción de crear sobre un
archivo de datos pre-existente, a menos que usted quiera remover todos los registros del
archivo)

12. Despliega la página de propiedades del elemento seleccionado
13. Despliega el diálogo de impresión de windows, proporcionando la capacidad de imprimir la

estructura en una vista de árbol

14. Despliega la información de la versión y copyright del DDBuilder
15. Despliega una ayuda sensible al contexto, para botones, menús y ventanas.


La vista de árbol (Tree View), proporciona una representación
gráfica de la estructura del diccionario de datos. Este despliega
cada Tabla, Columna, Índice, Tipo de campo, Reglas, y Vistas,
contenidas en el diccionario de datos.
Este puede ser usado para desplegar la página de propiedades
usada para definir los atributos del contenido del diccionario de
datos.