CAPTULO 1

INTRODUCCION

- INTRODUCCION

Bienvenido!
Muchas gracias por adquirir Clarion. Tiene ahora en sus manos la herramienta ms poderosa y
flexible para el desarrollo de aplicaciones. Muy pronto, usted podr apreciarlo por s mismo.

Niveles de usuario/desarrollador
Clarion funciona a varios niveles, y respalda a todo nivel de usuario o desarrollador.

Es un sistema de desarrollo automtico, manejado mediante asistentes

(wizards)
Cuando usted necesita una aplicacin simple para el mantenimiento de una base de datos, el
trabajo le llevar slo algunos minutos usando Clarion. La clave est en el diccionario de datos. Si
el Generador de aplicaciones (Application Generator) conoce los archivos o tablas que usted
necesita, y cmo se vinculan, puede construir una aplicacin completa. De manera que todo lo que
usted tiene que hacer es elegir uno o ms archivos, e indicar el tipo de relaciones que tienen entre
s (si son dos o ms). En el breve cursillo de Inicio rpido de este libro encontrar una
demostracin de lo fcil que es todo el proceso.
As, el Asistente para Aplicaciones (Application Wizard) puede crear una aplicacin completa
usando el concepto genrico de las aplicaciones Clarion. Lo llamamos el concepto browse-form
(procedimiento de visualizacin/ficha ), que se extiende directamente desde la estructura misma
de la base de datos. La aplicacin funciona as: (1) El usuario final navega por la base de datos -por toda ella o parcialmente, en un archivo de datos o mltiples bases de datos relacionadas-desplazndose por una lista, en la que cada tem representa un registro. La ventana en que esto se
realiza se llama browse (pronnciese /brus/). (2) El usuario selecciona un registro de la lista
para realizar una accin , como modificar los datos. Esto generalmente se hace en una ventana
separada, en que los campos de la base de datos aparecen en cajas de edicin separadas. Esto se
llama una ficha o formulario de actualizacin (update form). Una ficha puede tambin aceptar
datos nuevos. (3) Opcionalmente, el usuario final puede consultar un valor de una tabla vinculada
durante el ingreso de datos a la ficha. Esto abre otro browse en una ventana separada. El usuario
puede elegir un tem, cerrando la ventana y colocar el valor en la caja de edicin de la ficha. Esto

CLARION 5

PRIMEROS PASOS

se llama consulta (lookup). Esto sera la descripcin ms genrica. Adems, cada ventana de
visualizacin o browse, que puede navegarse desde la barra de herramientas, se abre en un hilo de
ejecucin separado, con su propio buffer de registro, lo que permite un manejo de datos ms
seguro. Se pueden seleccionar mltiples ordenamientos por claves (keys) dando CLIC sobre una
lengeta. Un DOBLE CLIC sobre un registro de la lista abre una ficha de actualizacin, con
comprobacin automtica de uso concurrente (para aplicaciones multiusuario) y, opcionalmente,
restricciones de integridad referencial, que mantienen las relaciones de la base de datos.

Cualquiera puede hacer todo esto. Se empieza sencillamente, escogiendo un archivo de datos de
la lista.

Es un ambiente de desarrollo visual

Con Clarion, colocar un control en una ventana hace mucho ms que en otras herramientas rpidas
para el desarrollo de aplicaciones, que tpicamente una vez colocado el control para la interfaz con
el usuario, esperan que usted escriba el cdigo para hacerlo funcionar. Con Clarion, usted aade un
template o plantilla, que contiene el control y todos los elementos de datos requeridos y el cdigo
ejecutable. Esto significa que no hay que escribir el cdigo, basta un CLIC para obtener una
solucin completa: el control de interface del usuario, y el cdigo que lo hace trabajar. Es ms,
cada template tiene su propia interfaz de usuario. Cuando se observan las propiedades del
template, se encuentra la lengeta Actions (acciones). Mediante acciones como responder a una
caja de dilogo, escoger un tem de una lista desplegable, o llenar un casillero, puede modificarse
el funcionamiento del template de modo que responda exactamente a las necesidades de la
aplicacin. Durante el cursillo que aqu presentamos, habr muchas oportunidades para configurar
estas acciones. El cursillo sobre el Generador de aplicaciones en la seccin Aprendiendo Clarion
lo introduce a todas las herramientas de desarrollo rpido de aplicaciones (RAD) que tiene el
programa.

Cuando se usa la interfaz de los templates para especificar tales comportamientos, el Generador de
aplicaciones escribe el cdigo fuente Clarion que los implementa. Se trata de un cdigo orientado
a objetos, construdo de la biblioteca de clases de aplicacin de Clarion (Application Builder Class
[ABC] Library), por lo que es un cdigo compacto y muy eficiente. Mediante los templates, usted
puede realizar una enorme cantidad de programacin totalmente configurada a sus necesidades,
sin necesidad de escribir ni una sola lnea de cdigo a mano.

La magnitud y el alcance del lenguaje Clarion pueden parecer imponentes a primera vista. La
Referencia del Lenguaje (Languaje Reference) tiene unas 1000 pginas. Una de las grandes
ventajas de tener el sistema de templates, adicionalmente a la capacidad de escribir cdigo
manualmente, es que usted puede irse introduciendo al lenguaje, al ritmo y profundidad que desee.
Si no le agrada el modo en que los templates resuelven un problema en particular, puede usarlos al
principio, slo para salir del paso. Luego, puede utilizar la interfaz del propio template para
hacerlo ms a su gusto. Finalmente, cuando domina el lenguaje Clarion, puede escribir una
solucin propia, con completa libertad. (Nota: adems puede comprar templates de terceras partes
para tener otro modo de resolver los problemas).
Los usuarios avanzados de computadoras que normalmente no escriben programas, pueden hacer
esto con facilidad.

CAPTULO 1

INTRODUCCION

Es un lenguaje de programacin completo

En su nivel ms bsico, se puede codificar una aplicacin completamente a mano, utilizando el
lenguaje Clarion de cuarta generacin. Clarion tiene un alto nivel de abstraccin, lo que lo hace
muy legible, y una sintaxis de base de datos compacta, de manera que fcilmente puede
manipularse un registro, o grupos de stos. No necesita saber Clarion para crear una aplicacin...
pero s conocer como trabaja, le ayudar a comprender lo que hacen las aplicaciones, lo que
mejorar su calidad. El cursillo sobre el Generador de aplicaciones en la seccin Aprendiendo
Clarion, lo estimula a escribir una pequea porcin de cdigo Clarion dentro de la fuente
generada por el template, y el cursillo sobre el Lenguaje Clarion (en la misma seccin) lo
introduce plenamente a la codificacin manual.

Los desarrolladores profesionales apreciarn realmente el lenguaje Clarion. Fue diseado desde
el vamos para programadores de aplicaciones de negocios. Su facilidad de aprendizaje (en
comparacin a otros lenguajes de bajo nivel) no le impide tener una performance deslumbrante.
El compilador de TopSpeed convierte todo el cdigo, sea escrito a mano o mediante el Generador
de aplicaciones, en cdigo binario altamente optimizado.

NOTA: No importa en qu nivel intente trabajar finalmente: lo har mucho mejor si

practica todos los cursillo hasta el final.

Qu hay en esta seccin

Esta es la introduccin al entorno Clarion. La siguiente es una lista de partes de esta seccin, y
resume su contenido:

Introduccin

Captulo uno: presenta Clarion y las instrucciones para

cargarlo en la computadora.

Cursillo para un rpido comienzo

Captulo dos: unos pocos pasos fciles con el Asistente

(Wizard) de Comienzo Rpido le permiten crear una
aplicacin completa en cinco minutos. Luego, en menos
de una hora, este captulo le ensear a usar el Wizard
de Aplicaciones y los wizards de procedimientos para
crear una aplicacin simple, y luego extender su
funcionalidad a un programa elaborado que trabaja con
dos archivos. Esto se lograr sin escribir ni una sola
lnea de cdigo.

Flujo de desarrollo

Captulo tres: un repaso del concepto Clarion de

desarrollo de aplicaciones. Describe todas las
herramientas del ambiente de desarrollo.

CLARION 5

10

PRIMEROS PASOS

Dnde encontrar ms informacin

El primer lugar para buscar es la seccin How do I ... ? (Cmo hago para ...?). Esos temas
responden muchas de las preguntas comunes que se hacen los recien llegados a Clarion. Oprima el
boton How do I ... ? en la seccin de Help Contens para ir a esa seccin.

Clarion tiene un muy amplio sistema de ayuda. La ayuda hipertextual aparece cuando oprime la
tecla F1, o elige una de las ordenes del men Help. La ayuda en lnea se maneja mediante la caja
de dilogo, para ofrecer ayuda sensible al contexto cuando la necesita.

Tambin hay un nmero de libros que se incluyen con Clarion.

Primeros pasos con Clarion

Es este volumen, que suma dos volmenes separados del original en ingls: Getting Started
(esta seccin) y
Learning Clarion (Seccin: Aprendiendo Clarion)
Esta ltima seccin contiene dos cursillo paso a paso. El primero es sobre el Generador de
aplicaciones, que ofrece una introduccin amplia a todas las herramientas del entorno de
desarrollo. La segunda presenta el lenguaje de programacin Clarion en s.
Application Handbook (Manual de las aplicaciones)
Es el manual de las herramientas Clarion que utilizar ms durante el desarrollo de
aplicaciones (en el formato .PDF en el CD de la edicin estndar). Describe los templates
que se incluyen con el producto, brinda una documentacin completa de la biblioteca de
clases de construccin de aplicaciones (ABC Library) que utiliza el cdigo generado por los
templates, y ofrece informacin profunda sobre los controladores (drives) de archivos de
Clarion.
Language Reference (Referencia del lenguaje)
La gua completa al lenguaje Clarion (en el formato .PDF en el CD de la edicin estndar).
Este libro ofrece descripciones de la sintaxis completa de Clarion, y todas las rdenes
disponibles, con ejemplos de cada una. El Language Reference se organiza mediante
tpicos funcionales. El texto completo de este libro tambin est disponible en la ayuda en
lnea. Cuando se trabaja en el Editor de texto, coloque el punto de inserccin sobre
cualquier funcin o sentencia Clarion, luego oprima Fl para obtener ayuda sobre ese tema.
Users Guide (Gua del usuario)
Provee una descripcin clasificada por distintas tareas del entorno de desarrollo, ordenada
por los componentes principales (en formato .PDF en el CD de las ediciones estndar y
profesional).
Programmers Guide (Gua del programador)
Coleccin de artculos que tratan en profundidad varios aspectos de la programacin
en
lenguaje Clarion y artculos sobre la personalizacin del entorno de desarollo (disponible
solamente en las ediciones profesional y empresarial, en formato .PDF en el CD de la
edicin profesional). Tambin contiene la gua completa al lenguaje de templates de

CAPTULO 1

INTRODUCCION

11

Clarion, lo que ofrece descripciones de todas las sentencias y funciones, con ejemplos de
cada una, con demostraciones claras de cmo escribir templates propios.
ReportrWriter Users Guide (Gua del usuario del ReportWriter)
Documenta el ReportWriter for Windows de Clarion. Esta es una herramienta
independiente para la confeccin de informes (includa solamente en las ediciones
profesional y empresarial -en formato .PDF en el CD de la edicin profesional), que
tambin est disponible como producto separado.
Enterprise Tools (Herramientas empresariales)
Documenta las herramientas disponibles para desarrollos cliente/servidor (Data Dictionary
y Syncronizer), desarrollo en grupo (Version Control / Team Developer) y las herramientas
Data Modeller. Documenta adems la Busines Math Library (Biblioteca de funciones de
matemtica empresarial) y Wise for Clarion (herramienta para usuario final que permite
crear instalaciones). Este manual est incluido solamente en la versin empresarial (algunas
componentes tambin estn disponibles como producto separado).
Wizatron Handbook.
Documenta los wizatrons, generacin avanzada de la tecnologa de asistentes Clarion,
quienes aprenden cmo usted trabaja, y se convierten en su asistente de programacin
automatizado (slo disponible con la edicin empresarial).
Master Index (Indice general)
Un listado completo de ndice para toda la documentacin impresa y tipo .PDF que viene
con cada edicin de Clarion (impresa solamente en la edicin empresarial, en formato .PDF
del CD en todas las dems ediciones).

Todos los libros que estn en formato .PDF en el CD (o en disquetes separados, en el caso de las
versiones en espaol) son accesibles mediante el programa Adobe Acrobat Reader, que tambin
puede instalarse desde el CD de Clarion. Pueden hacerse bsquedas por tema o palabra en estos
archivos .PDF, y tambin pueden imprimirse, si se desea.

Importante: si cualquier parte del texto on-line contradice la documentacin impresa, la

documentacin en lnea tiene precedencia. TopSpeed Corporation hace el mayor esfuerzo por
asegurar que la documentacin impresa est al da. Sin embargo, el tiempo requerido por los
impresores puede causar algunas inexactitudes: podemos actualizar los archivos de ayuda hasta el
lanzamiento mismo de una revisin del producto; pero los materiales impresos deben
alcanzarlos despus.

CLARION 5

12

PRIMEROS PASOS

Convenciones en la documentacin

Convenciones tipogrgicas:
Bastardillas

Indican qu debe tipearse en el teclado, como

por ejemplo Escriba esto. Tambin, ocasionalmente, se utilizan para destacar algunas
palabras o frases, o indicar expresiones en
idioma extranjero.

VERSALITAS

Indican pulsaciones de teclas, como ENTER o

ESCAPE, o dar un CLIC con el mouse.

Negritas

Indican rdenes u opciones de un men, o del

texto en una ventana de dilogo. Note: este
estilo tambin puede usar una familia
tipogrfica diferente, para igualarse a las
negritas en Helvtica que utiliza Windows
como fuente del sistema.

LETTER GOTHYC

Se utiliza para diagramas, listados de cdigo

fuente, para comentar ejemplos, y para
ejemplos del uso de sentencias de cdigo.

Convenciones del teclado

Fl

Indica una nica pulsacin de tecla. En este

caso, oprima y suelte la tecla Fl.

ALT + X

Indica una pulsacin combinada. En este caso,

oprima la tecla ALT y seguidamente pulse la
tecla X, luego suelte ambas teclas.

CAPTULO 1

INTRODUCCION

13

Informacin sobre el producto

Registro
Antes de comenzar a usar Clarion, llene y enve la tarjeta de registro que se encuentra en la caja a
UNISOFT, Uruguay 263 piso 5 (1015), Buenos Aires, Argentina a su Representante local. Esta
tarjeta le permite gozar de varios beneficios importantes. Una vez registrado, puede usar los
servicios de Apoyo Tcnico, y recibir automticamente anuncios y notificaciones de mejoras al
producto.

Apoyo tcnico
En la Argentina

Los usuarios registrados en la Argentina y pases de habla hispana disponen de

apoyo tcnico gratuito va Internet en la direccin: http://www.clarion.com.ar (o
tambin, ww.unisoft.com.ar) mediante Servicios de Newsgroup y FTP. Un equipo de
experimentados tcnicos locales (CST: Clarion Support Team Argentina) responder
a sus dudas. Tambin pueden obtener asistencia por correo electrnico a soporte@
unisoft,com.ar, o por fax al telfono (+54-11) 4374-9469.

Existen tambin planes alternativos de soporte tcnico por abono anual u horas de
consultora, como el Corporate Support que incluye asistencia telefnica ilimitada,
seguimiento de problemas, asesora y otros servicios. Para ms informacin
consulte al (+54-11) 4372-7243.

Apoyo internacional
Puede recibir apoyo tcnico ilimitado para Clarion en CompuServe Information Service y en
Internet. Los empleados de TopSpeed, as como los Asociados de Apoyo Tcnico Certificados
TopSpeed (un grupo voluntario de usuarios Clarion conocidos como Team TopSpeed),
respondern a sus preguntas oportunamente. Adems, podr recibir consejos y respuestas de otros
usuarios Clarion. Recomendamos ampliamente que nuestros clientes hagan uso de estos servicios.
1.

En CompuServe escriba
TopSpeed.

GO TOPSPEED para ingresar al foro de apoyo tcnico de

2.

En Internet, ingrese al grupo de noticias comp.lang.clarion, mediante cualquier servidor de

Usenet server.

3.

En Internet, ingrese al grupo de noticias topspeed.products en tsnews.clarion.com server.

4.

Tambin en Internet, visite la pgina Web de TopSpeed en http://www.topspeed.com. para

ms recursos de Clarion.

Tambin puede obtenerse servicio telefnico pago de la Coporacin TopSpeed al nmero (+1)
(954) 785-4556.

14

CLARION 5

PRIMEROS PASOS

Sistema de respuestas por fax

TopSpeed ofrece tambin acceso telefnico mediante fax para acceder a los documentos tcnicos y
comerciales ms comunes. Los documentos en lnea incluyen folletos de productos, documentos
tcnicos, reimpresiones de artculos, listas de precios, e incluso una actualizacin de los ltimos
productos TopSpeed (WhatsHot).
Para pedir documentos especficos, disque (+1- 954) 4785-4555, oprima 53 y escuche las
instrucciones del sistema. El men es interactivo y accesible. Quienes llaman por primera vez
pueden pedir una lista de documentos disponibles para hacer su eleccin. Luego puede ingresar el
nmero de cdigo del documento, y el material le ser transmitido inmediatamente. Puede acceder
al sistema desde su mquina de fax o desde cualquier telfono multifrecuente.

El programa de instalacin: Setup

El programa Setup descomprime y copia los archivos Clarion a su disco rgido.
En todos los sistemas operativos, le ofrece
componentes, tales como los archivos de ejemplo.

opciones para

instalar

los

varios

En todas las versiones de Windows, pregunta antes de actualizar la va de acceso (PATH) en el

archivo AUTOEXEC.BAT, para incluir el directorio Clarion.
En Windows 3.x pregunta si debe instalar los conos del Program Manager para el entorno de
desarrollo Clarion, y los archivos del Debugger (depurador), de ayuda y ReadMe.
En Windows 95 y Windows NT, sugiere instalar todos los conos del entorno de desarrollo
entre los programas del men de inicio (Start).

Requerimientos del sistema

Puede ejecutarse el entorno de desarrollo Clarion en cualquier sistema que cumpla con los
requerimientos mnimos para Microsoft Windows 3.x, Windows 95 , o Windows NT. Estos son
nuestros mnimos recomendados:
Windows 3.x, 8 Megabytes de RAM.
Windows 95, 16 Megabytes de RAM.
Windows NT, 32 Megabytes de RAM.
Mnimo de 12 a 35 Megabytes de espacio de disco libre, segn las opciones de configuracin
(Setup) elegidas.
Las aplicaciones que usted desarrolle con Clarion se ejecutarn
confortablemente en
computadoras que cubran solamente los requerimientos mnimos para esos sistemas operativos.

CAPTULO 1

INTRODUCCION

15

Iniciando el Setup
Para empezar el programa de Setup de Clarion en Windows 3.x:
1.

Inserte el CD de instalacin de Clarion en el dispositivo de CD-ROM.

2.

Desde el Administrador de Programas, o el Administrador de Archivos u otro programa capaz

de ejecutar un programa, elija: File Run.

Escriba D:\SETUP en el dilogo (Donde D: es la letra asignada a su unidad de CD-ROM), y

oprima el botn de OK.
El programa Setup presenta una pantalla introductoria y algunos datos adicionales. Le pide indique
las opciones de configuracin deseadas.

Para iniciar el programa Clarion Setup en Windows 95:

1. Inserte el CD de instalacin en el dispositivo de CD-ROM.
2. Desde el men de Inicio, escoja Configuracin Panel de Control.
3. Elija Aadir/Quitar Programas, y oprima el botn de Instalar.
El Asistente de Windows 95 lo guiar a travs del proceso de instalacin.

Opciones de instalacin
Despus de iniciar Setup, se mostrar un grupo de pantallas del Asistente que muestran una
variedad de opciones:

1. Escoja las opciones de configuracin ofrecidas por las pantallas (como el disco y directorio de
destino) oprimiendo el botn Next para desplazarse por las pantallas de opciones.
Setup instalar los componentes principales del entorno de desarrollo Clarion a un
subdirectorio BIN ubicado a un nivel ms bajo del directorio de destino que usted ha indicado.
El programa de instalacin instala todos sus archivos al directorio de destino, y a los
subdirectorios que estn por debajo de ste. No instala archivo alguno en otros directorios.
Durante la instalacin, aparecern barras de avance para mostrar la copia de los archivos.
2. Elija Yes o No cuando Setup pregunta si puede modificar el PATH.
En Windows 3.x y Windows 95, el entorno de desarrollo Clarion necesita que el subdirectorio
BIN est listado en la variable de entorno PATH. Si elije No, deber modificar manualmente el
archivo AUTOEXEC.BAT.
El nico cambio adicional que hace Clarion a sus archivos de sistema es aadir su propia
seccin al archivo de inicializacin de Windows (WIN.INI), cuando se lo ejecuta por primera
vez.

CLARION 5

16

PRIMEROS PASOS

3. Elija Yes o No cuando Setup pregunta si instalar los conos en un grupo de

programas Clarion o en el men de Inicio.
4. Elija Yes o No cuando Setup pregunta si debe mostrar el archivo ReadMe.
Si no desea leerlo inmediatamente, encontrar el cono correspondiente en el grupo del
Administrador de Programas (o en el men de Inicio) que crea Setup. Recomendamos leerlo
tan pronto como Setup haya copiado todos los archivos.
5. Oprima el botn OK cuando Setup haya terminado.

Ejecucin de Clarion
Para ejecutar Clarion, ubique el cono correspondiente en el grupo de programas Clarion y d
DOBLE CLIC sobre l, o simplemente un CLIC en el cono del men Inicio.
Aparece el entorno de desarrollo Clarion, listo para trabajar.
Encontrar una gua rpida para las partes del entorno de desarrollo, como un diagrama de los
conos de la barra de tareas, en el captulo tres de esta seccin.
Siga ahora con el captulo dos de este libro para crear dos aplicaciones impresionantes (desde
el diccionario de datos, a las ventanas del browse, a las ventanas de forms) todo en menos de
una hora.