Está en la página 1de 268

_abc Clarion

_abc CIarion
















" Automatizando eI Arte de Programar "



_abc Clarion ndice General

Gopc Soluciones ntegrales, S.A. de C.V. ii
www.gopac.com.mx
cursosgopac.com.mx



Copyright 2004 por Gopac Soluciones ntegrales, S.A. de C.V.
Todos los derechos reservados
Gop@c Press

No se permite la reproduccin de ninguna parte de esta publicacin, ni de los materiales
acompaados, sin un permiso previamente escrito por Gopac Soluciones ntegrales, S.A. de C.V.,
Av. Cubilete 800 local 11, Guadalajara, Jalisco, Mxico CP 45000. Tel. : +52 ( 3 ) 122 1947 ext
121. www.gopac.com.mx . e-mail : cursos@gopac.com.mx

LIMITE DE RESPONSABILIDAD

Gopac Soluciones ntegrales, S.A. de C.V. hace un esfuerzo honesto para asegurar exactitud y
calidad en sus materiales sin embargo, no hay garanta, ni explcita ni implcita de ello. Se produjo
este manual con la intencin de que sea usado en conjunto con la capacitacin de Gopac, Gopac
no se responsabiliza por daos, directos o indirectos que resultan del uso de la informacin en este
manual o los productos descritos adentro de l . El hacer referencia a cualquier producto no implica
su recomendacin por parte de Gopac. Todos los archivos aqu contenidos son ficticios, cualquier
semejanza con personas o compaas reales es pura coincidencia.



AVISO DE MARCA REGISTRADA

Clarion es una marca registrada por Topspeed representada en Mxico y en Amrica Latina por
Gopac Soluciones ntegrales, S.A. de C.V. Todas las marcas y nombres de productos son marcas
registradas de sus compaas respectivas.
_abc Clarion ndice General

Gopc Soluciones ntegrales, S.A. de C.V. iii
www.gopac.com.mx
cursosgopac.com.mx

Indice GeneraI


General
nstalacin Archivos de Ejercicio v
Definicin de Archivos vi
Ejercicios vii

Ambiente de Desarrollo de Clarion 1
niciando Clarion 2
Pick List 3
Cambiando de Directorio 4
Buscar Archivos 5
Edicin de Archivos ( Browse ) 6
Convertir Aplicacin 8
Men Setup 8
Editor Options 8
Redirection File 9
Database Driver Registry 11
Window Formatter Options 12
Application Options 14
Dictionary Options 16

Creacin y Mantenimiento de Diccionarios 26
Diccionario de Datos 27
mportar Tablas de otros Diccionarios 30
mportar Tablas de Archivos TopSpeed ( TPS ) 31
mportar Tablas de Archivos de Clipper ( DBF's y NTX ) 32
Propiedades de una Tabla 33
General 33
Comentarios 35
Opciones 35
Propiedades de un Campo 36
General 37
Atributos 39
Comentarios 41
Opciones 41
Ayuda 42
Validaciones 43
Ventana y Reporte 45
Propiedades de un ndice o Llave 46
General 46
Atributos 47
Comentarios 48
Opciones 49
Columnas 50
Pool de Datos 51
Campos 52
Tabla de Datos 53
Campos 54
Opciones 56
ndices Llaves 57
Relaciones 59
Triggers 63
Archivo Log 64
_abc Clarion ndice General

Gopc Soluciones ntegrales, S.A. de C.V. iv
www.gopac.com.mx
cursosgopac.com.mx


Generador de Aplicaciones 66
Vista Rpida 66
Generando una Aplicacin 67
Propiedades de la Aplicacin 67
Wizards 69
Utilizando los Wizards para crear una Aplicacin. 71
Procedimientos con Temas 73
Frame Customization: 73
Browse Customization: 78
Form Customization: 83
Agregando Triggers al Diccionario 87
Window Formatter 91
Procedimiento Main 92
Opciones del Men 94
General 94
Apariencia 96
Acciones 96
Ventana Splash 97
Ventana Acerca de... 99
Browses 105
Acciones 106
Locator 108
Record Filter / Range Limits 110
Conditional Behavior 110
Hot Fields 112
Color 113
List Box Formatter 113
Agregando Sort Order Button a un Browse 120
Agregando Sort Order Drop a un Browse 121
Habilidar las Columnas auto ajustables de Browse al tamao del
campo.
122
Habilitar el Efecto de Barra Verde (Green Bar) en un Browse 123
Control Template NOBrowseRecordsButton 124
Utlizar el Query By Example (QBE) 124
LST FORMAT MANAGER 127
Agregando Funcionalidad a un Form ( Forma ) 127
Formas 129
Lookup Button 130
DOS File Lookup Button 130
Spin Control 132
List Box Control 134
Puntos de Cdigo / Embeds 138
FORMAS Crear una Forma con Wizard 144
Navegacin dentro de una Forma Estilo VCR 147
agregar un Localizador en la Forma VCR 148
Cambio de color en los objetos 151
Agregando Variables de Ambiente 152
Variables de Ambiente 152
Locale 152
Barra de Status 153
Browses y Formas 153
Agregar y Eliminar Columnas 154
Agregar Rangos 155
Totales 157
Field Text Control 157
Agregar Browse 157
Deshabilitar Campos 159
_abc Clarion ndice General

Gopc Soluciones ntegrales, S.A. de C.V. v
www.gopac.com.mx
cursosgopac.com.mx

nicializar Variables 159
Group Box Control 160
Variables Locales 161
Formulas 164
Totales 165
Libreras Gopac 166
Puntos de Cdigo / Embeds 167
Deshabilitar Campos 167
Actualizar Datos en Tabla 167
Referencias ntegrales 171

Procesos, Templates y Reportes 172
Procesos 173
Procesando Registros 173
Templates 176
Template Registry 177
Tintools 178
Modificar Templates 178
Agregar Funcionalidad con Templates 179

Reportes 180
Propiedades 183
Rangos de mpresin 184
Etiquetas 186
Reporte de Ventas por Vendedor 187
Bandas de mpresin 188
Cortes y Totales 189
Lneas Viudas y Hurfanas
Cear un Rpoerte con el Asistente de Reportes
(Repor Wizard)
190
Mandar reportes a Diferentes Destinos de mpresin 192
Mandar reporte a PDF 197
Mandar reporte a TXT 198
Mandar reporte a HTML 199
Mandar reporte a XML 191
Utilizazndo el Templates para GRAFCAS de
Clarion
203
Aplicando el Browse Grid Template a la Aplicacin 206


Templates Adicionales (Terceros)
Modelo de Seguridad a la aplicacin 211
Aregando procedimiento de Acceso/ Loggin a la
aplicacin
213
Funcionalidad de Cambiar el Password para
Usiarios.
216
Administracin de Usuarios y Niveles o Compuertas 217
Cambiar de dioma las ventanas de SECWN. 218
Agegar Seguridad en Procedimientos (Browses,
Formas y Controles)
219

Seleccin Multiple de Registros para Procesar o mprimir 224
Registrar y Aadir Sper Tagging a la aplicacin

225
Aadir Sper Tagging a la aplicacin 225
Marcar registros en un Browse 226
mportando los archivos de Soporte. 226
Filtrar los registros marcados de un Browse. 232
_abc Clarion ndice General

Gopc Soluciones ntegrales, S.A. de C.V. vi
www.gopac.com.mx
cursosgopac.com.mx

Procesos y Reportes de Registros Marcados 234
Procesar Registros Marcados 235
Reportes de Registros Marcados 236
Enviar nformacin a Excel 238
Aadir Easy Excel a la aplicacin 239
Mandar Datos a Excel 239
Enviar Correo Electrnico desde la Aplicacin 243


Administrador de Cambios 246
Auto Up Actualizacin automtica de archivos 246
AutoNet Actualizacin de Archivos en red
AutoBuild Administracin de Archivos por Usuario 246
AutoFix ntegracin con TPSFix 247
C-Scan Browser para usuario final 247
Herramientas Adicionales 248
248
TopScan 248
TpsFix 248

Apndice 254
Estructura Diccionario ACME 254
Data Modeller ACME 258
Accesorios 259
CPCS 259
nsight Graphing 260
Super Security 261
Templates Freeware 261
Libreras Gopac 261
Cap Flash 261
Colour 261
Nova 261
Locus 261
Softvelocity NewsGroup 262
Catlogo de Accesorios 262

_abc Clarion

Gopc Soluciones ntegrales, S.A. de C.V. vii
www.gopac.com.mx
cursosgopac.com.mx

Estructura de Ios Archivos de Ejercicio
InstaIacin

En su disco de ejercicio encontrara un folder llamado Curso Basico , esta carpeta se encuentran
los sub-folders y archivos que se necesitaran en el curso:



















En los archivos de ejercicios usted deber de tener la siguiente estructura de directorios, en donde
se encuentran todos los archivos de Ejercicios :




















_abc Clarion

Gopc Soluciones ntegrales, S.A. de C.V. viii
www.gopac.com.mx
cursosgopac.com.mx




_abc Clarion

Gopc Soluciones ntegrales, S.A. de C.V. ix
www.gopac.com.mx
cursosgopac.com.mx



Definicin de Archivos de Ejercicio

Los subdirectorios que encontrara dentro del directorio de Curso Basico, son los que se utilizaran
por da encontrndose en ellos los siguientes archivos comunes :



C:\Curso Basico\\Dia_1\Curso Basico.exe ntroduccin Curso Bsico
C:\curso basico\Dia_1\Ejercicio 1.0 Ejercicio 1 del primer da
C:\curso basico\Dia_1\Ejercicio 1.1 Ejercicio 2 del primer da
C:\curso basico\Dia_1\Ejercicio 1.2 Ejercicio 3 del primer da
C:\curso basico\Dia_2\Ejercicio 2.1 Ejercicio 1 del segundo da
C:\curso basico\Dia_3\Ejercicio 3.1 Ejercicio 1 del tercer da
C:\curso basico\Dia_4 Ejercicio cuarto da
C:\curso basico\Imagenes Todas las imgenes necesarias para la realizacin de
los ejercicios
Acme.app Aplicacin general que se utiliza durante el transcurso
de los ejercicios

Acme_r.app Aplicacin general resuelta por cada da.
Acme.dct Diccionario de Datos para los Ejercicios
Acme_r.dct Diccionario de Datos resuelta para los Ejercicios
Archivos tipo TPS Archivos de Datos para los Ejercicios
Archivos tipo DBF Archivos de Datos para los Ejercicios
Archivos tipo NTX Archivos de ndices para los Archivos tipo DBF's
WizAcme.app Aplicacin general para el da 4


_abc Clarion

Gopc Soluciones ntegrales, S.A. de C.V. x
www.gopac.com.mx
cursosgopac.com.mx

Ejercicios en eI ManuaI

Los ejercicios que se realizan durante toda la duracin del curso son los siguientes :


1.1 Asignar un Directorio de Trabajo Nuevo 4
1.2 Busqueda de Archivos 5
1.3 Edicin de Tablas 6
1.4 Moficara Opciones del Editor 9
1.5 Modificar el Archivo de Redireccin de Clarion 10
1.6 Accesado el Database Driver Registry 11
1.7 Modificando Opciones del Window Formatter 12
1.8 Modificando Opciones Generales de la Aplicacin 14
1.9 Modificando Opciones Generales del Diccionario de Datos 16
2.1 Creando un Diccionario Nuevo 18
2.2 mportando Tablas de otro Diccionario 20
2.3 mportando Tablas de TopSpeed 21
2.4 mportando Tablas de Clipper 21
2.5 Generando Pool de Datos 40
2.5.1 Generando Campos del Pool de Datos 41
2.6 Generando una Tabla Nueva ( Vendedor / Cliente ) 42
2.6.1 Generando Campos para Tabla Nueva 43
2.7 Agregando Opciones a Tablas ( Detalle / Familia 45
2.8 Generando ndices / Llaves 46
2.9 Generando Relaciones 51
3.1 Wizards - Generando Aplicacin Nueva 55
3.1.1 Wizards 57
3.2 Personalizando Ventana Procedimiento Principal ( Men ) 59
3.2.1 Propiedades Ventana Principal 59
3.2.2 Modificando Opciones del Men 61
3.3 Agregar Procedimiento Splash 64
3.4 Agregar Opciones al Men 65
3.5 Agregar Procedimiento Acerca de .. 66
Agregar Botn nterlink 70
3.6 Agregar Funcionalidad al Browse de Clientes 77
Agregar Nombre del Vendedor 81
Tab Vendedores Agregar Tipo de Relacin 81
Agregar Localizador 82
Agregar Localizador Filtrado en Tab de Nombre 82
3.7 Agregar Funcionalidad a la Forma de Artculos 83
3.7.1 Agregar Botn Field Lookup 87
3.7.2 Agregar Control Spin Box Campo de Existencia 89
3.7.3 Agregar Control List Box Campo Unidad 89
3.7.4 Agregar magen 89
3.7.5 Agregar Botn de FieldLookup de Familia 91
3.7.6 Actualizar magen 94
3.8 Agregando Variables de Ambiente 96
3.8.1 Agregando Variables de Ambiente de Botones y Nombres Largos y Cortes Mes 97
3.9 Agregando Fecha y Hora a la Barra de Status 98
3.10 Funcionalidad al Browse de Facturas 99
3.10.1 Agregar Columna de Nombre y Eliminar Cdigo Cliente, Subtotal e VA 99
3.10.2 Agregar Rango de Clientes 100
3.10.3 Agregar Campo Totalizado de Facturas 100
3.10.4 Agregar Campos Hot Field RFC Cliente 101
3.11 Browse Detalle de Facturas 102
3.11.1 Crear Ventana de Detalle de Facturas 102
_abc Clarion

Gopc Soluciones ntegrales, S.A. de C.V. xi
www.gopac.com.mx
cursosgopac.com.mx

Ejercicios en eI ManuaI


3.11.2 Agregar y Deshabilitar Campo No. Factura 103
3.11.3 nicializar Campo Fecha 103
3.11.4 Agregar Control Spin Campo Fecha 104
3.11.5 Agregar Control Group Box Datos Cliente 104
3.11.6 Agregar Control Field Lookup Button de Cliente 104
3.11.7 Agregar Datos Cliente 105
3.11.8 Agregar Variables Locales de mporte, VA, Neto, Letras, Accin 105
3.11.9 Agregar Browse de Detalle 106
3.11.10 Agregar Frmulas para Calculo VA y Neto 107
3.11.11 Agregar Totales mporte, VA, Neto 109
3.11.12 Agregar Libreras Gopac 110
3.11.13 Agregar Funcin Nmeros a Letras 110
3.11.14 Deshabilitar Campos en Cambios de Facturas 111
3.11.15 Actualizar Datos de Cliente 111
3.12 Forma de Detalle de Facturas ( Prctica ) 113
3.13 Deshabilitar Transacciones de Tabla de Pagos 115
4.1.1 Agregar Opciones Men Procesos 117
4.1.2 Creando Procedimiento CambioPrecios 117
4.1.3 Agregando Variable Local de Porcentaje 118
4.1.4 Agregando Botn de Pausa 118
4.1.5 Agregando Embed para Procesar Registros 119
4.2.1 Template Registry 121
4.2.2 Registrando Templates Tintools 122
4.2.3 Modificando un Template 122
4.2.4 Agregar Template de Calendario al Campo Fecha de Facturas 123
4.2.5 Agregar Template de Calculadora al Campo Cantidad 123
4.3.1 mpresin de Facturas 125
4.3.2 Modificando Propiedades del Reporte 125
4.3.3 Agregar Variables 126
4.3.4 Agregar Rango de mpresin 127
4.4.1 Reporte de Etiquetas 128
Eliminado Bandas de Encabezado, Pie y Forma 129
Agregando Banda de Detalle 129
Agregando Embed 129
4.4.2 Reporte de Ventas por Vendedor 130
Agregando Procedimiento 130
Modificando Propiedades del Reporte 130
Agregando Bandas de Encabezado, Pie y Forma 130
Agregando Corte y Total por Cliente 130
Agregando Corte y Total por Vendedor 131
Agregando Corte y Total General 132
4.4.3 Manejo de Lneas Viudas y Hurfanas por Cliente 133
4.4.4 Agregando Extension del Tintools Report Viewer 133



_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 1
www.gopac.com.mx
cursosgopac.com.mx







































Introduccin a CIarion

Automatizando el arte de programar. Clarion es
una herramienta RAD ( desarrollo rpido de
aplicaciones ), con el cual usted aprender a
realizar sus propias aplicaciones en un tiempo
reducido y con un mnimo de cdigo.



Objetivo

Conocer el ambiente general de trabajo de
Clarion
CIarion para Windows
Introduccin






Ambiente de Desarrollo
Clarion
_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 2
www.gopac.com.mx
cursosgopac.com.mx


CIarion 6.0 es un medio ambiente integrado de desarrollo ( DE, ntegrated Development Environment ),
que es usado para crear una amplia variedad de aplicaciones de negocios. La creacin de una aplicacin
tpicamente envuelve una serie de pasos. CIarion 6.0 contiene un nmero de reas funcionales para
asistir en cada paso del proceso de desarrollo.

Conociendo eI Ambiente de Trabajo

Las caractersticas son accesadas por medio de las diferentes opciones de la barra del men y a travs
de la caja de seleccin asociada con cada opcin de la barra de men.

Cada una de estas opciones pueden ser accesadas a travs del teclado o del ratn.

CanceIando una SeIeccin

Si una opcin del men ha sido seleccionada y se desea cancelar dicha opcin, podr escoger alguna de
estas opciones para cancelarla :

Ratn, digitar un click izquierdo en cualquier parte fuera del men.
TecIado, presione la tecla ESC.

Iniciando CIarion


Seleccione de en Inicio / Programas / Clarion 6 Enterprise Edition / Clarion 6 Enterprise Edition. Con
lo cual se iniciar el programa de Clarion 6.0


niciando Clarion
Activando Clarion 6.0 Enterprise Edition



_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 3
www.gopac.com.mx
cursosgopac.com.mx



Pick List
Una vez cargado y activado Clarion 6., aparecer el men principal con el Pick Activado .


Herramienta Pick


Pick : Herramienta que se activa cada vez que inicia Clarion, permite seleccionar de una manera rpida
y fcil los ltimos archivos utilizados en Clarion, ya sean Aplicaciones ( *.APP ), Diccionarios (
*.DCT), Proyectos ( *.PRJ), Bases de Datos ( *.TPS / *.DAT ), Programas Fuentes ( .TP*),
Reportes (*.RPT), Todos los archivos usados recientemente.

La manera de activar esta herramienta son dos :

O Por medio del men File / dic




Seleccionando el cono del Pick





Para seleccionar una de las carpetas ( Aplicaciones, Diccionarios, etc. ), podr seleccionarla con el ratn
o presionando las teclas < Ctl > + < Tab >.





_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 4
www.gopac.com.mx
cursosgopac.com.mx

Opciones deI Pick



Abre el archivo que esta seleccionado.

< ALT > + E


Remueve el archivo seleccionado de la lista del Pick. No lo borra de
su sistema.

< ALT > + R


Crea un nuevo archivo de acuerdo al tipo que se tenga
seleccionado. Una vez presionado este botn, se le pedir el
nombre del archivo a crear, as como la ruta donde desea crearlo.
< ALT > + N


Abre un archivo previamente creado que no se encuentre en la lista
del Pick. Una vez presionado este botn, se le pedir el nombre del
archivo que desea abrir y la ruta en donde se encuentra.
< ALT > + O

Cierra la ventana del Pick

< ALT > + C

Activa la ayuda de la lista del Pick.

< ALT > + H

Tip : Para abrir rpidamente un archivo, seleccinelo con el mouse y presione doble click izquierdo.



Change Directory ( Cambiar Directorio )

Esta opcin del men principal ( File / Change Directory ), permite asignar un directorio de trabajo que se
estar utilizando hasta que se le indique uno nuevo, esto permite accesar a todos los archivos que se
estn trabajando de una manera rpida.


. Ejercicio : Asignar un Directorio
de Trabajo Nuevo .


1. Seleccione del men principal File y
a continuacin seleccione la opcin
de Change Directory


_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 5
www.gopac.com.mx
cursosgopac.com.mx


2. Del rbol de directorio seleccione el
directorio de C:\curso basico, y a
continuacin el botn Ok.













Este ejercicio permite cambiar el directorio de trabajo a
C:\curso basico, el cual es el directorio con el que se
estar trabajando durante todo el presente curso y
manual.



Search FiIe ( Bsqueda de Archivos )

Opcin del men File / Search File , permite realizar bsquedas de archivos, para localizar su ubicacin
dentro del rbol de directorios de una manera rpida y fcil. As mismo permite realizar bsquedas
dentro de los archivos, con lo cual, uno puede buscar determinado string, y el proceso l enviar todos
los archivos que lo contengan, adems de permitir la edicin directa de los archivos encontrados. (
Unicamente archivos de texto, como *.TPW, *.CLW, etc. ).

.2 Ejercicio ReaIizar Bsqueda deI Archivo Aeip.cIw


1. Seleccione del men principal File y a continuacin seleccione la
opcin de $earch Files...
_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 6
www.gopac.com.mx
cursosgopac.com.mx


2. En el campo de FiIes digite abeip.clw

3. En el campo de Directory cambie el
directorio de bsqueda al directorio de
C:\Clarion6

4. Presione el botn de Start para iniciar
la bsqueda de archivos.





5. Una vez terminada la bsqueda aparecer
el resultado de la misma con el o los
archivos que se hayan encontrado. En caso
de querer editar algn archivo, seleccinelo
y digite un click en el botn de /it, en caso
de querer realizar una bsqueda nueva,
seleccione el botn de New $earch, si
desea cerrar la ventana seleccione el botn
de Close.







Browse Database ( Edicin de Archivos )

Opcin del men File / Browse Database, permite editar un archivo de una manera fcil y rpida,
en donde podremos realizar consultas, modificaciones, inserciones y / o borrado de registros. Esta
herramienta nos permite editar archivos tanto nativos de Clarion ( archivos tipo TPS o DAT ) como
todos aquellos soportados en el Database Data Registry ( Registro /e Drivers /e Base /e Datos
). y que el driver sea un driver a 16 bits.

Nota : Si un driver de base de datos es a 32 bits, ser necesario realizar una pequea aplicacin
para poder realizar un Browse, ya que de manera como se menciona no es posible, como
ejemplo, cuando se accesa una base de datos de Access va ODBC, estas son a 32 bits,
por lo cual al intentar un Browse directo desde el diccionario no nos muestra los valores
correctos de los campos de la tabla.

.3 Ejercicio ReaIizar un Browse aI Archivo Vendedor.tps

1. Seleccione del men principal File y a
continuacin seleccione la opcin de Browse
Database...






















_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 7
www.gopac.com.mx
cursosgopac.com.mx

2. En la ventana de Pick, seleccione el botn de
pen.


3. Seleccione el FiIe Driver de %!$!D


4. Seleccione del rbol de archivos :
c:\curso basico\/ia_1\ejercicio1.2\ven/e/or.tps
y digite el botn de .

















Digite la tecla Insert para nsertar un registro nuevo,
DeIete / Supr para borrar un registro para Cerrar la
consulta presione el botn de it






Herramienta Browse




Convert AppIication ( Conversin de ApIicaciones )

Opcin del men File / Convert Application, permite convertir una aplicacin de Clarion 2 o de
cualquier versin de Clarion Legacy a Clarion 6.!, este asistente no borrara la aplicacin
original de Clarion 2 o Legacy. Podr elegir entre convertir la aplicacin desde un modo texto (
TXA ) o desde una archivo de aplicacin ( APP ), as mismo podr elegir que la aplicacin de
Clarion 6.0. se genere en un archivo texto ( TXA ) o directamente a un archivo de aplicacin ( APP
).

Men Setup ( Men de Configuracin )

Opcin del men principal $etup, permite configurar todas las herramientas y opciones con las que
se van a trabajar durante el desarrollo de una aplicacin, as mismo adaptar ellas a nuestros
caractersticas de trabajo, tal y como las opciones del /itor ptions ( Opciones del Editor ). Este
men se divide en tres partes :


O Editor Options ( Opciones del Editor ) y Redirection FiIe
( Archivo de Redireccin ) .


O Environment Options ( Opciones del Entorno de Trabajo
)



O TempIate, Database Driver ( Drivers de Base de Datos ) ,
Dictionary Synchronizer ( Sincronizador del Diccionario )
y VBX Options .

_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 8
www.gopac.com.mx
cursosgopac.com.mx


Editor Options ( Opciones del Editor )

El cuadro de dialog del Editor Options nos permite personalizar la edicin del ambiente de
desarrollo, la apariencia y el comportamiento del cursor. Para activar el cuadro de dialog,
seleccionar del men principal $etup / /itor ptions . Seleccione el %AB que desee, para
pcambiar las opciones.

Insertion : Configura el modo de
insercin de una lnea nueva de
cdigo, con lo cual nos permitir
que nuestro cdigo sea ms legible.

BIock : Configura los modos de
manejo de los bloques al momento
de borrar o copiar.

CoIors : Permite predefinir las
opciones de color para los 21
elementos del lenguaje de Clarion,
para que al momento de editar un
programa podamos identificar
rpidamente estos elementos.

Saving : Configurar las
caractersticas de autosave,
archivos de respaldo.


.4 Ejercicio Modificando Ias Opciones deI Editor ( Tab CoIor / Aadiendo Extensiones de
Cdigo )

1. Seleccione del men principal Setup y
a continuacin seleccione la opcin de
Editor Options.

2. En la opcin de Source Extensions,
inmediatamente despus de inc;
aadir las extensiones tpl y tpw (
extensiones de los archivos de
Templates )

Tip : Seleccione del cuadro Combo-List
el elemento de Clarion que usted
requiera que este sobresaltado con
algn tipo de color, para que se
identifique de forma ms rpida
dentro del /itor. En caso de que
usted cambie las opciones y no est
conforme con ellas presione el botn
de Restore Defaults, y la
configuracin original de Clarion
ser restablecida.





_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 9
www.gopac.com.mx
cursosgopac.com.mx



Redirection FiIe ( Archivo de Redireccin )

El ambiente de desarrollo de Clarion direcciona el directorio de trabajo al directorio en el cual la
aplicacin actual o los archivos del proyecto residen. Adems, Clarion utiliza el Redirection FiIe, (
\C60.RD o \C60!.RD ), para realizar bsquedas de los componentes de la aplicacin o de los
proyectos. El archivo de Redireccin le indica al ambiente de desarrollo donde puede encontrar los
archivos necesarios o donde puede crear nuevos archivos. Clarion busca de manera local el archivo
C60.RD en el directorio de la aplicacin. Si no encuentra este archivo, utiliza el archivo instalado por
default en \C60\BIN\C60.RD.

NOTA : Los archivos de respaldo son creados en el directorio donde se encuentra el archivo original.

Sintaxis

Cada lnea del archivo lleva este formato :

etensin_archivo = /irectorio1[;/irectorio2]....[;/irectorion]

La etensin_archivo es el nombre del archivo o la extensin de los mismos utilizando el estndar de
comodines de DOS : * y ?.
Directorio es la ruta que identifica al directorio donde realizar la bsqueda de etensin_archivo. El
directorio primario es donde los nuevos archivos son creados, esto nicamente para los archivos que
son creados por el ambiente de desarrollo como .BJ, .DBD, .LIB, . y .CLW. Los directorios
adicionales son rutas de bsqueda para los archivos existentes.


Macros

El archivo de Re/ireccin puede contener macros, las cuales son etiquetas delimitadas por el
smbolo de porciento (). En cualquier lugar donde Clarion encuentre un macro, este ser
substituido por el valor del macro. Se utiliza la seccin de Re/irection Macros] del archivo
\C60\BIN\C60.INI para definir ah las macros a utilizar. Existe un MACRO definido que es
R%, el cual contiene el drive y la ruta a un nivel arriba de donde se esta ejecutando
Clarion, es decir si Clarion normalmente se ejecuta en C:\C60\BIN el MACRO R%
contendra C:\C60\.

.5 Modificando eI Archivo de Redireccin

1. Seleccione del men principal $etup y a continuacin
seleccione la opcin de /it Re/irection File

2. Una vez que el archivo de Redireccin est abierto,
posicionese en la seccin Common], en donde se insertar
un rengln antes de la etension_archivo : *.*.

3. El rengln a insertar le indicar al ambiente de desarrollo
que todos los archivos de etensin *.CLW, se generen en
un directorio que se llame %rash, dentro del directorio propio
de la aplicacin, con lo cual, cada vez que se genere la
aplicacin, al momento de compilarse, buscar este
directorio y en caso de que este no existe lo crear y en el
grabara todos los archivos *.CLW. Quedando de la siguiente
manera
*.CLW = .\TRASH

_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 10
www.gopac.com.mx
cursosgopac.com.mx

4. De igual manera que el paso anterior, se generar la siguiente lnea, en donde se le indicara al
ambiente de desarrollo donde buscar todos los archivos tipo ICO.

*.ICO=ROOT\IMAGES;C:\CURSO BASICO\IMAGENES

Una vez que haya terminado de realizar los cambios, cierre la ventana y confirme uardar los Cambios.
Tip : Como Clarion no necesita los archivos fuentes ( .CLW, .INC, .EXP, .MAP ), uno puede mandar
estos archivos a un directorio temporal, el cual despus puede ser borrado con total seguridad.
Es importante que todos las lneas que se agreguen que queden antes de la extension_archivo :
*.*, ya que si no, no sern tomadas en cuenta.

_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 11
www.gopac.com.mx
cursosgopac.com.mx


Database Driver Registry ( Registro de Ios Drivers de Base de Datos )

El Registro /e Drivers /e Base /e Datos, le indica al ambiente de desarrollo de Clarion los tipos de
Base de Datos soportados. Algunos drivers vienen pre-registrados. En caso de obtener un driver nuevo,
es necesario realizar primeramente el registro del mismo por medio del cuadro de dialog del Database
Driver Registry.

.6 Ejercicio Accesando eI Database Driver Registry

1. Seleccione del men principal $etup y a continuacin
seleccione la opcin de Database Driver Registry

2. Para aadir un nuevo Driver presione el botn de
ADD del cuadro de Dialog .

3. Seleccione el archivo del driver, normalmente estos
archivos son de extensin DLL, del cuadro de dialog
de ADD Database Driver pen File, y presione el
botn .

Nota : Los archivos de drivers se encuentran ubicados en
C:\C60EE\BIN.



Remover un Driver : Seleccione el Driver y presione el botn de Remove. Esta accin no borra el
archivo DLL correspondiente del directorio, nicamente lo quita del registro de
drivers de Clarion

Tip : Cuando se distribuye la aplicacin, es necesario que se incluya los archivos de drivers que se
estn utilizando en la aplicacin. El nombre del archivo se indica en el cuadro de dialog del
Database Driver Registry, as mismo, cuando se genera la aplicacin, esta crea un archivo con
extensin .SHP el cual contiene un listado de todos los archivos necesarios para la aplicacin y que
son necesarios que se incluyan en la aplicacin, esto se aplica cuando se desarrolla la aplicacin en
modo $tan/alone.






















_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 12
www.gopac.com.mx
cursosgopac.com.mx


Window Formatter Options ( Opciones deI Formateador de Ventanas )

El Win/ow Formatter ptions, le indica al ambiente de desarrollo de Clarion la posicin y tamao que
se aplicar a los controles o cuando se alinean dichos controles con la herramienta de alineamiento.

.7 Ejercicion Modificando Opciones deI Window Fomatter

1. Seleccione del men principal Setup y a continuacin
seleccione la opcin de Win/ow Formatter ptions.


2. El cuadro de dilogo del Win/ow Formatter ptions esta
formado de 4 partes Grid, PopuIate DefauIts, Margin DefauIts,
and Spread DefauIts.



Grid ( RejiIIa de Posicionamiento )

La opcin del Grid ( Rejilla ) permite activar o desactivar el alineamiento automtico, e inicializa el punto
de inicio y los offsets de la ventana de Grid. Se puede utilizar el Grid para forzar los limites de los
controles a rangos de x o y , al forzar el Grid del eje de las X's, los controles son ms fcilmente
alineables y posicionables.

AIineamiento aI Grid ( Snap )

Active esta casilla para activar el alineamiento al Grid, se desplegara una rejilla de puntos de
coordenada de posiciones vlidas, y forzara el alineamiento a la esquina superior de todos los nuevos
controles que se aadan en el /itor /e Ventanas. La rejilla se activa nicamente en modo de diseo,
no en modo de ejecucin.

Tip : En modo de diseo, usted podr activar el Grid, seleccionndolo del
Men, o presionando el icono con lo cual se activar o
desctivar el Grid.
Width ( Ancho )

Digite la distancia horizontal entre cada punto del Grid. ( eje de )

Height ( AItura )

Digite la Distancia vertical entre cada punto del Grid. ( eje de ) .

Origin X ( Origen X )

Digite la coordenada horizontal en donde iniciarn a ponerse los puntos del Grid. Est es la posicin de
extrema izquierda al cual los controles que se aadan se alinearan, o se auto generaran cuando el
alineamiento del Grid est activado.

Origin Y ( Origen Y )

Digite la coordenada vertical en donde iniciarn a ponerse los puntos del Grid. Esta es la posicin
superior al cual los controles que se aadan se alinearan, o se auto generarn cuando el alineamiento
del Grid este activado.

Tip: Todos los valores especificados estn definidos de acuerdo a la unidad de
medida basado en el sistema de tipografa actual
Show Screen Extents ( Mostrar Limites de PantaIIa )
_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 13
www.gopac.com.mx
cursosgopac.com.mx


Activando esta casilla se desplegaran los lmites de la ventana en el Win/ow Formatter, para las
resoluciones ms comunes de vdeo.

Snap on Resize ( AIineamiento en eI Cambio de Tamao )

Activando esta casilla, los controles son forzados a posicionarse al punto del Grid ms cercano cuando
estos cambien de tamao.

Tip : El cambiar un control de tamao, utilizando el borde superior izquierdo
siempre lo alineara al Grid.

PopuIate DefauIts

Predetermina el ancho y el alto de los controles de ventanas. El Window Formatter, aplica el tamao
predeterminado cuando se aada un control a la ventana.

Margins DefauIts ( Mrgenes Predeterminado )

Permite definir los mrgenes a aplicar por la herramienta de alineamiento de mrgenes. El mrgen es
simplemente la distancia entre los bordes de dos controles. El Window Formatter aplica los mrgenes
predeterminados cuando se utiliza la herramienta de alineamiento de mrgenes. Diferentes tipos de
controles requieren diferente mrgenes por sus propias caractersticas. Por ejemplo los controles de TAB
y GROUP necesitan espacio extra para permitir incluir su propio texto.

Spread DefauIts ( Espaciado Predeterminado )

Predetermina el espacio entre controles Auto-PopuIated y controles posicionados por la herramienta de
alineacin de espacios. El Window Formatter aplica el espacio definido cuando se inserta campos del
FieIds TooIbox y cuando se utiliza la herramienta de espaciamiento.

Tip : En caso de que se requiera regresar a los valores predetermindados por la instalacin del sistema
presione el botn de Reset DefauIt VaIues.

_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 14
www.gopac.com.mx
cursosgopac.com.mx


AppIication Options ( Opciones GeneraIes de Ia ApIicacin )

El Application ptions, le indica al ambiente de desarrollo de Clarion todas las opciones generales con
las que va a trabajar la aplicacin

.8 Ejercicio Modificando Opciones GeneraIes de Ia ApIicacin

1. Seleccione del men principal $etup y a continuacin seleccione
la opcin de Application ptions









El cuadro de dialog del Application ptions, est dividido en opciones. Seleccione el %AB que
desee, para cambiar las opciones.

AppIication : Se define las opciones
personalizadas de como va a trabajar la
aplicacin. Si requiere o no un Diccionario,
Procedimientos por Mdulo, Activar los Wizard,
etc.

Registry : El cdigo del lenguaje del Template
puede ser separado de manera lgica en
diferentes archivos. Clarion utiliza estos para
producir un template lgico para crear las
aplicaciones. Las opciones del Registry estn
enfocadas a programadores que producen o
modifican sus propios Templates

Generation : ndica al ambiente de desarrollo de
Clarion las caractersticas a utilizar en la
generacin de la Aplicacin.

Tip : Seleccione del drop list de eneration
Message la opcin ModuIe Names, al realizar
este cambio le esta indicando al compilador que
enve nicamente el nombre del Mdulo que se
esta compilando en vez de incluir el nombre del
procedimiento, con lo cual usted estar
optimizando el tiempo de la compilacin es decir
reducir significativamente el tiempo de compilar
su aplicacin.


Synchronization : Permite especificar como y
cuando son aplicados los atributos de control en los procedimientos y controles de la
aplicacin, de los datos definidos en el diccionario.

Tip : Seleccione el Check Box de la opcin $ynchronize Application when pen para aumentar la
velocidad de la sincronizacin, especialmente cuando se requiere que se sincronice cada ves
que la aplicacin sea abierta.
_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 15
www.gopac.com.mx
cursosgopac.com.mx


Embed Editor Options : Permite controlar como el Generador de la Aplicacin crea el archivo de cdigo
temporal en el Embed Editor. Se puede especificar el texto que delimita los
puntos de cdigo, as como personalizar el texto del mismo, para que se mas
fcil de identificar los puntos de cdigo al momento de editar el cdigo.

AppIication ExpIorer : Permite configruar las opciones que aparencien a mano derecha del panel en el
Arbol /e !roce/imientos /e la Aplicacin.


Embed Tree Options : Permite controlar la apariencia de la seccin de Local bjects del Arbol /e
mbe/s. Este tab solo esta disponible si se tienen registrados los %emplates
ABC. Las opciones especificadas en esta parte solo tendran efecto sobre el
Arbol /e mbe/s de una aplicacin que este desarrollandose con ABC.


_abc Clarion Ambiente de Desarrollo Clarion

Gopc Soluciones ntegrales, S.A. de C.V. 16
www.gopac.com.mx
cursosgopac.com.mx


Dictionary Options ( Opciones GeneraIes deI Diccionario de Datos )

.9 Ejercicio Modificando Opciones GeneraIes deI Diccionario de
Datos

1. Seleccione del men principal $etup y a continuacin seleccione la
opcin de Dictionary ptions













El cuadro de dialog del Dictionary ptions, est dividido en 3 secciones. Seleccione el %AB que
desee, para cambiar las opciones.

TabIe Options : Define las opciones
generales que el ambiente utilizar cuando se
genere una tabla nueva en el diccionario de
Datos. Permite definir el Driver por omisin a
utilizar ( Default Driver seleccione de la lista el
driver ) . As mismo permite definir los
atributos que estarn activados, al igual que
indicarle los datos a desplegar en la lista de
tablas ( Nombre, Driver y Prefijo ) , activa o
desactiva el uso del Quick Load.

CoIumn Options : Define las opciones
generales que el ambiente utilizar al
momento de crear un campo, como es incluir
la descripcin del campo tanto en el mensaje
de ayuda como en el tooltip de ayuda.
Podemos indicarle los datos que se requieren
desplegar al momento de mostrar la lista de
campos de la tabla tal como Descripcin /el
Campo, %ipo, !icture o Mscara, !refijo y
Derivacin.

Key Options : Aqui se indican los datos que
se requieren desplegar al momento de
mostrar la lista de llaves o ndices de la tabla
tal como Descripcin /el In/ice, %ipo, Ban/era /e Unico, $tatus /e Llave !rimaria,
tro tipos /e Atributo /e Llave y !refijo.
_abc Clarion Creacin y Mantenimiento de Diccionarios

Gopc Soluciones ntegrales, S.A. de C.V. 17
www.gopac.com.mx
cursosgopac.com.mx






























Creacin y
Mantenimiento a
Diccionarios

Un buen diccionario de datos totalmente
detallado permitir que el tiempo de
desarrollo de una aplicacin de Clarion sea
drsticamente reducido.



Objetivo

Conocer eI Concepto de Diccionario de
Datos, as como Ias diferentes opciones
de creacin deI mismo. Revisando cada
uno de Ias Diferentes opciones que
incIuye.
CIarion para Windows
Introduccin






Creacin y Mantenimiento
de Diccionarios
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 18
www.gopac.com.mx
cursosgopac.com.mx



Diccionario de Datos.

Los diccionarios de datos definen el esquema fsico de los archivos de datos accesados por una
aplicacin, la relaciones existentes entre los archivos y las reglas para el mantenimiento de las
relaciones. Los Diccionario de Datos son requeridos por los programas que son creados por el
Generador de Aplicaciones ( AppIication Generator ) , para poder accesar los archivos de datos.
Clarion 6.0 permite accesar a las aplicaciones una variedad de diferente formatos de archivos de datos a
travs del uso de los drivers de base de datos. Alguno de los formatos de archivos, actualmente
soportadas a travs de los drivers incluidos en Clarion 6.0 son Btrieve, Clarion, Dbase, Dbase4, $"L,
%opspee/. Para poder accesar un archivo de datos, la aplicacin debe de conocer las caractersticas del
archivo. El Diccionario /e Datos es utilizados para almacenar y mantener las caractersticas de los
archivo o tablas. ncluso los Asistentes ( Wizards ) y los Wizatrones, al generar las aplicaciones utilizan
la informacin que esta almacenada en el Diccionario /e Datos, para generar la aplicacin. Campos,
llaves, reglas de validacin de datos de entrada, opciones de entrada de datos y la relacin entre
archivos son almacenados en el Diccionario /e Datos . El rea del ambiente de desarrollo usada para
crear y mantener los Diccionario /e Datos estn referenciada en el Editor de Diccionarios ( Dictionary
Editor ).


Creando un Diccionario de Datos Nuevo ( Database Dictionary )

Todos los archivos que contienen Diccionario /e Datos , tienen una extensin DCT. Para los ejercicios
siguientes se utilizarn la definicin del Diccionario del curso bsico que se encuentra en la parte final
de este manual ( Apn/ice I structura /e Diccionario Acme ). En su rbol de directorio de su equipo
encontrara un directorio del curso el cual se estar utilizando hasta que se mencione lo contrario, el
directorio a utilizar es el siguiente C:\curso basico\Dia_\Ejercicio .2.

2. Ejercicio Creando un Diccionario de Datos Nuevo

1. Seleccione del men principal la opcin de
FiIe
2. Seleccione New

3. Seleccione - Dictionary

4. En el rbol de directorio ubique el directorio
de C:\Curso basico\Dia_\Ejercicio .2

5. En el nombre del archivo digite Acme y en
seguida presione el botn de Guardar.

Tip : Una manera de crear un Diccionario de Datos
rpida, es utilizar la herramienta Pick
una vez presionada esta herramienta, seleccione el 2do Tab
( Dictionary ) y presione el botn de New, contine con el
paso 4.
Puede crear un diccionario nuevo presionando el siguiente
botn : y a continuacin seleccionar diccionario,
continuando con el paso 4.




_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 19
www.gopac.com.mx
cursosgopac.com.mx


























La ventana del diccionario est formada por dos partes, la parte de la izquierda identifica las tablas que
contiene este diccionario y la parte derecha indica las relaciones que tiene cada uno de las tablas. En
este momento explicaremos nicamente las opciones de las tablas, posteriormente se vern las
opciones de las relaciones.

Opciones de Ia Ventana :


Crea una tabla nueva a la lista ( ADD ) . As mismo nos
permite importar tablas de un diccionario ( Import ) o
generar un alias de una tabla ( AIias )

Permite modificar las propiedades de una tabla existente.

Permite crear, modifica o borrar campos o llaves / ndices
de una tabla seleccionada

Permite borrar una tabla de la lista de tablas, no borra
fsicamente la tabla si est ya existe.

Permite realizar un Browse a la tabla, si esta no existe la
crea. Tip : Si se modifico la estructura de la tabla es
necesario darle un Browse a la misma para evitar el
error 47 al momento de la ejecucin de la aplicacin
previamente generada.

Convierte el formato fsico de la tabla seleccionada para
que esta sea equivalente a la definicin del diccionario.

Permite aadir o editar informacin acerca del
Diccionario /e Datos actual, incluyendo las fechas de
creacin, modificacin y el texto descriptivo.

nvoca al $incroniza/or /e Diccionarios, ( opcin
disponible nicamente en la versin Enterprise ).



_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 20
www.gopac.com.mx
cursosgopac.com.mx



Desde la ventana de Edicin de Diccionario podemos ver y editar los campos, llaves y
relaciones directamente.












LocaIizadores:

Estos IocaIizadores inteIigentes permiten encontrar rpidamente eI nombre de una tabIa o de un
campo en eI diccionario., estn tambin Distribuidos en diferentes partes deI IDE deI Diccionario:
. Diccionario de Datos - Listas de Tablas y Archivos










_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 21
www.gopac.com.mx
cursosgopac.com.mx


2.2 Ejercicio Importando TabIas de Otro Diccionario

1. En el Diccionario /e Datos Acme, seleccionamos el botn de tabla nueva y en
seguida seleccionar la opcin de Import.

2. Enseguida el ambiente de desarrollo preguntar si se quiere grabar el Diccionario /e Datos,
presione el botn de $i.

3. En la ventana del $incroniza/or
/e $atos , en la opcin de $elect
Dictionary presionar el botn
En el rbol de directorios ubicar el
directorio de ejercicios y seleccionar
el diccionario Base./ct. El Log
$ynchronization %o, genera un
script de toda la sincronizacin que se
genere, en caso de haber un error o
un detalle es cuestin de checar el
archivo generado.
Una vez realizado estas opciones
presione el botn de Net.


4. En la siguiente ventana presenta
la o las tablas a importar (
Artculos y Familia ) del lado
derecho, seleccione una de ellas
con doble click para pasarlas al
lado izquierdo, realice la misma operacin con la tabla restante.

Tip : Si las tablas a importar tienen alguna relacin entre ellas, seleccionando solamente una, las dems
pasaran a la columna de importar, ya que el ambiente de desarrollo verifica la integridad de las
relaciones y para conservarlas, es necesario la o las tablas que se pasan a importar.

5. Presione el botn Finish para que se importen las dos tablas al Diccionario /e Datos Acme./ct.




6. Grabe su diccionario, presionando el botn

Una vez realizado estos pasos el diccionario de datos Acme, ya contendr el esquema de campos
contenidos en las dos tablas, la de Artculos y la de Familia. En caso de que estas dos tablas hubieran
tenido alguna llave, tambin estas estaran incluidas as como las relaciones entre ellos.





Tip : Cuando se importa de un diccionario o una tabla TPS ( Topspeed ), se importan automticamente
los ndices definidos y sus relaciones.
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 22
www.gopac.com.mx
cursosgopac.com.mx


























Ejercicio 2.3 Importando una TabIa de Datos de TopSpeed ( TPS )

1. Seleccione del men principal la opcin de File / Import
%able.

2. Seleccione de la lista de File Driver el driver de %opsee/ (
%!$ ) y en seguida presione el botn de OK






3. Presione el botn :
En el rbol de directorio ubicar el directorio
de ejercicios y seleccionar la tabla
Factura.tps y presionar el botn de Abrir y
posteriormente el botn de OK. En la ventana
de /it %able !roperties, seleccione el botn
de ( 'er p.p. 22 Propiedades de una
Tabla ).La tabla Factura.tps a sido agregada
a la lista de tablas de su Diccionario /e Datos.

4. Realice estos pasos para agregar la tabla de Detalle.tps

Este mtodo de importacin de datos permite importar el esquema de una tabla generada por otro
sistema e incorporarla al /iccionario /e /atos para utilizarla en una aplicacin diferente.






_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 23
www.gopac.com.mx
cursosgopac.com.mx



Ejercicio 2.4 Importando una TabIa de Datos de Dbase y sus Indices ( DBF / NTX )

1. Seleccione del men principal la opcin de File /
Import %able.

2. Seleccione de la lista de File Driver el driver de
Clipper y en seguida presione el botn de OK




3. En el rbol de directorio ubicar el directorio de ejercicios y seleccionar la tabla !agos./bf y presionar
el botn de Aceptar enseguida le pedir los n/ices ( *.nt ) que son relacionados con la tabla de
!agos, seleccione el primero y presionando la tecla $hift posicionese en el ltimo ndice y con un
click seleccione todos los ndices de la lista. Con esta accin se estn agregando los ndices
Akfecha.nt ( Indice alterno por Fechas ), A%ipo ( Indice alterno por Tipo de Pag ), FClien.nt (
Llave fornea para relacionarse con la tabla de Clientes ), !Numero ( Llave principal de la tabla de
!agos )


Tip : En caso de que aparezca el error de %oo Many Files pen, verifique el archivo de Config.sys que
contenga el comando Files=120 o superior y en caso de ser necesario incluya el siguiente
comando en su archivo Autoeec.bat , $% CLI!!R=F120 o superior.
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 24
www.gopac.com.mx
cursosgopac.com.mx


Propiedades de una TabIa Nueva.

La ventana de File !roperties, permite especificar completamente las caractersticas de los archivos de
datos . A continuacin explicamos cada uno de los controles mostrados en la ventana de Propiedades.

Ventana de Propiedades de una Tabla
Tab GeneraI
Usage ( Uso )

Permite identificar el tipo de estructura que la tabla tiene en el diccionario, como Archivo
de Datos, Variables Globales, Pool de Datos.

FiIe : Esta estructura representa un Archivo /e Datos. El enera/or /e
Aplicaciones genera una declaracin del esquema del Archivo /e Datos, as
como el cdigo necesario para leer/escribir el Archivo.

GIobaI : Esta estructura representa un grupo de declaraciones de variables de manera
global, es decir, en cualquier mdulo pueden ser utilizadas. El enera/or /e
Aplicaciones genera la declaracin global de cada campo en la estructura.
Esta opcin activa el checkbox de Last enerate.

PooI : Esta estructura representa un grupo de campos que sern utilizados para
generar posteriormente de una manera rpida, la declaracin de campos que
tengan las mismas caractersticas entre si, en otras tablas.

Name ( Nombre de Ia TabIa )

Es la etiqueta o nombre a ser utilizado cuando se refiera a esta tabla dentro de la
aplicacin. La etiqueta o nombre puede ser hasta de 255 caracteres. Puede ser
conformado de letras, nmeros, carcter de subrayado ( _ ) y los dos puntos ( : ). La regla
de uso : no pueden iniciar el nombre con un carcter distinto a letras y no tiene importancia
si es maysculas o minsculas.

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 25
www.gopac.com.mx
cursosgopac.com.mx


Tip : En tiempo de ejecucin el nombre asignado al archivo ser utilizado en las ventanas
de Browse o en las formas de actualizacin, as como en el men que se utilice
para ser llamado. Por lo cual es importante que el nombre a utilizar sea un nombre
descriptivo al archivo.

Description ( Descripcin deI Archivo )

Es un conjunto de caracteres utilizados para describir completamente el contenido de la
tabla de datos.

Prefix ( Prefijo )

El prefijo es una combinacin de hasta 8 caracteres que anteceden a los nombres de los
campos definidos en la tabla de datos. El prefijo es utilizado para distinguir entre los
nombres de campos iguales pero que estn en diferentes tablas. El prefijo por omisin que
el ambiente asigna, son los 3 primeros caracteres de la tabla, pero pueden ser cambiados.

Database Driver ( Driver de Ia Base de Datos )

Clarion 6.0 soporta una gran variedad diferente de formatos de base de datos .
Seleccione de la lista el driver que utilizara para la tabla a dar de alta. Dependiendo del
tipo de driver seleccionado y sus caractersticas individuales, algunas opciones podrn
ser desabilitadas.

Driver Options ( Opciones deI Driver )

El comportamiento de ciertos drivers puede ser adecuado a un funcionamiento, a travs
del uso de parmetros cuando el driver es utilizado.

Owner Name

Contiene la clave de acceso a la tabla. Al utilizar el driver de $"L/DBC/RACL, este
campo debe de contener el nombre del archivo, el D del usuario y su clave de acceso
separado por comas, esto es para que al momento que se conecte la aplicacin a la
base de datos no sea requerido al usuario suministrar esta informacin, caso contrario
omitir estos datos.

FuII Pathname ( Nombre y Ruta CompIeta deI Archivo )

La letra de la unidad de almacenamiento, la ruta y el nombre de DOS de la tabla
fsicamente, es especificado en este campo, si es omitido el ambiente de desarrollo
crear la tabla con el nombre especificado en Name, adems de que se crear en la ruta
en donde el programa se ejecuta directamente.

Tip : Si se desea crear la ruta y/o el nombre de una manera dinmica en base a una
variable, es necesario que se escriba el nombre de la variable en este campo
antecedida por el smbolo de exclamacin ( ! ).

EnabIe TabIe Creation ( Permitir Generar TabIa )

Activando esta casilla permite a la aplicacin el crear la tabla de datos si esta no existe
en tiempo de ejecucin .
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 26
www.gopac.com.mx
cursosgopac.com.mx



RecIaim DeIeted Records ( RecIamar Registros Borrados )

Esta opcin depende del driver seleccionado. ndica a la aplicacin que al momento de
ser borrado un registro reuse el espacio utilizado por este. Caso contrario simplemente la
aplicacin agregar los registros nuevos al final de la tabla.


Encrypt Data Records ( Encripta Ia Informacin de Ios Registros )

Activa la encriptacin de los datos de los registros, previamente se debi de haber
definido un nombre propietario en wner Name, el cual es la clave de acceso cuando se
requiere utilizar la informacin que existe en los registros mediante otra herramienta que
no sea la aplicacin.

Freeze

Al marcar esta opcin previene que cualquier campo que sea derivado en la tabla sea
refrescado.

Current Thread ( Abrir TabIa en Ia Hebra de Ejecucin ActuaI )

Opcionalmente se puede especificar que en cada hebra de ejecucin de la aplicacin
que utilice este archivo se aloje en memoria separada. Esto es tpico en el uso de
aplicaciones de mltiples documentos e involucra manejo de tablas. El default de Clarion
adiciona el atributo de hebra a cada estructura de tabla nueva.

OEM CoIIation

Esta opcin permite especificar que las caracteres de informacin son convertidos de
M A$CII a AN$I cuando estos sean ledos del disco y los convierte de AN$I a M
A$CII cuando los datos son escritos a un archivo. Esto permite que si los datos de las
tablas traen caracteres especiales en los campos tales como en los archivos DBF's
traen una letra en vez de que esta sea representada por el signo de # sea
representada por la letra .

EnabIe CoIumn Binding

Se especifica que todas las variables en la estructura del registro estn disponibles para
un uso dinmico al momento de su ejecucin.

32 Bit OnIy

Especifica que la estructura de la tabla es nicamente vlida para aplicaciones a 32 bits.
esto es nicamente para los drivers de SQL

Comments ( Tab de Comentarios )

En este Tab, puede uno escribir una amplia y completa descripcin de lo que la tabla es o hace.
Esta descripcin es nicamente para efectos de documentacin.

Options ( Tab de Opciones )

El Tab de Opciones controla cierta informacin importante que utilizada por los asistentes (
Wizar/s ) o por los Wizatrones al momento de utilizar el enera/or /e Aplicaciones.

Do Not Auto-PopuIate This FiIe.
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 27
www.gopac.com.mx
cursosgopac.com.mx



Es utilizado para que tanto el Wizar/ o Wizatron no generen cdigo para esta tabla, al
momento de generar una aplicacin, por parte de ellos.

User Options

Proveen de nformacin a los Templates, ya sean propios o de terceros. Permite indicarle
a los Wizatrones cierta informacin para la generacin de cdigo tal como :

SmaII ndica que el archivo que se esta utilizando es pequeo y puede utilizar el Edtin
n Place.

EditInPIace ndica a que para este archivo no se genere un procedimiento independiente
de actualizacin ( Forma ), si no que en el mismo Browse permita
actualizar la informacin

Recomendamos ampliamente revisar la Ayu/a de Clarion, en el tema Como Disear un Diccionario
/e Datos y una Base /e Datos, en caso de que tenga alguna duda de como realizar estos procesos. (
How to Design our Dictionary an/ Database ? )

Tip : Algunos campos pueden ser inicializados por default mediante las opciones que se muestran en el
Men $etup / Dictionary ptions / %able ptions

Propiedades de un Campo Nuevo ( Tab GeneraI )

La ventana de Column !roperties, permite especificar completamente las caractersticas de los
campos que estn en una tabla, as como establecer las opciones y atributos de las relaciones. Cuando
se definen Variables lobales o Variables %ipo !ool existen nicamente pocos atributos que no se
pueden definir a este tipo de variables que no son campos de tablas. El /itor /el Diccionario, permite
aadir de una manera rpida los campos , una vez que uno presiona el botn de , el /itor /el
Diccionario, volver a pedir un nuevo campo a dar de alta. A continuacin explicamos cada uno de los
controles mostrados en la ventana de Propiedades.

GeneraI ( Tab de GeneraI )

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 28
www.gopac.com.mx
cursosgopac.com.mx


CoIumn Name ( Nombre deI Campo )

Para nombrar un campo, digite un nombre vlido de Clarion. Son permitidos un mximo
de 80 caracteres y pueden consistir en caracteres alfabticos, nmeros, carcter de
subrayado ( _ ) o el smbolo de ( : ). Los nombres no pueden contener espacios y no
pueden iniciar con un nmero o smbolo.

Tip : El nombre utilizado, ser asignado automticamente al texto del Prompt ( !rompt
%et ) as como al titulo de la columna del reporte ( Column Hea/ing ), por lo
tanto es importante que para ahorrar tiempo de diseo, el nombre vaya de acorde
al nombre del campo tanto en la pantalla como en el reporte, manejando
maysculas y minsculas, ya que como una ayuda, cada vez que Clarion
identifique un cambio de maysculas y minsculas en el nombre, al momento de
asignarlo en el campo de !rompt %et y Column Hea/ing, Clarion pondr un
espacio en blanco . Ej.

CoIumn Name : CodigoCliente
Prompt Text : Codigo Cliente :
CoIumn Heading : Codigo Cliente :
Derived From ( Derivado de )

Permite asignar al campo los atributos y caractersticas de otro campo generado
previamente, ya sea un campo de un !ool /e Datos de otra tabla o de esta misma
tabla., estableciendo una relacin Padre Hijo entre los campos. Copia todos los
atributos excepto el nombre. Para actualizar el campo desde el padre presione el botn
de Actualizar, en caso de querer prevenir la actualizacin del campo active el Checkbo
de Freeze en la parte inferior de la pantalla.

Description ( Descripcin )

Es un conjunto de caracteres utilizados para describir completamente el campo. Las
descripciones de los Campos son utilizados cuando los asistentes ( Wizar/s ) crean
Browses, Formas y Reportes, as mismo la descripcin es utilizada en los campos del
%ab /e Ayu/a ( Message y %ool %ip ) , siempre y cuando este activada la casilla de
Assign Description to Message / %ool %ip en el Men /e $etup / Dictionary ptions
/ Column ptions

Data Type ( Tipo de Dato )

Para asignar el tipo de dato de un campo seleccione uno de la lista de tipos. Clarion
soporta una gran cantidad de tipos, que especifican como se almacenara la informacin
en el disco por medio del driver de la tabla, y como ser accesada por la aplicacin. Los
tipos disponibles varia de acuerdo al tipo de driver seleccionada para la tabla.

Tip : El tipo DecimaI generalmente provee el mejor rendimiento par los clculos
matemticos.

Base Type ( Tipo Base )

Digite el nombre de una estructura tipo Group o Queue, previamente declarada, con el cual
se heredara a esta nueva estructura. Este atributo nicamente esta activo con los tipos de
datos Group, Like o Type.

Characters ( Longitud deI Campo )

Asigna la mxima longitud del campo que puede digitarse y almacenarse.

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 29
www.gopac.com.mx
cursosgopac.com.mx


PIaces ( DecimaIes )

Utilizado con el tipo DecimaI y tipos de datos de punto flotante para especificar el
nmero de decimales asociados con el nmero.

Dimensions ( ArregIos )

Declara variables como arreglos, especifica las dimensiones del arreglo. Se pueden
asignar hasta arreglos de cuatro dimensiones.

Row Picture ( Mascara de Registro )

Utilizado con el tipo de datos Picture. Esta mscara permite indicar el formato con la que
la informacin es almacenada. Esto no implica que no se pueda mostrar posteriormente
la informacin con otro tipo de mscara.

Screen Picture ( Mscara de DespIiegue )

Permite indicar el tipo de mscara que se utilizara para este campo cuando este sea
mostrado en una ventana o en un reporte. El icono del candado indica, cuando este
cerrado, que la mscara asignada no cambiar aunque el tipo de dato sea cambiado.

Prompt Text

Especifica el valor con el que se inicializar la leyenda del campo a utilizar por el
enera/or /e Aplicaciones cuando este genere una ventana y necesite utilizar este
campo. Asume el valor del nombre del campo por defecto separando la palabra cada vez
que encuentre una mayscula, agregando los dos puntos al final del mismo.

CoIumn Heading

ndica el titulo de la columna, toma por defecto el valor indicado en el nombre del campo
igual que !rompt %et. El enera/or /e Aplicaciones lo utiliza cuando el campo es
utilizado en el formato de un un reporte.

Freeze

Esta casilla activada previene que las caractersticas ya definidas del el campo sean
actualizadas nuevamente a travs de los valores del campo que fue derivado; es decir si
el campo fue derivado y los valores del campo origen son cambiados y se hace una
actualizacin a todos sus campos hijos, solamente se actualizaran aquellos que esta
casilla no este activada.
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 30
www.gopac.com.mx
cursosgopac.com.mx




.
Attributes ( Tab de Atributos )

En esta ventana se especifican las caractersticas de un campo al momento de que este sea
capturado, tales como el tipo de letra mayscula, propiedades del cursor en este control y como
sern desplegados los caracteres en la ventana

Case ( MayscuIas / MinscuIas )

Este botn de radio controla el ingreso de los caracteres alfabticos que son tecleados
en este control.

NormaI

Los caracteres alfabticos que son digitados no sern modificados por la
aplicacin

Word CapitaIize ( Tipo TtuIo )

Este modo especifica que la primera letra de cada palabra sea mayscula y los
dems caracteres sern minsculas. La aplicacin convertir los caracteres que
sean necesarios para cumplir con este atributo.

Uppercase ( MayscuIas )

Este atributo le indica a la aplicacin que nicamente son permitido caracteres
alfabticos en maysculas para este control. La aplicacin convertir los
caracteres que sean necesarios para cumplir con este atributo.


_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 31
www.gopac.com.mx
cursosgopac.com.mx


Typing Mode ( Modo de Escritura )

ndica el modo en que se mostrara el modo de escritura en el control especificado.

Set Insert ( Activa eI Modo Insert )

Para controles tipo $tring, la manera en que se inserta la informacin es tipo
procesador de palabras en modo de insercin. Si la informacin es comenzada a
digitarse en un control que contiene informacin anterior, la informacin original
es movida a la derecha hasta que se alcance el limite del control. Para controles
tipo numrico, este modo implica que el campo ser llenado de derecha a
izquierda tipo calculadora.

Tip : Este modo es recomendado para controles numricos que
contengan informacin que vare significativamente en su longitud
as como para controles tipo monetarios.

Set Overwrite ( Activa Modo Sobrescritura )

Este modo implica que al momento de digitar informacin en el control esta ser
substituida por la informacin que se este digitando. En controles numricos este
modo especifica que los nmeros digitados sern ingresados de izquierda a
derecha.

Do Not Reset ( Activa Modo No Borrar )

Especifica el modo de ingresar datos para que no sean cambiados por este
control. El mtodo de ingresar datos ser a partir del limite izquierdo establecido
en el control.

FIags ( Indicadores )

Inmmediate ( Inmediato )

Especifica una notificacin inmediata del evento para los controles que hagan
referencia a este campo

Password ( Indicador de CIave de Acceso )

Este atributo especifica que la informacin digitada en este control debe de ser
confidencial ( oculta ). Conforme se digiten los caracteres dentro de este campo,
sern reemplazados automticamente por asteriscos ( * ). Este atributo es
seleccionado para campos requeridos que contengan informacin confidencial,
tal como las claves de acceso.

Read OnIy ( SoIo Lectura )

Este atributo indica que el campo nicamente ser desplegado, no permitiendo
nunca su edicin de la informacin contenida.

Justification ( Justificacin )

ndica la alineacin que ser referenciada en este campo, seleccionando de la lista .
Alineacin Izquier/a, Derecha, Centra/o, %ipo Decimal o Ninguno.
Offset ( Sangra )

Especifica la cantidad de sangra que el control tendr.
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 32
www.gopac.com.mx
cursosgopac.com.mx



InitiaI VaIue ( VaIor IniciaI )

ndica el valor inicial con el que el campo ser inicializado. Especificando un valor inicial
para un campo de base de datos . El enera/or /e Aplicaciones genera las
declaraciones necesarias de asignacin.

Tip : Si se requiere inicializar una variable con caracteres, estos deben estar entre
comillas, en el caso de nmeros nicamente digitar los nmeros, si se requiere
inicializar con una variable local o global indicar solo el nombre de la variable o el
nombre de una funcin

ExternaI Name ( Nombre Externo )

Permite indicar un nombre externo diferente al nombre asignado en el Nombre /el
Campo. Esto es cuando el nombre del campo en el programa es diferente al nombre del
campo en la base de datos, por ejemplo, se puede estar accesando una base de datos
va DBC, la cual permite nombre de campos mayores a los permitidos por Clarion,
para lo cual se deber de registrar el nombre tal y como existe en la base de datos
directamente en este campo.

PIace Over

Permite declara un campo como un overlay, seleccione otro nombre de campo de la lista.

Comments ( Tab de Comentarios )

Permite teclear una descripcin amplia del campo. La descripcin es nicamente para propsitos
de documentacin y no tienen un efecto en la aplicacin. Es altamente til llenar este campo
cuando existen varios programadores o cuando pasa el tiempo y vuelve a retomar o modificar,
ah encontrara toda la informacin necesaria para este campo.

Options ( Tab de Opciones )

Un conjunto de opciones que estan disponible para cada control / campo que se genere y tenga
efecto en los Wizar/s / Wizatrons /e Browse, Forma.

Do Not Auto-PopuIate This CoIumn

Activando esta casilla indica que este campo no sea utilizado por los Wizar/s cuando se
generen los procedimientos por ellos, es decir ser omitido al generar un procedimiento
con los Wizar/s o Wizatrons

PopuIation Order

Es utilizado para indicarle a los asistentes el orden en que se es utilizado este campo.
Existen tres opciones Normal, First o Last ( Normal, !rimero o Ultimo )

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 33
www.gopac.com.mx
cursosgopac.com.mx


From Tab

Designa el nombre del Tab en donde se requiere que este campo en particular sea
desplegado. Esto permite controlar como se requiere que los campos sean agrupados en
los procedimientos generados por los asistentes.


Add Extra VerticaI Space Before CoIumn ControIs on From Procedures

Aade un espacio adicional en los renglones entre los campos que son mostrados.

User Options ( Opciones deI Usuario )

Proveen de nformacin a los Templates, ya sean propios o de terceros. Permite indicarle
a los Wizatrones cierta informacin para la generacin de cdigo tal como :

Interest : Permite indicarle al Dictionary Wizatron que tan importante es este campo,
esto es muy til cuando uno desea que en vez de que le muestre los cdigos
de un campo, muestre su descripcin que esta referenciada en otra tabla y
esto se requiere que se haga de forma automtica, esto se logra indicando al
campo el nmero que tiene de Interest ( Inters ) muy bajo como 1 y al
campo de nombre de la otra tabla se indica con un Interest ( Inters ) muy
alto como 9. Debe de existir una relacin entre las dos tablas para que esto
se pueda realizar. En tiempo de ejecucin el Generador de ApIicaciones
adiciona un control de lista, para seleccionar el campo por su descripcin no
por su nmero.
HeIp ( Tab de Ayuda )

Existen tres opciones para cada campo para indicar diferentes niveles de ayuda que se requiera
hacer disponibles en las aplicaciones generadas.

HeIpID ( Identificador de Ayuda )

Este i/entifica/or /e Ayu/a, es utilizado para relacionar los archivos de ayuda creados
por programas externos. Hace referencia al tema que se requiere mostrar cuando el
usuario digite la tecla de F1

Message ( Mensaje )

Permite desplegar mensajes en la Barra /e $tatus /e la Ventana.

TooI Tip

Crea ayuda para cada campo del programa la cual se visualizara al momento de acercar
el mouse al campo.

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 34
www.gopac.com.mx
cursosgopac.com.mx





VaIidity Checks ( Tab de VaIidaciones )

El %ab /e Vali/aciones, permite establecer las reglas para determinar si la informacin que es
digitada son datos vlidos. Este Tab contiene Botones de Radio que permiten especificar
mtodos de validacin de datos particulares.

No Checks

Especifica que no hay ninguna validacin a realizar en este campo.

Choices ( Opciones )

Permite indicarle al campo las opciones que son vlidas, las cuales se
representaran en la ventana en forma de botn de Ra/io, $pin, List o Combo.
La forma en que se deben de aadir las opciones es en el siguiente formato
"pcin1|pcion2|pcion3, siempre deben de ser separadas las opciones por
medio del carcter pipe ( | )

VaIues Type ( VaIores de Ia Opciones )

Son el valor a asignar a cada una de la opciones correspondientes. El formato de
los valores es el siguiente "Valor1|Valor2|Valor3 siempre deben de ser
separadas las opciones por medio del carcter pipe ( | )

Cannot Be Zero or BIank ( No puede ser VaIor Cero o BIanco )

Especifica que cierto tipo de informacin debe de ser digitada en el campo. Vuelve el
campo como campo requerido.

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 35
www.gopac.com.mx
cursosgopac.com.mx


Must be in Numeric Range ( Entre Rangos Numricos )

Especifica que el dato ingresado debe de estar en un rango numrico. El valor mnimo o
mximo o ambos deben de ser especificados. El enera/or /e Aplicaciones genera el
cdigo necesario para realizar la validacin y aade un control tipo SPIN

Lowest

Esta casilla activa el campo para indicarle el valor mnimo del rango

Highest

Esta casilla activa el campo para indicarle el valor mximo del rango

Tip : Especificando nicamente el valor mnimo o el valor mximo, se especifica un
rango abierto por un lado


Must be True or FaIse ( VaIor Verdadero o FaIso )

Establece un valor Boleano ( si / no, verdadero / falso, prendido / apagado, etc. )

True VaIue ( VaIor Verdadero )

ndica el valor a asignar cuando el usuario elija este control

FaIse VaIue ( VaIor FaIso )

ndica el valor a asignar cuando el usuario elija este control

Must be in FiIe

Se indica que el campo debe de estar contenido en el campo de otra tabla. Esta opcin
se activa nicamente cuando existe una relacin previa con otra tabla o tablas.

Nota : Esta relacin debe de existir para que las opciones de Interest en el Tab de
Opciones / User Options funcione adecuadamente.

TabIe LabeI ( Nombre de Ia TabIa )

Seleccione la tabla de la lista de tablas relacionadas. El enera/or /e
Aplicaciones genera el cdigo para asegurar que el valor seleccionado se
encuentre en la tabla y realizar la validacin necesaria.

Must be in List ( Debe de Existir en Ia Lista )

Especifica que el valor ingresado debe de concordar con los especificados en las
opciones. Las opciones son desplegadas en controles del tipo $!IN, LI$%, CMB o
RADI

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 36
www.gopac.com.mx
cursosgopac.com.mx


Choices ( Opciones )

Permite indicarle al campo las opciones que son vlidas, las cuales se
representaran en la ventana en forma de botn de Ra/io, $pin, List o Combo.
La forma en que se deben de aadir las opciones es en el siguiente formato
"pcin1|pcion2|pcion3", siempre deben de ser separadas las opciones
por medio del carcter pipe ( | )

VaIues Type ( VaIores de Ia Opciones )

Son el valor a asignar a cada una de la opciones correspondientes. El formato de
los valores es el siguiente "Valor1|Valor2|Valor3" siempre deben de ser
separadas las opciones por medio del carcter pipe ( | )

Opciones de Ios tabs de Window y Report

La apariencia y caractersticas de un campo o control pueden ser preestablecidas cuando son
adicionados a la estructura de una ventana o reporte, mediante su acceso o modificacin a las
opciones que se muestran en estos Tabs.

Seleccionando las propiedades de un control en este momento, puede ahorrar tiempo. Cada
aplicacin generada desde el diccionario y cada procedimiento en la aplicacin automticamente
adicionaran el control de acuerdo a las caractersticas que se definieron en esta parte. Si no se
define el formato en este momento y el control requiere un formato especfico, el cual se tendr
que especificar en tiempo de diseo de la aplicacin y se tendr que realizar uno por uno, o
regresar a esta parte, formatear todos los campos y volver a generar la aplicacin.

Tip : En esta seccin se puede seleccionar como se requiera que el control se muestre
tanto en su descripcin ( !rompt ) , como el formato de entrada que se requiera (
ntry ) y en el caso de un reporte el ( $tring ). Puede uno modificar el tipo de
entrada y cambiar entre las diferentes opciones que se muestren $!IN, LI$%,
CMB o RADI, etc.

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 37
www.gopac.com.mx
cursosgopac.com.mx


Propiedades de una LIave / Indice ( Tab GeneraI )



Los ndices son el mecanismo para organizar u ordenar registros en una tabla de datos, basndose en
el contenido de un campo o la combinacin de los mismos. Las llaves son utilizada para localizar
rpidamente registros relacionados en un ambiente de base de datos relacional y permitiendo que la
informacin sea presentada en una secuencia ordenada en particular.

El cuadro de dilogo permite definir los ndices para la tabla seleccionada. El /itor /el Diccionario
permite aadir ndices y sus componentes de una manera rpida. Cada vez que se complete el llenado
de los atributos de los ndices y se cierre el cuadro de dilogo de las !ropie/a/es, un nuevo cuadro de
dilogo en blanco aparecer listo para generar la siguiente llave.

GeneraI ( Tab GeneraI )

Key Name ( Nombre deI Indice )

Es la etiqueta o nombre a ser utilizado cuando se refiera a esta llave o ndice dentro de la
aplicacin. La etiqueta o nombre puede ser hasta de 255 caracteres. Puede ser
conformado de letras, nmeros, carcter de subrayado ( _ ) y los dos puntos ( : ). La regla
de uso : no pueden iniciar el nombre con un carcter distinto a letras y no tiene importancia
si es maysculas o minsculas. Recuerde que no puede asignar como nombre el nombre
de un campo de la tabla.

Description ( Descripcin deI Indice )

Es un conjunto de caracteres utilizados para describir completamente el contenido del
ndice o Llave. El enera/or /e Aplicaciones, utiliza la descripcin cuando genera una
aplicacin Browse, Forma y Reporte, por lo cual es importante incluir la descripcin
para facilitar el trabajo posterior.
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 38
www.gopac.com.mx
cursosgopac.com.mx



Type ( Tip de Indice )

Permite especificar una llave como ndice esttico, dinmico o de orden.

Row Key

La llave o ndice es una secuencia ordenada en un campo o grupo de campos
que es mantenido individualmente por la aplicacin. Al momento que los
registros de informacin son modificados la secuencia es ordenada de manera
automtica

Static Index ( Indice Esttico )

Es una llave o ndice que esta en una secuencia ordenada que refleja el
contenido de una tabla en un momento determinado. Los ndices no son
mantenidos de manera dinmica, son creados cuando son especificados. Estos
ndices son tiles para ordenar secuencias que son utilizadas nicamente en
periodos largos ya sean en procesos mensuales o anuales.

Runtime Index ( Indices Tiempo de Ejecucin )

Los ndices dinmicos permiten seleccionar una secuencia de ordenamiento a
escoger cuando el programa se ejecute. El ndice dinmico es definido sin
componentes. En tiempo de ejecucin, el comando Buil/ es utilizado para crear
el ndice dinmico.




Attributes



ExternaI Name ( Nombre Externo )

Especifica el nombre de DOS para llaves externas


_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 39
www.gopac.com.mx
cursosgopac.com.mx


Require Unique VaIue ( Requiere VaIor Unico )

ndica al ambiente de desarrollo que esta llave requiere valor nico por cada llave, es
decir no permite registros que generen duplicidad en el valor de la llave.

Primary Key ( LIave Primaria )

Establece a la llave actual como llave primaria. Unicamente puede ser activado un ndice
como llave primaria por archivo. Esto es soportado por algunos drivers de base de datos
nada mas. Requiere que estn activados los atributos de Require Unique Value y de
clu/e mpty eys

Auto Number ( Auto NumerabIe )

Especifica al enera/or /e Aplicaciones, que genere el cdigo necesario para
mantener la secuencia numrica del registro de una manera automtica.

Case Sensitive ( MayscuIas / MinscuIas )

Para ordenar el registro en caso de querer que el ndice o llave sea sensitivo a
maysculas y minsculas. Cuando se crea o actualiza una llave todas las letras
maysculas se ordenaran antes de todas aquellas que tengan minsculas, de acuerdo al
cdigo de la Tabla ASC.

ExcIude Empty Keys ( ExcIuir LIaves Vacas )
.
Permite excluir registro con valor cero o nulo en el valor de su llave.

Comments ( Tab de Comentarios )


Permite teclear una descripcin amplia con toda la informacin necesaria acerca de la llave o
ndice. La descripcin es nicamente para propsitos de documentacin y no tienen un efecto en
la aplicacin. Es altamente til llenar este campo cuando existen varios programadores o cuando
pasa el tiempo y vuelve a retomar o modificar, ah encontrara toda la informacin necesaria para
est llave.

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 40
www.gopac.com.mx
cursosgopac.com.mx





Options ( Tab de Opciones )

Do Not Auto-PopuIate This Key

ndica al Asistente o Wizar/ que no genere cdigo para esta llave cuando se creen los
procedimientos de Browse o /e Reporte

PopuIation Order

Especifica el orden en que el Asistente generara las llaves. Seleccione Normal, First, o
Last de la lista. El Asistente generara en este orden primero todas las llaves
especificadas como First, en seguida las NormaI y por ltimo las Last, dentro de un
Browse o Reporte.




_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 41
www.gopac.com.mx
cursosgopac.com.mx






CoIumnas

Especifica los componentes de la llave / ndices ( campo o campos ) que se utilizaran. Se puede
especificar ms de un campo por llave. Cada campo es aadido a la lista de llaves en el cuadro
de dilogo de Definicin /e Campos / Llaves ( Fiel//eys Definition )

Sort Order ( Secuencia de Ordenamiento )

Se permite ordenar de dos manera, Ascen/ente o Descen/ente el campo que se va
aadir. No todos los drivers soporta la mezcla de ascendentes y descendentes en la
misma llave. Consulte la documentacin de Clarion.

Insert ( Inserta eI Campo/s de Ia LIave )

Permite seleccionar el o los campos que compondrn la llave.

DeIete ( Borrar )

Borra el componente de la llave que se encuentre seleccionado.

.
Move up/Move Down

Permite mover el componente de la llave seleccionado, a una posicin superior o
inferior.

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 42
www.gopac.com.mx
cursosgopac.com.mx


2.5 Ejercicio Generando eI PooI de Datos deI Diccionario

El concepto de !ool, permite definir una tabla que no genera cdigo dentro de la aplicacin, pero en ella
se definen los campos ms repetitivos y generales que se utilizarn en las dems definiciones de
campos de otras tablas, esto permitir derivar los campos nuevos a partir de la definicin de los campos
realizados en el Pool de Datos.

Un !ool de datos correctamente definido, permite ahorrar tiempo en el diseo de las dems tablas de
manera considerable, por lo cual recomendamos ampliamente que siempre que se desarrolle una nueva
aplicacin se genere un nuevo !ool de datos o se importe un !ool ya generado con anterioridad para
ayudar a la definicin rpida y congruente de los datos de las tablas a utilizar.

En el Apn/ice I structura /e Diccionario Acme se presenta el !ool de datos a utilizar en el
diccionario de datos Acme.


1. Presione el botn de Aa/ir %abla y seleccione %able .


2. Enseguida se le preguntar si quiere utilizar "uick Loa/ , seleccione el botn de No, para accesar la
ventana de !ropie/a/es /e una %abla ( New %able !roperties )



3. Seleccione en el Usage la opcin de PooI




4. En el campo Name teclee el nombre de la Tabla ( !L ), en el campo Description teclee una
breve descripcin de lo que se refiere esta tabla . El campo de !refi, el Ambiente /e Desarrollo le
asignara automticamente el prefijo a utilizar ( POO )




5. En seguida presione el botn de OK, con lo cual
la tabla ser adicionada a la lista de tablas del
diccionario ACM. Todos las tablas tipo Pool se
identificaran porque se antecede de un icono de
archivo color azul.


Con estos pasos se acaba de crear un esquema vaco del PooI de Datos, en seguida pasaremos a
generar los campos que contendr este PooI de Datos.

Nota : Grabe su diccionario.
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 43
www.gopac.com.mx
cursosgopac.com.mx


2.5. Ejercicio Generando Ios Campos deI PooI de Datos deI Diccionario

1. Presione el botn para crear Campos / In/ices (Columns/eys )

Tip : Puede accesar rpidamente a Campos / In/ices presionando doble click en la tabla PooI.

2. Presione el botn de Insert de la ventana de Column - ey Definition para crear los campos.

3. En el Apn/ice I structura /e Diccionario Acme se encuentra la definicin de todos los campos
que contiene la tabla PooI.

4. En la ventana de New Column !roperties se deber de digitar informacin en los campos
necesarios de acuerdo a las caractersticas de cada uno de ellos en base a la structura /el
Diccionario Acme.

5. Una vez digitada la informacin correspondiente del campo presione el botn , para que este
campo sea agregado a la tabla del !ool y pueda continuar con los dems campos, una vez
terminado de capturar todos los campos que se requieren, presione el botn de Cancel para dar por
terminada la captura y enseguida el ambiente de desarrollo le enviara la ventana de Column / ey
Definition con los campos generados :

Propiedades de Ia Ventana :

Insert permite insertar nuevoa campos.
Properties permite modificar las propiedades establecidas del campo seleccionado
DeIete permite borrar el campo seleccionado de la tabla
permite cambiar la posicin del campo seleccionado hacia arriba o abajo

CIose permite cerrar la ventana y regresar a la ventana de Lista /e %ablas
HeIp invoca la ayuda de Clarion

Nota : Grabe su diccionario.
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 44
www.gopac.com.mx
cursosgopac.com.mx


2.6 Ejercicio Creando una TabIa Nueva en eI Diccionario ( TabIa de Vendedor / CIiente )

En la estructura del diccionario ACME, contiene dos tablas que hay que generar , una es la tabla de
Ven/e/or y otra es la de Cliente, por medio de los pasos siguientes se crearan estas 2 tablas. Se
utilizar la tcnica de derivacin de campos a partir del PooI generado en el ejercicio anterior.

1. Presione el botn de Aa/ir %abla y seleccione %able.


2. Seleccione el botn de No, en la ventana de "uick Loa/



3. El campo Usage tiene seleccionado la opcin de Table




4. En el campo Name tecle el nombre de la Tabla (
Ven/e/or ) y en el campo Description teclee una
breve descripcin de lo que se refiere esta tabla.
En el campo de !refi el Ambiente /e
Desarrollo le asignara automticamente el prefijo
a utilizar ( VEN ) . Verifique que el driver
seleccionado sea %opspee/ ( %!$ ).


5. En seguida presione el botn de , con lo cual la tabla ser adicionada a la lista de tablas del
diccionario ACME.

Una vez realizado estos pasos realice los mismos para la tabla de CIiente.

Terminado este proceso la ventana de la lista de tablas quedar de la siguiente manera :

Nota : Grabe su diccionario.









_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 45
www.gopac.com.mx
cursosgopac.com.mx


2.6. Ejercicio Creando Campos para TabIa Nueva ( TabIa de Vendedor / CIiente )

1. Presione el botn para crear Campos / In/ices ( Columns/eys )

Tip : Puede accesar rpidamente a Campos / In/ices) presionando doble click en la tabla PooI.

2. Presione el botn de Insert de la ventana de Column - ey Definition para crear los campos.

3. En la structura /e Diccionario Acme se encuentra la definicin de todos los campos que contiene
la tabla Ven/e/or / Cliente .

4. En el las ventanas de New Column !roperties se deber de digitar la informacin de los campos
necesarios de acuerdo a las caractersticas de cada uno de ellos en base a la Estructura del
Diccionario Acme.

Nota : En el los campos que se muestran en la structura /el Diccionario en la columna Der. viene
indicado que campos son derivados de la tabla de PooI, por lo cual una vez digitado el nombre
del campo con esta marca, se deber de presionar el botn de elipsis, seleccionar ( con doble
click ) la tabla PooI, y seleccionar el campo del cual se requiera derivar. Observe que
nicamente se debe de derivar el campo a la tabla, todos los dems atributos son tomados de
ese campo, por lo cual no se tiene que realizar ninguna actividad para cambiar los atributos.


5. Una vez digitada la informacin correspondiente del campo presione el botn , para que este
campo sea agregado a la tabla del Vendedor y pueda continuar con los dems campos, una vez
terminado de pasar todos los campos que se requieren presione el botn de Cancel para dar por
terminada la captura y enseguida el ambiente de desarrollo le enviara la ventana de CoIumn / Key
Definition con los campos generados :











Contine con
los pasos
anteriores
para generar la
tabla de Cliente.

Nota : Grabe su
diccionario.

Continue con
las dems tablas
generando los
campos
necesarias que vienen en el la structura /e Datos /el Diccionario Acme. Al terminar debe llegar a
tener esta estructura de campos por tabla.

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 46
www.gopac.com.mx
cursosgopac.com.mx










Campos Tabla de Cliente Campos Tabla de Detalle


Campos Tabla Factura Campos Tabla Familia



Campos Tabla Pagos Campos Tabla Artculos












Campos Tabla LogClientes
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 47
www.gopac.com.mx
cursosgopac.com.mx


2.7 Ejercicio Agregando Opciones a Ias TabIas ( DetaIIe / FamiIia )

En la structura /e Datos /el Acme, de las tablas de Detalle y Familia, es necesario agregarle cierta
informacin en el %ab ptions de la !ropie/a/es /e la %abla.

1. Seleccione de la lista de tablas la tabla de Detalle y presione el botn de !roperties,
para editar las propiedades de esta tabla .

2. Seleccione el Tab de Options y en la casilla de Do Not
Auto !opulate %his %able actvela. Esto es con el fin de
que el archivo de detalle, al momento de generar la
aplicacin por medio del enera/or /e Aplicaciones, no
genere ningn procedimiento para esta tabla.


3. Presione el botn de OK para regresar a la lista de tablas.

4. Seleccione de la lista de tablas la tabla de FamiIia y presione el botn de Properties,
para editar las propiedades de esta tabla

5. Seleccione el Tab de Options y en el cuadro de !roperty / Value, presione click /erecho /el
mouse y seleccione la opcin Insert

6. En el cuadro de !roperty
Label digite SmaII



7. Presione el botn de OK.





8. En el cuadro de !roperty / Value presione nuevamente click /erecho y seleccione la opcin Insert
y en el cuadro de !roperty Label digite EditInPIace y presione el botn de OK.


Se mostraran las siguientes opciones en el Tab de Options :



Nota : Grabe su diccionario.


_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 48
www.gopac.com.mx
cursosgopac.com.mx



2.8 Ejercicio Generando Indices - LIaves para Ias TabIas

En la structura /e Datos /e Acme, todas las tablas a excepcin de la tabla PooI y la tabla de Pagos,
se tienen que generar sus ndices.

Nosotros recomendamos utilizar la siguiente nomenclatura para identificacin rpida de los tipos de llave
que se generen :

PKNombreLlave El prefijo PK permitir identificar a las llaves primarias ( Primary Key )
AKNombreLlave El prefijo AK permitir identificar a las llaves alternas ( Alternate Key )
FKNombreLlave El prefijo FK permitir identificar a las llaves forneas ( Foreign Key )


1. Seleccione de la lista de tablas del diccionario, la tabla de CIiente y presione doble click para editar
las propiedades de campos y llaves.

2. Selecciones el Tab de Keys y presione el botn de Insert

3. En el campo de Key Name digite el
nombre de la llave ( !Co/igo ) y en
descripcin !or C/igo.

4. Verifique que en las opciones de %ype
este seleccionado Row Key





5. Seleccione el Tab de Attributes



6. Active las casillas de Require Unique VaIue ( ), Primary
Key ( 2 ), Auto Number ( 3 ) , ExcIude Empty Keys ( 5 )

7. Seleccione el Tab de Comments para teclear una
descripcin amplia de con toda la informacin necesaria
acerca de la llave o ndice.


8. Seleccione el Tab de Opciones y active la casilla de Do Not Auto-PopuIate This Key, con el fin
que el Asistente no genere ningn procedimiento para esta llave al momento de generar la
aplicacin o procedimiento para esta tabla.

9. Seleccione el Tab de CoIumns

10. Presione el botn de Insert para
adicionar un campo para ordenar el
In/ice.

11. Seleccione el botn de OK para agregar
esta llave a la lista de llaves de esta
tabla.

Continue con estos pasos para agregar las dems llaves a esta tabla.
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 49
www.gopac.com.mx
cursosgopac.com.mx


Una vez terminado de agregar las llaves necesarias a la tabla de CIiente, obtendr una lista de llaves
como la siguiente :




















Continue con las dems tablas generando las llaves necesarias que vienen en el la Estructura de Datos
del Diccionario Acme. Al terminar debe llegar a tener esta estructura de llaves por tabla.

Llaves Tabla Artculos Llaves Tabla Detalle Llave Tabla Factura

Llaves Tabla Familia Llaves Tabla Pagos Llave Tabla 'endedor


No ta : Grabe su diccionario.

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 50
www.gopac.com.mx
cursosgopac.com.mx




ReIaciones entre TabIas

Las Rrelaciones entre las tablas describe como estas estarn relacionadas entre si mediante llaves,
campos comunes y como la referencia integral entre ambas tablas es mantenida. Definir las relaciones
entre las tablas es generalmente el ultimo paso de la creacin de los Diccionarios ya que es necesario
que estn creados tanto los campos como las llaves para poder crear estas relaciones.


En la parte derecha de la ventana del diccionario es donde se generan e identifican las relaciones entre
las tablas.




Opciones de Ia Ventana :



Crea una relacin de la tabla seleccionada a la lista ( ADD RELATION ) .

Permite modificar las propiedades de una relacin existente.

Permite borrar una relacin existente.


_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 51
www.gopac.com.mx
cursosgopac.com.mx



Tab GeneraI

Type ( Tipo de ReIacin )

Determina el tipo de la relacin que va existir entre los archivos 1:Many o Many:1 ( Uno
a Muchos o Muchos a Uno es decir !a/re : Hijos o Hijos : !a/re ) .

Key ( LIave )

Dependiendo de la relacin seleccionada, escoja la llave primaria o la llave fornea de la
tabla principal

Nota : Dependiendo del tipo de relacin seleccionada, el siguiente Grupo puede ser nombrado Chil/ (
Hijo ) o !arent ( !a/re ) respectivamente 1:Many o Many:1.

ReIated FiIe ( TabIa a ReIacionar )

De la lista a de tablas seleccione una tabla a relacionar.

Key ( LIave / Indice )

Dependiendo del tipo de relacin escogida para la tabla seleccionada, en la lista
aparecern las llaves Primaria o Forneas a seleccionar para realizar la relacin. Debe
de existir una en las llaves por lo menos un campo en comn que haga el enlace, en
caso de seleccionar la llave primaria en este campo, todos los campos de la llave
primaria deben de tener concordancia con la llave de la tabla de relacin.
FieId Mapping

En este grupo se despliegan dos listas, cada una mostrando la llave y sus campos. Si los
campos de cada llave son iguales a los de la otra, se selecciona el botn de Map by
Name, y el /itor /el Diccionario automticamente enlazara los campos. En caso de
que no sean iguales, ser necesario enlazarlos manualmente indicando que campo es la
relacin con el otro. En caso de que el orden en que estn mostrados los campos es la
relacin que se requiere, seleccionando el botn de Map by r/er, el /itor /el
Diccionario enlazara los campos en el orden en que estos son mostrados.

ReferentiaI Integrity Constraints ( RegIas de Uso en Ias Referencias IntegraIes )

Las referencias integrales permiten definir reglas para mantener las relaciones entre las
tablas, tanto al modificar registros como al borrar los registros. Las referencias requieren
que las llaves forneas no contengan ningn valor que no tenga su correspondiente en la
llave primaria. Esto ocasiona problemas potenciales cuando el usuario final decide
cambiar o borrar el registro de la llave primaria.

On Update

Este atributo permite especificar que accin ser tomada cuando se intente
modificar el registro !a/re con registros Hijos.

On DeIete

Este atributo permite especificar que accin ser tomada cuando se intente
borrar un registro !a/re con registros Hijos.

La lista de acciones que se pueden seleccionar para estos atributos son :

_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 52
www.gopac.com.mx
cursosgopac.com.mx


No Action Le indica al enera/or /e Aplicaciones que no debe de
generar ningn tipo de cdigo para mantener la referencia
integral entre las tablas. Esto genera que los procesos para
validar las relaciones se tengan que realizar de manera manual.
Restrict Esta opcin restringe al usuario borrar un registro, si el valor es
usado en una llave fornea.
Cascade Actualiza o borra los registros Hijos, al ser actualizar o borrar el
registro !a/re
CIear ndica que el valor en el registro Hijos sea inicializada en blanco
o cero.

Tip : Una vez creado las tablas, llaves y relaciones el diccionario esta completo y listo para que
se pueda disear una aplicacin usando el diccionario.

Tab Comments ( Tab Comentarios )

Permite teclear una descripcin amplia con toda la informacin necesaria acerca de la relacin.
La descripcin es nicamente para propsitos de documentacin y no tienen un efecto en la
aplicacin. Es altamente til llenar este campo cuando existen varios programadores o cuando
pasa el tiempo y vuelve a retomar o modificar, ah encontrara toda la informacin necesaria para
esta relacin.



2.9 Ejercicio Generando ReIaciones entre TabIas

TabIa de Vendedores <->> CIiente

La relacin que existe entre la tabla de Vendedores y la de Clientes es una relacin de 1 : Muchos ,
existen muchos clientes por vendedores. La tabla de clientes tiene una llave fornea
(FVen/e/or ) la cual es la llave de enlace con la tabla de vendedores.

1. Seleccione la tabla de Ven/e/or y presione el botn de aadir relaciones

2. En la relacin de Ven/e/or, seleccione el tipo ( %ype ) 1 : Many ( &no a muchos ) utilizando la
llave primaria de la tabla !Co/igo

3. En el siguiente cuadro seleccione de las opciones de Relate/ %able la tabla Clientes seleccionando
su llave fornea que hace relacin con la tabla vendedores FVen/e/or

4. En la lista de Columns Mapping , se seleccionara el botn de Map by r/er para que se
establezca una relacin de los campos de la izquierda con los campos de la derecha en el orden en
que se encuentra, en este caso entre los campos de ( CLI:Vendedor y VEN:Codigo, campo /e
Ven/e/or [ tabla de clientes (, y campo /e c/igo ven/e/or [ tabla de vendedor (

Tip : En caso de que exista alguna duda o mediante el botn de Map by Name o Map by Order no
permita establecer la relacin, presione doble click sobre el ( los ) campos que sean
necesarios para establecer la relacin, con lo cual le accede a una ventana en donde
seleccionara el campo con el cual se esta relacionando el campo. ( Esto se hara por cada
campo que se quiera establecer la relacin. ).

5. En las Referencias Integrales al momento de Actualizar On Update - la tabla, seleccione la
opcin Casca/e para que al momento de que la tabla !a/re se actualice la o las tablas Hijos sean
tambin actualizadas. En la opcin de Borrado On DeIete - la tabla, seleccione la opcin de
Restrict para que al momento de que la tabla !a/re se intente borrar un registro, esta verifique no
queden hurfanos en la o las tablas Hijos , en este caso no permitir el borrado de la tabla hasta que
los posibles registros hurfanos sean reasignados o borrados.
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 53
www.gopac.com.mx
cursosgopac.com.mx



6. Seleccione el botn de

7. Edite las propiedades de la tabla CIiente, y seleccione el %ab Vali/ity Checks y seleccione el botn
de Must be in %able, y de la lista seleccione la tabla de Ven/e/ores ( con esto se esta
estableciendo la referencia en la tabla de vendedor para que este campo siempre exista en la tabla
de vendedor creando una referencia integral )


8. Continue con las dems tablas generando las llaves necesarias que vienen en el la structura /e
Datos /el Diccionario Acme. Al terminar grabe su diccionario.
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 54
www.gopac.com.mx
cursosgopac.com.mx




Una vez realizadas todas las relaciones el ambiente de desarrollo esta listo para generar la aplicacin a
travs del generador de Aplicaciones.


- TRIGERS Los trigers son Cdigos de Clarion colocados en diferentes puntos en las propiedades
de las tablas que conforman el diccionario, que a su vez se une al cdigo de la aplicacin en
puntos ya predefinidos como al Antes de nsertar, Editar o borrar un Registro o as como
Despus de nsertar, Editar y Modificar, este cdigo puede estar en cada tabla que conforma
el diccionario.


- Uso de los Trigers:
-
- Los Triggers pueden suplir las
capacidaddes estandares de una base
de datos y proveer un sistema de menjo
altamente personalizado para la base
de datos. Por ejemplo un trigger puede
restringir las operaciones en una tabla
en horas espeficas o determinadas de
alta operacin. Asi como de dias de la
semana especificos. Puede prevenir
transacciones invalidas, asi como
generar estadsticas de lso accesos a
las tablas.


-
_abc Clarion Creacin y Mantenimiento de Diccionarios


Gopc Soluciones ntegrales, S.A. de C.V. 55
www.gopac.com.mx
cursosgopac.com.mx


- Los Triggers son una Herramienta poderosa en el desarrollo de aplicaciones, pero es
necesatrio inventir algo de tiempo en su planeacin. Se debe considerar que el ejecutar un
trigger puede accerar tablas que a su vez puede tener tambinen condificado el uso de otros
trigers.
-



Ejercicio : Registro de Actividades en la tabla de Clientes, en un archivo LOG.

Agregar una tabIa LOGCLIENTES, de tipo (ASCII) txt (LOGCLIENTES.TXT)







-
-
-
-
-
-
-
-


Agregar un campo G:CAMPOUNCO de tipo String de 200 caracteres (@s200)











_abc Clarion Generacin de Aplicaciones

Gopc Soluciones ntegrales, S.A. de C.V. 53
www.gopac.com.mx
cursosgopac.com.mx





































Creacin y
Mantenimiento a
ApIicaciones


En esta seccin se utilizar el diccionario
creado para generar a travs del Generador
de Aplicaciones de Clarion una Aplicacin.

CIarion para Windows
Introduccin






Generacin de
Aplicaciones
_abc Clarion Generacin de Aplicaciones

Gopc Soluciones ntegrales, S.A. de C.V. 54
www.gopac.com.mx
cursosgopac.com.mx

Generador de ApIicaciones ( AppGen )

Una vez definido correctamente el diccionario de la aplicaciones con todas sus tablas,
campos, ndices, validaciones y relaciones el siguiente paso es decidir que es lo que se va a
realizar con esta informacin.

La informacin tendr que ser capturada en los registros. La informacin existente debe
de ser revisada, borrada o reportada, para realizar estas tareas, la computadora necesita dar
instrucciones, las cuales deben de ser muy explcitas, guiando paso a paso que es lo que se
quiere realizar.

Con un lenguaje tradicional de programacin, es trabajo de los programadores el armar y
redactar todas las instrucciones que se requieran para generar un programa. Con Clarion, la
estructura principal de un programa es generada de manera automtica. Unicamente hay que
indicarle cuales son las tareas a realizar, describir como se desea que esas tareas funcionen y
como las pantallas y reportes deben de estar configurados. Clarion realizar el programa,
creando las declaraciones del lenguaje necesarias para que la tarea se realice de la manera mas
eficiente.

Que es una Aplicacin ?

Una Aplicacin es un programa escrito que cumple con las especificaciones de un
usuario final. Si un programa es escrito para sistematizar la facturacin, una Aplicacin de
facturacin debe de ser creada, para que realize las funciones especficas de controlar clientes,
facturas, vendedores, artculos, familias, existencias. Las Aplicaciones varan grandemente en
su complejidad. El propsito general de las aplicaciones es permitir a la informacin almacenada
ser manipulada y revisada de una manera eficiente.

Que es un !roce/imiento ?

Las tareas principales a realizar por un programa ( desplegar pantallas, impresin de
reportes, etc. ), son llamados !roce/imientos. Los !roce/imientos consisten en una serie de
instrucciones, cuando estas instrucciones son ordenadas y ejecutadas, es cuando mencionamos
que el !roce/imiento esta siendo ejecuta/o. Un !roce/imiento termina y regresa cuando las
instrucciones han sido ejecutadas correctamente.

Los !roce/imientos deben de tener un nombre. Un !roce/imiento inicia su ejecucin
cuando una instruccin del programa llama a este por su nombre. Cierto tipo de procedimientos
son comunes en la mayora de los programas. La mayora de los programas consisten
principalmente en mens, listas, pantallas de captura y reportes. Clarion soporta estos y muchos
otros tipos de procedimientos.

Los programas son creados en el enera/or /e Aplicaciones ( Application enerator )
seleccionado un tipo de procedimiento que se asemeje a los requerimientos del usuario, en el
cual se adaptaran los mens, pantallas o reportes mediante la definicin de datos o creando
frmulas o generando cdigo en los "puntos /e c/igo" ( embe//e/ source ).
!roce/imientos pueden llamar a otros procedimientos y pueden estar conectados entre si, lo
que eventualmente da como resultado un programa completo. El enera/or /e Aplicaciones,
almacena los programas y las caractersticas de los procedimientos en los archivos de
aplicaciones ( .A!! ).

En suma, existen %emplates ( plantillas ) de diferentes tipos : Code ( C/igo ),
ControI ( Control ), Extension ( tensin ), Wizard ( Asistentes ) y Wizatrons que permiten
virtualmente adaptar y generar rpidamente cualquier procedimiento pre-creado en los
TempIates que vienen incorporados en CIarion.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 55
www.gopac.com.mx
cursosgopac.com.mx


Generando una ApIicacin

A partir del diccionario previamente definido Acme.dct se creara la aplicacin que se estar
utilizando Acme.app hasta que se mencione lo contrario.

Una vez generado el diccionario, guardado y cerrado, procederemos a la creacin de nuestra
aplicacin de una manera rpida, utilizando los Asistentes ( Wizar/s )

3. Ejercicio Generando una ApIicacin Nueva por medio de Ios Asistentes ( Wizards )

1. Seleccione del men principal la opcin de
FiIe
2. Seleccione New

3. Seleccione - AppIication

4. En el rbol de directorio ubique el directorio
5. de C:\Curso basico\Dia_\Ejercicio .2

6. En el nombre del archivo digite Acme y en
seguida presione el botn de Guardar.

Tip : Una manera de crear una
Aplicacin rpida, es utilizar la
herramienta Pick
una vez presionada esta herramienta, presione
el botn de New, contine con el paso 4.
Puede crear una aplicacin nuevo presionando
el siguiente botn : y a continuacin
seleccionar la aplicacin,
continuando con el paso 4.


En seguida el ambiente de desarrollo desplegara la ventana de !ropie/a/es /e la Aplicacin (
Application !roperties )

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 56
www.gopac.com.mx
cursosgopac.com.mx

Application File ( Archivo de Aplicacion APP )

Digite el nombre de la aplicacin. ( Acme )



Dictionary FiIe ( Archivo de Diccionario DCT )

Digite el nombre del Diccionario /e Datos ( .DCT ). Si la aplicacin no requiere
diccionario, se puede dejar en blanco, para lo cual debe de desmarcar la opcin
de la casilla de Require Dictionary en el men principal $etup / Application
ptions. Presionando el botn de elipsis puede buscar el diccionario del rbol
de directorios.

First Procedure ( Primer Procedimiento / Procedimiento PrincipaI )

Digite el nombre del primer procedimiento, Clarion lo nombra automticamente
como Main, en caso de querer cambiar el nombre tan solo sobreescribalo. Por
ejemplo !rincipal.

Destination Type ( Tipo de Archivo a Generar )

Seleccione el tipo de archivo que el enera/or /e Aplicaciones, creara una vez
que haya terminado de generar la aplicacin. Opciones : ecutable ( . ),
Library ( .LIB ) o Dynamic Link Library ( .DLL ).

En el transcurso del presente curso se utilizaran nicamente archivos
ecutable (.), los otros tipos de archivos ( .LIB , .DLL ) se utilizarn y
explicarn en el curso de Clarion Interme/io

HeIp FiIe ( Archivo de Ayuda )

Opcionalmente digite el archivo de ayuda que la aplicacin utilizara ( .HL! ). Este
archivo debe de existir en el disco.

AppIication TempIate ( PIantiIIa de ApIicacin )

La plantilla controla la generacin del cdigo. Puede seleccionar de los
%emplates /e Clarion ABC o %emplates Clarion, los ABC son orientados a
objetos y los Clarion son del tipo procedural.

ToDo TempIate

Una caracterstica poderosa de Clarion es la habilidad de poder crear una
aplicacin de manera incremental. Los !roce/imiento por definir son llamados
ToDo Procedures ( Procedimientos PorCrear ) . En Clarion se puede
especificar el procedimiento personalizado a utilizar.

AppIication Wizard ( Asistente de ApIicaciones )

Esta casilla es utilizada para invocar a los Wizar/ %emplates o Wizatrons.
Estos automticamente leen el diccionario seleccionado y en base a la
configuracin de los mismos, pueden crear Browses, Formas, Reportes o
Aplicaciones completas. Estos asistente se relacionan a travs de dilogos de
informacin, posteriormente genera cdigo fuente Clarion el cual esta listo para
compilar y ejecutarse.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 57
www.gopac.com.mx
cursosgopac.com.mx

3.. Ejercicio UtiIizando Ios Wizards para crear una ApIicacin.


Encontrndose en la ventana de Application ptions , realice lo siguiente :

1. Digite el nombre de la aplicacin crear, en este caso Acme.app

2. Seleccione el diccionario a utilizar del rbol de diccionario.

3. Compruebe que el nombre del procedimiento principal ( First !roce/ure ) este escrito

4. Seleccione de Destination %ype la opcin de ecutable ( )

5. En Application %emplate compruebe que este seleccionado ABC

6. %oDo %emplate este digitado la opcin de %o/o(ABC)

7. Active la casilla de Application
Wizar/ para activar el uso de
los asistentes.

8. Presione el botn de


9. El asistente le guiara a travs
de preguntas y ventanas para
crear una aplicacin, presione
el botn de Net para iniciar .


10. En la ventana Theme Selction, seleccione el Tema en el cual se basar el
asistente para crear la Aplicacin, seleccione efault y presionamos NEXT

11. En la misma Ventana Theme Selction podemos seleccionar el layout o el tipo de
reporte (tipo de papel, Orientacin, fonts, colores) que deseamos para todos los
reportes de nuestra aplicacin.


12. En esta ventana sele indica al asistente de la aplicacin si se generarna procedimientos
(Browse, formas y Reportes) para todas las tablas del diccionario o solo algunas, Selecione
del opcion all files in my Diccionary del Drop enerate !roce/ures for y ( enerar
Procedimientos para). Para generar procedimientos para todas las tablas definidas en el
diccionario ACME.DCT.

Tip : En caso de no querer generar
procedimientos para todas las
tablas del diccionario,
Selecione la opcion Selected
Files, precione next y a
continuacin indique que
tablas son las que requiere
que se generen los
procedimientos, termine
presionando el botn Net..

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 58
www.gopac.com.mx
cursosgopac.com.mx

13. En la ventana del Wizar/ - Control Mo/el seleccione el botn de Both para que el
asistente agregue los controles de Botn y los controle de Caja de Herramienta a los
procedimientos. Termine presionando el botn de Net

14. La ventana del Wizar/ - Internet Connect permite crear la aplicacin como una aplicacin
parar nternet, en esta caso se verifica que la casilla no este seleccionada y presione el
botn Net.

Nota : Si usted desea crear una aplicacin de nternet es necesario que su aplicacin
este compilada a 32 bits, en el Curso Avanza/o /e Clarion este tema se estudia
en su totalidad.



15. En la ventana Window And Control
Customization, nos da acceso a una seccin
donde podemos modificar y personalizar los
componentes de la aplicacin como el Menu,
Catlogos, Formas y Reportes,

Nota : Cada uno de las secciones de
personalizacin se explicara a
fondo mas adelante en la seccin
de Temas para una Aplicacin.


16. La ltima ventana es Wizar/ - Finally en donde se seleccionara la casilla de verwrite
eisting !roce/ures y verificar que la casilla de enerates Reports for each File no este
activada. Presione el botn de Finish para que el asistente inicie la generacin de la
Aplicacin

17. Grabe su aplicacin. Compile y corra su aplicacin presionando
el botn .

18. Si usted sigui correctamente todos los pasos Felici/a/es , acaba /e generar su primera
aplicacin funcional en Clarion.

Estos son los procedimientos que el asistente genero por usted, y se llama rbol de
procedimientos :

















_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 59
www.gopac.com.mx
cursosgopac.com.mx


Durante el transcurso de los siguientes temas y ejercicios se irn mencionando y explicando
todos los puntos bsicos que conforman esta ventana, as como la manera de cambiar los
parmetros bsicos, agregar procedimiento y agregar funcionalidad bsica tanto a la aplicacin
como a los procedimientos y controles de acuerdo a las circunstancias que se nos presenten en
el transcurso de los ejercicios.




Procedimientos con Temas

El asistente para aplicaciones de clarion
crea una aplicacion completa de des un
diccionario ya definido, crea un Marco con
men con opciones que llaman todos los
procedimientos tambien creados por el
asistente com Browses, formas y
reportes, para cada uno de los archivos
definidoso en el diccionario.


Este mismo asistente te lleva de la mano
para crear tu aplicacion , ademas peudes
definir y elegir un tema para que todas los modulos de tu aplicacion se basen en el tema
seleccionado.

Los Temas son configuraciones predefinidas para cada
unos de los procedimientos de la aplicacin, que van
desde el Color, el Grafico del fondo, Tipo de letra a utilizar
en los textos de la aplicacin, iconos, botones, mensajes
para el usuario. Estos temas se pueden Guardar y ser
Utilizados en otras Aplicaciones, o en la creacin de otros
procedimientos de la misma aplicacin, para conservar
predefinido el estilo en la configuracin y apariencia.

PersonaIizacin

Estas configuraciones y acciones llamadas temas, se puedes personalizar, modificar y grardarse
para usarlas en otrsa palicaciones posteriors o en otros procedimientos de una mismma
aplicacin. La configuracin de estos temas se controla por una varidead de opciones de
configuracion dividia en 4 Areas importantes, Frame Customization , Browse Customization,
Form Customization y Report Customization.
Estas Areas se describen a detalle en la sigioente seccion:

Estas Areas se describen a detalle en la sigioente seccion:

Frame Customization:

La configuracon en esta ventana
conrtola la apariencia del Menu
principal. Estas configuraciones pueden
ser guardarse para ser urilizadas en
futuras aplicaciones

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 60
www.gopac.com.mx
cursosgopac.com.mx


Esta Area se divide en 3 grandes secciones grupos que son la configuracin de la Ventana, el
Menu y la Barra de desplazamiento.(Window, Frame enu, ToolBar)




Window
Images
Aqui se define la configuracion de la imgenes itilizadas en el Frame del Men principal.

Backgroun/
Aqui se define la ruta y el nombre
del archivo grafico que e usara
como fondo en el cuerpo del menu
principaly (es el area bajo las
opciones y la barra de menu).

Mo/e
Se especifica si la imagen de fondo
a ulizar en el menu principal se
mostrara Acomodada, Estirada o
Centrada. ( tiled, stretched, or
centered.)

Icon
En esta parte se define el cono que
se asignara al frame de la
aplicacion. Esto permitira que las
aplicacipn se pueda minimizar si
es necesario.

Font
Presione el Boton de Font para selecionar el Font que sera utlizado en forma
predeterminada en todos los testos de el men principal. Un Ejmplo del Font y sus
caractersticas seleccionadas, se muestra en la parte de abajo.

!osition

Selecionar del drop list laposiscion inicial de la ventna del Frame. Tiene la opcion de
Centrar la ventana o usar la posicin por default que la establece el asistente.

Adems si elijes el check box en el System Mem click aadira el Windows System
Menu a tu procedimiento principal (Frame). S utilizars cualquier campo tipo entry en el
toolbar, puedes hacer click en el check box de Entry Patterns para permitir un formateo
especial en esos campos. (Ejemplo:Pictures de Numero de telefono o Fechas)










_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 61
www.gopac.com.mx
cursosgopac.com.mx



FrameMenu

File


nable File Menu:
Este check Box de indica al Asistente de la
aplicacion que se incluya el Menu File (Archivo)
dentro del menu principal. Ademas se pueden
personalizar, los Siguientes tems y sus
mensajes asociados. Cambiarlos Espaol. ( los
cuales se muestran a continuacin):

File Menu Text
Print tem Text
Print tem Msg
Exit tem Text
Exit tem Msg



Edit

nable /it Menu
Este check Box de indica al Asistente de
la aplicacion que se incluya el Menu Edit
(Editar) dentro del menu principal.
Ademas se pueden personalizar, los
Siguientes tems y sus mensajes
asociados. Cambiarlos Espaol. ( los
cuales se muestran a continuacin):

Edit Menu Text
Cut tem Text
Cut tem Msg
Copy tem Text
Copy tem Msg
Paste tem Text
Paste tem Msg



Window

nable Win/ow Menu:
Este check Box de indica al Asistente de la
aplicacion que se incluya el Menu Window
(Ventana) dentro del menu principal. Ademas se
pueden personalizar, los Siguientes tems y sus
mensajes asociados. Cambiarlos Espaol. ( los
cuales se muestran a continuacin):

Window Menu Text
Tile tem Text
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 62
www.gopac.com.mx
cursosgopac.com.mx

Tile tem Msg
Cascade tem Text
Cascade tem Msg
Arrange cons tem Text
Arrange cons tem Msg

Help

nable Help Menu:
Este check Box de indica al Asistente de la aplicacion que se incluya el Menu Help
(Ayuda) dentro del menu principal. Ademas se
pueden personalizar, los Siguientes tems y sus
mensajes asociados. Cambiarlos Espaol. ( los
cuales se muestran a continuacin):

Help Menu Text
Contents tem Text
Contents tem Msg
Search tem Text
Search tem Msg
How tem Text
How tem Msg

TooIbar

eneral:

Background

En esta parte se define el archivo de
imagen que se utilizar como fondo en
la Barra de Herramientas (Toolbar) de
la aplicacin.

Mode
Si tiene designada una imagen de
fondo para usarla en al marco de la
barra de herramientas, esta opopcion
se habilita para controlar si la imagen es en
Mosaico, Estirada o Centrada. (tiled, stretched, or
centered).

Height
Se establece la altura en unidades de dialogo del
marco de donde estar la barra de herramientas.


Tip

This tab identifies the toolbar buttons that are available from
the wizard. You can modify the tool tip message for each
button here.




_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 63
www.gopac.com.mx
cursosgopac.com.mx




Icon Properties

Width
The Frame procedure wizard has the option to
produce toolbar navigation buttons. Enter here
the default width of each button in dialog units.

Height
The Frame procedure wizard has the option to
produce toolbar navigation buttons. Enter here
the default height n dialog units of each button. Care must be taken not to exceed
the default height of the overall toolbar properties.

FIat
Activate this checkbox to produce a flat button
appearance for all toolbar buttons.

Icon
This tab identifies the toolbar buttons' default icon files
used by the wizard. You can modify the icon files for
each button here.
































_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 64
www.gopac.com.mx
cursosgopac.com.mx





Browse Customization:

La apariencia General de los Broweses
generaros por el Asistente de Aplicaciones es
controlada por la configuracion que se
establesca en esta ventana. Esta configuracin
puede ser Gruardada como un "Tema para
utilizarce posteriormente en futuras
aplicaciones.


Procedure Name
Aqui se determina el nombre que el Asistente para Browses usara para genrear los nombres de
los procedimientos en la aplicacin. EL macro template, FileName, es requerido , para extraer
del diccionario los nombres de los archivos selecionados para ser procesado por el asistente.

NOTA: No se permiten espacion en los nombres de los procedimientos.



Browse Message

Aqui se define el Texto por default que sera generado o asignado al atributo MSG para cada List
Box. El usuario podra ver este texto en la barra de estatus de la aplicacin en tiempo de
ejecucin cuando el list Box sea seleccionado . El macro FileName macro no es requerido en
esta parte pero si es recomendable que se utilice.


Window

Caption
El texto especificado en esta liena sera utilizado como la
rescirpccion de la ventna utilizada por el asistente para
browses.

$econ/ary Caption
El texto especificado en esta linea sera utilizado para
mostrase en la barra de estatus de la aplicacion siemrpe
y cuando el Browse sea publicado como archivo
secundarioenla forma.

Images
Aqui se define la configuracion de la imgenes
itilizadas en el Frame del Men principal.

Backgroun/
Aqui se define la ruta y el nombre del
archivo grafico que e usara como fondo
en el cuerpo del menu principaly (es el
area bajo las opciones y la barra de menu).
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 65
www.gopac.com.mx
cursosgopac.com.mx


Mo/e
Se especifica si la imagen de fondo a ulizar en el menu principal se mostrara
Acomodada, Estirada o Centrada. ( tiled, stretched, or centered.)

Icon
En esta parte se define el cono que se asignara al frame de la aplicacion. Esto
permitira que las aplicacipn se pueda minimizar si es necesario.

Font
Presione el Boton de Font para selecionar el Font que sera utlizado en forma
predeterminada en todos los testos de el men principal. Un Ejmplo del Font y sus
caractersticas seleccionadas, se muestra en la parte de abajo.

!osition

Selecionar del drop list laposiscion inicial de la ventna del Frame. Tiene la opcion de
Centrar la ventana o usar la posicin por default que la establece el asistente.

Adems si elijes el check box en el System Mem click aadira el Windows System
Menu a tu procedimiento principal (Frame). S utilizars cualquier campo tipo entry en el
toolbar, puedes hacer click en el check box de Entry Patterns para permitir un formateo
especial en esos campos. (Ejemplo:Pictures de Numero de telefono o Fechas)


Tabs

%ab %et
Se esecifica el texto que sera utlizadon en cada TAB del Browse genreado por el
asistente de Browses. La configuraion por default es &%#) %Key. El ampersam (&)
identifica al caracter siguiente como HOTKEY o llave para de acceso rapido para el
TAB. El macro %# dentifica el orden de la llave, este orden es el orden en que estan
definidas en el diccionario. El macro %Key es la descripccin de la llave (Si el campo
descripcin esta en blanco en el diccionario, se utilizara el identificador de la llave).
Ejemplo: 2) By Account

$ort r/er $election $tyle
Presionar este boton para accesar a la ventana para Selecionar un Estulo de
ordenamiento.



Esta ventana es utilizada para configurar el Estilo de
ordenamiento que se utilizara en los browses como
predeterminado. Tipo de Ordenamiento esta definido de
manena que se pueda navegar de una llave a otra ySort
order style is defined as the way you navigate from one
sort value to the next based on the number of keys that
you designate for the Browse. You can select from the
following options:




_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 66
www.gopac.com.mx
cursosgopac.com.mx

Which seIection styIe? (CuaI estiIo de SeIecin)
Hay tres estilos el Form %abs, Drop List o !opup menu.

Form %abs:
The Tabs selection uses tab controls to signal the list box that a new sort order is to be
applied.

Drop List:
Esta opcin Muestra un control de tipo /rop list que
contiene las llaves pro las cuales se puede oirdenar el
Browse.

!opup menu:
The Popup menu option stores the sort order selections
in a popup menu, which is accessed when right-clicking
on the Browse Box (List Box) control, or pressing the
Sort Order button that is created. n addition, Popup
menu enables the following additional options for the
Sort Order button:


Text
Especifique el texto que se desplegara en el botn del tipo de Ordenamiento.

Icon
Especifique el nombre del archivo o utilice el boton de selecionar archivo del
icono, que deseas utilizar en el boton del tipo de ordenamiento.


Cursor
Especifique el nombre o utilice el boton para selecionar el archivo del cursor que
deseas usar para este boton. El cursor seleccionado sera desplegado cuando el
apuntador del raton se mueva sobre el area del boton del tipo de Ordenamiento.


HotKey
En esta opcin se especifica la secuencia de teclas con las cuales clarion
(keycodes) identiificar y utilizar como teclas de acceso rapido para este botn.
use as the hot key for this button. Presionando esta secuencia de teclas en tiempo
de ejecicin activara el boton de tipo de ordenamiento.

Message
Especifique el mensage a desplegar en la barra de status de la aplicacin cuando
el mouse se mueva sobre el area del boton de tipo de ordenamiento.

Tip
Especifique el mensaje de Tool Tip que se desplegar cuando el mouse se mueva
sobre el area del boton de tipo de ordenamiento.


Options:

Actve o selecione el Flat check bo para darle al boton de tipo de ordenamiento
la apariencia de un boton plano.

Tip: Se recomienda asignarle una imagen al boton cuanto utilice la opcion FLAT
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 67
www.gopac.com.mx
cursosgopac.com.mx



Actve o selecione el $kip check bo para deshabilitar que el boton de tipo de
ordenamiento sea tomando en cuenta en la secuencia de recorrido de los
controles (tabbing). Es decir que en la secuencia de "Tabs dentro del Browse se
brinque este boton.

Selecione el modo de justificacin para designarle donde se mostrara el icono del
botn (si se defini) con respecto al texto del mismo.







Buttons

EL Tab de botones es el control central de todos los botones utilizados en la ventana del
Browsw. Cada Boton puede ser personalizado
individualmente en su ventna de configuracin.

Los Botones por default que considera el asistente de
Browses son :
nsert,Change ,Delete,'iew,Select,Close,Parent
Select,Help.


Esta venatana contiene la configuracin geneirca utilizada
para algunos botonoes generados por el asistente, (Ej.
Botton de nsertar, Boton de Cerrar, etc.), todos los
botones tienen propiedades comunes las cuales se
describen a continuacin.



Propiedades Comunes IncIuyen:

Width
Digite un numero entero (Unidades de Dialogo) constante que especifica la Anchura del control
especificado.

Height
Digite un numero entero (Unidades de Dialogo) constante que especifica la Altura del control
especificado.

Text
Especifique el texto que se desplegara en el botn.

Icon
Especifique el nombre del archivo o utilice el boton
de selecionar archivo del icono, que deseas utilizar
en el boton.

Cursor
Especifique el nombre o utilice el boton para
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 68
www.gopac.com.mx
cursosgopac.com.mx

selecionar el archivo del cursor que deseas usar para este boton. El cursor seleccionado
sera desplegado cuando el apuntador del raton se mueva sobre el area del boton.


HotKey
En esta opcin se especifica la secuencia de teclas con las cuales clarion (keycodes)
identiificar y utilizar como teclas de acceso rapido para este botn. use as the hot key
for this button. Presionando esta secuencia de teclas en tiempo de ejecicinactivara el
boton.

NOTA : Se puede utlilizar su numero de Equate. Que representa a esa secuencia de
teclas.



Message
Especifique el mensage a desplegar en la barra de status de la aplicacin cuando el
mouse se mueva sobre el area del boton.

Tip
Especifique el mensaje de Tool Tip que se desplegar cuando el mouse se mueva sobre
el area del boton.

Options:

Actve o selecione el Flat check bo Para darle al boton selecionado la
apariencia de un boton plano.

Tip: Se recomienda asignarle una imagen al boton cuanto utilice la opcion FLAT


Actve o selecione el $kip check bo para deshabilitar que el boton sea
tomando en cuenta en la secuencia de recorrido de los controles (tabbing). Es
decir que en la secuencia de "Tabs dentro del Browse se brinque este boton.

Selecione el modo de justificacin para designarle donde se mostrara el icono
del botn (si se defini) con respecto al texto del mismo.


Procedure Name: (Valido solo para el Boton de Parent
Select)

Especifique el nombre del procedimiento que el boton llamara para sele
padre que esta relacionado con el procedimiento del archivo
hijo. Si asi lo deseas puede modificar el marco y el texto de
esta linea.

NOTA : No se permiten espacios en el mombre del
procedimiento.

ChiId Browse Proc Name (Valido solo para el boton de
archivo Hijo (Child button))

Especifique el nombre del procedimiento que el boton
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 69
www.gopac.com.mx
cursosgopac.com.mx

llamara (Browse) del archivo hijo relacionado con el archivo primario. Este botn
normalmente se despliega en el procedimiento FORM para visualizar y modificar los
registros del archivo hijo.

Window Name (Valido solo para Valid for the Parent Select and Child Buttons)

El Texto especificado en en esta linea ser utilizado como Descripccin de la ventana
usada por el procedimeinto al que llama el botn.








Form Customization:

Las especificaciones en esta ventana Controlan la apariencia de los procedimientos tipo forma
(FOR) de la aplicacin. Estas especicificaciones pueden ser Grabadas para utilizarse en
futuras aplicaciones, (temas)

Procedure Name
Aqui se determina el nombre que el Asistente para Formas usar para genrear los nombres de
los preocedimientos tipo forma en la aplicacin. EL macro template, FileName, es requerido
required, para extraer del diccionario los nombres de los archivos selecionados para ser
procesado por el asistente.


Window

Caption

Text that is entered on this line will be used as the description of the window used by the
Form Wizard.

Images
Aqui se define la configuracion de la imgenes itilizadas en el Frame del Men principal.

Backgroun/
Aqui se define la ruta y el nombre del archivo grafico que e usara como fondo en el
cuerpo del menu principaly (es el area bajo las opciones y la barra de menu).

Mo/e
Se especifica si la imagen de fondo a ulizar en el menu principal se mostrara
Acomodada, Estirada o Centrada. ( tiled, stretched, or centered.)

Icon
En esta parte se define el cono que se asignara al frame de la aplicacion. Esto
permitira que las aplicacipn se pueda minimizar si es necesario.

Font
Presione el Boton de Font para selecionar el Font que sera utlizado en forma
predeterminada en todos los testos de el men principal. Un Ejmplo del Font y sus
caractersticas seleccionadas, se muestra en la parte de abajo.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 70
www.gopac.com.mx
cursosgopac.com.mx


!osition

Selecionar del drop list laposiscion inicial de la ventna del Frame. Tiene la opcion de
Centrar la ventana o usar la posicin por default que la establece el asistente.

Adems si elijes el check box en el System Mem click aadira el Windows System
Menu a tu procedimiento principal (Frame). S utilizars cualquier campo tipo entry en el
toolbar, puedes hacer click en el check box de Entry Patterns para permitir un formateo
especial en esos campos. (Ejemplo:Pictures de Numero de telefono o Fechas)

EL modo de Captura permite establecer el efecto que tendra el texto al ser capturado en
la forma en la forma, puedes seleccionar de los siguientes tipos nsert, Overwrite, or
Default






!RM!%$

Background CoIors
En este control se especifica el color del fondo por defecto para cada unos de los
campos capturables (Entrys).


Tabs
Form Tabs
Especifique el Texto que sera utilizado para cada TAB que se generara por el asistente
de Formas.

Se especifica el texto que sera utlizado en cada TAB del Browse genreado por el
asistente de Formas. La configuraion por default es &%#) %Key. El ampersam (&)
identifica al caracter siguiente como HOTKEY o llave para de acceso rapido para el
TAB. El macro %# dentifica el numero de TAB generado, este numero esta
determinado por la cantidad de campos publicados en la forma. Ejemplo: 2) General


Buttons

EL Tab de botones es el control central de todos los botones utilizados en la ventana de la
Froma. Cada Boton puede ser personalizado individualmente en su ventna de configuracin.

Los Botones por defecto en el asiste de la forma son:

OK, Cancel, Child, Help ,
Cada uno de estos botones cuenta con una serie de propiedades las cuales se decriben a
continuacin, estas propiedades pueden ser personalizadas por el usuario.


Width
Digite un numero entero (Unidades de Dialogo) constante que especifica la Anchura del control
especificado.

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 71
www.gopac.com.mx
cursosgopac.com.mx

Height
Digite un numero entero (Unidades de Dialogo)
constante que especifica la Altura del control
especificado.

Text
Especifique el texto que se desplegara
en el botn.

Icon
Especifique el nombre del archivo o
utilice el boton de selecionar archivo del
icono, que deseas utilizar en el boton.

Cursor
Especifique el nombre o utilice el boton
para selecionar el archivo del cursor que deseas usar para este boton. El cursor
seleccionado sera desplegado cuando el apuntador del raton se mueva sobre el area del
boton.


HotKey
En esta opcin se especifica la secuencia de teclas con las cuales clarion (keycodes)
identiificar y utilizar como teclas de acceso rapido para este botn. use as the hot key
for this button. Presionando esta secuencia de teclas en tiempo de ejecicinactivara el
boton.

NOTA : Se puede utlilizar su numero de Equate. Que representa a esa secuencia de
teclas.



Message
Especifique el mensage a desplegar en la barra de status de la aplicacin cuando el
mouse se mueva sobre el area del boton.

Tip
Especifique el mensaje de Tool Tip que se desplegar cuando el mouse se mueva sobre
el area del boton.

Options:

Actve o selecione el Flat check bo Para darle al boton selecionado la
apariencia de un boton plano.

Tip: Se recomienda asignarle una imagen al boton cuanto utilice la opcion FLAT


Actve o selecione el $kip check bo para deshabilitar que el boton sea
tomando en cuenta en la secuencia de recorrido de los controles (tabbing). Es
decir que en la secuencia de "Tabs dentro del Browse se brinque este boton.

Selecione el modo de justificacin para designarle donde se mostrara el icono
del botn (si se defini) con respecto al texto del mismo.


_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 72
www.gopac.com.mx
cursosgopac.com.mx


N%A : La configuracin /e reportes se vera en el Capitulo /e Reportes /e este manual.



Depues de configurar cada uno de
los grandes grupos de
propiedades de la apclicacn,

Esta ventana nos pregunta si
queremos Guardar los cambios
realizados a la personalizacion de
los componentes de la aplicacin,
(Frame, Browses, Formas,
Reportes) y adems si queremos
que dicha personalizacion, sea
Guardada como un Tema aparte
para poderlo Utilizar
posteriormente, Una de las ventajas importantes de utilizar temas para generar aplicaciones
es la de porder crear temas en el idioma del usuario final.

Si asi lo deseamos, le asignamos un nombre al Tema y le asignamos un nombre al archivo
donde se Guardar el Tema, para posteriormente Utilizarlo.

































_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 73
www.gopac.com.mx
cursosgopac.com.mx

3.2.9 Agregando Triggers aI Diccionario.



Los trigers son Cdigos de Clarion colocados en
diferentes puntos de embed ya establesidos en las
propiedades de las tablas que conforman el
diccionario, que a su vez se une al cdigo de la
aplicacin en puntos ya predefinidos como al Antes
de nsertar, Editar o borrar un Registro o as como
Despus de nsertar, Editar y Modificar, este cdigo
puede estar en cada tabla que conforma el
diccionario.






La ventna de configuracin de los triggers esta
localizada en las pestaas de las propiedades de
cada tabla dentro del diccionario y ah se pueden
configurar los siguientes conceptos al insertar un
trigger se muestra la siguiente Ventana:









GeneraI

Type
Seleciona el tipo de Trigger que establece cuando en que moemento sera ejecutado
durante las siguientes aaciones que realice la Base de datos:

Nota: Cada trigger type corresponde a un un metodo de la ABC FileManager


Type ABC Method CaIIed

Before nsert Prensert
After nsert Postnsert
Before Update PreUpdate
After Update PostUpdate
Before Delet PreDelete
After Delete PostDelete

Data
Al presionar este boton podemos definir las varables de memoria que sera utilizadas en
el trigger, estas variables seran incluidas automaticvemente en la aplicacin cuiando se
haga referencia a la tabla en la cual se definen para utilizarse en el trigger, Estas
variables definidas aqu son solo validas para el trigger Type seleccionado.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 74
www.gopac.com.mx
cursosgopac.com.mx


Text

Aqui se define la instrucciones en codigo del
trigger, y puedes entrar a la ventana conpleta del
editor de codigo rpesionado el boton con los
3 puntitos, (ellipsis button).

NOTA: Asegurate de Presionar el Boton de OK
para guardar el triggert depuse de salir de las
ventanas de edicin de Variables (DATA) o de la
Ventana de Edicin de Codigo, antes de agregar
mas.


Comments

En esta seccion puedes agregar una descrpccion detallada de todo lo que el trigger
hace, esta descripcin no tiene efecto alguno en la aplicacin, es mas bien un espacio
para que el programador documente los que hace el trigger para que posteriormente al
entrar a este punto de nuevo sepamos que es lo que el trigger hace.

2.9. Agregando Trigers a aI apIicacin.

En este ejercicio agregaremos 3 trigers a la tabla de clientes al nsertar, Modificar y
Eliminar para que en cualquiera de las 3 acciones agregue un registro a la tabla
LOGCLENTES del diccionario, para posteriormente en la aplicacin visualira cada una
de las actividades realizadas la tabla clientes.

1. $eleccionar la tabla lientes en el
diccionario.
2. Presionar dos veces el Boton del Mouse
para entrar a la venta de Deficicion de
Campo, llaves y Triggers (Column and Key
Definition).
3. Seleccionar el TAB de Triggers
4. Presiona el Boton de Insert para agregar un
nuevo trigger y muestra la ventana de
edicin de triggers.
5. En Type elegir el tipo After nsert.
6. Presionar el Boton Elipsis (...) para entrar a la
ventana del editor de codigo y agregar el
siguiente codigo:

Triger al Insertar AFTER INSERT
IF ~Errorcode()
REGISTRA AL INSTERTAR
LOG:AMPOUNIO = 'liente : ('& LI:ODIGO &') Fue Agregado a la |
Tabla lientes el Fecha:' & format(TODAY(),@D8) &' Hora: |
'&format(lock(),@t3)
IF AESS:LOGLIENTES.Insert()
Message('Error al Intentar Agregar el Evento en el Archivo de Registro|
','Error al Insertar')
END
END
Fin del trigger
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 75
www.gopac.com.mx
cursosgopac.com.mx



7. Presionar el boton de OK de la
Ventana de Edicion de propiedades
del Trigger para que guarde.










8. Ahora agregaremos el codigo del trigger para cuando el cliente se modifique se
registre en evento en el archivo LOGCLENTES, para hacer esto en la ventana
de definicin de campos y llaves, presionamos el boton de nsert.

9. En la Ventana de propiedades del trigger (Trigger Propierties) seleccionar en
Type : Affer Update.


10. Presionar el Boton Elipsis (...) para entrar a la ventana del editor de codigo y
agregar el siguiente codigo:

Triger al Editar After Udate
IF ~Errorcode()
Log hange
LOG:AMPOUNIO = 'liente : ('& LI:ODIGO &') Fue Editado en la
Tabla lientes el Fecha:' & format(TODAY(),@D8) &' Hora:
'&format(lock(),@t3)
IF AESS:LOGLIENTES.Insert()
Message('EL cambio en el cliente no fue aadido al Archivo de
registro','Error al Editar')
END
END
Fin del trigger


11. Presionar el boton de OK de la Ventana
de Edicion de propiedades del Trigger
para que guarde.










12. Ahora agregaremos el codigo del trigger para cuando el cliente se Elimine, se
registre en evento en el archivo LOGCLENTES, para hacer esto en la ventana
de definicin de campos y llaves, presionamos el boton de nsert.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 76
www.gopac.com.mx
cursosgopac.com.mx






13. En la Ventana de propiedades del trigger (Trigger Propierties) seleccionar en
Type : Affer Delete.

14. Presionar el Boton Elipsis (...) para entrar a la ventana del editor de codigo y
agregar el siguiente codigo:


Triger al Borrar AFTER Delete
IF ~Errorcode()
Registra la Accion de Borrar
LOG:AMPOUNIO = 'liente : ('& LI:ODIGO &') Fue Borrado en la
Tabla lientes, Fecha:' & format(TODAY(),@D8) &' Hora:
'&format(lock(),@t3)

IF AESS:LOGLIENTES.Insert()
Message('EL Borrar registro del cliente no fue aadido al Archivo de
registro','Error al Borrar')
END
END
Fin del triger


15. Presionar el boton de OK de la Ventana de
Edicion de propiedades del Trigger para
que guarde.






16. Despus de Agregar los Tres codigos para los Triggers se guarda el Diccionario,
mas adelante depuse de generar la aplicacin. Veremos en una Ventana el
contenido del archivo LOGCLENTES.

















_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 77
www.gopac.com.mx
cursosgopac.com.mx




Window Formatter ( Formateador de Ventanas )


El Win/ow Formatter permite disear visualmente los elementos de la ventana - ventanas y
controles que se desplegaran en la pantalla. El Win/ow Formatter automticamente genera e
introduce la estructura del lenguaje y el cdigo fuente que describe estos elementos en el archivo
de aplicacin o en los documentos de cdigo fuente.




Componentes deI Window Formatter

3.2 Ejercicio PersonaIizando Ia Ventana deI Procedimiento PrincipaI

Objetivo :
Cambiar Ttulo de la ventana del procedimiento principal,
Agregar Papel Tapiz
Agregar cono a la Ventana
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 78
www.gopac.com.mx
cursosgopac.com.mx

Personalizar el inicio de la ventana como Maximizada
Agregar al Men Principal la opcin de Reportes
Agregar al Men Reportes la opcin de Ventas por Vendedor / Etiquetas
Agregar al Men Principal la opcin de Procesos
Agregar al Men Procesos la opcin de Cambio de Precios
Ocultar del Men Principal la opcin de Ventana
Deshabilitar opciones del Men Ayuda
Agregar opcin de Acerca de....
Agregar Procedimiento Splash

3.2. Ejercicio Propiedades de Ia Ventana PrincipaI

1. Seleccione del rbol de procedimientos el procedimiento principal Main presionando
doble click,
2. En seguida aparecer la ventana de Procedure Main Properties, en donde se
definen todas las propiedades de los procedimientos, as como las tablas, las
variables, ventana, las extensiones, procedimientos, embeds que tienen que ver con
este proceso, seleccione el botn de Win/ow para acceder al Formatea/or /e
Ventanas ( Window Formatter ).



3.
4.
5. Seleccionada la venta del procedimiento , presione click derecho sobre de ella y
seleccione la opcin de !roperties ( !ropie/a/es ). Enseguida aparecer la
ventana de propiedades de la venta del procedimiento.

El %ab eneral permite establecer las propiedades de
generales de la ventana como Nombre, Tamao
Inicial, Papel Tapiz, etc
.
El %ab tra establece el icono , opciones especiales,
barra de Status y barras de desplazamiento.

El %ab Color define el color a utilizar en la ventana.

El %ab !osition define la posicin inicial de la ventana

El %ab Actions permite el acceso al File $chematic
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 79
www.gopac.com.mx
cursosgopac.com.mx

Definition y Embedded Source

6. Seleccionando el %ab eneral, en la opcin de %et , la cual permite modificar el
nombre de la ventana, digite el nombre que se desplegara en el Caption de la
Ventana. ( $istema Acme Curso Bsico ) . La opcin de Label definir la
identificacin dentro de la estructura de la aplicacin de este objeto.

7. Initial $ize permite seleccionar la forma en que al ejecutarse la aplicacin o la
ventana esta sea mostrada. Seleccione Maimize/, al ser el procedimiento principal
la aplicacin ser siempre maximizada al ejecutarse.

8. Wallpaper asigna el papel tapiz de la venta del procedimiento, presione el botn de
elipsis para asignar el siguiente papel tapiz : C:\curso basico\Imagenes\%apiz.bmp

9. Verifique que el modo del Wallpaper sea $tretche/.

10. Seleccione el %ab de tra
presione el botn de elipsis
del campo icono para
seleccionar el icono de la
ventana.

Tip para que una ventana se
pueda minimizar es
necesario que se le
asigne el icono a la
misma.

11. Verifique las opciones de
$ystem Menu, Maimize
Bo, $tatus Bar estn
activados. $ystem Menu
permite indicarle al ambiente
de desarrollo que esta
ventana contendr el men
del sistema, Maimize Bo
indica que debe contener los
iconos de Maximizar,
Restaurar y Cerrar, $tatus
Bar indica que la ventana
tendr barras de Status en la
parte inferior de la ventana, los cuales estarn definidos en longitud y cantidad por el
campo de Status Widths

12. En el campo de $tatus Wi/ths indique la longitud a utilizar en cada campo que
requiera de Status y en seguida presione el botn de para aplicar sus cambios.










_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 80
www.gopac.com.mx
cursosgopac.com.mx



3.2.2 Ejercicio Modificando Ias Opciones deI Men de Ia ApIicacin

Existen dos maneras de modificar las opciones establecidas en el men principal de la
aplicacin a generar :

a) Seleccionando del Men Principal la
Opcin Menu / /it Menu

b) Presionando Doble Clic sobre el Men
/e la Aplicacin

1. Seleccione del Men Principal la Opcin Menu /
/it Menu una vez seleccionada esta opcin el ambiente de desarrollo mostrara la
ventana de edicin de opciones del men .



Agrega un Ttulo de Men Agrega una lnea de Separacin


Agrega una Opcin de Men Borra una Opcin o un Ttulo de Men


Mueve la Opcin o Ttulo del Men.


Tab GeneraI

Indica Ios parmetros generaIes tanto para eI TtuIo como para una opcin de men

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 81
www.gopac.com.mx
cursosgopac.com.mx

Menu Text indica el texto a desplegar para un Men u Opcin. Antecediendo el
carcter de a una letra del texto permitir al usuario acceder a esa
opcin de una manera rpida presionando la tecla de Alt + letra
antecedida por &.

&se 'ariable se /efine la variable a utilizar por este control, siempre es
antece/i/a por el carcter , generalmente el ambiente /e
/esarrollo asigna esta variable para su manejo.

Message Type Mensaje que se despliega en la barra /e $tatus, cada vez que
el usuario se posiciona en el Men u Opcin.

HeIp ID ndicar la clave de la ayuda presente en el archivo HL! correspondiente.

STD ID ndica una accin stn/ar /e Win/ows, seleccione de la lista que se presenta. El
ambiente de desarrollo, implementara el comando stn/ar /e Win/ows.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 82
www.gopac.com.mx
cursosgopac.com.mx

!osition Permite especificar tanto al TtuIo y Opcin prioridad que tienen cuando por
alguna razn se decide unir o mezclar mens entre si.

Hot Key es muy similar a la tecla Alt . Permite al usuario desplegar
inmediatamente un Men o ejecutar una accin asociada a la pcin
/el Men, sin necesidad de presionar la pcin. ey asigna el juego
de teclas a presionar para ejecutar una accin o desplegar un men.
Menu %et permite desplegar junto al Men u pcin un texto.

FIags Banderas que permiten indicarle al Ambiente /e Desarrollo que
ciertas opciones estn activadas :

DisabIe Item Desactiva el Men u pcin hasta que se le indique se
vuelva a reactivar.

ToggIe ( on / off ) Item Para crear una alarma para la Opcin
seleccionada. La Opcin debe de tener una variable
numrica en Campo Use. La variable deber de ser
declara utilizando uno de los dilogos o en los puntos de
cdigo. Activada esta opcin, cuando el usuario seleccione
esta por primera vez, la opcin estar prendida y el valor
de la variable declarada en su Use, ser ( 1 ) y aparecer
un marca por un lado de la opcin. Cuando el usuario la
seleccione por segunda ocasin, se apagara y el valor de
la variable ser ( 0 ) y la marca desaparecer. Deber de
agregar cdigo para controlar los sucesos cuando estos
ocurran.

Hide ndica que al momento de iniciar la aplicacin esta opcin esta
oculta hasta que se indique lo contrario

Appearance ( Apariencia )

Permite establecer el Icono a la pcin del Men, as como determinar los
colores de fondo y de texto, asignar la indentacin del Men u pcin, as
como el Ancho y Alto y el tipo de Font a utilizar.

Actions ( Acciones )

Permite aadir funcionalidad a las pciones /el Men. Completando los
prompts ocasionan que la pcin /el Men ejecut una accin cuando el
usuario selecciona esta opcin

2. Presione el botn de agregar %tulo /e Men y posicionelo
antes del Men Ventana, en la opcin del %ab eneral, en Menu %et, indique el
nombre del men que se esta adicionando ( Reportes )


3. Presione el botn de agregar pciones /e Men, y posicionelo
dentro del Men Reportes, en el %ab eneral indique el Menu %et Reporte /e
Ventas por Ven/e/or


4. Se agregara la tecla de acceso rpido < Ctl R > al reporte presionando
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 83
www.gopac.com.mx
cursosgopac.com.mx

5. En la ventana de nput Key, indique en el campo Key la letra que desea que se le
asigne a la tecla de acceso rpido y en la opcin de modificadores con que conjunto
de teclas adicionales desea que se accese y/o opcin del mouse, presione la tecla R
y seleccione el cuadro de opcin Ctrl, y presione el botn de para regresar a la
opcin de Men.

6. Seleccione el %ab de Actions, y elija la opcin de Call a !roce/ure, en el campo de
When !resse/, para indicar el procedimiento a ejecutarse cuando sea elegido este
proceso.

7. En !roce/ure Name indique el nombre del procedimiento a ejecutar ,
VentasporVen/e/or, as como seleccionar Initiate %hrea/ ( Iniciar Hebra /e
jecucin )

8. Presione el botn de Close para regresar al Win/ow Formatter.


Tip Todos los procedimientos que sean llamados del Men Principal tienen que Iniciar Hebra de
Ejecucin, por requerimientos de Windows.




3.3 Ejercicio Agregando Procedimiento SpIash

El procedimiento SpIash es un procedimiento que se ejecuta, una vez que el Frame de
la aplicacin a sido abierta, pero antes de que algn evento del usuario haya sido
ejecutado. Por convencin, los procedimientos SpIash, proveen de motivos visuales o de
audio al inicio del programa. Esta ventana se cierra automticamente despus de un
tiempo determinado, o
permitindole al usuario que cierre
la ventana con el mouse.

1. Seleccione del Men Principal
la Opcin Menu / !roce/ure /
una vez seleccionada esta
opcin el ambiente de
desarrollo mostrara la ventana
de edicin de opciones del
men .


2. En la ventana de procedimiento nuevo inserta el nombre del procedimiento SpIash.

3. Seleccione de la ventana $elect !roce/ure %ype la ceja de Defaults y de ah
seleccione la opcin de $plash Win/ow , en la ventana de !ropie/a/es /el
!roce/imiento

4. Presione el botn de Win/ows para entrar al Win/ows Formatter para darle el
formato a la ventana de $plash :


Agregar un Letrero de Nombre del Sistema
Agregar un Letrero Realizado por
Agregar un Letrero E-mail

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 84
www.gopac.com.mx
cursosgopac.com.mx

















5. Active las ventana de Control, !ropie/a/es, Alineacin controles y Agregar
Campo ( conos en la barra de herramientas
del Window Formatter )

6. Seleccione el letrero de This is my ApIicaction y
en la caja de !roperty, en el campo %et digite el
texto que desee que aparezca y presione la tecla
%AB, para visualizar sus cambios. Realice los
mismos pasos para cambiar el letrero de
DesarroIIado por .



7. Agrege un control $tring de la Caja de ControIes y agregelo en
la Ventana de Splash, modificando en la caja de !roperty el campo %et para que
muestre la direccin electrnica.



8. Grabe su aplicacin. Compile y corra su aplicacin
presionando el botn .


3.4 Agregando mas Opciones deI Men de Ia ApIicacin

Realice los pasos necesarios para agregar las opciones de Men siguientes :

Agregar Opcin de tiquetas en el Menu de Reportes ( Nombre
del Proceso : tiquetas )

Agregar Ttulo de Men Procesos

Agregar Opcin de Cambio de Precios en el Men de Procesos (
Nombre del Proceso : Cambios!recio )

Ocultar Men Ventana

Deshabilitar los Procesos del men Ayuda


_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 85
www.gopac.com.mx
cursosgopac.com.mx

En el Men Ayuda agregar opcin de Acerca de... ( Nombre del
Proceso : Acerca/e)
Una vez realizado los pasos necesarios para incluir estos procesos el rbol de aplicaciones
se mostrar de la siguiente manera :


3.5 Ejercicio Agregando eI Procedimiento Acerca de ...

1. Seleccione con doble click el procedimiento Acercade ( ToDo )


2. Seleccione de la ceja de %emplates la pcin
Win/ow - Ventana enrica

3. En la ventana de Propiedades deI Procedimiento
seleccione el botn de , en el ArboI de
Procedimientos seleccione el procedimiento $plash .

4. Edite la definicin de la ventana $plash presionando el botn al lado derecho
de la opcin Window, con lo cual se editara la misma.

5. Seleccione toda la definicin de la ventana y cpiela al portapapeles ( CtI + C )

6. Seleccione el procedimiento Acerca/e ( %oDo ) y presione el botn , con el cual
se editara la definicin de la ventana Acercade, la cual esta en blanco.

7. Pegu la definicin de la ventana de SpIash ( CtI + V ). Grabe y cierre la definicin de
ventanas.

3.5. Ejercicio PersonaIizando eI Procedimiento Acerca de ...

Agregar Botn de Cerrar Ventana

Agregar Botn de nternet Link



_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 86
www.gopac.com.mx
cursosgopac.com.mx


1. Abra el Win/ow Formatter , presionando el botn de Window en la ventana de
Propiedades deI Procedimiento
2. De la caja de ControIes seleccione el botn de Control %emplate, con lo
cual abrir una lista completa de todos los ControI TempIate
disponibles.

3. Seleccione de la Clase CIass ABC - TempIates
ABC ( AppIication BuiIder CIass ) / CIose
Button


Tip : Este Control %emplate permite agregar un botn que permite cerrar la ventana al
momento de presionarlo. Es muy recomendable que cada vez que se haga una ventana
nueva se personalice cambiando el nombre del Caption ( Ttulo de la 'entana ) as como
agregando un Control %emplate de cerrar ventana.

4. Es necesario agregar el Global Extencion Template nternet Link (nternet Link Global) en el
Globla de la Aplicacin para posteriormente como Control %emplate en el lugar donde
desee ubicarlo dentro de la ventana Acerca/e...

5. Seleccione nuevamente de la caja de Controles el botn de Control %emplate.

6. Seleccione de la Clase CIass InternetLink -
Internet Link TempIate / InternetLink
Button.



7. Posicione el ControI TempIate en el lugar donde desee ubicarlo dentro de la ventana de
Acercade... Este ControI TempIate, nos permite agregar un botn, el cual tiene como
propiedad ejecutar el motor de Correos (ej. MS - Outlook ) instalado en la mquina para
enviar un correo electrnico a una direccin o ejecutar el navegador de nternet para abrir
una direccin especifica

8. Digite click derecho sobre el botn que acaba de insertar y seleccione propiedades.

Propiedades Botn :

Tab de GeneraI

Text : Texto a ser desplegado en el botn.
Agregando el smbolo ( ) antes de un
carcter, este se convierte en la tecla
aceleradora, la cual aparece subrayada
en el botn.

Use : Define el atributo U$ para este control.
Es el nombre de la variable con la que
Clarion identifica este control y con el que
se va a referenciar en la aplicacin.

Justification : La justificacin esta relacionada con el uso de los iconos en los botones. De
manera predeterminada el icono se muestra arriba del texto. Justificacin
derecha lo muestra a la derecha, y justificacin izquierda a la izquierda del
texto.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 87
www.gopac.com.mx
cursosgopac.com.mx


Hide : Oculta el control en la ventana, agregando el atributo HID al control. Utilice el atributo
UNHID para desplegar el control en la ventana




DisabIe : Desactiva el control cuando el programa inicialmente lo despliega, agregando el
atributo DI$ABL al control. Utilice el atributo NABL para permitir al usuario
accesar este control.

Skip : ndica al enera/or /e Aplicaciones, omitir este control del orden de los Tab, es
decir cuando se presione la tecla de Tab para pasar de campo a campo, este ser
saltado, es decir el Tab nunca le dar el focus a un control que tiene la bandera de
$I! activada.

ScroII : Especifica cuando un control se debe de mover cuando el usuario realiza un
desplazamiento de la ventana con las barras horizontales o verticales. La opcin
predeterminada es desactivada, lo cual indica que el control no se mover.


Freeze : Este atributo indica que en los subsecuentes cambios que se realicen al Diccionario
/e Datos y que tengan que ver con este campo no sern aplicados. Se pueden activar
este atributo a todos los controles o de manera individual. En las opciones de la
aplicacin ( Application ptions ) al activar este atributo todos los cambios que se
generen en el Diccionario /e Datos no sern aplicados.

Tab de Extra



Icon : Permite asignarle al botn un icono
estndar. La imagen se despliega en
la cara de botn, cortndola o
centrndola ya sea necesario.

FIat : Crea un botn de apariencia plana, hasta que el apuntador del ratn pasa
por encima. Este tipo de botones planos es comn utilizarlos en los
botones de la barra de trabajo. Esta caracterstica funciona mejor si el tipo
de icono utilizado es un archivo tipo .GF.

Required : Especifica que cuando el botn es presionado, el programa
automticamente checa que todos los controles con el atributo de
Requerido, no sean ni blancos ni cero. Cuando se presiona este botn con
el la opcin Require/ activada, y se encuentra con campos requeridos en
blanco o ceros en la forma, regresar el Focus al primer campo que no
cumpla con la condicin de requerido.

DefauIt Button : Asigna al botn como el control predeterminado, es decir cuando el usuario
presione la tecla nter se "presionara" el botn. En general se activa esta
opcin al botn que representa la opcin mas comn para el usuario.
Asigne solamente un botn predeterminado por ventana.

Inmediate : Permite crear un botn que repetir una accin continuamente, mientras el
usuario mantenga presionada este botn.

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 88
www.gopac.com.mx
cursosgopac.com.mx


Las /ems opciones que muestra el %ab /e tra son tema /el curso Interme/io.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 89
www.gopac.com.mx
cursosgopac.com.mx

Tab de CoIor



Text CoIor : Unicamente afecta el texto del botn
cuando un icono esta presente, pero
siempre afecta el indicador del focus
del botn ( rectngulo que aparece
alrededor del botn indicando que el
focus esta en este control )

Tab de HeIp



Cursor : Permite especificar una forma alterna
cuando el apuntador del ratn pase por
encima de botn. La lista provee
cursores estndares a seleccionar tal
como -Beam y Crosshair. Para
seleccionar un archivo de cursores
externos ( archivos extensin .CUR,
seleccione la opcin archivo de la lista y
a continuacin elija el archivo.

HeIp ID : En este campo se especifica el nombre del tpico que se acceder en el archivo de
ayuda al ser invocada este. Puede ser una clave del HELP o un contexto tipo String y
deber de identificarla anteponiendo un tilde ( ~ )

Message : Permite especificar el texto a desplegar en la primera zona de la barra de status
cuando el control tenga el focus.

Tip : Especifica el texto a desplegar en una caja de ayuda tipo "globo", cuando el
apuntador del mouse se posicione sobre el control y este se detenga un momento
en el. No existe un limite de caracteres a especificar en el Tip, pero se
recomienda que estos no sean mayores al tamao de la pantalla o ventana.

Tab de Position

Permite establecer la posicin y el tamao del
control. Tanto la posicin como el tamao del control
se puede indicar en forma manual a travs de este
Tab o mediante arrastrar el control y cambiarlo de
tamao con el mouse. Las coordenadas estn
establecidas en unidades de Dialogo. Estas son
relativas a partir de la esquina superior izquierda de
la estructura que se contenga, ya sea en ventana o
reportes
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 90
www.gopac.com.mx
cursosgopac.com.mx

Tab de Action ( Botn de InterIink )

Los %ab /e Actions permiten proveer funcionalidad
especifica a los controles.

Link to: Seleccione la accin que quiere que ejecute
el botn cuando sea presionado, ya sea
llamar una direccin Web o un correo
electrnico.

Address : Escriba la direccin Web o de correo
electrnico que desee ejecutar.

Nota : Al seleccionar H%ML / F%! al presionarse el botn se invocara al explorador
predeterminado que este instalado en la computadora. Si se escoge -Mail se
ejecutara el motor de correo electrnico que este instalado en el equipo.

Tip : En la mayora de los campos se puede especificar que se verifique una variable de
programa en tiempo de ejecucin. La manera en que esto se le indica en tiempo
de diseo es anteponer el smbolo de admiracin ! Nombre_de_VariabIe.



Una vez explicado los anteriores puntos usted deber de realizar la siguiente prctica :

Agregar al botn el icono de C:\curso basico\imgenes\spinmail.gif
Seleccione un tipo de Cursor diferente cuando se posicione el Mouse
sobre el botn
Agrege un Mensaje y ToolTips
Seleccione el tipo de Link del botn como correo electrnico
Direccin del correo electrnico predeterminado cursosgopac.com.mx





Grabe su aplicacin. Compile y corra su aplicacin presionando el botn .
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 91
www.gopac.com.mx
cursosgopac.com.mx

3.6 Ejercicio Agregando FuncionaIidad a un Browse

ControI TempIate Browse

El control template Browse, agrega una Lista a la ventana. Las !ropie/a/es de la lista
permiten definir las caractersticas fsicas de la misma ( apariencia ). List Bo Format permite
seleccionar los campos o variables a mostrar en la lista, as como definir sus caractersticas.
Actions permite definir la funcionalidad de los %emplate, incluyendo los filtros, rangos y
localizadores.

Actions ( Acciones )

El Tab de Actions permite definir un gran
nmero de opciones del template, as como
aadir cdigo fuente en puntos de cdigo
personalizado a la lista estndar de eventos, tal
como al moverse al final de la barra de
seleccin.






Quick- Scan Records ( Buffered Reads)

Especifica el comportamiento del buffer de
acceso para tablas tipo ODBC, ASCII, DOS o
BASIC. Estos drivers solo leen un buffer a un
mismo tiempo, no un registro, permitiendo un
acceso mucho mas rpido. En un ambiente
multi-usuario este tipo de Buffers no son 100 %
confiables para accesos subsecuentes, porque
algn usuario puede realizar cambios al
registro y este no verse reflejado, para evitar
esto , el driver siempre vuelve a releer el buffer
cada vez que haga un acceso al registro, para
desactivar esta funcionalidad active este
campo.
TabIe Schematics Descrition

Loading Method

Permite seleccionar el mtodo a utilizar
para leer los datos del Browse.

!age : Cargar los datos de forma de pgina,
provee un rpido despliegue de
los datos que no estn filtrador,
inclusive para Tab con gran
cantidad de datos. Utiliza menos
memoria, por el otro lado causa
trafico adicional en la red por cada
scroll de bsqueda que realiza.

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 92
www.gopac.com.mx
cursosgopac.com.mx

File : Permite cargar los datos para optimizar el despliegue vertical, adems de no
ocasionar trfico adicional a la red cuando se navega. Este tipo de mtodo es
adecuado par utilizarlo con $"L. Por el otro lado, este mtodo puede ocasionar
lentitud en el despliegue de los datos, as como la utilizacin de gran cantidad de
memoria cuando se leen gran cantidad de registros.

Accept Browse ControI from TooIbar

Activando esta opcin permite aceptar los eventos de navegacin y otro tipo de eventos
de control generados pro el FrameBrowseControl template, es decir permite o no
permite el uso de la barra de herramientas del Browse para el control del mismo.

Locator

Permite al usuario buscar un registro
especifico dentro de la lista, sin que se
tenga que realizar la navegacin manual
dentro de toda la lista. El localizador esta
nicamente disponible cuando la lista
esta en el orden de la llave que fue
especificada en el File $chematic . El
campo de bsqueda debe de ser el
primer elemento libre de la llave, esto es,
el primer campo componente de la llave que no esta en un lmite de rangos a un simple
valor. Para listas de mltiples llaves, se pueden tener mltiples localizadores. Utilice el
Tab de Con/itional Behavior para adicionar localizadores, seleccione el tipo de
localizador de la lista siguiente :

None No utilizar localizador

Step Especifica un localizador de un solo carcter sin ningn control de
localizador requerido. Cuando la lista tiene el focus y el usuario digita
algn carcter , la lista se posiciona en el registro que cumpla con la
tecla que el usuario dgito. Utilice este localizador cuando el primer
elemento de la llave sea tipo $%RIN, C$%RIN o !$%RIN y desee
que se posicione inmediatamente en la primera ocurrencia del campo de
la llave que inicie con el carcter digitado. Este localizador no es
apropiado par llaves numricas.

Entry Especifica un localizador multi-carcter que se activa cuando el
localizador es aceptado ( no en cada tecla digitada ) . Este localizador
puede ser un campo tipo N%R, CMB o $!IN. Utilice este tipo de
localizador cuando se requiera utilizar sobre una llave numrica o
alfanumrica.

IncrementaI Especifica un localizador multi-carcter, sin requerir un control
del mismo ( aunque se recomienda ). Utilice un localizador incremental
cuando desee buscar sobre llaves numricas o alfanumricas y desea
que la bsqueda se realice inmediatamente despus de que el usuario
dgito la o las teclas. Es decir conforme el usuario va presionando las
teclas la lista se va posicionando en el registro que mas se acerque.

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 93
www.gopac.com.mx
cursosgopac.com.mx

El localizador puede ser tipo STRING, ENTRY, COMBO o SPIN, aunque
cualquier otro diferente a STRING, causa que el localizador incremental
se comporte como localizador tipo ENTRY.

Cuando el control sea de tipo STRING, y la lista tenga el focus, los
caracteres son colocados automticamente en el localizador y la lista
inmediatamente avanza al registro concordante mas parecido. La tecla
de retroceso ( backspace ) borra los caracteres del localizador.

Es sumamente recomendable utilizar controles STRING como
localizadores incrementales, para que la bsqueda se haga de manera
automtica inmediatamente despus de cada teclazo, as el usuario
pueda visualizar el valor que esta buscando.

FiItered Especifica un localizador multicaracter, sin ningn control requerido.
Utilice localizador filtrado cuando se desea buscar en llaves
alfanumricas y desee minimizar el trfico en la red. Este localizador es
parecido al localizador incremental pero con filtro sobre los registros.
Especifica el rango de valores para realizar la bsqueda y muestra
nicamente los registros que cumplan con esa condicin. Por ejemplo
para una bsqueda del valor 'A' regresa todos los registros desde 'AA' a
'AZ'

El localizador filtrado determina el limite de la bsqueda basado en un
valor de bsqueda especificado por el usuario. La implementacin de los
lmites depende en los driver de la base de datos. Para base de datos
basadas en $"L el localizador filtrado utiliza la sentencia LI; para
base de datos I$AM utiliza limites superiores e inferiores. El localizador
solamente regresa los registros que correspondan al valor de la
bsqueda, generando un limite de rangos dinmicos.

Tip : El localizador debe de estar despus del Control /e la Lista en la definicin del
orden de control ( $et Control r/er ).

Por definicin, el localizador es un control cuyo atributo U$ es el primer
elemento libre de la llave que se esta utilizando. El elemento libre es aquel que
no esta limitado en los rango a un valor simple, si esto no se cumple el
enera/or /e Aplicaciones convierte el localizador a tipo $tep, en caso de no
existir una llave definida el enera/or /e Aplicaciones no adiciona un
localizador

Cuando el usuario presiona uno o mas caracteres en el localizador y presiona la
tecla %AB, o presiona un botn de localizador o selecciona algn otro control de
la pantalla , la lista avanza al registro mas cercano que cumpla la condicin.

El localizador filtrado se desempea correctamente con bases de datos $"L

Override DefauIt Locator ControI

El control predeterminado del localizador es el controle, cuyo atributo del USE es
el primer elemento libre de la llave del Browse. Para sustituir esta
predeterminacin y especificar un control diferente seleccione esta casilla. Esta
opcin, se utiliza en caso de que se tengan mltiples controles para el mismo
elemento libre de la llave en el atributo U$, esto es cuando se tienen el mismo
campo para ambas llaves, ascendente y descendente. Seleccione el control que
funcionara como localizador .
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 94
www.gopac.com.mx
cursosgopac.com.mx

.



Find Method

Unicamente disponible cuando se seleccione el localizador tipo Filtra/o. La
opcin Fin/Anywhere determina que la bsqueda se realice dentro de todo el
campo, en caso de no tener activada esta opcin la bsqueda se realizara
nicamente en los caracteres de la extrema izquierda.


Record FiIter

Digite una expresin vlida de Clarion para limitar el contenido de la lista exclusivamente
a aquellos registros que cumplan con la expresin. El procedimiento busca a travs de
todos los registros desplegables para seleccionar nicamente aquellos que cumplan con
el filtro. Los filtros son generalmente mas lentos que los rangos, ya que los filtros buscan
en toda la tabla. Es necesario que los campos o las variables estn BIND.

Range Limits

Especifica un registro o grupo de registros para incluirse en la lista. Seleccione un campo
presionando el botn de elipsis. El limite del rango es dependiente de la llave. Los
limites establecidos por rangos son mucho mas rpido que los filtros.

Current VaIue : Limita la llave al valor actual establecido en los campos en
Range Limit

SingIe VaIue : Limita la llave a un solo valor. Especifique el campo o variable
que contiene ese valor .

Range of VaIues : Permite indicar el valor superior y el valor inferior.

FiIe ReIationship: Permite seleccionar un limite de rangos por tabla en relacin
1:Muchos. Esto limita a desplegar en la lista solamente
aquellos registros hijos que concuerden con el registro padre
de la tabla.
AdditionaI Sort FieIds

Especifica campos adicionales para ordenar la tabla en suma a cualquier llave
especificada en el FiIe Schematic, simplemente con poner una expresin vlida,
delimitando por como los nombres de los campos.

Reset FieIds

Presionando este botn, despliega una ventana que permite aadir campos R$% (
restablecer ) . Si algn valor de cualquier campo en la lista de Reset Fiel/s, la lista es
actualizada automticamente.

ScroII Bar Behavior

Presionando este botn despliega un dialogo en donde se define la manera de
comportarse de la barra de desplazamiento vertical. La manera predeterminada es el
mtodo estndar de windows , movible, pero como esto no es posible realizarse
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 95
www.gopac.com.mx
cursosgopac.com.mx

correctamente para listas paginadas esta opcin permite seleccionar el comportamiento
que mejor se adapte a la aplicacin.

. Fixed Thumb : Barra de desplazamiento vertical fija. El indicador permanece
en el centro de la barra. Presione arriba del indicador para
paginar una pagina arriba.. Presione abajo del indicador para
paginar una pagina abajo


Tip : Seleccione el mtodo Fixed, ( Fijo ) cuando se muestren tablas grandes de SQL para
obtener mejor rendimiento.
MovabIe Thumb : Barra de desplazamiento vertical movible. Presione sobre el
indicador y arrastre para navegar sobre una porcin de la
lista. El indicador permanece donde se arrastro, y su
posicin en la barra indica, la posicin relativa sobre la lista

Cuando se selecciona esta opcin, se puede tambien
definir la distribucin de la llaves para determinar la manera
en que el indicador evala la posicin relativa dentro de la
lista.

Key Distribution : Especifica la distribucin de los puntos sobre la barra
de desplazamiento. Seleccione una de las dos
definiciones predefinidas ( Alfabticamente o
Apellidos "USA" ), Personalizado, o en Tiempo de
Ejecucin.

AIpha Define 100 puntos distribuidos alfabticamente.
ApeIIidos Define 100 puntos distribuidos de acuerdo a los apellidos
mas comnmente encontrado en Estados Unidos.
Custom Permite definir los puntos propios a utilizar
Run-Time Lee el primer y ultimo registro y calcula los valores a
distribuir los 100 puntos.

Custom Key Distribution

Permite especificar los puntos de distribucin a travs de la barra de
desplazamiento. nserte los valores para cada punto en la lista Las
variables constantes deben estar entre comillas sencillas.

Run-time Distribution Parameters

Permite especificar los tipos de caracteres considerados para determinar los
puntos de distribucin. Esto es solamente apropiado cuando el primer elemento
libre de la llave es STRING o CSTRING. Selecciones las casillas para los tipos
de caracteres que se desee incluir para las consideraciones.









_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 96
www.gopac.com.mx
cursosgopac.com.mx



ConditionaI Behavior

Este Tab contiene una lista que
permite definir el comportamiento
basado en las condiciones o
expresiones. Aada las expresiones a
la lista presionando el botn de
Insert. Este dialogo permite definir
las expresiones y asociar el
comportamiento cuando esta
expresin sea verdadera.





Hot FieIds

Permite especificar campos o variables no especificados en la lista para ser aadidos al
QUEUE. Cuando se desplaza por la tabla, el cdigo generado lee los datos de esos
campos o variables del QUEUE, en vez de hacerlo del disco. Esto aumenta la velocidad
de la actualizacin de la lista.

Especificar Hot FieIds, permite tambien establecer controles fuera del BrowseBo, que
son actualizados cada vez que se selecciona un registro diferente de la lista. Elementos
de la llave primaria y de la llave actual son siempre incluidos en el QUEUE, por lo tanto
no es necesario especificarlos como Hot Fiel/s. Estos campos tambien puede
especificarse el atributo BIND. Es necesario hacer a cada campo, variable o EQUATE el
BIND, cuando estas forman parte de una expresin en un filtro.

TotaIing

Permite definir campos totales en el BrowseBo. Al presionar el botn de Insert abre el
cuadro de dialogo para definir los campos totales dentro del BrowseBo

TotaI Target FieId : Variable que contendr el valor total calculado. Puede ser
variable local, modular o global, incluso un campo de la
tabla, mas sin embargo se tiene que escribir el cdigo
necesario para actualizar la tabla.

TotaI Type : Seleccione Count, $um, o Average ( Contar, Sumar o
Promedio ) de la lista de opciones. Count : cuenta el
nmero de registros. Sum suma los valores del campo
especifico ( Fiel/ %o %otal ) al campo total ( %otal %arget
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 97
www.gopac.com.mx
cursosgopac.com.mx

Fiel/ ). Average : Determina el promedio del campo (
Fiel/ %o %otal ) al campo total ( %otal %arget Fiel/ )


FieId to TotaI : Campo a sumar o a promediar.


TotaI Based On : Total basado en cada registro o en una condicin
especificada, la cual al evaluar la condicin y ser
verdadera, esta ser sumada al campo total el valor a
sumar.


TotaI Condition : Expresin a cumplir cuando se utiliza el total basado en
condicin.



_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 98
www.gopac.com.mx
cursosgopac.com.mx

CoIors ( CoIores )

Este %ab esta solamente disponible cuando se activa la casilla de Color en el List Bo
Formatter. Despliega una lista de todas las columnas del BrowseBo que son sujetas a
color. Para especificar un color predeterminado o condicional, seleccione el campo, y
presione el botn de !ropie/a/es, el cual abre el dialogo de Customize Colors
(Colores !ersonaliza/os ) , en el cual se pueden especificar los colores
predeterminados y condicionales tanto para primer plano como para el fondo, tanto para
renglones seleccionados como para renglones no seleccionados.

ConditionaI CoIor Assignments

Permite definir los colores a aplicar cuando una expresin sea evaluada y esta
sea verdadera. Para aadir una expresin y asociarle colores, presione el botn
IN$R%. En tiempo de ejecucin la expresin es evaluada, y los colores para la
primera expresin verdadera son utilizados.

Icons ( Iconos )

Este %ab esta solamente disponible cuando se activa la casilla de Icons en el List Bo
Formatter. Despliega una lista de todas las columnas del BrowseBo que son sujetas a
un icono condicional. Para especificar un icono predeterminado o condicional, seleccione
el campo y presione el botn de !ropie/a/es, el cual abre el dialogo de Customize
BrowseBo Icons ( Iconos !ersonaliza/os ) , en el cual se pueden especificar los
iconos predeterminados y condicionales .

DefauIt Icon cono predeterminado a desplegar. Digite el nombre y ruta
completo de un archivo tipo .ICO


ConditionaI Icon Usage

Permite definir los iconos a utilizar cuando una expresin sea evaluada y esta
sea verdadera. Para aadir una expresin y asociarle un icono, presione el botn
IN$R%. En tiempo de ejecucin la expresin es evaluada , y los iconos para la
primera expresin verdadera son utilizados.


3.6 Ejercicio Agregando FuncionaIidad aI Browse de CIientes

Agregar el Nombre del Vendedor en el Browse
Tab de Vendedores Agregar Tipo de Relacin File Relationship
Agregar Localizador en Tab de Nombre
Agregar Localizador Filtrado en el Tab de Nombre


1. Seleccione del rbol de
procedimientos el BrowseCliente.

2. En la ventana de propiedades
presione el botn de Win/ow para
iniciar el Win/ows Formatter del
proceso

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 99
www.gopac.com.mx
cursosgopac.com.mx

El Browse de Clientes, que se muestra a continuacin es el Browse que se gener cuando se
gener la aplicacin por medio de los asistentes :


3. Presione el botn derecho del mouse en el Win/ows Formatter sobre el
Browse /e Clientes y seleccione ListBo Format para acceder al
formato de la lista del Browse.



List Box Formatter

Muestra como la lista del Browse se esta generando. Rellenando el cuadro superior de
ejemplos con caracteres que representan el contenido de cada campo. Si algn campo
contiene encabezado , estos aparecen en la parte superior.

Grupo Nuevo : Permite
aadir un grupo nuevo,
agregando a la columna
seleccionada dentro de un
grupo, el cual se puede
designar un ttulo.
eva CoIumna : Aade un
campo a la lista. Se puede
indicar cualquier campo de las
tablas o variable de memoria.

Borrar CoIumna : Borra la
columna seleccionada de la
lista.,

Mover a Ia Izquierda :
Mueve el campo
seleccionado una posicin a
la izquierda. Si el campo
seleccionado es el campo a la
extrema izquierda de un
grupo este pasa a estar fuera
del grupo, sin cambiar su posicin. Si el campo seleccionado es el campo
inmediatamente a la derecha del grupo, este es movido dentro del grupo sin cambiar su
posicin actual.
Mover a Ia Derecha : Mueve el campo seleccionado una posicin a la derecha . Si el
campo seleccionado es el campo a la extrema derecha de un grupo este pasa a estar
fuera del grupo sin cambiar su posicin. Si el campo seleccionado es el campo
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 100
www.gopac.com.mx
cursosgopac.com.mx

inmediatamente a la izquierda del grupo, este es movido dentro del grupo sin cambiar su
posicin actual.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 101
www.gopac.com.mx
cursosgopac.com.mx


GeneraI este Tab permite personalizar las siguientes opciones :

Header

Heading Text : Modificar el texto del
encabezado de la columna, el nombre
predeterminado es el nombre del
campo que se indico en el diccionario
de datos en el campo !rompt %et.. El
encabezado se muestra en el rengln
gris que se indica en la parte superior de la lista de datos. Al asignarle un
encabezado a un grupo el encabezado este se muestra en la parte superior de
los campos que conforman el grupo. El formato del encabezado se muestra entre
los caracteres de tilde (~)

Width : Especifica el ancho de la columna del campo en unidades de dialogo. De
manera predeterminada el Formatter asigna el valor del nmero de caracteres
especificados en el campo de !icture en el Diccionario /e Datos por cuatro, es
decir si se asignan un !icture de 10 posiciones, el Wi/th estara representado
por 40.

ScroII Bar : Permite indicar si se agrega una barra de desplazamiento horizontal
al campo seleccionado, es decir , si se desea que la columna Nombre solo tenga
80 unidades de dialogo de ancho, es decir 20 caracteres, y esta tiene 40
caracteres totales , se indicara que tiene un barra de desplazamiento de otras
80 unidades de dialogo para mostrar 40 y 40 para desplazar dentro de la
columna.

Justification : ndica la justificacin izquierda, derecha, centrado o decimal del
encabezado .

Indent : ndenta el encabezado de la columna en unidades de dialogo, de
manera contraria a la justificacin seleccionada.


CoIumn Data

Picture : Especifica el formato con
el que se representara la
informacin del campo. El ListBo
Formatter toma el Picture
predeterminado en el diccionario de
datos.

Justification : ndica la justificacin izquierda, derecha, centrado o decimal de
los datos de la columna. La justificacin decimal alinea la informacin a partir del
punto decimal.

Indent : ndenta los datos de la columna en unidades de dialogo, de manera
contraria a la justificacin seleccionada. n el caso /el punto /e /ecimal y la
justificacin es /ecimal, es importante in/icar la in/entacin /e acuer/o a
la canti/a/ /e nmeros /ecimales por cuatro.

FieId Number :
Auto:
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 102
www.gopac.com.mx
cursosgopac.com.mx

Formatting FIags

Right Border : Agrega un
separador de columnas
entre los campos en la
lista .

ResizeabIe : Activa o desactiva la funcionalidad del usuario de mover el tamao
de las columnas en tiempo de ejecucin.

UnderIine : Esta casilla activa aade estilo subrayado al texto de la lista,
causando el efecto de borde inferior para cada columna, dndole un efecto de
hoja de clculo o celdas a la lista, esto en combinacin con el atributo Right
Bor/er

Fixed : Esta opcin indica que la columna se mantendr visible, aunque se
desplace por la lista de manera horizontal, columna tipo Ttulo.

Last on Line : ndica que el prximo campo en el grupo aparecer
inmediatamente debajo del campo actual, es decir apila dos o mas campos
debajo del encabezado del grupo. Nota : El campo debe de formar parte de un
grupo.

Locator : De manera predeterminada el primer campo de un Combo tipo multi-
columna es el que se despliega en la porcin del Entry de un Combo. Activando
la casilla indica que el este campo, en vez del primero es el que se despliega en
el Entry del control multi-columna del Combo.

CoIor : Active esta opcin para permitir colores condicionales en tiempo de
ejecucin. Este se especifica en los Actions /el Browse / Colors anteriormente
mencionados ( pp 71 - 77 ) En el manual del Application Han/book
encontrara informacin sobre los colores condicionales BrowseBo

StyIe : Activando esta opcin permite establecer estilos condicionales en tiempo
de ejecucin. Este se especifica en los Actions /el Browse / $tyle
anteriormente mencionados ( pp 71 - 77 )

TooITip:

Tip: Una vez agregado el campo a la lista, se pueden arrastrar los separadores de columna de
la lista de ejemplos para modificar el tamao del ancho de la columna, de una manera mas
sencilla y prctica.

Appearance Tab permite personalizar las siguiente opciones :

CoIor and StyIe Permite establecer
los colores y estilos predefinidos para
todos los renglones de la columna
seleccionada. Tanto para el %eto,
Fon/o, %eto $elecciona/o, Fon/o
$elecciona/o

DefauIt StyIe : El nmero de estilo
define el tipo de fuente, tamao, estilo
y color para todos los renglones y columnas de la lista.

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 103
www.gopac.com.mx
cursosgopac.com.mx


Icon

None : ndica que no se quiere desplegar un icono en esta columna.

NormaI : Crea una rea a la izquierda de los datos de la columna para
desplegar una imagen tipo ( .ICO ). Este se especifica en los Actions /el
Browse / Icons anteriormente mencionados ( pp 71 - 77 )

Transparent : Crea una rea a la izquierda de los datos de la columna para
desplegar una imagen transparente tipo ( .ICO ).


Tree Tema del Curso Intermedio.


4. El campo de CLI:Vendedor indica que el campo a desplegar es el Nmero /el
Ven/e/or, lo que se requiere es que el Nombre /el Ven/e/or es el que se visualice,
por lo tanto posicionese en el campo CLI:Vendedor y presione el botn de
agregar columna


5. Seleccione del lado izquierdo ( TabIe
Schematic ) la tabla de Ven/e/ores de
ther %ables.

6. Seleccione de CoIumns el campo de
VEN:Nombre, y presione el botn de
$elect, para adicionar este campo a la
lista.


7. Quedando de la siguiente manera , seleccione el campo
CLI:Vendedor y brrelo presionando el
botn


8. Seleccione el campo VEN:Nombre en Heading Text ponga
el siguiente encabezado : Vendedor.

9. En Justification asgnelo Left y en Indent con dos unidades de dialogo.

10. En la seccin de Data / Justification asigne Left.

11. Mueva el campo con los botones ya sea a la derecha o a la
izquierda.

12. Presione el botn de para salir del ListBox Formatter.

13. Seleccione la lista y presione click derecho y
seleccione la opcin de AC%IN$

14. Seleccione el Tab ConditionaI Behavior, posicionese sobre la
opcin
CHOICE(?CurrentTab) = 3 - CLI:FKVendedor y presione el botn de
!R!R%I$.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 104
www.gopac.com.mx
cursosgopac.com.mx


15. En el campo de Range Limit Fiel/ seleccione el campo CLI:Vendedor

16. En Range Limit %ype seleccione de la lista el valor File Relationship

17. Asegrese que en el campo de Relate/
File este la tabla Ven/e/or, caso contrario
seleccinela.

18. Presione el botn de Locator Behavior

19. Seleccione de la lista el tipo de localizador a
Filtere/

20. Active la casilla de Fin/ Anywhere.

21. Presione el botn cuantas veces sea
necesario para regresar al Win/owsFormatter .

Con esto se activa el tipo de localizador del %AB de Ven/e/ores para que acte en forma
filtrada por el Nmero /e Ven/e/or, es decir, nicamente mostrara los clientes del nmero de
vendedor que se vaya digitando.

Para agregar el localizador por nombre en el %AB de Clientes, no es necesario realizar nada,
automticamente Clarion aade el localizador, pero generalmente es muy til para el usuario
final visualizar lo que se esta localizando para lo cual se agregar un Localiza/or ( tipo ntry )
en el %ab de Clientes.

22. Seleccione el %ab de Clientes, y de la Caja /e Controles seleccione el Control
ntry

23. Coloque y arrastre el control sobre el %ab de Clientes, en la posicin y tamao que
desee
ubicarlo y sultelo.

24. Seleccione del %able $chematic /
File Browsing List Bo la tabla
de CIientes y selecciones el
campo CLI:Nombre. Con lo cual
esta creando la referencia entre el
ntry agregado y la tabla de
Clientes


25. De la barra de herramientas presione el icono para grabar y salir a las
propiedades del procedimiento, presione el botn de .

26. Grabe su aplicacin. Compile y corra su aplicacin
presionando el botn .







_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 105
www.gopac.com.mx
cursosgopac.com.mx



Prctica Browse de CIientes
Agregar en el Browse el campo de Descripcin de la Familia del Artculo
Eliminar en el Browse el campo de Nmero de Familia del Artculo
Agregue bordes a las columnas del Browse
Agregue formatos a las columnas
Agregue la relacin entre los campos de Familia de la tabla Artculo y de
la tabla Familias en el Tab de Familias ( ConditionaI Behavior )
Agregue el tipo de Localizador Filtrado para este Tab
Agregue un control Entry como visualizador del Localizador por Nombre


Grabe su aplicacin. Compile y corra su aplicacin presionando el
botn
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 106
www.gopac.com.mx
cursosgopac.com.mx

3.6 Ejercicio Agregando Sort Order Button a un Browse

Ahora en este ejercicio aplicarremos un nuevo control template que tiene clarion
para elegir la forma como queremos ver ordenado un browse, este template cambia
la forma claisca de los TABs sobre el Browse ya que automaticamente esconde los
TAB$ control del browse (opcionalmente un solo TAB) y cuando se presiona delpliega
una lista tipo pop up con las opciones para elegir por que llave quiero ordenar el
Browse.


1. Selecciona el Browse de Vendedores


2. Entrar al Editor de Ventana (Window formater)


3. De los "Control templates Agregar el
template SortORderButton


4. Colocarlo, sobre los TABS del Browse de
Vendedores.





5. En las acciones del Botn, en el Parmetro
Sheet Order $eleccionar la Opcin
?urrenTab.


Sheet Control: Aqu se selecciona la hoja que tendra el control para
ordenar los tabs. Cada Tab representa uan diferente secuencia de
ordenamiento del browse. Generalmente se seleciona ?CurrentTab,
pero es posible elegir cualquier otra hoja validad que se muestre en el
drop de elecion.

Hide Sheet Marcando este Check se escondela hoja que selecionaste
desde en el Propt Sheet ontrol.

6. En el editor de la ventana, presione F12 para Abrir la
ventana de las propiedades del Browse en forma de rbol y
asegrese de que el botn que acabamos de agregar.
?$ortORderButton. Este "Colgado del flder ?CurrenTab.


7. Compilar y probar.





_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 107
www.gopac.com.mx
cursosgopac.com.mx



3.7 Ejercicio Agregando Sort Order Drop a un Browse

EL Control Template $ort Order Drop List esta diseado para proporsionar o moistrar
una lista decendente (Drop List control) que representa el centro de elecion de
ordenamiento del browse de archivo. EN tiempo de ejecucion los TAB$ clasicos de un
Brose se esocnden y se despliega una lista (Drop list) para elegit lal lalve por la que
se ordenara el browse.

TIP: uando pones este control sobre la forma, te aparece la ventana para
elegir un ampo para el control en este punto debes presionar ANEL y
depues debes elegir que no cuando te pregunte si quieres guardar los cambios
en el Formaeador del List Box. El template automaticamente desplegara la
liasta de las opciones que tiene el Browse para ordenarse.

Cuando se utiliza este control sobre una forma asegurate de que no este sobre un
TAB (si asi se requiere) pero que si este sobre la ventana. This will make it visible for
all sort choices. You can verify this in the Window Formatters Property Editor.


1. Selecciona el Browse de Articulos


2. Entrar al Editor de Ventana (Window formater)


3. De los "Control templates Agregar el
template SortORderButton


4. Colocarlo, sobre los TABS del Browse de
Vendedores.





5. En las acciones del Botn, en el Parmetro Sheet Order $eleccionar la Opcin
?urrenTab.

Sheet Control: Aqu se selecciona la
hoja que tendra el control para
ordenar los tabs. Cada Tab representa
uan diferente secuencia de
ordenamiento del browse.
Generalmente se seleciona ?CurrentTab, pero es posible elegir
cualquier otra hoja validad que se muestre en el drop de elecion.

Hide Sheet Marcando este Check se escondela hoja que selecionaste
desde en el Propt Sheet ontrol.


_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 108
www.gopac.com.mx
cursosgopac.com.mx



6. En el editor de la ventana, presione F12 para
Abrir la ventana de las propiedades del
Browse en forma de rbol y asegrese de que
el botn que acabamos de agregar.
?$ortORderDrop y el ?$ortORderDropPrompt .
Esten "Colgado del flder ?CurrenTab.


7. Compilar y probar.








3.7 Ejercicio HabiIidar Ias Columnas auto ajustables de Browse al tamao del
Campo (Enable Auto Size BrowseBox olumns)

Este check box habilita el que las colunas de un browse se auto ajusten al tamao
del cambo o variable que estan mostrando. EN tiempo de ejecucion al hacer doblel
click sobre la linea derecha de la columna del list box, automaticamente se ajustara
el tamao. Al contenido mas largo del campo.
Esta funcionalidad se puededeshabilitar
individualmente en las propiedades de cada
browse.

1. Para habilitar que las columnas se ajusten
automticamente Primero es necesario
Habilitar esta Funcion en el Global de la
aplicacin en APP $ETTING$.


2. En el Grupo Extended Browse Optios,
encender el Check de Enable Auto size
BrowseBox Columns. De esta forma en
todas los browses se habilitara la opcion
de Auto size en las columnas.


3. &na vez habilitada la opcion en el global
se activa en todos los browses de la
aplicacin y si se desea des habilitar
esta opcion es necesario entrar en las
acciones del List Box del browse y en el
TAB Extended Optios Marcar el Check
Disable Auto Size BrowseBox olumns.

4. Compilar y probar.

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 109
www.gopac.com.mx
cursosgopac.com.mx

.8 Ejercicio para Habilitar el Efecto de Barra Verde (Green Bar) en un
Browse.

El efecto de barra verde consiste en mostrar un renglon del browse con un color
(verde) y el siguiente en blanco o con un color dferente, semejando esto al papel
pautado que se utlizaba mucho tiempo atrs.

1. $eleccionar el Browse de Articulos


2. Entrar al Editor de ventanas y seleccionar el List Box de Articulos.


3. Dentro del List Box Format del Browse de
Artculos, en cada campo, habilitaremos el
Check de Colores (Colors) y presionamos
OK para que se tomen los cambios.

4. Entramos a las Acciones del Browse y
en el Tab de Colores, habilitaremos el
check que dice Use same color for All
columns. Para que la configuracin se
aplique a todas las columnas del Browse y ademas habilita el Create Greenbar
Effect.


5. Ah mismo marcamos el Chek del Create
GreenBar Effect, efecto de barra verde. Para
que muestre la seccion de configuracin de
primer color y segundo color.


6. Asignar El color COLORLIME para
BACKGROUN Normal (Fondo Normal) y
COLOR YELOW para BACKGROUN
SELECTE (Fondo Selecionado), para lograr
el efecto.


7. Compilar y Probar. El Browse debe verse dela
siguiente manera












_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 110
www.gopac.com.mx
cursosgopac.com.mx


.9 Control Template NOBrowseRecordsButton

Este Control template al agregarlo en un Browse automticamente detecta si la
tabla tiene registros o si la tabla est vaca. Estar Deshabilitado cuando la tabla
este Vaca y estar habilitado cuando la tabla tenga registros.



1. $eleccionar de los control Tempaltes el
BrowseNoRecordButton, y colocarlo
sobre el browse.

2. En las Propiedades de este botton control template, se puede configurar la
accin a seguir, ya sea quedar deshabilitado (Disable) o Escondido (Hide),
cuando la tabla que muestra el Browse no tenga registros.

Select from popup
El marcar esta opcion agregara el
noRecordbutton el menu pop up
del browse. El Text del boton sera
delsplegago en el menu pop &p.

When no Records
Elegir la accion de Deshabilitar
(Disalbe) o Esconder (Hide) del
boton cuando el Browse donde se
utiliza el control no tenga registros.

Refresh Window After Action?
Check this box to force a window
refresh after the buttons actions
are completed. In the ABC chain,
this will generate
"ThisWindow.Reset(True)". In the
Clarion template chain, this will
generate "ForceRefresh = TR&E;DO RefreshWindow".

3. Para este caso selecionaremos la opcion Disable


4. Al compilar y ejecutar la aplicacin se mostrara de la siguiente
manera cuando la tabla que se muestra en este Browse no tenga
registros.




5. Y se vera de la siguiente manera cuando la tabla tenga
registros., para este ejemplo se configur el control
template como (DI$ABLE).


_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 111
www.gopac.com.mx
cursosgopac.com.mx

.10 Ejercicio Utlizar el Query By Example (QBE)

Este Control Template le permite al usuario final generar Querys (Bsquedas Dinmicas)
en los Browses para aplicarlas, y utilizarlas posteriormente. Guardarlas todo este en tiempo
de ejecucin.
Clarion 6.0 cuenta tipos de QBE control Template. Uno es el BrowseQBEButton QBE-Filter
y QBE Filter Advanced.

El BrowseQueryButton control template es un botn que llama a una
Interface donde el usuario final puede seleccionar un campo, un operador
comparativo (=,>,<,Etc) y as mismo establecer un valor para comparar el
contenido del campo y aplicarlo como filtro.

La nterface del BrowseQueryButton, se pude configurar de dos maneras una es de tipo
FORM y la otra de tipo LSTA.

1. BrowseQueryButton de Tipo Form con este tipo de Interface puedes
seleccionar el campo y utilizar los operadores =, >= , <=, <> para
comparar el contenido de campo que deseas filtrar.


2. En la ventana de diseo del Browse, agregar el
control Template BrowseQueryButton,
colocarlo en el tab del Browse.





3. En las Actions del BrowseQueryButton,
presionar el botn QBE Options



4. En la $eccin QBE Interface $eleccionar la
opcin FORM.

















_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 112
www.gopac.com.mx
cursosgopac.com.mx



5. Al compilar y ejecutar la aplicacin veremos el
siguiente resultado en pantalla. $eleccionar el
Botn de Query en el Browse y establecer el
Criterio.













6. BrowseQueryButton de Tipo List: con este tipo de Interface puedes
seleccionar el campo y utilizar los operadores =, >= , <=, CONTAINS,
BEGINS y NOT =, para comparar el contenido del campo que deseas
filtrar, en este tipo de QBE te permite, seleccionar el campo que deseas
comparar, el operador para comparar y el valor contra el que deseas
comparar.

7. LA nica diferencia para utilizar QBE tipo list es que en las Actions del
BrowseQueryButton, deber presionar el botn QBE Options y en la
$eccin QBE Interface $eleccionar la opcin LIST.










8. Al compilar y ejecutar la aplicacin veremos el siguiente resultado en
pantalla. $eleccionar el Botn de Query en el Browse y establecer el
Criterio de bsqueda en forma de lista.


_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 113
www.gopac.com.mx
cursosgopac.com.mx


3. Ejercicio LIST FORMAT MANAGER

El List Format Manager, te permite $eleccionar el orden en que quieres ver
los registros de un Browse, adems con el puedes personalizar el Browse de
tal modo que puedes elegir las columnas que tu quieres ver, y guardar esa
Configuracin como un $ET de columnas y grabarlo, para su uso posterior,
todo esto en tiempo de Ejecucin.

1. En las acciones del browse de
Vendedores, en el tab Extended
Options, encontraremos la Opcin
List Box Manager




2. Al presionar el Botn LIST FORMAT MANAGER, entraremos a la
configuracin del LIST FORMAT MANAGER.



Pop Up Mode: (Modo
del Menu POP UP) :
Te permite seleccionar
la opcin habilitar el
Drop list para permitir al
usuario el acceso a la
Interface del Format
Editor en tiempo de ejecucin, o seleccionar Deshabilitar para quitar
el Men del Format Editor en tiempo de Ejecucin.

Format Editor Interface:

Items Check Type:
$elecionar Icons para permitir que la figura (Check Box) aparezca al
lado derecho, en la seleccin de campos, en el Editor de Formatos.
(En tiempo de Ejecucin). $eleccionar Texto si en lugar del Icono de
Check Box quieres que salga la palabra "YE$ o "NO al seleccionar
las columnas a mostrar en Format Editor. (En tiempo de Ejecucin)

Items Sort By:
$eleccionar Alpha en el rop list para desplegar todos los list
Format en Orden Alfabtico, o $eleccionar Code para ordenar los
list Format en el orden como fueron registrados.

Identificator Tip:
$eleccionar Enable para permitir que los TOOL TIP$ sean
desplegados en el Format Editor.

ifferent Format for each Sort Order?:
Habilitar este Check Box permite guardar un list Format diferente
para cada llave activa que tenga el Browse.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 114
www.gopac.com.mx
cursosgopac.com.mx


Save Format on Session?:
Habilitar este Check box permite al usuario guardar los cambios
actuales que haga cuando cierre la ventana, y pueda usar el mismo
formato como el nuevo predeterminado cuando la ventana sea
abierta de nuevo.


3. Despus de compilar y ejecutar la
aplicacin en el Browse de
Vendedores, seleccione cualquier
Registro y presione el Botn derecho
para entrar al LIST FORMAT








4. $eleccionar el FORMAT SETUP, Para entrar a la
configuracin del LIST FORMATS y presione el Botn
de INSERT para agregar un List Format o Formato de
lista nuevo.







5. Asignar el nombre de Telfonos y marcar slo el
nombre y el telfono como columnas a mostrar en
nuestro Formato de Lista y por ultimo seleccionar el
Botn de SAVE para que Ese nuevo formato de lista
se Guarde.







6. Presione el Botn del Aply para que el nuevo
Formato de lista se Aplique a Browse.






_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 115
www.gopac.com.mx
cursosgopac.com.mx

7. EL Browse de Vendedores debe Verse tal y como se muestra en la Figura, slo
el nombre y el telfono.





















































_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 116
www.gopac.com.mx
cursosgopac.com.mx


3.2 Agregando FuncionaIidad a un Form ( Forma )

Agregando Field Lookup Button
Agregando DOS File Lookup Button
Agregando Funcionalidad a un Control Tipo Spin
Agregando Funcionalidad a un Control List Box
Agregando una magen
Puntos de Cdigo Sencillos

Los LookUp Button y FileDos LookUp Button son control template de la clase :Class ABC -
Application Buil/er Class %emplate

FieId LookUp Button

El template del Fiel/ LookUpButton provee de un botn que permite al usuario hacer una
bsqueda ( look up ) de un valor en una tabla. Asignando el resultado de la seleccin a un
control, el cual generalmente es un control tipo ntry, el cual en sus acciones permite especificar
las siguientes caractersticas :

Actions

Las acciones estndar estn diseadas para proveer
validacin de la informacin para el control. El %ab
esta dividido en dos secciones paralelas. When the
Control is $electe/ ( Cuan/o el Control sea
$elecciona/o ) provee validacin cuando el control
recibe el focus. When the Control is Accepte/ (
Cuan/o el Control sea Acepta/o ) provee
validacin cuando el control pierde el focus, despus
de que la informacin a sido seleccionada. Las dos
secciones no son mutuamente exclusivas, por lo cual
se puede proveer informacin en ambos puntos, o en
un solo.

Lookup Key

Permite seleccionar la llave de la tabla, con la que se mostrara la informacin de la
misma.

SeIect Key DiaIog

Permite seleccionar la tabla y la llave que utilizara al momento de desplegar la
informacin de la tabla.

Tip : El LookUp funciona mejor con llaves que estn compuestas de un nico
campo.

Lookup FieId

Selecciona el componente del campo de la llave que ser asignado a la variable del
ntry.




_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 117
www.gopac.com.mx
cursosgopac.com.mx

Lookup Procedure

Se indica el procedimiento a ejecutarse cuando el usuario digita un valor invlido al
permitido en el campo ntry o presiona el botn de LookUp



Perform Iookup during non-stop seIect

Activando esta casilla indica a Clarion , ejecutar una validacin cuando la ventana es
aceptada, incluso cuando el control no reciba el focus, es decir, si el campo por alguna
circunstancia no fue seleccionado o su valor no es valido y se pretende cerrar la ventana,
se ejecutara automticamente el LookUp. Desde el punto de vista prctico activar esta
casilla previene al usuario de dejar en blanco un campo requerido al presionar el botn
de .

Force Window Refresh when Accepted

Activando esta casilla se asegura que todos los controles, formulas y ntry's en la
ventana son actualizados cuando el usuario presiona la tecla %AB despus de estar
sobre este control.

DOS FiIe Lookup Button

El template del D$ File Lookup Button, provee de un botn que permite al usuario abrir una
ventana de bsqueda de archivo estndar de Windows.

Permite especificar las mscaras a utilizar, el directorio y el nombre predeterminado del archivo
as como la variable a recibir la ruta y el nombre seleccionado por el usuario. Opcionalmente se
puede permitir mltiples selecciones de archivo , as como especificar el cdigo a procesar por
cada seleccin.

GeneraI

FiIe DiaIog Header : ndica el ttulo en la
ventana de dilogo a mostrar.

DOS FiIename VariabIe : Presionando el
botn de elipsis, permite elegir la variable que
va a recibir la seleccin realizada por el
usuario.

DefauIt Directory : Permite indicar el
directorio de inicio que se mostrara en la
ventana de dilogo. Si ningn directorio es
sealado, el dilogo abrir en el directorio de
trabajo de la aplicacin.

DefauIt FiIename : Especifica el nombre inicial que se mostrara en el campo
correspondiente en el cuadro de dilogo. Si ningn nombre es especificado, el cuadro de
dilogo no mostrar ningn nombre.

Return to originaI directory when done : Al activar esta casilla, una vez que es
realizada la bsqueda, restablecer el directorio de trabajo a su valor inicial.

Long FiIenames? : Permite habilitar el uso de nombres largos en el cuadro de dilogo .
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 118
www.gopac.com.mx
cursosgopac.com.mx


MuIti-SeIect? : Permite seleccionar uno o mas archivos .

Action For Each SeIection : ndique el procedimiento a llamar para cada seleccin.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 119
www.gopac.com.mx
cursosgopac.com.mx

FiIe Masks

Use a variabIe fiIe mask : Activando esta casilla
permitir definir en una variable de programa la
mscara de archivo a utilizar.

Mask VariabIe : Nombre de la variable de
programa que contendr la mscara de archivos
a utilizar. Para especificar esta variable refierace
a su manual :Language Reference en
FileDialog

FiIe Mask Description : Especifica la descripcin del tipo de archivo, el cual aparecer
en la lista de la ventana de dilogo. Se pueden adicionar mas descripciones de archivos
presionando el botn More File Masks.

FiIe Mask : Determina la mascara a utilizar como por ejemplo "*.%%" o se pueden
utilizar mltiples patrones de mscara , separados por punto y coma, como por ejemplo
"*.BM!;*.IF".

More FiIe Masks : Las mscaras adicionales se especifican en esta parte, las cuales
estarn disponibles al usuario final a travs de la lista que se despliegue en la ventana
de dilogo.

Window Update Options

Update entire window? : Activando esta casilla
permitir la actualizacin de todos los controles
contenidos en la ventana, una vez terminado el
proceso de seleccin.

Update SeIected FieIds : Se pueden especificar los controles o campos que se
requieren actualizar una vez que se termino el proceso de seleccin.


Spin ControI

En la caja de ControIes el control especificado con el Botn es el Control %ipo $!IN
B. Los $pin Boes son cajas de acceso ( entry boxes ) que solamente permiten valores
predefinidos en rangos. As mismo proveen al usuario de botones de incremento y decremento,
fciles de accesar mediante el uso del mouse o igualmente digitar directamente dentro del
control.

GeneraI

Picture : Especifica el formato con el que
se desplegaran lo valores que sean
introducidos en el campo. Puede
seleccionar un formato presionando el
botn de elipsis. De manera
predeterminada se asigna el formato
elegido por la variable a utilizar en el
campo. Si el usuario digita informacin en un formato diferente al establecido, el
programa tratara de determinar el formato convirtiendo la informacin de acuerdo al
formato especificado. Si el programa no puede determinar el formato de la informacin,
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 120
www.gopac.com.mx
cursosgopac.com.mx

esta no ser actualizada a la variable utilizada y el focus regresara al control para que
vuelva a ser introducida informacin de acuerdo al formato.


Use : Permite especificar la etiqueta ( label ) de la variable que recibe el valor que el
usuario selecciona o la etiqueta de un campo equate que hace referencia al control en
las declaraciones del programa.

From : Este atributo es opcional, pero es muy til en valores que se incrementan de una
manera irregular. Permite proveer al usuario de formatos tipos String como opciones del
$pin Bo, tales como los das de la semana o los meses del ao, para estos casos
especifique un "UU en este campo .

Justification : Especifica la alineacin izquierda, centro, derecha, decimal o
predeterminada. La predeterminada esta establecida por la determinada en el
diccionario de datos. Seleccionando alineacin decimal, debe de especificar Offset
necesario para permitir el despliegue de los dgitos a la derecha del punto decimal.

Offset : Especifica el valor del desplazamiento de la caja, esta determinado en unidades
de dilogo.

Tip : Es recomendable que por cada dgito se especifiquen 4 unidades y 4 unidades adicionales
para el punto.


Extra

Range : Especificar el rango superior ( Upper )
e inferior ( Lower ) del valor permitido, as como
incremento o decremento especificado ( Step ).
Los valores deben de concordar con el campo
de Picture

Case : Permite especificar los atributos de
maysculas, letra capital o predeterminada (
Uppercase / CapitaIize / DefauIt ) que
automticamente sern convertidos los
caracteres al ser digitados en el control de $pin
Bo.

Entry Mode : Seleccione el modo de entrada de datos predeterminados , nsertar,
Sobreescribir o Predeterminado ( Insert / Overwrite o DefauIt )

Immediate : Especifica que un evento se genera cada vez que el usuario presiona una
tecla.

Required : Especifica que este control no puede dejarse en cero o blancos.

Read OnIy : Despliega nicamente la informacin, sin permitir la edicin de la misma.

DeIay : Especifica la cantidad de tiempo antes que se ejecute una nueva seleccin, es
decir el tiempo que tarda en cambiar al siguiente valor, cuando se mantiene presionado
el mouse sobre algn botn de seleccin del control SPIN.

Repeat : Especifica la cantidad de tiempo para que ocurra el siguiente evento cuando el
usuario presiona y sostiene un botn del control SPIN.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 121
www.gopac.com.mx
cursosgopac.com.mx


ScroII Bar : Establece la apariencia de los botones del control $pin, seleccionando
cualquier combinacin de las cajas de desplazamiento.

Seleccionando cualquier opcin Vertical genera botones de manera
vertical pero pequeos. Seleccionando las dos cajas o la opcin
Horizontal produce botones grandes alineados lado contra lado.

List Box ControI

En la caja de Controles, el control especificado con el Botn es el Control List Bo.
Los List Bo son tiles para presentar un gran nmero de opciones a seleccionar por el usuario.
Permiten presentar una gran cantidad de informacin en un rea relativamente mnima, lo cual
permite utilizarlo como un control de datos para todo propsito. Utilizando Clarion, permiten
crear List Bo, que pueden mostrarse tipo hoja de clculo, realizar /rag-an/-/rop, y mucho
mas.

Una vez que el List Bo es establecido en la ventana, este debe de drsele formato tal y como
se explico en la seccin de List Bo Formatter, pp de este manual.

Nota : Las propiedades de este control que son inherentes al curso bsico, han sido cubiertas en
la mayora de los controles previamente vistos.

3.2. Ejercicio : Agregando un Botn FieId Lookup a Ia Forma de ArtcuIos

1. Seleccione del rbol de procedimientos el
ArticullosFicha(Form)


2. En la ventana de propiedades presione el botn de
Win/ows para iniciar el Win/ows Formatter del
proceso.




3. Seleccione el ntry del campo C/igo , el cual es
el cdigo de la familia a la que pertenece el artculo.



4. Presione click derecho sobre este campo, seleccione
!roperties.

5. En la casilla de opciones Hi/e, actvela y presione el
botn de




_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 122
www.gopac.com.mx
cursosgopac.com.mx


6. Seleccione el !rompt que tiene como etiqueta C/igo y en la ventana de !ropie/a/es
cambie el texto por FamiIia

7. Seleccione el ntry del campo C/igo y posicionelo cerca de la etiqueta de FamiIia

8. Presione el botn de ControI TempIate


9. Seleccione el ControI TempIate /
Fiel/LookupButton y posicione el botn de
bsqueda dentro de la ventana en la posicin
del !rompt de Familia.





10. Presione sobre el Fiel/LookupButton que acaba de insertar, el botn derecho del mouse y
seleccione sus Actions y seleccione el control
que tiene la bsqueda. En esta caso
?AR%:Familia, el cual fue el control que se
oculto.

11. Seleccione el control AR%:Familia, y presione
el botn derecho del mouse, seleccione sus
Actions.

12. En la seccin de When the Control is Accepte/ (
Cuando el control sea Aceptado ) seleccione las
siguientes opciones que se muestran en la
ilustracin.

Lookup ey : Seleccione la Llave !rimaria /e
Familia FAM:PKCodigo

Lookup Fiel/ : Campo a buscar seleccin el campo de la llave FAM:Codigo

Lookup !roce/ure : Procedimiento a ejecutarse, seleccione FamiIia:EIegir

Active la casillas de !erform Lookup /uring Non-$top $elect y Force Win/ow Refresh
when Accepte/

Agrege un control String en seguida del botn de Fiel/LookupButton, presione el
botn derecho del mouse y
seleccione sus !roperties . En el
Use presione el botn de elipsis y
seleccione de la tabla familia el
campo FAM:Descripcion




_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 123
www.gopac.com.mx
cursosgopac.com.mx


Quedando de la siguiente manera su ventana :


3.2.2 Ejercicio : Agregando FuncionaIidad aI ControI Spin Box deI Campo Existencia.

Los campos de Existencia e VA estn determinados desde el diccionario como campos $!IN
B, por lo cual al momento de generarse la aplicacin por medio de los Wizar/s estos son
adicionados estos ntry's como $!IN B de manera automtica.

1. Seleccione el $pin Bo del campo
istencia y presione el botn derecho del
mouse y seleccione !roperties Tab de
tra.

2. En los rangos, digite el valor superior ( Upper
) y el valor inferior ( Lower ), as como el
valor incremental ( $tep ) que quiere que este
$pin Bo tenga.

3. Presione el botn de

Realice estos pasos para modificar el $!IN B del campo de IVA.


3.2.3 Ejercicio : Agregando FuncionaIidad aI List Box deI Campo Unidad

El campo Unidad esta determinado desde el diccionario como campo LIST BOX, por lo cual al
momento de generarse la aplicacin por medio de los Wizar/s este es adicionado este Entry's
como LIST BOX de manera automtica, as como los valores a seleccionar como los valores a
grabar en el campo.

3.2.4 Ejercicio Agregando una Imagen

1. Para agregar una imagen que sea representativa del artculo, seleccione el campo
Fotografia y reduzca su tamao.

2. Borre la etiqueta del campo Fotografa

3. Agrege un botn de DOS FiIe Lookup, presionando el botn de ControI TempIate

4. Seleccione el ControI TempIate de
D$FileLookup y posicione el botn de
bsqueda dentro de la ventana donde se
encontraba la etiqueta del campo Fotografia.



_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 124
www.gopac.com.mx
cursosgopac.com.mx


5. Presione el botn derecho del mouse sobre el botn que acaba de agregar .

6. En el %ab de eneral en el campo %et borre su
contenido y seleccione el %ab de tra para
cambiar la imagen del botn por la
siguiente imagen C:\Curso
Basico\Imgenes\Camera.gif


7. Seleccione el Tab de Actions, y en el Tab GeneraI realice
los siguientes cambios :

FiIe DiaIog Header : Escriba el Ttulo de la Ventana

DOS FiIename VariabIe : Seleccione la variable

ART:Fotografia la cual contendr la ruta de acceso
de la imagen correspondiente al
artculo.

DefauIt FiIename : Seleccione el directorio predeterminado a buscar imgenes a
C:\CIarion6\Images

Active las casillas de Return to originaI directory when done y Long FiIenames ?

8. Seleccione el Tab FiIe Masks y realice los siguientes cambios :

FiIe Mask Description : Escriba el Ttulo de la
descripcin de la mascara
: Archivos /e Imagen

FiIe Mask : *.bmp;*.jpg;*.gif

Presione el botn de mas asignaciones de mscaras
de archivo More File Masks y agregu una mscara
adicional que sea de ttulo %o/os los archivos, y
con mscara *.*

9. Seleccione el Tab Window Update Options y active la casilla de Update entire Window ?,
para actualizar toda la ventana.

10. Seleccione de la caja de ControIes el Image ControI y agregu este control en
la ventana, realizando un cuadro grande donde quiera insertar la imagen correspondiente al
artculo. Quedando la ventana de la siguiente
manera :










_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 125
www.gopac.com.mx
cursosgopac.com.mx

Puntos de Cdigo ( Embeds )

Los %emplates de Clarion permiten adicionar cdigo personalizado en muchos puntos
predefinidos dentro del cdigo estndar que los templates generan. Es una manera eficiente de
lograr el mximo cdigo flexible y reutilizable. Al punto en donde es insertado el cdigo es
llamado mbe/ !oint o !unto /e C/igo. Los !untos /e C/igo estn disponibles en todos
los eventos de las ventanas, controles de la ventana y para muchos otras posiciones lgicas. Los
puntos de cdigo estn determinados por los templates.

El cdigo fuente Incrusta/o en un procedimiento permite personalizar al mximo un
procedimiento. El enera/or /e Aplicaciones guarda este cdigo fuente dentro del archivo
.app y lo integra dentro del cdigo generado por el %emplate cada vez que se genere cdigo
fuente.

En orden de adicionar efectivamente cdigo Incrusta/o, se debe de comprender el medio que
rodea a la generacin de cdigo por medio de los %emplates de Clarion. Le recomendamos que
lea los siguientes manuales Learning Clarion y Application Han/book para obtener mas
informacin del cdigo generado por los ABC %emplates /e Clarion.

Existen varias maneras de adicionar cdigo fuente por medio de mbe/s, para lo cual
Clarion provee varios mtodos poderosos :

El mbe/itor permite visualizar el cdigo adicionado en el contexto de todo el cdigo
generado por los %emplates, permitiendo tener acceso total al /itor /e %eto, incluyendo
bsqueda de texto, reemplazo, copiar y pegar, lista de campos ( !opulate Fiel/s %oolbo ) y a
importar texto.

El mbe//e/ $ource /ialog permite visualizar los puntos de cdigo y su contenido, sin
el contexto de todo el cdigo generado por los %emplates, as mismo incluye el acceso total al
/itor /e %eto, adems de un localizador para encontrar los puntos, herramientas para copiar,
mover o cortar puntos de cdigo adems de poder generar puntos de cdigo con los Co/e
%emplates.

Los Botones /e mbe/s para un control de la ventana, accesa al mbe//e/ $ource
/ialog, focalizado nicamente a los eventos de ese control en particular.


3.2.5 Ejercicio Activando Automticamente eI Botn de FieIdLookup de FamiIia

1. Seleccione el botn de Fiel/Lookup de Familia y presione el botn
derecho del mouse eligiendo mbe/


_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 126
www.gopac.com.mx
cursosgopac.com.mx

2. En seguida se mostrar la ventana de los mbe/ disponibles para este control :





















El /it Menu permite manipular los !untos /e C/igo, permitiendo Cortar, Copiar, Pegar,
Insertar un punto de cdigo.

El View Menu y los botones de la barra de herramienta permiten personalizar los !untos /e
C/igo que se requieren ver.




Expand AII - Expandir todo el rbol de !untos /e C/igo de la lista.


Expand FiIIed - Expandir nicamente aquellos !untos /e C/igo que estn
llenos


Contract AII - Contrae todo el rbol de !untos /e C/igo de la lista .


Show FiIIed OnIy - Muestra nicamente todos los !untos /e C/igo llenos.


Show Priority LabeIs - Muestra las etiquetas de los !untos /e C/igo
generados por el %emplate, para que pueda incrustar precisamente el cdigo
deseado entre el cdigo generado por el %emplate.

IncIude Legacy Embeds - Muestra los !untos /e C/igo de Clarion 2.
Legacy.


Show Window Embeds - Disponible nicamente cuando se estn mostrando los
!untos /e C/igo desde un control, permite expandir
el rbol y mostrar todos los !untos /e C/igo de la
ventana.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 127
www.gopac.com.mx
cursosgopac.com.mx



El Navigate Menu y los botones de la barra de herramienta permiten personalizar los !untos /e
C/igo que se requieren ver

Previous FiIIed - De la posicin actual, permite pasar al !unto /e C/igo
previo que se encuentre lleno.

Next FiIIed - De la posicin actual, permite pasar al !unto /e C/igo siguiente
que se encuentre lleno.


3. Presione el botn de expandir todo el rbol de !untos /e C/igo para verificar que se
muestren todos.

4. Seleccione el !unto /e C/igo : Control vents / ?CallLookup / $electe/ y presione el
botn de IN$R% ( Se esta indicando que en los ventos /el Control ?CallLookup ,
cuando se $eleccione, se ejecute el cdigo que se va insertar )

Tip : Es altamente recomendable que la primera lnea que se escriba en el /itor /e C/igos
siempre sea un comentario ( ! ) breve de lo que se esta realizando generalmente de una
lnea. Una vez insertado este cdigo, en el rbol de !untos /e C/igo se muestra este y
la primera lnea que se puso en el /itor /e C/igo.

As mismo se recomienda que en cada !unto /e C/igo sea para una funcin especfica
y lo mas breve posible, en caso de ser necesario un !unto /e C/igo largo, se
recomienda partirlo y ponerlo en varios !untos /e C/igo continuos.

5. En el /itor digite el siguiente cdigo :

Activa automaticamente el LookUp de Familias, Siempre y cuando ART.Familia 0

IF ART:Familia 0
GlobalRequest SelectRecord Indica al programa que el llamado de la forma
sera tipo Seleccion de Registro
Familia:Elegir Llama al procedimiento Elegir Familia.
END

Tip : Cuando se desean incluir variables tanto de tablas como de memoria existe una ventana :

En la cual se pueden seleccionar las tablas, ndices, campos y
variables ya sean globales, locales o modulares de una manera
sumamente sencilla, rpida y evita el error.



6. Presione del Men del /itor la
opcin it! para regresar al
rbol de mbe/s
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 128
www.gopac.com.mx
cursosgopac.com.mx

7. En el Arbol /e mbe/ se mostrar el !unto /e
C/igo que se acaba de insertar, presione el
botn de CL$ para regresar a la ventana de
diseo.



3.2.6 Ejercicio: ActuaIizando Ia Imgen

La imagen que se agrego debe de ser actualizada cuando esta sufra algn cambio en algn
control. Estos cambios son cuando suceden alguno de estos ventos :

Al Abrir la ventana la magen se debe de Actualizar
Cuando el usuario agrega la ruta y nombre de la magen
Al Presionar el Botn de Bsqueda

AI Abrir Ia Ventana

1. Seleccione la Ventana y presione el botn derecho del mouse eligiendo la opcin de Embed




2. Presione el botn de contraer todo el
rbol









3. En el Locator de bsqueda penWin/ow. El cual se
encuentra en Win/ow vents / penWin/ow. ( Se
mostraran todos los eventos de la ventana en donde se
puede insertar un punto de cdigo, dependiendo del
evento que se requiera )

4. Presione el botn de INSERT, para insertar el siguiente
cdigo :

Actualiza la imagen al abrir la ventana

?ImagePROP:Text} ART:FotograIia

?Image es el nombre que CIarion asigno al control
de la imagen que se inserto en la ventana
de diseo, en sus Properties / Use viene
esta asignacin.


{PROP:Text} es la propiedad de texto el cual se asigna al control, en el caso de un control
tipo
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 129
www.gopac.com.mx
cursosgopac.com.mx

imagen, esta asignacin equivale a la ruta y nombre de un archivo de grficos.

ART:Fotografia : Es la variable de la tabla ArtcuIos que contiene la ruta de la imagen
relacionada
al artculo.

5. Presione del Men del /itor la opcin
it! para regresar al rbol de mbe/s

6. En el Arbol /e mbe/ se mostrara el
!unto /e C/igo que se acaba de
insertar, presione el botn de CL$
para regresar a la ventana de diseo.



AI Agregar Ruta y Nombre de Ia Imagen

1. Seleccione el control del AR%:Fotografia y presione el botn derecho del mouse eligiendo la
opcin de mbe/

2. Presione el botn de expandir todo el rbol de !untos /e C/igo para verificar que se
muestren todos.

3. Seleccione el !unto /e C/igo : Control vents / ?AR%:Fotografia / Accepte/ y presione
el botn de IN$R% . ( El cdigo se ejecutara inmediatamente despus de que el control
haya sido aceptado )

4. En el /itor digite el siguiente cdigo :

Actualiza la imagen cuando el usuario escribe el nombre del archivo en el entry

?ImagePROP:Text} ART:FotograIia

5. Presione del Men del /itor la opcin
it! para regresar al rbol de mbe/s



6. En el Arbol /e mbe/ se mostrara el
!unto /e C/igo que se acaba de
insertar, presione el botn de CL$
para regresar a la ventana de diseo.

AI Presionar eI Botn de Bsqueda y SeIeccionar una Imagen

1. Seleccione el control del ?LookupFile y presione el botn derecho del mouse eligiendo la
opcin de mbe/

2. Presione el botn de expandir todo el rbol de !untos /e C/igo para verificar que se
muestren todos.

3. Seleccione el !unto /e C/igo : Control vents / ?LookupFile / Accepte/ y presione el
botn de IN$R% . ( El cdigo se ejecutara inmediatamente despus de que el control haya
sido aceptado )
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 130
www.gopac.com.mx
cursosgopac.com.mx




4. En el /itor digite el siguiente cdigo :

Actualiza la imagen cuando el usuario escoge un archivo con el boton de busqueda de
archivos

?ImagePROP:Text} ART:FotograIia

5. Presione del Men del /itor la opcin it! para regresar al rbol de mbe/s

6. En el Arbol /e mbe/ se mostrara el !unto /e
C/igo que se acaba de insertar, presione el
botn de CL$ para regresar a la ventana de
diseo.




7. De la barra de herramientas presione el icono para grabar y salir a las
propiedades del procedimiento.

8. Presione el botn de OK

9. El rbol de procedimientos mostrara lo
siguiente :




10. Grabe su aplicacin . Compile y corra su aplicacin presionando el botn y
pruebe todos los cambios.





















_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 131
www.gopac.com.mx
cursosgopac.com.mx


.1 FORMAS Crear una Forma con Wizard

Este wizard nos lleva de la mano para crear una forma de campura que se asosica la
a un browse en la palicacin en la cual podemos Agregar, Editar y eliminar los
registros de un archivo, los pasos para el



1. Agregamos una Opcin nueva en el Men
Principal, de nombre FormaArticulosVCR y
le decimos que inicie un Thread.



2. En l, $eleccionamos el procedimiento nuevo y con Doble Clic, abrimos la
ventana para $eleccionar el Asistente o Template que &tilizaremos, para crear
nuestra forma, en este caso &tilizaremos
del Tab Wizards, el Form Wizard para crear
nuestra forma




3. Esta ventana nos indica el inicio de Form
Wizard asisten para crear la Forma.
Presionamos NEXT.







4. En esta ventana seleccionamos el Tema en el
cual se basar el asistente para crear la
forma, seleccionamos Default y presionamos
NEXT.








5. El asistente nos pregunta el Nombre de la
tabla de la cual aremos la Forma. Con el
Botn (...) seleccionamos la tabal Artculos
y presionamos NEXT.



_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 132
www.gopac.com.mx
cursosgopac.com.mx



6. En este Ventana, Podemos elegir las
acciones que estarn permitidas realizar
en la Forma, Agregar, Editar y Borrar un
registro. Validamos que estn marcadas
(CHEK) las 3 y presionamos NEXT.







7. En esta seccin podemos definir los
mensajes que queremos que el usuario vea,
tanto como para agregar, editar, eliminar, y
ver un registro y adems, Decirle donde
queremos que ese mensaje se muestre. En
la barra de ttulo de la ventana o en la barra
de $tatus. $eleccionar Title Bar y presionar
NEXT.



8. Esta ventana nos muestra las opciones
para personalizar nuestras formas, al
presionar el Botn de FORM
C&$TOMIZATION, nos da acceso a una
seccin donde podemos modificar y
personalizar el Formato de la Ventana
y los botones de la forma.






9. Dentro de la ventana de personalizacion de
la forma, existen 3 tabs, (Window,Tabs
Butons), en cada una de estas seciones, es
posible personalizar, la Ventana de la forma
modificando desde el Nombre del
procedimiento, la imagen del Fondo de la
forma, su Icono, Fonts, Colores, Posiciones,
y los Prompts.







_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 133
www.gopac.com.mx
cursosgopac.com.mx


10. En la seccin de TAB, se puede personalizar el nombre que Desplegar en tab
de la forma. Y utilizar los macros.









11. As mismo es posible personalizar cada uno de
los botones de la forma, como el de OK, el
Cancel, el Help y el botn de acceso a la tabla
relacionada que est incluida en la forma
(CHILD).




12. En esta ventana le especificamos, que mtodo
queremos utilizar para la funcionalidad de los
botones de (Agregar/editar/eliminar) registros,
tenemos los botones flotantes y la barra de
navegacion, $elecionamos ambos y le damos
NEXT.


13. En esta ventana, podemos indicarle si queremos
sobre-escribir el procedimiento y si es que ya
existe o deseamos crear uno adicional al existente.
Dejamos en blanco el cuadro de CHEK y
presionamos NEXT, pues es un procedimiento
nuevo.



14. Esta ventana nos pregunta si queremos Guardar
los cambios realizados a la Personalizacion y
ademas si queremos que Dicha personalizacion,
sea Guardada como un Tema aparte, para poder
&tilizarlo posteriormente. $i as lo deseamos, le
asigamos un nombre al Tema y un nombre al
archivo donde se Guardar el Tema para &tilizarlo
posteriormente.


15. Presionamos el Boton de Finish para que el asistente nos cree el procedimiento
con las configuraciones que le asignamos y ademas editar el menu para
Agregarlo llamarlo desde ah.


_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 134
www.gopac.com.mx
cursosgopac.com.mx



.14 Navegacin dentro de una Forma Estilo VCR



1. Seleccionamos la forma de Aticulos que acabamos de hacer.



2. Eentramos al formateador de ventanas. (Window
Formater)



3. Editor de Ventanas, y en nuesta ventana de
control templates , $elecionamos el
FORMVCRButtons.





4. Colocamos el VCR control Template
y lo agregamos en la forma.






5. En la propiedades del cotrol VCR
$elecionamos el TAB de acciones y
validamos en que Default Beheavor
tenga selecionado Inser Record.


NOTA: $e puede configurar para que
el comportamiento predeterminado
(Default Beheavor), sea tambien
Change Record o View Record.




6. Guardamos y compilamos y
probamos al llamar a la forma
directamente del menu principal
para agrear registros sin necesidad
de un Browse.



_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 135
www.gopac.com.mx
cursosgopac.com.mx

.16 Ejecicio agregar un Localizador en la Forma VCR

En este ejercicio agregaremos un localizador en la forma en la que utilizamos el
FORMVCRButtons, de tal forma que cuando pongamos un texto en el entry del
buscador nos lleve al registo que en su campo elegido como llave, contenga el valor
que contiene la variable que utlizaremso como buscador.




1. $eleccionar el procedimiento de la forma
en la aplicacin.



2. Es necesario que en el TABLE $chematic est definida la llave por la cual
haremos la bsqueda.

NOTA: Para este Ejercicio &tilizaremos
la ARTAKDescripcion.




Para agregar un Localizador en la FORMA,
agregaremos una variable local con nombre
C:BUSCADR, de tipo String de 200
(@S200)






4. Agregamos esa Variable con un Entry en la
Forma y asignamos un Prompt con la etiqueta
"B&$CADOR.
















_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 136
www.gopac.com.mx
cursosgopac.com.mx


5. En las Acciones del VCR control
template Presionamos el Botn
FORMVCR Button Prompts.









6. $eleccionamos el %AB Conditional
Behavior,y entramos a sus propiedades.








7. Agregamos en el Entry de Condition Choice(CurrentTab)=1 y en Key to &se
le Agregamos AR%:AKDescripcion.












8. Al presionar el Botn de Locator Behavior entramos a la configuracin de
comportamiento del localizador donde le decimos que el localizador es de tipo
ENTRY y que el control sobre el cual esta definido es la variable
?LOC:BUSCAOR.












_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 137
www.gopac.com.mx
cursosgopac.com.mx



. $alimos del Window Formater Guardamos la aplicacin y compilamos


0. Probamos el buscador Abriendo la forma VCR de articulos y en el entry del
buiscador coloamos un Txto EJ: LIP y le damos tab, en la forma se mostrara
el prier regiustro que en su descropccin tenga "CLIP















































_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 138
www.gopac.com.mx
cursosgopac.com.mx

.16 Ejecicio Cambio de color en los objetos

Asignar Colores a los Campos de una Forma cuando tiene el Focus.

1. En el GLOBAL de la Aplicacin, en el TAB
APP $ettings, Marcamos la Opcin
Provide Visual indicators on control with
focus, la marcamos, esto habilita el
botn en la parte inferior que dice $et
Visual Indicator.




2. Al presionar este botn Entramos a una
seccin de configuracin (General) en la
cual podemos personalizar los tipos de
controles a los que Aplicar la
configuracin de colores al momento de
tener el Focus.



3. Y en la parte Inferior $elected Control
Indicators, podemos Configurar el color
del control, (Control Color Indicator),
podemos personalizar tambien la caja de
despliegue (Box Indicator) en la que se
emarca el control al momento de tener
el Focus, as como el Indicador Visual
que marca el campo que tiene el Focus
(Visual Indicator) y para cada uno de los
3, podemos personalizar el control para
indicar que el campo es Requerido.


4. Depus de cambiar los
colores a nuestro gusto,
Compilamos y probamos, es
importante decir que todas
las Formas de la aplicacin
seran afectadas con este
cambio, ya que la
configuracion es global.








_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 139
www.gopac.com.mx
cursosgopac.com.mx

3.4 Ejercicio Agregando VariabIes de Ambiente

Las variables de ambiente contienen las caractersticas de internacionalizacin de la aplicacin,
independiente al soporte del Driver /e Archivo utilizado, generalmente soportado por el atributo
M. Recomendamos que consulte la informacin que se ofrece con el Driver en la seccin de
soporte internacional.


Las siguientes caractersticas se pueden personalizar por medio de las variables de Ambiente

CLASYSTEMCHARSET Especifica el valor de conjunto de caracteres del sistema.

CLACHARSET Determina el conjunto de caracteres usados por las
especificaciones en el archivo .ENV

CLACOLSEQ Especifica el conjunto de secuencias a utilizar en tiempo de
ejecucin. Este conjunto es utilizado para crear LIaves e
Indices.

CLAAMPM Especifica el texto utilizado para indicar AM o PM como parte
del campo tipo tiempo a desplegar.

CLAMONTH Especifica el texto a regresar por los procedimientos y el
formato cuando se incluye el nombre de mes completo.

CLAMON Especifica el texto a regresar por los procedimientos y el
formato cuando se incluye el nombre del mes abreviado.

CLADIGRAPH Permite a los caracteres Digraph a mostrarse correctamente

CLACASE Permite especificar letras maysculas y su correspondiente en
minsculas.


CLABUTTON Define el texto utilizado de los botones que se despliegan en la
ventana del procedimiento de MESSAGE

CLAMSG Permite en tiempo de ejecucin cambiar los mensajes de error
con mensajes traducidos.

CLALFN Habilita / Deshabilita el uso de nombres largos en el programa

Tip : Recomendamos ampliamente consultar la ayuda en lnea de Clarion 6.0 acerca de
nvironment Files donde encontrara mayor informacin sobre el uso y manejo de las
variables de ambiente.

3.8. Ejercicio : Agregando VariabIes de Ambiente de Botones y Nombres Largos y Cortos
deI Mes.

1. Seleccione del rbol de procedimientos el procedimiento Main(Frame), presione el botn
derecho del mouse y seleccione embe/s

2. En el Locator penWin/ow. El cual se encuentra en
Win/ow vents / penWin/ow. ( Se mostraran
todos los eventos de la ventana en donde se puede
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 140
www.gopac.com.mx
cursosgopac.com.mx

insertar un punto de cdigo, dependiendo del evento que se requiera )

3. Presione el botn de IN$R%, para insertar el siguiente cdigo :

ambia variables de ambiente

LOALE('LABUTTON','OK,&Si,&No,&Abortar,&Ignorar,&Reintentar,ancelar,&Ayuda')
Textos de los botones usados en los Messages
LOALE('LAMON','Ene,Feb,Mar,Abr,May,Jun,Jul,Ago,Sep,Oct,Nov,Dic')
Meses abreviados en los campos Iecha
LOALE('LAMONTH','Enero,Febrero,Marzo,Abril,Mayo,Junio,Julio,Agosto,Septiembre,Octub
re,Noviembre,Diciembre')
Meses nombre largos en los campos Iecha


4. Presione del Men del /itor la opcin it! para regresar al rbol de mbe/s


5. En el Arbol /e mbe/ se mostrara el
!unto /e C/igo que se acaba de
insertar, presione el botn de CL$
para regresar a la ventana de diseo.


3.9 Ejercicio Agregando Fecha y Hora a
Ia Barra de Status

En el ejercicio 3.2.1 !ropie/a/es /e la
Ventana !aso # 9 pp 61 se usa una barra
de status dividida en 4 partes. En este ejercicio se mostrar la fecha y hora en 2 de las secciones
de la barra de status, agregando un tension %emplate que nos facilitar agregar esta
funcionalidad a nuestra aplicacin de una manera rpida y sencilla.

Un tension %emplate genera cdigo fuente ejecutable dentro de uno o mas !untos /e
C/igo para aadir una funcionalidad especifica a un procedimiento que no esta "amarrado" a
ningn Control de la Ventana.

1. Seleccione del rbol de procedimientos el procedimiento
Main(Frame), presione el botn derecho del mouse y
seleccione Extensions



2. Se mostrar la ventana de tension an/ Control
%emplate, presione el botn de INSERT





3. Seleccione del rbol de tension, el
tension %emplate - Date%imeDisplay y
presione el botn de SeIect, para seleccionar
este %emplate


_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 141
www.gopac.com.mx
cursosgopac.com.mx





4. En la ventana de tension an/ Control %emplate, se
agregar el %emplate - Date%imeDisplay y sus
opciones . Active la casilla Display Current Day / Date
in Win/ow.

5. Seleccione el formato de fecha que desee de la lista.

6. Active la casilla $how the /ay of the week before the
/ate.

7. En el campo Location of Date Display seleccione
$tatus Bar

8. Digite el nmero 3 en $tatus Bar $ection para indicar
que la fecha se mostrara en la seccin 3 del $tatus Bar


Realice estos pasos para activar la Hora, nicamente seleccionando la seccin 4 en el $tatus
Bar $ection. Termine presionando el botn OK

Grabe su aplicacin . Compile y corra su aplicacin presionando el botn
y pruebe todos los cambios.

3.0 Agregando FuncionaIidad aI Browse de Facturas

Agregar Columna de Nombre de Cliente
Eliminar columnas de Cdigo de Cliente, Subtotal e VA
Agregar Campo de Total de Facturas
Agregar Campo Hot Field de RFC del Cliente
Agregar Rango en Tab de Clientes

3.0. Ejercicio Agregando CoIumna de Nombre de CIiente y EIiminar CoIumna Cdigo
CIiente, SubtotaI e IVA.


1. Seleccione del rbol de procedimientos el proceso
de Factura(Browse) - %abla /e Factura, presione
el botn derecho del mouse y seleccione la opcin
Win/ow, para acceder al Win/ows Formatter del
procedimiento.



2. Presione el botn derecho del
mouse en el Win/ows Formatter
sobre el Browse /e Facturas y
seleccione ListBo Format para
acceder el formato de la lista del
Browse.


_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 142
www.gopac.com.mx
cursosgopac.com.mx

3. El campo FAC:Cliente indica que el campo a desplegar es el Nmero /el Cliente de la
factura. Se requiere el Nombre /el Ven/e/or , por lo tanto posicionese en el campo
FAC:Cliente y presione el botn de agregar columna



4. Seleccione del lado izquierdo de la ventana ( %able
$chematic ) la tabla de Clientes de ther %ables

5. Seleccione del lado derecho ( Columns ) el campo de
CLI:Nombre , y presione el botn de $elect, para
adicionar este campo a la lista.

6. En el ListBo Format, seleccione el campo de FAC:Cliente y presione el botn
para borrarlo

7. Seleccione el campo CLI:Nombre, y en el campo de Hea/ing %et ponga el siguiente
encabezado : Nombre Cliente

8. Seleccione el campo FAC:$ubtotal y presione el botn para borrarlo. Repita
esta operacin para el campo FAC:IVA

9. Presione el botn de OK para salir del
ListBo Formatter. El Browse /e Facturas
quedar de la siguiente manera :





3.0.2 Ejercicio : Agregando un Rango de CIientes en eI Tab CIientes

Esta accin nos permitir mostrar exclusivamente las facturas de un cliente predeterminado o
seleccionado por medio del botn de seleccionar Clientes que esta ubicado en el Tab de
Clientes del Browse Facturas.

1. Seleccione el Browse /e Facturas y presione click derecho del mouse y seleccione la
opcin de AC%IN$.

2. Seleccione el %ab Con/itional Behavior, posicionese sobre la opcin
CHIC(?Current%ab)=3 - FAC:FCliente y presione el botn de !R!R%I$.

3. En el campo de Range Limit Fiel/ seleccione el
campo FAC:Cliente

4. Seleccione de la lista de Range Limit %ype la
opcin de File Relationship.

5. Asegrese que en el campo de Relate/ File este
la tabla Clientes, en caso contrario seleccinelo.

6. Presione el botn de Locator Behavior

7. Seleccione de la lista el tipo de localizador
Filtere/

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 143
www.gopac.com.mx
cursosgopac.com.mx

8. Presione el botn OK cuantas veces sea necesario para regresar al Win/owsFormatter

3.0.3 Ejercicio : Agregar Campo TotaIizado de Facturas.

1. Seleccione el Tab de Por Nmero y agregue 1 control String abajo del
Browse.

2. Seleccinelo y presione el botn derecho del mouse y elija !roperties, y en el %et digite
Ventas

3. Agregue un control Entry
enseguida del control de Ventas agregado
en el paso anterior

4. Seleccione del rbol de TabIe Schematic
LCAL DA%A Factura y presione el botn
de NEW para agregar una variable local con
las siguientes caractersticas :

Nombre : LOC:SaIdo
Tipo : ReaI
Picture : @N0.2


5. Seleccione el control anterior y presione el botn derecho del mouse, elija Properties y elija
las siguientes Propiedades :

Justification : Centrada
Offset : 2
Disable : Activada

6. Seleccione el Browse /e Facturas, presione el botn derecho del mouse y elija Actions
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 144
www.gopac.com.mx
cursosgopac.com.mx


7. Seleccione el Tab de %otaling y presione el botn de INSERT

8. En la ventana de Browse %otaling realice los siguientes
cambios :

Total Target Field : LOC:SaIdo
Total Type: Sum
Field To Total : Fac:TotaI
Total Base On : Each Record Read

Con lo cual se esta asignando una sumatoria de la columna Fac:%otal y el resultado se
asignar a la variable LC:$al/o.

9. Presione el botn cuantas veces sea necesario para
regresar al Win/owsFormatter, quedando de la siguiente
manera :


3.0.4 Ejercicio : Agregar Campo Hot FieId para Mostrar RFC de CIiente.


1. Agrege un control Fiel/ %et ( Campo de Texto ) , en la parte inferior de su
ventana.



2. Seleccione el tipo de Control %emplate a utilizar, en
este caso !opulate Control without control template.

3. Seleccione del %able $chematic la tabla de Clientes y
seleccione el campo Cli:RFC

4. Seleccionado el campo, presione el botn derecho del
mouse y elija !roperties , activando la casilla Disable. Quedando el diseo del Catlogo /e
Facturas de la siguiente manera


5. De la barra de herramientas presione el icono para grabar y salir a las
propiedades del procedimiento.

6. Grabe su aplicacin Compile y corra su aplicacin presionando el botn
y pruebe todos los cambios.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 145
www.gopac.com.mx
cursosgopac.com.mx

3. Creando eI Browse de DetaIIe de Facturas

Creando la Ventana del Browse de Detalle de Facturas
Agregar y Deshabilitar el Campo de Nmero de Factura
nicializar Fecha con la Fecha del Sistema
Agregar Control Spin para el Campo Fecha
Agregar Control Group Box para Datos de Cliente
Agregar Control Field Lookup Button Columna de Cliente
Agregar Grupo de Datos Generales de Cliente
Agregar Variables Locales de mporte, VA, Neto, Letras, Accin
Agregar Browse de Detalle
Agregar Frmulas de Neto e VA
Agregar Totales para mporte, VA, Neto
Agregar Libreras Gopac
Agregar Funcin de Nmeros a Letras
Deshabilitar Campos en Cambios de Facturas
Actualizar Datos de Cliente

3.. Creando Ventana de DetaIIe de Facturas

1. Seleccione del rbol de procedimientos el
procedimiento FormaFactura (Form), presione
el botn izquierdo del mouse dos veces y
seleccione el botn de Win/ow, para acceder al
Win/ows Formatter del procedimiento.

2. Seleccione todos los controles de la ventana y agrande un poco el tamao de la misma como
a continuacin se muestra :


_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 146
www.gopac.com.mx
cursosgopac.com.mx


3..2 Ejercicio Agregando y DeshabiIitando eI Campo de Nmero de Factura

1. Seleccione el control de
Dictionary Fiel/ para agregar el
campo de FAC:Numero de la tabla de
Facturas, posicionelo en la extrema
superior izquierda de su forma.

2. Seleccione el entry del campo
FAC:Numero

3. Presione el botn derecho del mouse sobre este campo, seleccione la opcin de !roperties

4. En la casilla de opciones active la opcin Disable y presione el
botn de

5. Grabe y salga del Win/ows Formatter a la ventana de
!ropie/a/es /el !roce/imiento.







3..3 Ejercicio IniciaIizando eI Campo Fecha con Ia Fecha deI Sistema.


FieId Priming on Insert permite indicar un valor predeterminado a uno o varios campos de un
registro. Este valor precede al valor inicial especificado en el
diccionario de datos.

1. Estando en la ventana de !roce/ure Factura:Ficha
!roperties presione el botn de Fiel/ !riming on Insert


2. Presione el botn de INSERT de la ventana de Fiel/
!riming on Insert,


3. En el Campo de Fiel/ to !rime presione
el botn de elipsis y seleccione del File
$chematic la tabla de Facturas el
campo FAC:Fecha.

4. En el campo de Initial Value indique el
valor inicial que contendr el campo
seleccionado, en este caso la funcin %o/ay()

5. Presione el botn dos veces para regresar a la ventana de propiedades del
procedimiento.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 147
www.gopac.com.mx
cursosgopac.com.mx

3..4 Ejercicio Agregar ControI Spin para eI Campo Fecha.

1. Seleccione el botn de Win/ow de la ventana de !roce/ure Factura:Ficha !roperties
para acceder al Win/ow Formatter


2. Seleccione el control de Dictionary Fiel/ para agregar el campo de
FAC:Fecha de la tabla de Facturas, posicionelo en la derecha del campo de
Nmero /e Factura en su forma.

3. Seleccione el entry del campo FAC:Fecha, presione el botn derecho del mouse y
seleccione la opcin de !roperties.

4. Seleccione el TAB de tra y active las dos casillas
del $croll Bar, horizontal y vertical. Recuerde que
desde el diccionario se defini este campo como un
campo $pin Bo

3..5 Ejercicio Agregar ControI Group Box para Ios Datos deI CIiente

1. Seleccione el control de roup Bo para agregar una marco a una regin de
la ventana donde se situaran todos los datos del cliente. Seleccione una
parte de la ventana y arrastre al tamao deseado.

2. Seleccionado el marco del rupo presione el click derecho del mouse sobre este campo y
seleccione la opcin de !roperties

3. En el TAB de eneral en el campo de %et tecle Cliente y presione el botn de OK para
regresar al Win/ows Formatter.

3..6 Ejercicio Agregar ControI FieId Lookup Button de CIiente

1. Seleccione el control de Dictionary Fiel/ para agregar el campo de
FAC:Cliente de la tabla de Facturas.

2. Seleccione el Prompt del campo FAC:CIiente y brrelo

3. Seleccione el entry del campo FAC:CIiente y presione el botn
derecho del mouse , seleccione la opcin de !roperties.

4. En la casilla de opciones active la opcin Hi/e

5. Seleccione el TAB de Actions.

6. En la seccin de When the Control is Accepte/ ( cuando el
control es aceptado ) incluya los siguientes datos :

Lookup Key : CLI:!Co/igo
Lookup FieId : CLICo/igo
Lookup Procedure : Clienteslegir

. Presione el botn de OK para regresar a la ventana del Win/ows Formatter


8. Presione el botn de ControI TempIate

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 148
www.gopac.com.mx
cursosgopac.com.mx

9. Seleccione el ControI TempIate / Fiel/LookupButton, como se muestra en el ejercicio de
la pp 88, y posicione el botn de bsqueda dentro de la ventana.

10. Sobre el botn que acaba de insertar presione el botn derecho del mouse y seleccione la
opcin de Actions

11. De la lista seleccione el control ?FAC:Cliente

12. Presione el botn de OK para regresar a la venta de Win/ows Formatter.


3..7 Ejercicio Agregar Datos deI CIiente

1. Seleccione el control de Dictionary Fiel/ para agregar los campos de
CLI:Nombre, CLI:RFC, CLI:Domicilio, CLI:%elefono de la tabIa de CIientes que esta
relacionada de la tabIa de Facturas.

2. De la misma manera que el paso anterior agregu el campo del Nombre /el Ven/e/or,
VN:Nombre, de la tabIa de Vendedores que esta relacionada con la tabla de clientes.


3. Agregue el campo FAC:Con/iciones.



Una vez realizados estos pasos se obtendr una ventana de diseo de esta manera :


Nota : Salga del Win/ows Formatter y grabe su aplicacin


3..8 Ejercicio Agregando VariabIes LocaIes de Importe, IVA, Neto, Letras, Accin

1. En la ventana de !roce/ure Factura:Ficha
!roperties presione con el botn de DA%A,
para acceder a la ventana de Creacin /e
Variables Locales






_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 149
www.gopac.com.mx
cursosgopac.com.mx


2. Presione con el botn INSERT para agregar las siguientes variables locales :

Nombre Derivado Tipo Long Texto

LOC:Importe FAC:SubtotaI Importe
LOC:IVA FAC:SubtotaI IVA
LOC:Neto FAC:SubtotaI Neto
LOC:Letras String 255
LOC:Accion Byte 3


Quedando como a continuacin se muestra :






3..9 Ejercicio Agregar eI Browse de DetaIIe

1. Seleccione el control de Control %emplate para agregar un Control /e
Browse en la ventana.

2. Seleccione de la lista de Controles el control de BrowseBo -
File Browsing List Bo y a continuacin seleccione la tabla de
Detalle en el File $chematic seleccionando el campo de
rengln como primer campo del List Bo Format.


3. El File $chematic debe de quedar de la siguiente manera :










4. El ListBoFormat debe de quedar de la siguiente manera :
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 150
www.gopac.com.mx
cursosgopac.com.mx


. Una vez agregado el Browse /e
Detalles, presione el botn de
ControI TempIate para agregar los botones
de Actualizacin /el Browse /e Detalle

6. Presione el botn derecho del mouse sobre
uno de los botones que agrego y seleccione la
opcin de Actions, en la opcin de Up/ate
!roce/ure seleccione el procedimiento de
actualizacin Detalle:Ficha.

7. Presione el botn OK para regresar al la ventana del Win/ows Formatter.

8. El Browse /e Detalle debe de visualizar hasta la columna de Importe las dems columnas
de LC:Importe, LC:IVA, LC:Neto son columnas ocultas para realizar los totales nada
mas.


3..0 Ejercicio Agregar FrmuIas para CaIcuIar LOC:IVA y LOC:Neto

El /itor /e Frmulas permite accesar a los campos definidos en el File $chematic, as como
a todas aquellas variables globales o locales, creando correctas expresiones sintcticas para su
posterior evaluacin

Existen diferentes Clases. Las Clases de la frmula permiten determinar cuando ser realizado
el clculo de la misma. Cada %emplate tienes su propio juego de Clases.

TempIate CIases

Procedure Setup -- Upon Entry into the Procedure

Este punto es evaluado inmediatamente despus de las sentencias puestas en CD,
permitiendo inicializar los valores que se requieran al entrar a un procedimiento.

Before Lookups -- Refresh Window ROUTINE, before Iookups

Este punto es evaluado antes de cualquier bsqueda a los registros relacionados, permitiendo
asignar un valor a los campos principales de la llave para realizar las bsquedas con estos
valores.

After Lookups -- Refresh Window ROUTINE, after Iookups

Este punto ocurre inmediatamente despus de haber realizado la bsqueda de los registros,
permitiendo asignar los valores encontrados en los clculos a realizar.

Procedure Exit -- Before Leaving the Procedure

Permite asignar los valores antes de regresar al procedimiento de donde fue llamado.

Prime FieIds -- Prime FieIds of the Primary FiIe record at beginning of Insert

Disponible nicamente cuando el %emplate del botn de Guardar ( SAVE ) es utilizado, permite
pre-asignar valores a los campos cuando se esta agregando un nuevo registro.
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 151
www.gopac.com.mx
cursosgopac.com.mx


Before FiIter Check -- In VaIidate Record ROUTINE, Before FiIter Code

Disponible cuando se utiliza el Control %emplate /e BrowseBo, permite crear una formula a
ser utilizada en la expresin del filtro.

Before Range Check -- In VaIidate Record ROUTINE, Before Range Limit Code

Tambien disponible cuando se utiliza el Control %emplate /e BrowseBo, permite asignar
valores antes de que los limites de rango fueron aplicados.

Format Browse -- Format a variabIe in the Browse Box

Tambien disponible cuando se utiliza el Control %emplate /e BrowseBo, permite calcular
valores a desplegar en una List Bo

Before Print DetaiI -- Before Printing Report DetaiI

Unicamente disponible cuando se utiliza los %emplates /e Reportes, permite calcular valores
antes de mandar el detalle al reporte.

El /itor /e Frmulas permite agregar frmulas complejas utilizando Funciones Definidas por
el usuario, operadores, funciones matemticas .

1. En la ventana de !roce/ure Factura:Ficha
!roperties presione con el botn de
FRMULA$, para acceder a la ventana del
/itor /e Frmulas.

2. Presione el botn de INSERT para agregar una
frmula nueva.

3. En la ventana del Formula /itor, usted definir
la frmula a utilizar, en este caso la frmula del
CIcuIo deI IVA :

Name : Digite el nombre de la frmula CIcuIo IVA

CIass : Seleccione de la lista el %emplate Class a utilizar
: Format Browse

Description : Breve descripcin de la Frmula


ResuIt : Seleccione la variable LC:IVA ,la cual contendr
el resultado de la frmula por cada registro en el
Browse.

Statement: Digite la expresin o frmula que desea que se
calcule :

Det:antidad * Det:Precio * Det:Iva / 00

Check : Prueba y valida la expresin digitada. Una "paloma" aparece si la expresin esta
correcta, en caso contrario aparece "X" . Presione este botn para comprobar su
frmula
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 152
www.gopac.com.mx
cursosgopac.com.mx


Information : Describe el componente seleccionado de la frmula .

Operators : Provee botones para agregar expresiones lgicas, matemticas o de evaluacin.

Data : Permite seleccionar del File $chematic variables o campos como valores operandos de
la frmula

Functions : Lista de funciones de Clarion.

User : Lista de las funciones creadas por el usuario en la aplicacin.

ConditionaIs : Permite crear frmulas con condiciones.

4. Una vez generada la frmula presione el botn de OK .

5. Presione el botn de INSERT para agregar la frmula del Calculo /el Importe Neto ,
realizando los pasos anteriores necesarios. Frmula : Det:antidad * Det:Precio

6. Una vez agregada las dos frmulas regrese a la ventana de !roce/ure Factura:Ficha
!roperties presione con el botn izquierdo del mouse el botn de Win/ow



3.. Ejercicio Agregar TotaIes para VariabIes Importe, IVA, Neto


1. Seleccione el Browse /e Detalles y presione el botn derecho del mouse y seleccione la
opcin de Actions

2. Seleccione el %AB /e %otaling y presione el botn de INSERT

3. TotaI Target FieId : Seleccione el campo de donde
se va almacenar el valor Totalizado ( FAC:Total,
FAC:I'A, FAC:Subtotal )

4. TotaI Type : seleccione de la lista SUM

5. FieId to TotaI : Seleccione el campo de donde se van a sumarizar los valores (
LOC:Importe, LOC:I'A, LOC:Neto )

6. TotaI Based ON: verifique que este seleccionado ach Recor/ Rea/

Realice estos pasos para las tres variables : mporte, VA y Neto.

7. Regrese al Win/ows Formatter y agregue los campos de FAC:%otal, FAC:IVA,
FAC:$ubtotal en la parte inferior del Browse /e Detalle, para que se desplieguen estos
datos cada vez que se navegue por el Browse /e Detalle.

8. Salga del Win/ows Formatter y grabe su aplicacin

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 153
www.gopac.com.mx
cursosgopac.com.mx

3.6.2 Ejercicio Agregar Libreras de Gopac

Las libreras /e opac, le permitirn agregar funciones como Nmeros - Letras, Calcula/ora,
etc. Estas libreras las puede usted bajar de nuestra pgina en Internet www.gopac.com.mx nada
mas debe seleccionar la versin de Clarion que esta usando ( 5b o 5.5 o 60 ), as como para el
tipo de compilacin de su aplicacin ( 16 o 32 bits ). Para mayor informacin sobre que funciones
contienen y como funcionan haga referencia al archivo de ayuda que vienen incluido en cada
librera.


1. Verifique que se encuentre en el rbol /e
!roce/imientos

2. Presione con el botn de LBAL y presione el
botn de MBD$

3. Ubique el punto de cdigo INSIDE THE GLOBAL
MAP , presione el botn de INSERT y digite la
siguientes lneas :

Agregando Prototipo de Librerias Gopac
Include(':\urso
Basico\Imagenes\GOPW6032.PRO')

4. Regrese al rbol /e !roce/imientos.


5. Seleccione del men principal la opcin de Application / Insert Mo/ule.

6. Seleccione del tipo de mdulo ternalDLL - ternal Dynamic Link
Library(DLL)

7. En la ventana de !ropie/a/es /e M/ulo en el campo Name digite
!W6032.LIB



NOTA : Es necesario que el tipo de compilacin ( 16 o 32 bits ) de la aplicacin
coincida con el de las libreras, as mismo la opcin de STANDALONE ( !roject /
!roperties / Run-%ime Library ) sea la opcin seleccionada para el correcto
funcionamiento de los resultados que arrogarn las funciones de Gopac.


3..3 Ejercicio Agregar Funcin de Nmeros a Letras

1. Seleccione el procedimiento de Factura:Ficha presione el botn de Win/ows para ingresar
nuevamente al Win/owsFormatter.

2. Presione el botn derecho del mouse sobre el Browse /e Detalle y elija la opcin de
mbe/s

3. Localice el punto de cdigo ResetFromView

Local bjects / ABC bjects / Browse on Detalle /
ResetFromView
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 154
www.gopac.com.mx
cursosgopac.com.mx


. Seleccionado el Co/e del mbe/, presione el botn de INSERT para agregar el siguiente
cdigo : LO:Letras Letras(Fac:Total,'P')
Display(?LO:Letras)

5. Grabe su mbe/ y regrese a la ventana del Win/ows Formatter y agregu la variable
LC:Letras

3..4 Ejercicio DeshabiIitar Campos en Cambios de Facturas

1. Regrese a la ventana de edicin de mbe/s y active todos los Embed de la Ventana
y verifique que el botn de mostrar solo llenos no este activado.

2. Localice el punto de cdigo de pen Win/ow e inserte el siguiente cdigo .:

IF SELF.OriginalRequest hangeRecord VeriIica que el llamado a esta ventana sea
por cambio en el registro de Facturas
Disable(?Fac:Numero:Prompt,?Fac:ondiciones) Desactiva los controles que estan desde el
Numero de Factura hasta el ampo de
ondiciones
Hide(?Insert:3,?Delete:3) Oculta los botones de Insertar y Borrar
dejando unicamente activado el boton de cambios
End

3. Grabe su mbe/ y regrese a la ventana del rbol /e mbe/s.

3..5 Ejercicio ActuaIizar Datos de CIiente

Una vez que la factura es agregada correctamente es necesario actualizar los datos del cliente,
como su $al/o / istencia as como preguntar si se imprime la factura en este momento.

1. Ubicado en el rbol /e mbe/s localice el punto de cdigo de n/ of !roce/ure , Before
Closing Files e inserte el siguiente cdigo .:

II SELF.OriginalRequest InsertRecord and SELF.Response Requestompleted
LI:Saldo Fac:Total Incrementa el Total de la Factura al Saldo del liente
Acccess:lientes.Update() Actualiza Saldo del liente
Det:Factura Fac:Numero
Det:Renglon Inicializa la llave primaria del Archivo de Detalles
Set(Det:PKFactura,Det:PKFactura) Posiciona el Archivo de Detalles en la Factura Actual
Loop Until Access:Detalle.next() Or Det:Factura~Fac:Numero iclo Loop para leer todos los

Detalles de la Iactura, leer el siguiente registro y calida si no es Iind e archivo.
ART:odigo Det:Articulo Inicializa la Llave Primaria del Archivo de
Articulos
Access:Articulos.Fetch(Art:Pkodigo) Se posiciona en al Articulo de cada detalle
ART:Existencia - Det:antidad Descuenta la cantidad del detalle a la existencia
del articulo
Access:Articulos.Update() Actualiza existencias
End
II Message('Imprimir la Factura?' ,'Imprimir?' ,ION:Question, Button:YesButton:No, Button:Yes)
Button:Yes Si la Iuncion Message, regresa el valor del boton Yes,
llama al procedimiento de imprimir la Iactura
ImprimirFactura Procedimiento de Impresion de Facturas
End
End
_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 155
www.gopac.com.mx
cursosgopac.com.mx


2. Grabe su mbe/ y regrese hasta el rbol /e !roce/imientos

3. Del men principal seleccione !roce/ure / New y agregue el procedimiento
ImprimirFactura al rbol /e !roce/imientos, quedando como un procedimiento %oDo()

4. Grabe su aplicacin . Compile y corra su aplicacin presionando el
botn y pruebe todos los cambios

Al finalizar esta serie de ejercicios deber de obtener una pantalla con las siguientes
caractersticas :



3.2 Modificando Ia Forma de DetaIIe de Facturas ( Prctica Participante )

Eliminar el campo de Nmero de Factura y Nmero de Rengln
Agregar el Lookup de Artculos
Asignar los valores de Precio e VA
Deshabilitar campos de Precio e VA
Validar Cantidad contra la Existencia
Agregar Funcionalidad de Campo Requerido al Campo de Cantidad

En base a los conocimientos adquiridos el participante deber de ser capaz de agregar la
siguiente funcionalidad a la Forma /e Detalle /e Facturas :

_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 156
www.gopac.com.mx
cursosgopac.com.mx


Eliminar de la ventana de captura los campos Nmero de Factura y Rengln.
Agregar el Campo Cdigo del Articulo oculto para permitir hacer la bsqueda.
Agregar un Botn de Lookup para permitir la bsqueda y seleccin de los Artculos a
Capturar
Asignar los valores de los campos de Precio e I'A del Artculo a los campos de Precio e I'A
de la tabla de detalle, por medio del botn de More Fiel/s Assignments que se encuentra
en las Actions del campo de Cdigo del Artculo.
Deshabilitar los campos de Precio e I'A
Agregar el siguiente mbe/ para validar la Existencia del Artculo contra la Cantidad
'endida :

Embed : ControI Events / ?DET:Cantidad / Accepted despus del Perform FieId
VaIidation

Cdigo a Agregar :

II Det:antidad ~ ART:Existencia
Message('La cantidad no puede ser mayor a la existencia,Se asignara el
valor existente ~ '&ART:Existencia,,'Fuera de
existencia',ION:Exclamation)
Det:antidad ART:Existencia
Display(?Det:antidad)
End
Agregar al campo de Cantidad la opcin de Requerido

Al finalizar deber de obtener una ventana de captura como se muestra a continuacin :


_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 157
www.gopac.com.mx
cursosgopac.com.mx

Notas : Prctica Forma de DetaIIe de Facturas





































_abc Clarion Generacin de
Aplicaciones



Gopc Soluciones ntegrales, S.A. de C.V. 158
www.gopac.com.mx
cursosgopac.com.mx

Referencias IntegraIes y CIipper


Dependiendo del Driver /e Base /e Datos que se estn utilizando para las TabIas, cierta
funcionalidad no se podr obtener, como es el caso de Referencias Integrales en las tablas que
son de Clipper, como es el caso de la tabla de !agos.

Toda tabla que no se le indique lo contrario, realiza la funcin de validacin de las Referencias
Integrales, por lo tanto se tiene que especificar en caso de que no se requiera esta funcionalidad
o el driver de la tabla no permita el manejo de esta.


3.3 Ejercicio DeshabiIitar Ias Transacciones de Referencias IntegraIes TabIa de Pagos


1. En el rbol /e !roce/imientos presione el botn de
GLOBAL y seleccione el TAB de In/ivi/ual File
verri/es seleccionando la tabla de !agos y
presionando el botn de !roperties.



2. En el campo de Use RI %ransaction Frame ,
seleccione de la lista la opcin NO y presione el botn
OK cuantas veces sea necesario para regresar al
rbol /e !roce/imientos
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 116
www.gopac.com.mx
cursosgopac.com.mx







































Procesos, TempIates y
Reportes





Objetivo

Agregar de forma automtica Procesos diversos,
una breve introduccin al uso de los Templates y
generar Reportes Sencillos.
CIarion para Windows
Introduccin






Procesos, Templates y
Reportes
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 117
www.gopac.com.mx
cursosgopac.com.mx

Procesos

El template de !roce/imiento /e !rocesos permite procesar secuencialmente una tabla de datos.
Se puede especificar un filtro o un rango para realizar el proceso. De manera automtica genera
una ventana con un indicador de avance del proceso , para indicarle al usuario el avance.

El proceso que se realizar para este ejercicio es del Cambio /e !recios de la %abla /e Artculos
por medio de un incremento en un !orcentaje. Se realizaran las siguientes acciones :


Agregar al Menu Principal la opcin de Procesos
Agregar al Men Procesos la opcin de Cambios de Precios
Agregar la variable local de Porcentaje
Agregar el Control Spin de Porcentaje
Agregar el Botn de Pausa
Agregar el Embed para Procesar Registros


4.. Ejercicio Agregar opciones de Men

1. En el rboI de Procedimientos seleccione el proceso de Main y edite su ventana para
modificar el men de la aplicacin, agregando una opcin de men principal que se llame
!rocesos

2. Agregue al men !rocesos la opcin de
Cambios /e !recios, y en las Acciones
seleccione de la lista Call a !roce/ure de
nombre Cambio!recios, iniciando una hebra
de ejecucin Initiate %hrea/

3. Regrese al rbol /e !roce/imientos y
verifique que este generado un proceso %o/o
de Cambio!recios.

4..2 Ejercicio Creando eI Procedimiento CambioPrecios.

1. Seleccione el procedimiento Cambio!recios ,
2.

3. Del rbol /e %ipos /e !roce/imiento del %AB /e
Defaults seleccione el procedimiento tipo !rocess

4. Presione el botn de %ables para agregar la tabla
principal sobre la cual se va a ejecutar el
procedimiento.

5. En el %able $chematic Definition agregue la tabla de Artculos ordenado por su llave
principal, y presione el botn de .

6. Presione el botn de Win/ow .

7. Estando en el Win/ows Formatter seleccione la ventana del proceso y hgala un poco mas
grande .

_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 118
www.gopac.com.mx
cursosgopac.com.mx

8. Note que la ventana de un !rocess contiene la barra de progreso y el botn de cancelar,
adems contiene dos controles ocultos que estn arriba del botn de cancelar y el otro arriba
de la barra de progreso seleccione los 4 controles y ubquelos en la parte inferior de la
ventana.

4..3 Ejercicio Agregando VariabIe LocaI de Porcentaje.

1. Seleccione el de la caja de Controles el control Diccionario seleccionando
del %able $chematic / Local Data y presione el botn de NEW

2. Agregue la variable local LC:!orcentaje de tipo Byte y con !rompt %et : !orcentaje.

3. Seleccione el Tab de Vali/ity Checks y seleccione la opcin de Must be in Numeric Ranges

Lowest = Highest = 00


4. Seleccione el Tab de Win/ow y verifique que el tipo de control sea SPIN caso contrario
seleccinelo.

5. Posicione la variable dentro de la ventana del proceso.


4..4 Ejercicio Agregando eI Botn de Pausa.

Toda ventana de proceso por naturaleza asume que al ejecutarse se iniciar el proceso. En caso
que el proceso no requiera tener ninguna validacin o parmetros del usuario as es como debe de
ser. En este caso como es requerido que el usuario asigne el valor del porcentaje a incrementar los
precios es necesario que este proceso inicie de manera pausada, por lo cual es necesario agregar
un Control %emplate que le indique al proceso que debe de iniciar pausado.

1. Presione el botn de Control %emplate de la caja de Controles .

2. Seleccione el Control %emplate / !auseButton y posicionelo en la ventana del proceso.

3. Sobre el botn que acaba de agregar presione el botn derecho del mouse y seleccione la
opcin de Actions

4. !ause %et : Texto a desplegar cuando el botn
este en !ausa. Ejercicio : !ausa

Restart %et : Texto a desplegar en el botn
cuando el botn esta pausado y la opcin de
permitir mltiples inicios esta activada. Ejercicio :
Continuar

$tart !ause/ : Opcin para determinar que el proceso inicie pausado ( activada la casilla ) o
este inicie su ejecucin hasta que el usuario presione el botn. Ejercicio Activar casilla, ya
que se requiere que el proceso inicie pausado, para permitir al usuario capturar el porcentaje.

$tart %et : Texto a desplegar en el botn cuando la ventana del procedimiento es abierta.
Este texto avisa al usuario que el proceso puede ser iniciado presionando este botn siempre y
cuando la casilla de $tart !ause/ este activada. Ejercicio : Iniciar.

Allow multiple starts : Activando esta casilla permitir iniciar mas de una vez este proceso.
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 119
www.gopac.com.mx
cursosgopac.com.mx


5. Presione el botn de OK y regrese a la ventana de !ropie/a/es /el !roceso.
4..5 Ejercicio Agregando Embed para Procesar Registros

1. En el rbol /e mbe/s seleccione el Embed : %ake Recor/ , que es el punto de cdigo que
se ejecutar despus que el procedimiento a ledo el registro de la tabla.

2. Agregue el siguiente cdigo

Actualiza el Precio del Articulo
ART:Precio ART:Precio * (00LO:Porcentaje) /00


3. Grabe el mbe/ y regrese a la ventana de !roce/ure Cambio!recios !roperties


4. Seleccione el botn de
Con lo cual acceder a las propiedades del proceso en donde se podr definir las acciones,
filtros, rangos, etc. Que se pueden utilizar en un procedimiento, el cual se describe mas a
detalle en el curso Interme/io /e Clarion.

5. Seleccione el TAB /e eneral para asignar
el mensaje de la ventana de proceso :
Cambian/o !recios

6. Action for !rocess, seleccione de la lista !ut
recor/, despus de que se procese el registro
se requiere grabarlo. La lista de Action for
!rocess permite que despus de procesar el
registro permite rabarlo ( !ut ), Borrarlo (
Delete ), No hacer na/a ( No recor/ action )

7. Presione el botn de OK. Grabe su aplicacin, compile y pruebe.
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 120
www.gopac.com.mx
cursosgopac.com.mx

TempIates

Los %emplates de Clarion son $cripts altamente configurables, interactivos, interpretativos y
generadores de cdigo de manera automtica. Un %emplate tpico realiza ciertas preguntas al
programador y genera un conjunto de cdigo basado en las respuestas que se le dieron. Adems
de las preguntas que realiza el %emplate algunos tambin aaden cdigo fuente en diferentes
puntos de cdigo de la aplicacin, puntos en los cuales se puede aadir cdigo fuente integrado al
cdigo generado por el %emplate. Se puede pensar como que las preguntas realizadas por el
%emplate, son una manera de definir ( en tiempo de compilacin ) , las caractersticas estticas del
procedimiento o programa, y el cdigo en los puntos de mbe/ como el camino a definir ( en
tiempo de ejecucin ) de las caractersticas variables de un programa o procedimiento.

TempIate Prompts

Un %emplate tpicamente pregunta por informacin en tiempo de diseo. El enera/or /e
Aplicaciones interpreta los %emplates y muestra un dialogo al programador para que este
configure y conteste las preguntas del %emplate de acuerdo a la funcionalidad que se requiera.

TempIate Embed Points

Adems de las preguntas que realizan los %emplates, tambien aade puntos de cdigo en la
aplicacin o procedimiento. Puntos a los que se le puede aadir cdigo personalizado el cual se
integra al cdigo generado por el %emplate. Se pueden utilizar estos puntos de cdigo para
cambiar la definicin ( en tiempo de ejecucin ) de las caractersticas de un programa o
procedimiento.

Beneficios de Ios TempIate

Los %emplates promueven el reuso del cdigo y centraliza el mantenimiento del mismo. Ellos
proveen mucho de los mismos beneficios de la programacin orientada a objetos, especialmente la
reutilizacin de cdigo. Adems los %emplates complementan y enriquecen el uso del cdigo
orientado a objetos , mediante el fcil uso del encapsulamiento de objetos complejos. Los ABC
%emplates y la Librera ABC es un ejemplo de la sinergia de la relacin entre %emplates y
bjetos.

FIexibiIidad de Ios TempIate

Los %emplates pueden ser modificados para que se adecuen a las especificaciones y estas
modificaciones almacenarlas en el %emplate Registry . As mismo existen una gran cantidad de
%emplates de %erceros, los cuales tambien se pueden modificar y adecuar y trabajar en conjunto
con los %emplates de Clarion aadiendo mayor funcionalidad, estos %emplates de %erceros
existen Freeware o Pagados. Adems se pueden escribir %emplates !ropios, este tema se ve
ampliamente en el curso Avanza/o /e Clarion. El Lenguaje de %emplate viene totalmente
documentado en manual de !rogrammer's ui/e.

A continuacin estos son los temas que se revisaran en esta seccin. :


Revisar el Template Registry
Registrando el Template de TinTools
Modificando un Template
Agregar un Calendario al campo de Fecha de la Factura
Agregar una calculadora en la Cantidad del Detalle de la Factura.
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 121
www.gopac.com.mx
cursosgopac.com.mx

4.2. Revisando eI TempIate Registry


1. Grabe su aplicacin y cirrela, quedando solamente en Clarion.

2. Seleccione del men principal la opcin de $etup / %emplate
Registry para accesar a la ventana principal del %emplate Registry.

Los %emplates son interactivos, procesan la informacin especificada al
momento del diseo de la aplicacin en conjunto con el ID. Clarion
evala los archivos de %emplates dos veces :

O Antes de crear la aplicacin, Clarion pre-procesa los archivos de %emplate y
almacena la informacin en el archivo Registry.%RF. El pre-procesamiento solo ocurre
cuando el enera/or /e Aplicaciones detecta que existe un nuevo %emplate o a
ocurrido un cambio.

O Al momento de la generacin de la aplicacin, el enera/or /e Aplicaciones evala
la informacin suministrada en el proceso de diseo, desde los datos del Diccionario
hasta los datos en la aplicacin, con esto procesa en conjunto a las clusulas del
lenguaje y los smbolos en el Registry.%RF para generar el cdigo fuente de la
aplicacin.

Cada %emplate puede contener multiple tipos de %emplates de procedimientos de los que se
pueden seleccionar para crear procedimientos en la aplicacin. Antes de poder utilizar un
%emplate este debe de estar registrado en el %emplate Registry.

El %emplate Registry provee botones de comandos para las opciones de mantenimiento de los
archivos que estn en el registro.

Los botones de Register , Unregister, nable, Disable no estn disponibles en modo de Multi-
Developer, para cambiar esta opcin, seleccione del men principal la opcin $etup / Application
ptions.

Register ( Registrar ) Llama al cuadro de dilogo de Abrir Archivo, con lo cual
permite seleccionar el archivo de %emplate que se quiere
registrar. ( Tipo de archivos %!L )

UnRegister ( Desregistrar ) Permite borrar la Clase del %emplate actualmente
seleccionada del Registry.%RF. ( No borra fsicamente el
archivo %!L del disco )

EnabIe ( Habilitar ) Permite habilitar la Clase de %emplate o !roce/imiento
actualmente seleccionado, el cual previamente haba sido
deshabilitado.

DisabIe ( Deshabilitar ) Permite deshabilitar la Clase de %emplate o !roce/imiento
actualmente seleccionado.

Edit Definition ( Editar Definicin ) Permite desplegar el cdigo del %emplate en el /itor /e
%etos /e Clarion. Con lo cual uno puede editar y cambiar
el cdigo. Si actualmente tiene seleccionado un modulo, la
edicin abre el archivo %!L en la primera lnea de la
definicin del M/ulo. Si es un procedimiento, este abre en
la primera lnea del procedimiento.
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 122
www.gopac.com.mx
cursosgopac.com.mx


4.2.2 Ejercicio Registrando Ios TempIates de TintooIs

Los %in %ools es un desarrollo freeware realizado por %inman Development , y pueden ser
accesados a travs de su pgina www.thetingroup.com . Es un conjunto de funciones,
procedimientos, vistas y %emplates, que han sido desarrollados para la comunidad de
desarolladores de Clarion ncluye dentro de este conjunto Preview para Reportes, Api ToolKit,
Calculadora, Calendario y muchos mas.

La mayora de los %emplates al momento de instalarse estos se auto registran en Clarion , en
caso de ser necesario registrar un %emplate estos son los sencillos pasos que se necesitan
realizar :

1. Presione el botn de Register

2. Seleccione del directorio de c55ee\3r/party\template el archivo de %intlabc.%!L que es el
conjunto de %emplates para la versin ABC.

3. Presione el botn de abrir y espere unos segundos para que se registre el %emplate :

















4.2.3 Ejercicio Modificar TempIate

1. Encontrndose en el rboI de Registro de
TempIate busque el template !auseButton al cual
se le cambiar el texto del botn.


2. Presione el botn de /it Definition para abrir el %emplate en modo de edicin.

3. Posicionese en la lnea de #!rompt('!ause
%et',@$20),!ause%et,DFAUL%('!ause') y
modifique el texto de Default del botn de pausa . Este
texto es el que despliega el botn al momento de
agregar este control a la ventanas de proceso. Haga lo
mismo con el botn de Restart %et.


En el curso de Clarion Avanza/o se profundiza totalmente en los temas de los templates, desde
generar un template personalizado nuevo hasta modificar la funcionalidad de los existentes.
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 123
www.gopac.com.mx
cursosgopac.com.mx

4.2.4 Ejercicio Agregar CaIendario aI Campo Fecha de Facturas


1. Del rbol /e !roce/imientos elija el procedimiento de FacturaFicha(Form) y edite su
ventana.

2. Presione el botn de Control %emplate de la
caja de Controles .

3. Seleccione de los %emplates /e %in%ools el
%inCalen/arLookup , lo que hace este template es agregar
un Lookup Button, que muestra un calendario en el cual se
puede elegir una fecha, la cual se contendr en una variable.

4. Agrege el botn enseguida de la fecha de la factura, y
presione el botn derecho del mouse y seleccione la opcin de Actions

5. En el campo de Control to Vali/ate seleccione de la lista el
campo ?Fac:Fecha , es el campo que guardara la fecha
seleccionada. As mismo seleccione de la lista de Calen/ar
$tyle el estilo que desee. En caso que desee que el
calendario se posicione con el valor del campo active la
casilla de !rime Lookup with Control. En caso que desee
un titulo en la ventana del calendario agregesela en
Calen/ar %itle.


4.2.5 Ejercicio Agregar CaIcuIadora aI Campo Cantidad en DetaIIe de Facturas


1. Del rbol /e !roce/imientos elija el procedimiento de DetalleFicha(Form) y edite su
ventana.

2. Presione el botn de Control %emplate de la caja de Controles .

3. Seleccione de los %emplates /e %in%ools el %inCalculatorLookup , lo que hace este
template es agregar un Lookup Button, que muestra una calculadora para realizar ciertos
clculos y el resultado del mismo asignrselo a una variable.

4. Agrege el botn enseguida del campo de cantidad, y presione el botn derecho del mouse y
seleccione la opcin de Actions

5. En el campo de Control to Vali/ate seleccione de la lista el campo ?Det:Canti/a/ , es el
campo que guardar el resultado de los clculos u operaciones realizadas en la calculadora.

6. Grabe su aplicacin y prubela.
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 124
www.gopac.com.mx
cursosgopac.com.mx

Reportes

Para generar un reporte en Clarion es necesario utilizar el Report Formatter, en el cual se pueden
visualizar los elementos de diseo del reporte como encabezado, detalle y pie de pagina, totales,
imgenes grficas, formas preimpresas etc. El Report Formatter automticamente genera el
cdigo fuente necesario de Clarion para definir estos elementos.

El Report Formatter tiene seis componente mayores que son de gran ayuda en el diseo del
reporte: $ample Report, Controls %oolbo, Fiel/ %oolbo, !roperty %oolBo, Align %oolBo y
el Report !review.
El Report Formatter representa las cuatro partes bsicas, de la estructura de datos de un
Reporte, mostrando el Encabezado, Detalle, Pie de Pgina y la Forma representado por sus cuatro
"bandas"
Proceso de DesarroIIo de un Reporte utiIizando Report Formatter

1. Especificar las %ablas y las Llaves que el reporte utilizara
2. Establecer el diseo general del Reporte : tamao de papel, orientacin,
mrgenes y posicin de las bandas.
3. Agregar las constantes necesarias como ttulos y logotipos en la Ban/a /e
ncabeza/o o en la Ban/a /e la Forma
4. Agregar variables como nmeros de pginas, encabezados de seccin en la
Ban/a /e ncabeza/o
5. Agrege los campos del Diccionario en la Ban/a /e Detalle
6. Si es necesario agregue rupo /e Corte ( roup Break ) con variables de
encabezado , subtotales, etc.
7. Prever el reporte
8. Repetir cualquiera de los pasos anteriores si es necesario

A continuacin estos son los temas que se revisaran en esta seccin. :

mpresin de Facturas
Configurar File Schematic
Propiedades del Reporte Vista General
Agregar Campos de Factura
Agregar Variable LOC:mporte
Agregar Frmula
Agregar Rango de mpresin

Reporte de Etiquetas
Configurar File Schematic
Propiedades del Reporte
Modificar Tamao del Detalle
Multirengln Automtico y Rezise

Reporte de Ventas por Vendedor
Configurar File Schematic
Propiedades del Reporte
Modificar Banda de Factura
Agregar Corte por Clientes
Agregar Total por Cliente
Agregar Corte por Vendedor
Agregar Gran Total
Agregar Control Templates Pgina / Fecha / Hora
Manejo de Viudas y Hurfanos por Cliente
Agregar el Pre-View Report de Tin-Tools
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 125
www.gopac.com.mx
cursosgopac.com.mx

Impresin de Facturas

4.3. Ejercicio Agregar Procedimiento ImprimirFactura / Configurar FiIe Schematic

1. Agregar un procedimiento nuevo que se llame ImprimirFactura ( Tal y como se llamo al
procedimiento en el Embed Before Closing Files del !roce/imiento Factura Ficha.

2. Seleccionar el procedimiento ImprimirFactura y seleccionar de tipo de procedimiento Defaults
/ Reporte.

3. Presione el botn de %ables para agregar las tablas que se van a utilizar en
el File $chematic quedando como se muestra en la imagen .


4.3.2 Ejercicio Propiedades deI Reporte

1. Presione el botn de Report para ingresar al Report Formatter

2. Seleccione del men principal del Report Formatter la opcin de /it /
Report !roperties

3. Tab GeneraI :

Job Name Nombre de la tarea de impresin del reporte, al ser listada
en el administrador de impresiones de Windows.
dentifquelo con el nombre Impresin Factura.

LabeI Nombre de la etiqueta de la estructura del Reporte

Prefix Nombre del prefijo de la estructura del Reporte

Units Seleccione la unidad de medicin del reporte. Una vez cambiado la unidad del
medicin del reporte, el %ab /e !osition se deshabilitar , es necesario salir
del cuadro de dialogo de las propiedades del reporte para que se grabe el
cambio y poder modificar las posiciones.

Freeze No permite que los cambios subsecuentes a los campos en el diccionario de
datos sean aplicados.
Tab Extra :

Preview Especifica el nombre del "UU que almacena el nombre(s) de los archivos (
*.WMF ) de los archivos metafile que son generados por el previsualizador .
Tab CoIor :

CoIor Seleccione un color tanto para el Color de Texto como para el fondo.

Tab Position

Permite indicar la posicin y el tamao del rea imprimible del detalle. Para indicar una
posicin precisa del punto de inicio del rea imprimible indique la esquina superior
izquierda del papel como la squina $uperior Izquier/a, esto establece el margen
izquierdo del reporte. El margen superior es generalmente determinado por la posicin del
encabezado ( !age Hea/er ). Estos valores pueden ser determinados o completados
visualmente, arrastrando secciones del reporte o mrgenes en el Report Formatter !age
Layaout View.
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 126
www.gopac.com.mx
cursosgopac.com.mx

Tab Paper Size

Paper Size 40 diferentes tamaos standard a seleccionar o asignar un tamao
personalizado

With El valor determina el ancho del papel.

Height El valor determina el largo del papel

Landscape Especifica la orientacin del papel.

4. Seleccione del men principal del Report Formatter / View / !age Layout View para
modificar exactamente el tamao de las diferentes secciones o bandas que el reporte tenga,
generalmente es necesario que la seccin de detalle modificar su tamao para que cumpla con
el tamao especificado y que las bandas de encabezado y pie de pgina, no interfieran con los
datos del detalle. Una vez terminado de acomodar las seccione del men principal del Report
Formatter / View / Ban/ View.


4.3.3 Ejercicio Agregando VariabIe LOC:Importe, CIcuIo deI Importe y Campos de TabIa
Factura en Reporte


1. Agregue una variable Local llamada LC:Importe derivada de la variable FAC:$ubtotal

2. Agregue la frmula que calcla el importe del detalle, D%:Canti/a/ * D%:!recio asignar
este resultado a LC:Importe, utilizando la clase Before !rinting Detail.

3. Seleccione de la Caja /e Controles el control de Campos /el
Diccionario

4. Agrege los siguientes campos en el encabezado !age Hea/er : CLI:Nombre, CLI:Domicilio,
CLI:Condiciones, CLI:RFC, CLI:Telefono, CLI:Fecha. En la banda de Detail : DET:Cantidad,
ART:Descripcion, ART:Precio, LOC:Importe, !age Footer : FAC:Subtotal, FAC:I'A, FAC:Total.

Quedando de la siguiente manera :



_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 127
www.gopac.com.mx
cursosgopac.com.mx

4.3.4 Ejercicio Agregando eI Rango de Impresin

1. Salga a la ventana de !roce/ure ImprimirFacturas
!roperties y presione el botn de Report !roperties

Tab GeneraI

Print Preview Activando esta casilla permite activar
el !review del reporte antes de su
impresin.

Quick-Scan Records Especifica el comportamiento
del acceso para tablas tipo
DBC, A$CII, D$ o BA$IC.
Estas tablas leen un buffer de
datos, no un registro,
permitiendo accesos a las tablas mucho ms rpidos. En un ambiente
multi-usuarios este buffer no es 100 % confiable para accesos
subsecuentes, ya que otro usuario puede realizar cambios a la tabla
entre los accesos. Como medida de seguridad el driver re-lee el buffer
antes de hacer un acceso a los registro. Para deshabilitar la re-lectura
active la casilla de "uickscan.

Record FiIter Escriba una expresin para limitar el contenido de la tabla a nicamente los
registros que coincidan con la expresin del filtro. Cuando un filtro es usado en
conjunto con limite de rangos ( Range Limit ) nicamente aquellos registro que
cumplan con el rango especifico son filtrados.

Approx. Record Count Especifique un nmero aproximado de registros que sern filtrados. El
indicador de la barra de progreso utiliza este valor para calcular el
porcentaje que a sido cubierto.

Set progress bar Iimits manuaIIy? Active esta casilla para asignar los valores mnimos y
mximos de la barra de progreso.

Tab Range Limits

Range Limit FieId En conjunto con el tipo de Range Limit,
se especifica el conjunto de registros a
incluir en el Report. El Range Limit Fiel/
debe de ser un componente de la llave de
acceso del reporte. El Range Limit es
dependiente de la llave.

Range Limit Type Especifica el tipo de limite de rangos a aplicar.

Current VaIue Aplica el valor actual de la variable asignada al Range Limit Fiel/

Range of VaIues Permite especificar limites superiores e inferiores.

FiIe ReIationship Permite seleccionar un rango por tabla en una relacin de 1:Muchos.
Esto permite desplegar en el reporte nicamente aquellos registros que
concuerden con el registro padre.
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 128
www.gopac.com.mx
cursosgopac.com.mx

Tab Preview Options

El Tab de !review ptions permite controlar la
apariencia inicial de la ventana del previsualizador del
Report. Este Tab esta disponible siempre que se active la
casilla de !rint !review en el Tab de eneral.

InitiaI Zoom Setting Asigna el valor inicial de tipo de vista
que se desee.

AIIow User VariabIe Zooms? Activando esta casilla se le permitir cambiar la vista del
reporte al usuario en tiempo de ejecucin.

Set InitiaI Window Position Activando esta casilla podr indicar los valores de la posicin
y tamao inicial de la ventana del !review.

Maximize Preview Window Activando esta ventana indicar que la ventana del !review
del reporte iniciara maximizada.

2. En el %ab eneral verifique las casillas de !rint !review y "uick $can estn activadas.

3. En el %ab Range Limits seleccione el campo de FAC:Numero en Range Limit Fiel/, e
indique el tipo de Rango sea Current Value con lo que le indicar que desea imprimir los
registros de la factura actualmente seleccionada en el proceso que se esta llamando (
FacturaFicha , embed Before Closing Files )

4. Grabe su aplicacin, compile y pruebe.


4.4. Reporte de Etiquetas


1. Agregue al men principal la opcin de Reportes y dentro de este el proceso de tiquetas
iniciando una hebra de ejecucin.

2. Del rbol /e !roce/imientos seleccione el proceso %oDo de tiquetas y seleccione el tipo
de proceso Report del %ab Default.

3. Presione el botn de %ables y agregue la tabla de Ven/e/ores con su llave ANombre.

4. Agregue las variables locales LC:Copias de tipo Byte e Initial
Value = 1 y de tipo $pin Bo y LC:Conta/or de tipo Real

5. En la ventana del proceso agregue el botn de !ausa y agregue el
ntry de nmero de Copias

6. Entre al Report Formatter y edite las propiedades del reporte.

7. En el %ab eneral asigne el nombre de la tarea ( job name ) como
Reporte /e tiquetas

8. Seleccione el %ab !aper $ize y seleccione el tipo de papel ther y asigne en Ancho 9,000
por Largo 8,000. Presione el botn de ( Recuerde que el tamao esta dado en milsimas
de pulgada y supongamos que el ancho del papel de las etiquetas es de 9 * 8 pulgadas )

_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 129
www.gopac.com.mx
cursosgopac.com.mx


9. Elimine la banda de !age Hea/er, !age Footer y !age Form.

10. En la banda de detalle elija el detalle y presione el botn derecho
del mouse y elija la opcin de !roperties, seleccione el %ab
!osition, seleccione en Ancho y Alto la opcin Fie/ asignando
los valores de 2,990 y 1,990 respectivamente. ( En este ejercicio
se supone que el tamao de las etiquetas es de 3 * 2 pulgadas y
son 3 al paso )

11. Seleccione de la Caja /e Controles el control de Campos /el Diccionario y
agregue los campos de VN:Nombre y LC:Conta/or

12. Seleccione de la Caja /e Controles el control de %et Fiel/ y agregue el campo
de VN:Direccion en una caja estrecha, seleccione con el botn derecho del mouse la opcin
de !roperties / tra / Resize y verifique que la casilla este desactivada.

Nota : Esta propiedad de Resize al estar activada permite que el campo sea haga del tamao
que se requiera, utilizando todo el espacio disponible necesario, cuando esta
desactivada lo que hace es que se adapta al tamao que se especifique utilizando los
renglones que sean necesarios, pero nicamente del tamao que se haya establecido.

13. Una vez realizado todo lo anterior debe de llegar al siguiente formato de reporte :

14. Salga del Report Formatter y seleccione el botn de mbe/s y ubique el siguiente punto de
cdigo :Local bjects / ABC bjects / !rocess Manager / %ake Recor/ , que es el punto de
cdigo donde se imprime el detalle y presione el botn de $ource.

15. Presione AL% F3 y busque la siguiente
expresin !rint(Report:/etail) y en el siguiente
rengln en blanco agregue : Imprime las
copias de Etiquetas Necesarias grabe y regrese
al rbol /e mbe/s

16. En el punto de cdigo que se acaba de agregar,
edite y agregue el siguiente cdigo

Imprime las copias de Etiquetas Necesarias
Loop x# to LO:opias -
Print(RPT:Detail)
End
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 130
www.gopac.com.mx
cursosgopac.com.mx



Nota : La tcnica que se utilizo en la bsqueda de este punto de cdigo, permite identificar el
punto exacto donde se encuentra determinada instruccin y donde debe de ubicarse el
punto de cdigo arriba o debajo de esta instruccin dependiendo lo que se requiera
realizar. As mismo se utiliza el nmero de copias por tiqueta - 1 ya que se deja que
Clarion con el cdigo que genera imprima una vez el detalle y por medio del embed se
imprime el restante nmero de tiquetas.

17. Grabe, compile y pruebe.

4.4.2 Reporte de Ventas por Vendedor

1. Agregue al men principal la opcin de Reportes y dentro de este el proceso de Ventas por
Ven/e/or iniciando una hebra de ejecucin.

2. Del rbol /e !roce/imientos seleccione el proceso %oDo de Ventas!orVen/e/or y
seleccione el tipo de proceso Report del %ab Default.

3. Presione el botn de %ables y agregue la tabla de Ven/e/ores con su llave ANombre
adems agregue la tabla de Clientes / Facturas dependiendo de la tabla de Ven/e/ores

4. Agregue la variable LC:Dummy de tipo Byte e Initial Value = 1

5. nicie el Report Formatter, seleccione del men principal la opcin de /it / Report
!roperties y agregue un Job Name VentasPorVendedor, y verifique en el %ab /e !aper
$ize que este seleccionado el tipo de papel tamao carta.

6. Agregue en el !age Hea/er lo siguiente :

Nota : El nmero de pgina es un control template :Report!ageNumber

7. Agregue en el Detail el siguiente detalle FAC:Numero, FAC:Fecha, FAC:%otal

8. Agregue en el !age Footer lo siguiente :

Nota : La fecha del reporte es un control template : ReportDate$tamp


9. Para agregar los totales por Cliente seleccione del men Ban/ / $urroun/ing
Break
_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 131
www.gopac.com.mx
cursosgopac.com.mx

10. Presione el botn del mouse sobre la banda de Detalle ,
apareciendo la ventana de propiedades del corte Break
!roperties.

Tab GeneraI

VariabIe : Seleccione la variable sobre la cual se va a realizar el corte . En este caso
seleccione FAC:Cliente.

LabeI : Escriba una etiqueta vlida de Clarion, con lo cual se va a identificar el corte :
PorCIiente

Los grupos de corte permiten agrupar la informacin en secciones en donde opcionalmente se
pueden subtotalizar ciertos campos. Cada grupo contiene un grupo de registros, todos
compartiendo el mismo valor del campo de corte. Dentro del reporte uno puede separar estos
registros y aadir subtotales o informacin sumarizada, generalmente debajo del grupo. Estos
grupos de corte tienen los mismos elementos de un reporte ncabeza/o, Detalle y !ie /e
!gina ( Hea/er, Detail, Footer )

Cuando el reporte es impreso, todos los registros son agrupados de acuerdo al valor del
Campo /e Corte, si la variable del corte es una variable global o local, se debe de asegurar
que se actualiza el valor, para que se generen los Cortes.

11. Agregue el ncabeza/o y !ie /e !gina para el Corte por Cliente, seleccione del men
Ban/ / roup Hea/er y presione el botn izquierdo del mouse sobre el Corte por Cliente,
realice la misma operacin para agregar el roup Footer. Modifique el ancho de las bandas
agregadas.

12. En el roup Hea/er agregue el campo CLI:Nombre.

13. Para agregar el total por cliente realice los siguientes pasos :

a. Seleccione de la Ban/a /e Detalle el campo de
FAC:Importe
b. Mueva el puntero del mouse a la banda de roup
Hea/er
c. Presione la tecla de funcin F2
d. En el campo agregado selecciones sus
propiedades
e. En sus propiedades seleccione de la lista de %otal
%ype la opcin de $um
f. De la lista Reset n seleccione la opcin de
!orCliente


14. Agregue un $urroun/ing Break sobre Break de Clientes para agregar el Corte por
Ven/e/or ( el Surrounding break anterior fue para agregar el corte por Cliente Factura, este
es para agregar el corte 'endedor Cliente )


15. En la ventana de Break !roperties / Variable seleccione la
variable por la que se va a realizar este corte :CLI:Ven/e/or y en
Label : !orVen/e/or


_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 132
www.gopac.com.mx
cursosgopac.com.mx


16. Agregue las bandas de roup Hea/er y roup Footer para el corte !or Ven/e/or.

17. En el roup Hea/er !or Ven/e/or agregue campo VN:Nombre.

18. Para agregar el total por vendedor realice los siguientes pasos :

a. Seleccione de la Ban/a /e Detalle el campo de
FAC:Importe
b. Mueva el puntero del mouse a la banda de roup
Hea/er por Ven/e/or
c. Presione la tecla de funcin F2
d. En el campo agregado seleccione sus propiedades
e. En sus propiedades seleccione de la lista de %otal
%ype la opcin de $um
f. De la lista Reset n seleccione la opcin de !or
En el roup Hea/er agregue el campo
VN:Nombre.

19. Agregue un $urroun/ing Break sobre Break de Ven/e/ores para agregar el %otal eneral

20. En la ventana de Break !roperties / Variable seleccione la variable por la que se va a
realizar este corte :LC:Dummy y en Label : %otaleneral ( Se utiliza esta variable, ya que
nunca cambia su valor durante todo el proceso de impresin del reporte )

21. Agregue las bandas de roup Footer para el corte %otaleneral.

22. Para agregar el total General realice los siguientes pasos :

a. Seleccione de la Ban/a /e Detalle el campo de FAC:Importe
b. Mueva el puntero del mouse a la banda de roup Hea/er %otaleneral
c. Presione la tecla de funcin F2
d. En el campo agregado selecciones sus propiedades
e. En sus propiedades seleccione de la lista de %otal %ype la opcin de $um

Una vez realizado todos los pasos anteriores debe de llegar a tener este formato de reporte :

_abc Clarion Procesos, Templates y Reportes

Gopc Soluciones ntegrales, S.A. de C.V. 133
www.gopac.com.mx
cursosgopac.com.mx

3 Ejercicio Manejo de Lneas Viudas y Hurfanas por CIiente

1. Presione el click derecho del mouse en roup Hea/er[Fac:Cliente] y
seleccione !roperties

With Prior : ndica que el encabezado o pie de pgina se imprime con
N lneas antes que el. ( eneralmente los pie de pgina
llevan esta opcin )

With Next : ndica que el encabezado o pie de pgina se imprime con
N lneas antes que el. ( eneralmente los encabezados
llevan esta opcin )


2. Seleccione With Net y digite la cantidad de lneas que desee que tenga como mnimo en la
hoja despus de que se vaya a imprimir el Nombre /el Cliente .

3. Presione el botn de OK y regrese al Report Formatter

4. Presione el click derecho del mouse en roup Footer[Fac:Cliente] y seleccione !roperties

5. Seleccione With !rior y digite la cantidad de lneas que desee que tenga como mnimo en la
hoja antes de que se imprima el %otal /el Cliente


4.4.4 Ejercicio Agregando Ia Extension Report Viewer de TintooIs

1. Estando en la ventana de !roce/ure VentasporVen/e/or
!roperties, seleccione el botn de tensions / Insert
seleccionando el %%ReportViewer, el cual nos va a permitir
tener un !revisualiza/or /e Reportes con mucho mayor
funcionalidad del que tiene Clarion.

2. En la parte de Report View ptions agregue el nombre del


reporte que requiera, adems de poner el zoom al 100 % y
activar la casilla /e maimizar la ventana /el
previsualiza/or.

3. Presione el botn de
















Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 116
www.gopac.com.mx
cursosgopac.com.mx



4.5 Ejercicio crear un Reporte con el Asistente de Reportes (Repor Wizard).


1. Para iniciar la creacin del reporte le damos Doble click al
procedimiento VentasxFecha, para hacer el reporte
agregamos una Opcin en el men principal, la cual
llamar al procedimiento VentasxFecha.





2. Seleccionamos la opcin de Report Wizard- Crear un nuevo reporte y nos muestra el aviso que
nos muestra la figura, para continuar presionamos el botn NEXT.









3. La $iguiente ventana el asistente nos pregunta por el
Tema del reporte y tambin por su estructura o
(layout) para crear reportes


Theme: Al seleccionar un Tema
del la lista, ests cargando un conjunto de caractersticas para el
reporte, tales como, color de los controles, fonts, iconos, fondos
(backgrounds), posiciones.

Layout: Esta es la estructura o tipo, orden que tendr el reporte en la
aplicacin.


4. De qu archivo quieres el Reporte?, en esta pantalla seleccionars el archivo principal a
incluir en tu reporte.

NOTA: Presionando el Botn ()
podrs seleccionar el archivo de una
lista, esta lista esta conformada por los
archivos definidos en el diccionario.








Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 117
www.gopac.com.mx
cursosgopac.com.mx




5. En esta pantalla seleccionars la $ecuencial en base a
las llaves por las cuales quieres que tu reporte salga
ordenado y podrs, adems, seleccionar uno de los
mtodos de generacin del reporte de las 3 opciones
$iguientes


O Llave Sencilla (Single Key):
$eleccione esta opcin para obligar al
asistente a que genere un reporte, por la llave seleccionada
previamente. $i seleccionas esta opcin el asistente pedir que
selecciones la llave del archivo por la cual quieres que se ordene el
reporte.

O Tiempo de Ejecucin (Runtime Key Selection):
$eleccione esta opcin para obligar al asistente a que genere un
reporte sencillo, que preguntar por el orden de acomodo por el cual
quiere que se imprima su reporte, es decir, preguntar antes de
imprimir el reporte (en tiempo de Ejecucin) que llave quiere que sea
la que ordene su reporte.

O Orden de los Registros (Record Order)
$eleccione esta opcin para obligar al asistente a generar un reporte
sencillo ordenado por registros fsicamente como estn en la tabla
guardados.



6. En esta ventana le indicamos al asistente de
reportes cuantas columnas queremos que tenga
nuestro reporte. El asistente de reportes distribuye
a lo ancho el nmero de columnas que le fueron
indicadas.

7. $eleccionar los campos que necesitas mostrar en el
reporte Con esta opcin puedes aadir o eliminar
los campos del archivo en el cual se basara el
reporte, para crear a tu gusto los datos que quieres
mostrar. Adems de seleccionar los campos que quieres en tu reporte puedes modificar
las propiedades como lo son el ttulo del campo (etiqueta), el picture, y la justificacin,
puedes usar las flechas para especificar en que orden quieres que los campos se vean en
tu reporte.









Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 118
www.gopac.com.mx
cursosgopac.com.mx

8. Personalizacin: Los asistentes cuentan con diferentes configuraciones y acciones
para modificar la apariencia de los Reportes, Formas, Procesos, esas diferentes
configuraciones se llaman %AS, los cuales puedes ser modificados y guardados
para usarse en otras aplicaciones. Los temas se crean y se controlan, por una
variedad de opciones de personalizacin en las cuales resaltan








O Procedure (Procedimiento)
o Procedure Name
o Procedure "With Key"









O Progress Window (Ventana de Progreso)
o Caption
o Background
o Mode
o Icon
o Font
o Width
o Height
o Position


O Report Layout (Cuerpo del Reporte)
o General
o Header
o Detail
o Footer
o Form












Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 119
www.gopac.com.mx
cursosgopac.com.mx


O Additions (Adiciones)

o Page Number Control (Control
de Numero de Pagina)
o Date and Time Control (Control
de Fecha y hora)















9. Sobre escribir procedimientos existentes:
El Prender este Check Box es para sobre escribir
procedimientos (reportes) existentes, que tengan un mismo
nombre, si el Check Box est apagado (no seleccionado) no
sobreescribir los procedimientos con el mismo nombre.




10. En esta Ultima ventana el Botn Finish esta encendido
habilitado
En esta ventana si el reporte se configur satisfactoriamente,
al presionar FINI$H crears el reporte. Pero adems tienes la
opcin de Guardar los cambios hechos a la configuracin,
asignndoselos as al tema que seleccionaste al iniciar el
asistente, como Tu Predeterminado, o si prefieres puedes
Guardarlo como un tema nuevo.














11. El asistente de Reportes (Report Wizard):
Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 120
www.gopac.com.mx
cursosgopac.com.mx

Crea el reporte basado en la configuracin del
diccionario y en los cambios personalizados que
se configuraron para el reporte y te muestra la
ventana de las propiedades del reporte creado.
















































4.6 Ejercicio enviar reportes a iferentes estinos de Impresin

Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 121
www.gopac.com.mx
cursosgopac.com.mx

Para Mandar un Reporte a Cualquiera de los Formatos PDF, HTML, TXT o XML, Es
necesario primero

1. Incluir en los Global Extensin Templates de la
Aplicacin los siguientes Templates









2. Estos templates se agregarn a cada
uno de los reportes generados en la
aplicacin, y pueden configurarse
individualmente para cada reporte.







3. En las propiedades del reporte (Report
Propierties) se aade un TAB (Report
Target) (Destino de Reporte), donde
puedes configurar la salida del
reporte, esta salida puede ser, fija a un
formato determinado, a una
impresora, o que el usuario decida en
tiempo de ejecucin.




4. Al ejecutar el programa y correr el reporte se mostrara una ventana en la cual
podemos elegir entre las opciones que nos muestra la ventana para dar salida
nuetro reporte.















Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 122
www.gopac.com.mx
cursosgopac.com.mx

5. Al mandar a imprimir con la Opcin Print Obtenemos el Preview Normal que no da
Clarion.
































5.6.1 Ejercicio para Mandar reporte a PF

Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 123
www.gopac.com.mx
cursosgopac.com.mx


1. &na vez incluido el template en las extensiones del reporte se puede configurar de la siguiente
manera.

2. Populate on Report: En esta seccin del
template se determina si la salida o publicacin de
este reporte es en Formato PDF, estar siempre
disponible (Always), o (Never), si no estar
disponible o si la salida del reporte en este
formato estar condicionada (Conditional).

NOTA:Estas Opciones aplican
tambin para los otros tipos de
reportes (HTML,TXT,PDF,XML)









3. Output Name Type: En este seccin del template, se configura como ser asignado el nombre
del archivo (PDF) donde se guardar el reporte. Esta configuracin puede ser de 3 formas.
Puede tener un nombre FIJO. (FIXE), as mismo puede tener un nombre VARIABLE,
(VARIABLE), el cual puede estar contenido en alguna variable de memoria del sistema
(LOC,MOD,GLO), o en el campo de alguna tabla. $i (RUNTIME) al imprimir el reporte abrir
la ventana de Guardar de Windows para que el usuario le asigne el nombre antes de
imprimirse.

NOTA: Estas Opciones aplican tambin para los otros tipos de reportes
(HTML,TXT,PDF,XML)





4. Al Ejecutar el reporte en la aplicacin nos genera un archivo PDF, el cual podemos abrir con Adobe
Acrobat Reader.

















Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 124
www.gopac.com.mx
cursosgopac.com.mx










































Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 125
www.gopac.com.mx
cursosgopac.com.mx

4.6.2 Ejercicio para Manda reporte a TXT


1. &na vez incluido el template en las extensiones del reporte se puede configurar de la siguiente
manera.






2. Save Output as Separate files (Guardar como
Archivos Separados) Al activar esta opcin cada pgina
del reporte es guardada como un archivo aparte con
extensin .TXT











3. El resultado del reporte los Guarda en un archivo TXT que podemos abrir con el cualquier editor de
Texto. (NOTEPAD.ExE)
































Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 126
www.gopac.com.mx
cursosgopac.com.mx

4.6. Ejercocio para Mandar reporte a HTML


1. &na vez incluido el template en las extensiones del reporte
se puede configurar de la siguiente manera.


2. Al ejecutar el reporte nos crea un archivo HTML, adems
de &n flder con el nombre del Reporte, el cual contiene
una archivo HTML por cada pagina del reporte, as como un
archivo C$$ (Cascada de Estilos ) y una archivo html con el
formato de navegacin.









3. Al abrir el archivo HTML creado con el nombre del reporte. (Facturas.html) se ve de la siguiente
manera





































Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 127
www.gopac.com.mx
cursosgopac.com.mx



4.6.4 Ejercicio Mandar reporte a XML

1. &na vez incluido el template en las extensiones del
reporte se puede configurar de la siguiente manera.
Esta opcin del reporte genera cdigo XML, el cual
puede ser abierto de varias maneras, una de ellas es
creando un archivo XSL para poder verlo con un
Navegador, O se puede crear un Frame con Flash
para ver el resultado del reporte




2. Al ejecutar el reporte y deja un archivo en
(Facturas.xml).









































3. Es necesario crear un Archivo X$L, (Archivo de estilo), para dar formato al X$L que se cre y
abrirlo con un Navegador. Y Agregar una lnea en Facturas XML, para indicarle cual es el
Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 128
www.gopac.com.mx
cursosgopac.com.mx

archivo de estilo que utilizar. As mismo si el archivo de estilo utiliza imgenes. Esas imgenes
deben estar disponibles, para que el navegador las pueda abrir.




4. Despus de crear el Archivo de estilos X$L y agregar la lnea al archivo XML generado por
Clarion, indicando que archivo de estilos (X$L) utilizarn. Abrir el archivo Facturas.XML y se
mostrara de la siguiente forma






































4.7 Ejercicio UtiIizazndo eI TempIates para GRAFICAS de CIarion


Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 129
www.gopac.com.mx
cursosgopac.com.mx

Clarion 6.0 cuenta con un template que nos permite aadir grficas, a una aplicacin
las cules pueden estar basadas en los datos de los archivos, o pueden estar basadas
en los datos de un queue. A estas grficas se les puede modificar el formato y
apariencia en tiempo de ejecucin, guardarse como un archivo WMF o mandarse a
imprimir.

1. Ejercicio Agregar una grfica en el Browse de
Clientes.


2. Para agregar la grafica cualquier grafica a una
aplicacin es necesario, aadir el GraphGlobal
Extensin de la aplicacin el Template $VGraphGlobal.


3. Adems debemos validar que en las propiedades
del GraphGlobal Extensin Template, Est
seleccionado el GraphClass.

4. EL siguiente paso, es abrir espacio en el Browse de
clientes para Agregar el Graph Control Template.
&na vez agregado en la forma, es posible Editar las
propiedades de este template, dndole Clic derecho
al control en las Extensiones del Procedimiento.

5. Las propiedades que Configuraremos de este Template son

6. GENERAL En la $eccin de General Dejaremos encendidos
los Check's Box de Refresh Automatically. Esta opcin
habilitada permite que en el grfico se refresquen los
cambios de los valores en los cuales se basa la grfica,
PopUp Menu esta opcin habilitada te permite utilizar un
men de Opciones en tiempo de ejecucin, para Imprimir,
Guardar, y Modificar el Formato del Grfico y Tooltip te
habilita poder utilizar los tooltips en el grafico.






7. Initial Values En Valores iniciales se Define el Tipo de grfico al cual le pondremos
Bar Char, aqu mismo podemos definir el ttulo del grfico, las leyendas y textos de los
ejes.



8. isplay Options
En esta seccin se habilita o deshabilitan las opciones que
estarn Disponibles en el Men Popup del grfico en tiempo
de Ejecucin. Para efectos de este ejercicio lo dejaremos
como se muestra en la figura.


Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 130
www.gopac.com.mx
cursosgopac.com.mx













9. ata Sources:
En esta seccin se define y se configuran las propiedades del origen de los datos que se
tomarn en cuenta para crear la Grfica.



10. Pare este ejercicio Tomaremos los datos de la tabla de
Facturas, agregue ("Colgarle) la tabla de clientes y en el
Table Schematic lo definiremos como se muestra en la
figura.





11. En las propiedades del ata Source definiremos, la llave del
archivo a utilizar.


12. En las Propiedades del Data $ource, le definimos el origen de
nuestros datos, que en este caso, sern de un Archivo (File), ya
que tambin pueden provenir de un Queue

13. $e especifica las condiciones en la cuales manejara los archivos,
especificando su llave FAC:FKCliente, el rango a &tilizar (Range
Limit Field), $eleccionar FAC:CI% , en el tipo de rango (range
Limit Type), seleccionamos File Relationship y archivo que limita el
rango, seleccione el archivo de Clientes, de esta forma quedan
configurados los archivos de los cuales se obtendr la informacin para
la grfica.


14. $eleccione el TAB de Puntos (Point), para definir que datos sern
mostrados en la grfica y Presione el Botn de Insertar.








Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 131
www.gopac.com.mx
cursosgopac.com.mx

15. En la Ventana de configuracin de los puntos, en el Nombre de la serie ($erial Name),
asignar "Importe Total.


16. En el Botn de FILL seleccione el tipo de llenado
de la barra que representa los puntos de la
grfica. Y el para el color seleccionar es fijo
(Fixed) y el color deseado.



17. En el punto de agrupamiento (Grouping of Ponit) se establece como sern reunidos
los datos a mostrar en la grfica, en este caso, se agruparn las facturas de cada
cliente por fecha, especficamente por mes Month(Fac:FECHA).




NOTA: Los Puntos de Agrupamiento son
utilizados en grficas de tipo Barra y
Columnas.


18. En Record Action $eleccione del Drop list
como cada registro ledo (De los
Establecidos en el $et de datos en los
parmetros de Data $ource) ser
procesado dentro de punto de datos.


19. $eleccione Graph para que cada valor ledo
sea desplegado en la grfica como un valor
separado, es decir por cada factura
despliega una barra.
20. En Field se especifica el campo que
contiene el valor a graficar en este caso, seleccione el total de la factura FAC:TOTAL.


2. Compilar y Probar





4.8 Ejercicio Aplicando el Browse Grid Template a la Aplicacin

El template BrowseGrid provee una serie de controles que son usados para definir un
rea para desplegar controles de una ventana en forma de matriz, o recuadro. El
tamao de el BrowseGrid y del BrowseBox puede ser manipulado para dar como
resultado final una matriz con una o varias columnas o renglones donde se desplegar el
contenido de los registros de la tabla, en los controles sobrepuestos al BrowseGrid.
Cuando el control (BrowseGrid) es aadido el BrowseBox no se despliega, solo en
tiempo de ejecucin.

Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 132
www.gopac.com.mx
cursosgopac.com.mx

1. Para utilizar este Control Template, primero crearemos un Browse normal con el
asistente para Browses, para la tabla artculos.


2. &na vez Generado el Browse de Artculos con el Wizard, $eleccionar el Browse y abrir
el Window formater para agregar sobre el List Box Format del Browse el BrowseGrid
Control Template.

3. Al seleccionar el control template trazamos con el mouse el
rea sobre la cual queremos que ocupe el control template,
para este ejercicio lo colocaremos como un rectngulo
vertical sobre el list Box Format del Browse de artculos que
acabamos de crear.


4. Para este ejercicio debemos modifica el tamao de la ventana, para que el control
forme una matriz de al menos 4 Columnas por registro, cada registro ser mostrado
en el rea marcada por el BrowseGrid.

5. Agregar sobre el BrowseGrid, el control de cuadro de Texto,
asignndole el nombre del artculo y en sus propiedades, le
activaremos isable.





6. Agregar sobre el BrowseGrid una Regin control Template. Y en
sus propiedades en el Tab Help $eleccionar el tipo de Cursor
Zoom.

















7. As mismo sobre el BrowseGrid Agregaremos un String, en el cual se mostrara el
Precio del Articulo.




Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 133
www.gopac.com.mx
cursosgopac.com.mx






8. $obre Control de Regin agregar un DynamicImage Control
Template y en sus propiedades en el Field Drive Image
asignarle el campo ART:FOTOGRAFIA, en el cual estar
guardada la imagen que mostrara el control.













9. $eleccionar el BrowseGrid y con el Botn derecho entrar a sus propiedades y del lado
derecho, en el Entry de Expresin for Goup agregar el siguiente texto ' Codigo:
'&ART:COIGO&' ', en Color of Selected Group seleccionar el COLOR:YELOW, y
encender el Check Box de Make Growp Selectable.

















10. Compilar y Probar, presionar las teclas Page&p y PageDown se recorren los registros de
la tabla de Artculos.









Clarion Bsico Manual de Ejercicios
Procesos, Templates y Reportes


Gopc Soluciones ntegrales, S.A. de C.V. 134
www.gopac.com.mx
cursosgopac.com.mx













































































CI




T
_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 134
www.gopac.com.mx
cursosgopac.com.mx









TempIates y
Herramientas
AdicionaIes


Objetivo

Breve introduccin al uso de algunos
Templates de Terceros y herramientas
adicionales de Clarion 6.0
_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 135
www.gopac.com.mx
cursosgopac.com.mx

5.0 Agregando un ModeIo de Seguridad a Ia apIicacin


Secwin es un de los primeros templates de seguridad que ha ido creciendo haste convertirse euno
de los paquetes de stemplates de seguridad para las aplicacioens de clarion. Este templates esta
basado en la idea de que el usuario final pueda administrar la seguridad y accesos de su aplicacin
ya que es muy facil de usar y facil de esear.

Nota : Todas la caracteristicas son Opcionales, esto queire decir que tu peudes agregar las
tantas como sean necesarias para tu apcliacin o solo algunas.

Algunas de las caractersticas mas importantes de este templates se describen a continuacin :

ControI de Acceso a Usuarios:

O Permiet la adminsitracion de multiples usuarios y sus Passwords
O Control de acceso a Usarios a una Ventana completa oo inclusive a nivel de una
columna en un Browse.
O Manejo de Grupos de Usarios o Grupos de Trabajo
O Permite Multiples areas de acceeso dentro de la misma aplicacin. (login areas)
O Puedes configurar que las caracteristicas de los passwords, regular o forzar cambios
de password de los usuarios, cantidad de caracteres minimos para password.

Registro y Licenciamieinto de una acpIicacin

O Maneja Nombre del la compaia , Numero de serie, y Fecha de Expiracin
O Nivel de programa DM, NRMAL !RF$INAL M!R$ARIAL.
O Modulos Opcionales - permite hasta 15
O Multiples critrerios de caducidad para aplicaciones Demos.

Otras caracteristicas :

O Permite cambiar la intenacionalizacion del lenguaje en sus parnatallas.
O Soporta los Drvers de datoas mas comunes TPS , SQL, Etc.
O Herramienta configurable.


5.0. Ejercicio Agregar seguridad a Ia apIicacin ejempIo.

Para aadir Sec Win a la aplicacin es necesario incluir el SEC WN lobal Extension template, en
las extenciones globales de la aplicacin, habilita a la aplicacin para que sus caractersticas sean
utilizadas.

NOTA: El agragar el SEC WN lobal Extension template no enfdra ningun efecto visual sobre la
aplicacin esto solo.

1. Abra su apcliacin en Clarion.


2. Selecciones la Opcion lobal !roperties del menu de
ApIication.

NOTA: Puedes tambien hacer clic en el Boton GLOBAL (lobal button)

_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 136
www.gopac.com.mx
cursosgopac.com.mx



3. Selccionar el Boton de tensions




4. Presionar el Boton de Insert, para agregar el Template





5. Buscar y elegir en la Ventna de Templates el Activate $ecwin
Features.














6. Una vez agregado el lobal tencin %emplate, es
necesario configurarlo, en la pestaa Aplication, en la seccin
Unique Application Name : Telclearle el nombre de la
Aplicacin.






7. En la pestaa Files y en la seccin Driver $uport,
en $elect Driver elegir TOPSPEED.




8. E la seccion de Security File Marcar el Chek de Permitir
al programa crear los archivos de seguridad.


9. En la seccin de Position, le indicaremos a la aplicacin
donde esta los archivos de seguridad en este caso
selecionaremos la opcion Directory.


10. Guardamos, Compilamos y Probamos, hasta este punto no hay cambio en el Programa.
_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 137
www.gopac.com.mx
cursosgopac.com.mx


5.0.2 Ejercicio agregando procedimiento de Acceso/ Loggin a Ia apIicacin

En esta seccion agregaremos un Extensin Template con el que cuenta este Sec Win para
solictarnos en una ventna el nombre de usuario y su clave. Una vez agregado el template al
ejecutar la aplicacin nos preguntara si crea el archivo de seguridad donde se guardan los
usuarios y sus claves. Despus de eso nos mostrara la vetanan pidindonos Usuario y
Password.

1. En el procedimiento principal de la aplicacin
Main (FRAME), agregaremos el Extensin
Template : User_Login.


2. Despus de agregarlo nos muestra una ventana de
condiguracin al lado derecho, en el cual
describiremos a continuacin.
O Unique Area Name: Nombre Unico de la
Aplicacion como identigficador.


O AIIow Case Insensitive User Password:
Permite que el password no sea sencible a
mayusculas o minusculas.


O AIIow onIy 3 times: Permite solo 3 ntentos
de ingresar el password.


O AIIow automatic Iogin from other Exe's:
Permite Logins automatico desde otros
programas.


O AIIow defauIt Iogin vaIues: Permite
Valores Predeterminados en Usuairo y
Password.


O Don't show screen if DefauIt faiIs: No muestra la ventana si el Default no funciona.
O Force Iong password (6 aIpha + 3 Number): Establese a que el password sea
largo de 6 Caracteres alfabeticos y 3 numericos.

O Use own Login Screen: Esta opcion permite elegir cual es procedimiento para
hacer login y ademas cual es el primer procediiento para los Usuarios.


O DispIay Login After Windows DispIays: Despliega la ventana de login depues de
la pantalla principal.




_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 138
www.gopac.com.mx
cursosgopac.com.mx




1. Para fines de nuestro ejercicio marcaremos, las
siguientes opciones priemero marcamos AIIow
Case Insensitive User Password, ademas
marcaremos AIIow onIy 3 times.
















2. Compilamos y ejecutamos la aplicacin, al ejecutarse el programa por primera vez nos manda
un mensaje No users eist for this Aplcation / $ecurity Area" (no existen usuarios para
esta aplicacin en el area de sguridad) y nos har la pregunta Do yo want to grant
Access to an isting user?" (Desea otorgar accesoa un usuario existente?), a este
pregunta contestaremos que no.







3. AL contestar que no en la pregunta anterior nos hara una nueva pregunta, ala cual
contestaremos que S. Do you want to a// a new user? Deseas agegar un nuevo usuario.


















_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 139
www.gopac.com.mx
cursosgopac.com.mx






4. Al contestar afirmativamente la pregunta anterior el sistema abre una ventana donde nos pide
lso datos del usuario quoe queremos agregar como es la primera vez, agregaremos al priemr
usuario ADMN.


5. En la Ventna Up/ate Users hay dos cosas a
considerar :

1. El mismo nombre de usuario ADMN. Sera
el primer password para ese usuario.


2. Este priemr usuario sera Agregado con la
4ategora de supervisor, teniendo acceso a
todas las opciones del sistema.

6. Al darle OK en la ventna de edicin de usuarios, abre la ventna de LOGN para ingresar al
sistema. En esta ventna teclearemos para LIN: ADMIN. Y para !asswor/: ADMIN.,
presionamos OK y entramos al sistema.


NOTA : Es posibIe cambiar Ios PROMTS de Ia ventna de
Ioggin a espaoIy eI icono tambien.



























_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 140
www.gopac.com.mx
cursosgopac.com.mx

5.0.3 Ejercicio Agregando Ia FuncionaIidad de Cambiar eI Password para Usiarios.

En el ejercicio anterior generamos el acceso para la aplicacin creando al Usuario supervisor
ADMN. Ahora necesitamos agregar a la aplicacin una opcion para cambiar el password a los
usuarios del sistema.

SecWin cuenta con un Code Template que nos permite cambiar el
Password de los usuarios
registrados. Para esto primero haremos lo siguiente:


1. Para habilitar este Code Template Primero agregaremos en el
Menu principal el menu Utilerias y dentro de ese menu
agregaremos la Opcion Cambia !asswor/.


2. Con la opcion Cambiar Password seleccionada, abrimos el
Tab Acciones del lado derecho del editor de menus.




3. En el TAB de Accions el Code Template presionamos el
boton de EMBEDS , eso abrira la ventna de embeds y nos
posisionamos en el Accepted depuse del Codigo generado pro
clarion es decir After enerate/.




4. En ese punto presionamos el boton de insertar (insert) de la
ventaba de la ventana principal de Embeds mbe//e/ $ource Main Win/ow .




5. De la ventna de Tipos de Embed (Embed Type)
Seleccionamos el Call $ecwin's Changue
!asswor/ Co/e de Sec Win.



6. Cerramos compilamos y probamos entrando a la aplicacin y cambiando el password al
Usuario ADMN.











_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 141
www.gopac.com.mx
cursosgopac.com.mx


5.0.3 Ejercicio Agregando Ia Administracin de Usuarios y NiveIes o Compuertas

En este ejercicio agregarmos un centro para mantenimiento a los usuarios de la aplicacin, este
modulo va desde registrarlos hasta administrar los lugares donde cada usuario tendra acceso en la
aplicacin.

SecWin cuenta con un Code Template que nos permite Agregar un Centro de Administracin de
usuarios, donde podemos agregar, modificar y eliminar usuarios, asi como sus permiosos. Para
esto primero haremos lo siguiente:

1. Para habilitar este Code Template Primero agregaremos en el Menu principal el menu
Utilerias y dentro de ese menu agregaremos la Opcion Cambia !asswor/.


2. Con la opcion Cambiar Password seleccionada, abrimos el Tab Acciones del lado derecho
del editor de menus.




3. En el TAB de Accions el Code Template presionamos
el boton de EMBEDS , eso abrira la ventna de embeds
y nos posisionamos en el Accepted depuse del Codigo
generado pro clarion es decir After enerate/.





4. En ese punto presionamos el boton de insertar (insert)
de la ventaba de la ventana principal de Embeds
Embedded Source Main Window







5. De la ventna de Tipos de Embed (Embed Type) Seleccionamos el Call $ecwin's perator
Browse Co/e de Sec Win.













_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 142
www.gopac.com.mx
cursosgopac.com.mx


6. Cerramos Compilamos y probamos entrando a aplicacin y agregarmos un usuario, en la
opcion Utilerias / usuarios del Menu.

NOTA: Despues de Agregar el usuario se le
puede modificar el password con la opcion del
ejercicio anterior.










5.0.4 Cambiar de Idioma Ias ventanas de SECWIN.

Como hemos notado a lo largo de los ejercicios mostrados en de este templates todos los prompts
de las y los textos de los botones de las ventnas que utiliza SECWN para interactuar con el
usuario estan en ngles. En este ejecicio veremos la manera de cmo cambiar el idioma por el de
nuestra preferencia.

Al instalar SecWin se copiaron al folder C:\Clarion6\3r/party\LIB$RC, una serie de archivos con
Extencion RF, los cuales contienen los textos de las ventanas de SecWin en diferentes idiomas,
para este ejercicio utilizaremos el de idioma Espaol ($panish.IRF), para habilitar



1. En las Extenciones Globales de la aplicacin
seleciomamos el Activate SecWin features, la pestaa
Files.







2. En la pestaa de FiIes, en la Seccion Language
File (archivo de doma), debemos poner el
nombre del archivo IRF, correspondiente al idioma
que queremos configurar, para este ejercicio
pondremos el $!ANI$H.IRF









_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 143
www.gopac.com.mx
cursosgopac.com.mx


3. En la seccion de Position le indicamos a la aplicacin
donde se encuentra el archivo de idioma que utilizaremos
para este ejercicio le diremso que se encuentra en el mismo
lugar que el Ejecutable.



NOTA: No olvidar copiar el archivo $!ANI$H.IRF al directorio de trabajo donde esta el
ejecutable de la aplicacin, estos archivos se encuentran en C:\Clarion6\3r/party\LIB$RC.



4. Guardamos, compilamos y al ejecurar el programa y entrar a las ventanas relacionadas con
SecWin, veremos sus textos en espaol o el idioma que se configur.








%!: En todas las ventanas de SecWin viene incluido un logo (candatito amarillo). Ese logo
se puede cambiar por uno personalizado o quitarlo completamente de la ventana, utilzando
la funcin dssetLogo(). Ej: ds_setlogo('milogo.ico',0),el archivo nilogo.ico debe estar en el
dicatorio donde se encuentra el ejecutable. Esta funcion debe estar en el GIobaI Embed
Program Setup.






5.0.4 Agegar Seguridad en Procedimientos (Browses, Formas y ControIes)

Una vez que ya tenemos el acceso controlado a nuestra aplicacin y el centro de administracin
de usuarios, necesitamos configurar a que opciones de menu y Modulos tiene acceso los
usuarios. Ademas de que controles (botones) dentro de las ventanas se pueden accesar por esos
usuarios controles y botones son permitidos para los usuarios.

Para lograr eso se realiza en dos pasos primero en cada modulo (incluyendo el menu principal)
agrear el extencion template User $creen $ecurity y configura en el los controles que estaran
bajo el esquema de seguridad de la la plicacin. Segundo en tiempo de ejecucin en cada modulo
se accesa al centro de control de permisos de usuairos y se configuran las compuertas para los
usuarios.

En este ejercicio agregaremos seguridad a los botones del CataIgo de ArticuIos para que los
usuarios que son operadores, no puedan editar o eliminar articulos.






_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 144
www.gopac.com.mx
cursosgopac.com.mx


1. Selecionamos el Browse de articulos y en sus extenciones agregamos el Template User
$creen $ecurity .












2. Con el solo hecho de agregar este template en el Catalogo de Articulos, se creo una
compuerta para cada usuario para permitir o no, el acceso a este modulo. Para Admisnitrar
los accesos es necesario ejecutar la aplicacin y entrar como usuario Admisnitrador.


3. Una vez firmado como administrador,
debemos abrir el modulo al que le
agramos el Template User $creen
$ecurity en este caso el CatIgo de
articuIos. Con el catalgo de articulos
abierto Presionar las teclas C%RL-F.
Esto abrira la ventna de permisos a
usuarios donde se puede dar o no
acceso a los usuarios para entrar al
modulo.



4. Como se muestra en la figura el prpiemr y el
tercer usuario si tiene acceso al Catalgo de
Articulos y para el segundo y el cuarto el
acceso no esta permitido, si alguno de estos
ultimos usuarios intenta ingresar el sistema
le envia el siguiente mensaje :




5. En esta seccin del ejercicio agregamos
comnpuertas a los botones del Catalogo de
Articulos para esconderlos o deshabilitarlos
para algunos usuarios. Para esto en la
extenciones del Catalogo de Articulos en el
Template User $creen $ecurity
presionaremos el boton Control
Restrictions.




_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 145
www.gopac.com.mx
cursosgopac.com.mx





6. Al presionar el boton Control Restrictions se abre una
ventana donde se agregan todos las compuertas para los
controles de esta ventna a los que se les adminsitrara el
acceso.


7. En la ventana de Control Restrictions presionamos el
boton de insertar para Editar las propiedades del control
que se quiere admistrar.


Unique Bit Position : Este es simplemnte un
numero desde 1 a 30. niciando desde uno y
a cada control que quieras adminisitrar se le
asigna un numero no tiene que ir en
secuencia.


Name (Nombre) : Es es el nombre para una
columna en el Set Access Screen. Utilice un
nombre simple, BT_BORRAR para el boton
de borrar, para el boton de mprimir
BT_MPRMR y asi para cada caso. Este
nombre esta limitado a 7 caracteres.


Use Equate : Este es el Equate (Equivalente) para el control que estas protegiendo y
se puede selecionar de una lista Drop-Down.

List box CoIumn : S el control es un List Box, enteonces puedes proteger una
columna individual de ese list box. Por ejemplo si quieres suprimirm la columna de
salarios para un grupo de suarios la agregarias aqu, con el numero de columna.

Accion : Esto determina lo que suceder cuando el usuario no tenga acceso al
control. Los Botones generalemente son Button son Deshabilitados y las opciones del
Menu no se Esconden se Deshabilitan, los campos tipo Entry genrealmente se
esconden pero tod depende de las necesidades establecidas.


Attach Other ControIs : En algunos casos un grupo de
controles debe habilitar o deshabilitar todos juntos, si es e
es el caso, haga click en este boton y agregue cuantos
controles necesites en conjunto. Este grupo aparece
como un simple control en la pantalla de usuarios.







_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 146
www.gopac.com.mx
cursosgopac.com.mx



8. Para este ejercicio agregaremos la siguiente configuracin para deshabilitar el botn de
Editar Del CataIogo de ArtcuIos para unos usuarios registrados.


9. En las extenciones del catalogo de articulos presionamos el boton Control Restrictions ,
para insertar y configurar los permisos del boton de Editar .


10. En el Enty de Unique Bit Position (-30): teclemos el Numero . por ser este el priemer
control que protegeremos.


11. En la opcion NAM le asignaremos el nombre
B%_DI%AR .


12. En el USE Equate selecionaremos el
?Change:3. es la etiqueta que representa al
boton de Editar regsitro.


13. En Action Selecionaremos DISABLE para
que el control aparesca Deshabilitado en la
ventana.


14. Presionamos ok y salimos de esta ventana.



15. Para este ejercicio agregaremos la
siguiente configuracin para Esconder el
botn de Eliminar del CataIgo de
ArticuIos para unos usuarios
registrados.


16. En las extenciones del catalogo de
articulos presionamos el boton Control
Restrictions, para insertar y configurar
los permisos del boton de eliminar:


17. En el Enty de Unique Bit Position (-
30) teclemos el Numero 2. por ser este
el priemer control que protegeremos.


18. En la opcion NAM le asignaremos el
nombre B%_BRRAR .



_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 147
www.gopac.com.mx
cursosgopac.com.mx


19. En el USE Equate selecionaremos el ?Delete:3. es la etiqueta que representa al boton de
Editar regsitro.


20. En Action Selecionaremos HIDE para que el control se no se vea en al ventana.


21. Presionamos ok y salimos de esta ventana, Guardamos, Compilamos


22. Ejecutamos al aplicacin y nos firmamos como Usuario: Admin y Pass: ADMN. Y abrimos el
catalogo de Articulos.


23. Una vez abierto el Catalogo de articulos presionamos la secuencia de teclas C%RL-F para
abrir la ventna de permisos a usuarios.


24. En esta ventana apareceran 2 nuevas
columnas, las cuales son las Compuertas
para permitir o no el acceso a los usuarios al
los botones de Agregar o Editar, del
Catalogo de Articulos.


25. Selecionaremos un usuario y le
Permitiremos el acceso, haciendo boble click
en la coluna de Acceso para que mueste SI
y en las columnas BT_EDITAR y
BT_BORRAR, le qasignaremos NO.


26. Para probar que nuestra configuracin
funciona salimos de la aplicacin y
entramos con el usuario al que le
cambiamos sus permisos. Y entramos al
Catalogo de Articulos, en el el boton de
Editar debe estas deshabilitado y el
boton de Eliminar no aparece.















_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 148
www.gopac.com.mx
cursosgopac.com.mx

5..0 SeIeccin MuItipIe de Registros para Procesar o Imprimir


El Tempalte SuperTagging te de la habilidad de poder marcar los registros de una tabla, el
marcar los registros de una tabla o pude ser de mucha ayuda para sobre todo si le das al usuario la
habilidad de que aleatoriamente pueda elegir uno o mas registros para incluirlos ne un reporte o un
proceso.

Ademas este template te da a elejir donde quieres almacenar los registros marcados. Esto te
permite manejar una combinacin de que mutiples usuarios puedan marcar multiples tablas hacer
opreadciones con ellas.

Acontinuacion se decriben unas de las caractreristicas mas importantes de este practico template:

BrowseTaggingButtons Este control template te permite marcar los registros de un
Browse normal de clarion. Este conytol template agrega botones a la ventna que te
permiten Marcar (tag), Desmarcar (untag), nvertir uno solo (toggle), Marcar todos (tag all),
Desmarcar todos (untag all),
and nvertir todos (flip all). Ademas de dos botones adicionaes que son el de Salltar al
siguiente Registro marcado (next tag) y al saltar el registro previo marcado (previous tag).
Ademas puedes hacer clic en la columna de marcar para marcar o desmarcar un registro.

BrowseOptTagFiIter Este control Template que coloca una serie de botones en la
ventna, con los cuales puede el usuario elegir que conjunto de registros quiere ver los
marcados "Tagged ", Desmarcados "Untagged" o Todos"All" records.

BrowseTagFiIter Este Extencion Template te permite desplegar solo los regustros
marcados de un Browse, a diferencia del anteiror este caracteristica siempre esta fija.

ProcessTagFiIter Este Extension Template aade un filtro a un procesar o mandar a
reporte solo los registros marcados. Este es similar al BrowseTagFilter
template, ecepto que este se utiliza especificamente en procedimientos de tipo proceso y
reporte.

BrowseMarking Este Extension Tempalte prove el metodo Standar de Windows (WSB)
Para marcar una serie de registros. EL usuario puede presionar el boton zquierdo del
mouse para marcar un registro sencillo o tambien puede presionar , Shift y el boton
zquierdo del mouse para marcar un rango y ademas con Ctrl-Click y boton izquierdo
puede invertir un registro en forma individual.

SaveTags Este control Template guadra el conjunto (SET) actual de registros marcados
de un browse a otro Conjunto difernte (SET) que puede ser cargado depuse cuando se
necesite a memoria con el "LoadTags" control template.

LoadTags Este control template carga en memoria un conjunto de registros marcadosy
guardados previamente con el control template "SaveTags".

CopyTags Este Code template copia registros marcados de un conjunto (SET) a otro.







_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 149
www.gopac.com.mx
cursosgopac.com.mx



5.. Ejercicio Registrar y Aadir Sper Tagging a Ia apIicacin

Como la mayoria de los template por no decir que todos, es necesario primero nstalar el tempate
en nuestra maquina, corriendo el instaldor que te entrega el proveedor del template, y luego
Registrarlo en Clarion en el men SETUP en lalpocin tmplate registry.

5... Registar eI TempIate:

Clarion te permite tener multipes conjuntos de templates accesibles en la
misma palicacin, y para tener accesible y usar el Super Taggin es
necesario Registrarlo en el TempIate Registry de clarion. Para hacer esto
seguiremos lo siguientes pasos:

1. Arbir Clarion 6, y selecionar del Menu Principal el menu Setup

2. Elegir la Opcion TempIate Registry

3. En la ventan de Template Registry presionar el boton
[REGSTRY(

4. Seleccionar el archivo
C:\CLARIJN6\TEMPLATE\STAB_.TPL (ABC) para
registrar el templates, para aplicaciones ABC.

5. Seleccionar el archivo
C:\CLARIJN6\TEMPLATE\STCL_.TPL (Clarion) para
registrar el templates, para aplicaciones Clarion o Legacy.


NOTA :El nombre del directorio donde esta instalado clarion C:\CLARIJN6 en este
ejercicio puede variar.





5...2 Aadir Sper Tagging a Ia apIicacin

El objetivo de este ejrcicio es agregar el Extencin template de

1. Con la aplicacin abierta entraremos a las Extenciones
Globales de la Aplicacin.



2. En la ventana de Extensin and Control Templates presina el boton de NSERT.


3. De la ventana de seleccin elegir el
TAGGLOBAL (Super Tagging) GIobaI
Extensin.

_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 150
www.gopac.com.mx
cursosgopac.com.mx


4. El agregar el Global Extensin template no
producira ningun efecto en la aplicacin.









5..2.0 Ejercicio Marcar registros en un Browse

Antes de utilizar el Template Tagging para marcar registros es necesario incluir los archivos de
soporte (Support FiIes) en el diccionario de la aplicacin.

Support FiIes (%AIN.%D)

En estos archivos se registran, la informacin necesaria para identificar los registros marcados.

Apartir de SuperTagging 4.0, los archivos de soporte se deben incluiur en el diccioario de la
apcliacin, esto es para evitar errores de configuracin y ademas da aportar ms beneficios al
programador y ahorar tiempo de programacin.

Estos archivos estan localizados en la carpeta SUPER\SRC_ABC\TAGGING. El archivo se llama
TAGGNG.TXD.





5..2. Importando Ios archivos de Soporte.

El primer paso es cargar los archivos al diccionario importando el TAGGNG.TXD que se
encuentra en SUPER\SRC_ABC\TAGGING. Los archivos que se agregan al diccionario son los
siguientes:

TagFiIe_ Este archivo almacena los registros marcados cuando utilizas la opcin "Disk Set" , en el
cual el D de la llave primaria del registro es guardado en ese archivo.

TagFiIePos_ Este archivo se almacenan los registros marcados cuando la llave primaria no es un
entero largo (LONG) si otro tipo como (STRNG).

TagSet_ Este archivo contiene los nombres de los Conjuntos o grupos de registros marcados
(SET). Cada registro contiene un numero de SET y el nombre de la tabla.









_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 151
www.gopac.com.mx
cursosgopac.com.mx






1. Lo primero que necesitamos hacer es abrir el diccionario


2. En el Menu de File, seleccionamos la opcin IM!R% %%


3. En la ventna de seleccionar archivo buscamos en la ruta
SUPER\SRC_ABC\TAGGING, el archivo TAGGNG.TXD


4. Guardamos el dicccionario con las nuevas tablas agregadas y regresamos a la aplicacin.



NOTA: Estos pasos solo se tienen que hacer una
sola vez en cada aplicacin donde se dese utilizar
Super Tagging.











5. Despus de agregar los archivos al diccionario y el Global Extensin , le activaremos la
funcionalidad de marcar los articulos.


6. Abrimos las propiedades del Catlgo de Artculos y
abrimos el editor de ventanas, de la aplicacin.


7. De nuestra caja de Templates Seleccionamos el
Control Tempale, BrowseTaggingButtons.










_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 152
www.gopac.com.mx
cursosgopac.com.mx





8. En la ventana de se muestran una serie de
botones que conforman el control Template


9. Al agregar el control template tambien se
agrego.una variable local %A de tipo $tring de
11.









10. Esta variable se agrega al List Box deI
Browse como la priemer columna, ademas
en el Headeing TEXT se deja en blanco, en
las Flags se desmarca la de Rigth Border y
la de ReziseabIe todo esto hara el efecto de
que no existe la priemr coluna. Presionamos
Apply, OK y guardamos.











11. En la ventana del Browse de artculos, seleccionamos
los botones que agregamos y entramos a sus acciones,
para configurarlos a nuestro agrado.














_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 153
www.gopac.com.mx
cursosgopac.com.mx


Que es un Conjunto de Marcas ("Tag Set")

Debemos entender el Tag Set, como un conjunto de registros de un archivo associados que seran
utilizados para un mismo fin o propsito, es necesario utilizar un numero de conjunto para cada
archivo de datos, esto es para que no se revuelvan los los registros marcados aun cunado los dos
conjuntos sean del mismo archivo de datos. Sper Taggin cuenta con 3 metodos para almacenar
los registros marcados. El Memory Set, el Disk Set y el BYTE Field in Primary.

Memory Set: Usando este metodo de almacenamiento, las marcas son almacenadas en un
QUEUE en memoria, Cada elemento del conjunto contiene un entero largo ( LONG integer) donde
se almacena el campo de la llave primaria. Debido a que las marcas se alacenana en memoria
multiples usuarios pueden marcar registros sin interferir uno con otro. Hay dos desventajas al
utilizar este metodo:

1. Las marcas estan ahi mientras el programa esta ejecutandose. Si necesitas guardar los
registros marcados de una sesion a otra o para utilizarlso otro dia, puedes utilizar los
templates SaveTags or CopyTags.

2. Si estas marcando muy pocos registros de un archivo largo o grande, y deseas
procesas solo los registros marcados, el metodo Memory Set, te forza a utilizar un filtro
en lugar de un rango y esto hace mas lento el proceso. Para solucionar esto se
recomienda orto metodo de almacenamiento.


Disk Set: A diferencia del metodo "Memory Set", este medoto es un poco mas lento ya que lso
registros marcados se guardan en disco, pero tiene la ventaja que las marcas esos registros
marcados los puedes utilizar para un reporte o proceso directamente cuando tu lo deses.

NOTE: f you wish to process tagged records in ReportWriter, you will need to save
them on disk.

Las marcas se almacenan en cualquiera de los archivos TagFiIe_ oTagFiIePos_, dependiendo de
que tipo sea el componenete de la llave primaria si es numerico o string. (Estos archivos por lo
genera son TPS).

BYTE FieId in Primary
Este metodo del marcar registros agregas un campo de tipo byte al archivo primario de tu proceso
y tu reporte, en el cual se guarda la marca. Este metodo no es posible utilizarlo en metdo
multiusuario, pero es una opcion de procesar registros marcados. Este tipo de marcado es facil de
usar pero no por eso es el mas eficiente. De alguan manera es mas rapido que metodo Disk Set, y
en algunos casos resulta hasta mas lento.


O TAG STORAGE : En esta pesataa se configura que metodo de
almacenamiento se utilizaran para las guardar las marcas.

O TAG DISPLAY: En esta seccin se configura el carcter de texto o el icono
que ser desplegado en el Browse para identificar visualmente los registros
marcados.

O BUTTONS : En esta seccin se configura la apariencia de los botones, con los
que marcaremos los registros.


_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 154
www.gopac.com.mx
cursosgopac.com.mx

O MESSAGES: En esta seccion se configurn si se eliminan o no, las marcas de
los registros, para liberar el set de registros, en fomra automatica o si se le
pregunta al usuario. Ademas se le configuran los mensajes que mostrara al
usuario cuando llegue a primer registro del set o el ultimo registro del set.


O MISCE. En esta seccion se peuden configurardiferentes cosas entre ellas, si al
hacer doble clic en la columna TAG se inverte la accion, es decir si estaba
marcado que se desmarque o si estaba desmarcado que se marcque,
Refrescar la ventana cada vez que se haga una seleccin de marcado.


12. Para este ejercicio Utilizaremos el Metodo "Memory
Set. En las acciones de los botones en la seccion
Tage Storage, en el Drop %ag are $tore/ in:
selecionaremos Memory Set y en el Tag Set
Number/Equate : le pondremos 1, lo cual indica que
este set de registros pra el archivo de productos sera el No 1.


13. En la Pestaa %ag Display, elegir la opcion
CON para que al seleccionar el regisrto,
aparezca un conito, y asi visualmente identificar
el registro marcado.


14. En Icon Scheme podemos escojer de una
varidedad predeterminada de iconitos y ademas si
elegimos la opocion custom se abre la opcion
para poner nuestros propios icono de marcado y
desmarcado.














15. En el Tag CoIumn Width en esta opcion s forza
la anchura de la columna donde aparecera el
iconito en Tiempo de Ejecucin.






_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 155
www.gopac.com.mx
cursosgopac.com.mx


16. En la seccion de botones le diremos que asigne iconos
a los botones marcando el chek de AutomaticaIIy add
icons to buttons. Y en Drop de Which si/e
Seleccionar LEFT.

NOTA: En el boton largo de CON FLES se puede
configurar el template para que muestre los iconos
personalizados, o se pude dejar los defaults.


17. En la seccion de Messages Selecionar la opcion ASK.

18. En el entry Question Modficar la pregunta Clear Existing
tags?, por Limpiar los registros marcados?



19. Asi como los mensajes de No More Previous Tags y el
de No More Next Tags.








20. Seccion de Misc. la dejamos con los valores por default
que trae el template.


21. Despues de esto salimos del Editor de formas,
guardamos, compilamos y ejecutamos la aplicacin.







22. Hasta este punto la aplicacin
solo permite marcar los registros
y desmarcarlos pero no hemos
hecho nada con ellos. Solo le
dimos la funcionalidad al Browse
de articulos para marcar sus
registros.







_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 156
www.gopac.com.mx
cursosgopac.com.mx



5..2. FiItrar Ios registros marcados de un Browse.

Este template cuenta con un control (boton) que al presionarlo nos permite ver solamente los
registros que estan marcados en el SET.

1. Lo priemero que necesitamos hacer es abrir nuestro browse de articulos, en el diseador de
ventanas.


2. De los control templates seleccionar, el
BrowseOptTagFilter y ponerlo sobre la
venatana, esto dejara un boton sobre la
ventana.



3. En las acciones de ese boton, encontraremos 3
pestaas, una es Tag Storage (Almacenamiento
de las marcas), Button Appearance (Apariencia
del boton), MisceIIaneous (misaelaneos).En la
seccion Tag Storage seleccionamos el Memory
Set y el Tag Set ser el numero 1.





4. En la Seccion Button Appearance seleccionamos
el Boton Icons, Y marcamos el Check
Automatically add icons to button y seleccionamos en que lado queremos la imagen. En este
caso seleccionamos (Left).


5. En la seccion Miscellaneos le asignaremos la
funcion de mostrar todos los registros marcados
de nuevo. Para hacer esto marcamos el check de
Switch to "show aII" with Untag AII] Button y
en el Drop "Untag AII" Button: seleccionar la
etiqueta del boton ?UntagAII desmarcar todos.














_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 157
www.gopac.com.mx
cursosgopac.com.mx


6. Salimos del editor de ventanas, guardamos y
compilamos la aplicacin, y el resultado se
muestra en las siguientes figuras donde vemos,
antes de presionar el boton todos los registros
incluyendo los marcados y en la otra figura solo
vemos los marcados.





7. En imprtante darnos cuenta que el boton
que nos sirve para mostrar solamente los
registros marcados camba su etiqueta del
Show Tagged a Show All.










8. Tambien podemos regresar a que se muestren todos si
presionamos el boton Untagg All.



























_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 158
www.gopac.com.mx
cursosgopac.com.mx


5..2.2 Procesos y Reportes de Registros Marcados

FiIter Tagged Records in a Process or Report (tension %emplate)
Una vez que el usuario ha marcado los registros, estos registros no haran nada por ellos mismos,
pero si podemos imprimirlos en un reporte o procesarlos ya sea para modificarlos o para borrarlos.

Esto se logra con solo agregar un Extensin Template !rocees %ag Filter en el reporte o procesos
que queremos correr, ademas es necesario configurarlo.

El Extensin template cuenta con 2 configuraciones importantes dividios en 2 TABS el TAG
STORAGE y el OPTONAL FLTER SETTNGS.

Tag Storage Tab (AImacenamiento de Ias Marcas)
En esta opcion del Extension template se configura el metodo de marcado selecionado (Memory
Set, Disk, o Byte).

OptionaI FiIter Settings Tab (Configuracion de Ios registros fiItrados)
En esta opcion se establecen las acciones a seguir en dos casos cuando no hay registros
marcados y cuando si hay registros marcados.

If No %ags ist:
Process aII records if no tags exist Si no hay registros marcados cuando el repoerte o
el proceso se llamado entonces automaticamente se procesaran todos los registros si esta opcin
del template se encuentra en ON. Y si se encuentra en OFF entonces se activara el metodo
NoRecords y enviara el mensaje al usuario.

Abort procedure if no tags exist S la opcion anterior est OFF, entonces esta abortara
el proceso.


"Aborting" Message Si la opcin anterior "Abort setting esta marcada con ON,
entonces puedes especificar un mensaje opcional en esta parte.

If %ags ist:
OptionaI fiIter if tags exist En algunos casos es necesario darle al usuario la opcion de
procesar todos los registros o solo los marcados.

FiIter Question Si la opcion anterior es activada ON, entonces aqui se configura el
mensaje que le aparecera al usuario.















_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 159
www.gopac.com.mx
cursosgopac.com.mx


5..2.3 Procesar Registros Marcados

En este ejercicio utilizaremos el proceso que ya existe de Cambia!recio para llamarlo desde el
browse de Articulos y que procese solo los registros marcados.


1. En nuesta aplicacin selecionamos el
procedimiento Cambia!recio, y abrimos sus
extencion .


2. Agregar el Extencion Template (!rocees %ag
Filter),

3. Al extencion template se le configura el
MEMORY SET, en este caso pondremos el 1,
ya que es el mismo que tiene asigando el
browse de Articulos, y de esta manera por
medio del Numero de Set de Memoria el
proceso se relaciona con los registros
marcados.



4. Entamos en la seecion WINDOW del proceso Cambia precio, para
seleccionar la ventana

5. En sus propiedades, en el tab Extra marcar la opcion
MD.



6. Cerramos las propiedades del proceso y entramos al
formateador de ventana del Browse de Articulos.






7. Agregamos un boton que llama al proceso
CambiaPrecio, el cual solo procesar los registros
marcados.


8. En la Seccion Procedures del Browse de articulos selecionamos el proceso CambiaPrecio.







_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 160
www.gopac.com.mx
cursosgopac.com.mx



9. Depues de que el proceso termine la ejecucion, es
necesario que el Browse de articulos se refresque
para que muestre los cambios de precios a los
articulso marcados. Esto se logra agregando una
liena de codigo en el accepted del boton que llama
al proceso de CambiaPrecio, aplicando el metodo
ResetFromBuffer al Browse de Articulos. Para esto
agregaremos la siguiete linea de codigo en el
Embed Accepted BRW.ResetFromBuffer.





10. Guardamos la apcliacion, compilamos, Para probar la
funcionalidad abrimos el borwse de Articulos, marcamos
algunos articulos y presionamos el boton de Cambia Precio,
depues de asignarle el porcentaje precionamos el Boton de
nicar.







11. En la figura se muestra el cambio de precio de los
articulos marcados unicamente.










5..2.4 Reportes de Registros Marcados
En este ejercicio utilizaremos el reporte que ya existe para imprmir etiquetas de articulos
Reptiquetas para llamarlo desde el browse de Articulos y que procese solo los registros
marcados.


12. En nuesta aplicacin selecionamos el
procedimiento Reptiquetas, y abrimos sus
extencion .


13. Agregar el Extencion Template (!rocees %ag
Filter),

_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 161
www.gopac.com.mx
cursosgopac.com.mx

14. Al extencion template se le configura el MEMORY SET, en este caso pondremos el 1, ya que
es el mismo que tiene asigando el browse de Articulos, y de esta manera por medio del
Numero de Set de Memoria el proceso se relaciona con los registros marcados.



15. Cerramos las propiedades del reporte y entramos al Editor
de ventanas del Browse de Articulos.












16. Agregamos un boton que llama al proceso
CambiaPrecio, el cual solo procesar los registros
marcados.


17. En la Seccion Procedures del Browse de articulos
selecionamos el reporte Reptiquetas.











18. Guardamos la apcliacion, compilamos, Para probar la
funcionalidad abrimos el borwse de Articulos, marcamos
algunos articulos y presionamos el boton de Etiquetas, y
validamos que se impriman solo las etiquetas de los
articulos marcados.












_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 162
www.gopac.com.mx
cursosgopac.com.mx

5.2.0 Enviar Informacin a ExceI

Para mandar los datos que tenemos registrados en nuestos archivos a Excel desde una
aplicacin en clarion, es necesario tener Instaldo y registrado EasyExcel Template el
cual consta de una Clase y un Conjunto de templates, que te dan la de utilizar
Microsoft Excel desde tus aplicaciones de Clarion.
Con EasyExcel puedes exportar datos desde los programas de clarion, crear graficas,
escribir comentarios en las celdas , cambiar Fonts y colores , dibujar bordes a las
celdas, agregar, renombrar, borrar, esconder hojas, imprimir y guardar documentos.
Entre los Templates mas utilizados de EasyExcel se encuentran los $iguientes
%emplates Requeridos:
Cualquier otro template que se necesite se debe insertar entre entre estos dos
(excepto los contol Templates)
O Init An ExceI TempIate: nicializa un Objeto Excel
O KiII An ExcIe TempIate: Finaliza un Objeto Excel

Bulk data export templates:

O QUEUE2EXCEL TEMPLATE: Exporta el contenido de un Q&E&E a una hoja en
Excel, ademas crea los encabezados de la tabla, y se configuran el font, color y
bordes.

O LIST2EXCEL TEMPLETE: Exporta el contenido de un List Box que se muestra
en una ventana, opcionalmente se incluye el encabezado.

Data import templates:

O Get Range Template : Importa datos desde un rango selecionado de una hoja
de Excel a un Q&E&E.

Change cells appearance templates:

O Set font : Configura el FONT, Estiloy Color de un rango de celdas.
O Set Colour : Configura el color de fondo de un rango de celdas.
O Set format : Configura el Formato de un rango de celdas.
O raw Table : Dibuja los borders in una hoja de Excel.
O Set conditional format : Configura el formato condicionado de un rango de
celdas.











_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 163
www.gopac.com.mx
cursosgopac.com.mx



5.2. Aadir Easy ExceI a Ia apIicacin

Despues de registrar los templates, lo primero es insertar en la aplicacin un lobal
extension template. Para que este disponible en toda la aplicacin y porder utilizarlo.




1. En la ventana de la aplicacin, presionar el Boton
"Global".






2. En la ventana de Global seleciona el boton de "Extension".




3. Precionar el boton de Insert para abir la ventana de
Template.




4. De la ventana de Global Templates
$elecionar el EasyExcel Global
- Global Support for EasyExcel
Template.


5. Preciona OK y salir de Global.

NOTA: Adems de agregarlo en el Global Extensin de la aplicacin es necesario
agregarlo en las extenciones de cada modulo donde se utilice en Template.


5.2.2 Mandar Datos a ExceI

Para este ejercicio mandaremos el contenido de la tabla Articulos a Excel, esto lo haremos de dos
maneras, una es mandando todo el contenido de la tabla y la otra solo mandaremos los registros
marcados previamente con el Template SuperTaggin.

1. En las propiedades del Procedimiento del Catalogo de
articulos agregar el Extencin template
asycelLocal.



_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 164
www.gopac.com.mx
cursosgopac.com.mx


2. Entrar al editor de ventanas y agregar un Boton con la
Etiqueta Enviar a ExceI.












3. Entrar a la Ventna de Embeded Source, con Doble
click en el boton que agregamso en el paso anterior.


4. Localizar el evento Accepted del Boton Enviar a Excel
y mover el cursor sobre punto Generated Code y
presionar el boton nsert.




5. En la ventana Embed Type muestra 3 opciopnes,
llamar un Procedimiento (CaII A Procedure), nsertar
codigo Fuente (Source) e nsertar un Code template.






6. En esta ventana buscar la Clase CIassEasyExceIABC y hacer
doble click sobre el code template EEInit - Init ExceI Object.



7. En el momento de insertar el code template, se abre su ventana
de configuracion en las cuales tenemos las opciones que
controlan el comportamiento del Objeto de Excel que queremos
abrir.










_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 165
www.gopac.com.mx
cursosgopac.com.mx


8. Para agregar el Code Template List2ExceI, en la
ventana Embed Type, Debemos buscar la Clase
CIassEasyExceIABC y hacer doble click sobre el
code template EEList2ExceI - Export Iist Contents
to ExceI.


9. Al insertar este code Template List2ExceI se abre su ventana de propiedades. En la cual se
puede configurar el formato de los datos asi como el encabezado.


O TAB GENERAL:

o ListControI: En este lugar se especifica la
etiqueta del browse que estamos
mandando a excel.


o Start at: En este lugar se especifican a partir de
que columna y que renglon iniciara la
exportacion de los datos.

o Export Propierties: En las propiedades de
exportacion se configura: el Modo de
exportacin, el auto ajiste, o si se exporta
el campo tal y como va.



O TAB CONTENT
o Borders: Se especifica el tipo de borde que
tendra el set de datos que se exportara.

o BackGround: Se especifica el color del fondo
que tendra la seccion de datos que se
exportan.

o Font: Se expecifican las caracteristicas de la
fuente con la que se exportaran los datos.



10. As mismo agregar el Code Template KiII ExceI Object. Para deshabilitar o cerrar el Objeto
de Excel.










_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 166
www.gopac.com.mx
cursosgopac.com.mx


11. Cerramos la ventana de source, guardamos, compilamos y probamos la aplicacin,
presionando el boton de Exportar a Excel, en el browse de articulos.




















































_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 167
www.gopac.com.mx
cursosgopac.com.mx


5.3.0 Enviar Correo EIectrnico desde Ia ApIicacin

Para enviar un correo electronico desde dentro de una aplicacion utilizaremos el Template MaiI
and fax. Este s un templats muy util ya que entre otras cosas, con el se peude :

O Se puede enviar correos desde dentro de una aplicacin.
O Se puede automatizar el envio y lectura de correos en fomra trasnparente para el usuario.
O Se pueden enviar correos en forma masiva a multipes destinos.
O Se pueden enviar Copias Ocultas(BCC) de los mensajes o E-mail.
O Se pueden enviar correos aunque el usuario este offline, y al reconectarse su clietne de
correo (Outlook Express) los enviara.
O Es posible abrir la libreta de direcciones que ya tienes desde dentro de la aplicacin.


5.3. En este ejercicio enviar un correo a una direccion seIecionada de Ia Iibreta de
direcciones adjuntandoIe un arhivo PDF, generado por eI reportes de Ventas desde dentro
de Ia apIicacin.

Antes de empezar a utilizar el templates MAL and FAX, es necesario instalarlo y registrarlo en el
template registry asi como el resto de los templates.

1. Antes de poder usar cualquierea de los MAP Templates, es
necesario incluir MAP Library en la acplicacin. Para esto
presionamos el boton Global en la aplicacin.


2. Precionamos el boton de Extensions y luego el boton de
Insert, para agregar un Template de extension a la apcliacin.


3. Seleccionamos y elegimos el MAPILibrary GIobaI Extension
TempIate de la
ventna de templates.



4. Este template mostrara una serie de configuraciones, pero para
empesar utilizaremos los default.




5. Es necesario tambien agregar el global Extensin Template Mail and Fax Global Data variables
MAPIMessageGIobaIs. El cual define una serie
de variables globales preconfiguradas, las
cuales utilizaremso mas adelante.







_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 168
www.gopac.com.mx
cursosgopac.com.mx



6. Depues de agregar el los Templates Glopbales y las Variablel globales de Mail and Fax
agregaremos un nuevo procedimiento, en el cual configuramos los datos necesarios para un
correo electrnico, este mismo proceso llamara la ejecucionde un reporte el cual a su vez
generara el archivo PDF que adjuntaremos al nuetro correo. Para agregar un nuevo
porocedimiento a nuestra aplicacin estando en el arbol de la apalicacin presionamos la tecla
Insert, y en el nombre del procedimiento, teclear RepEnvMaiI.


7. Seleccionamos el asistente para crear la ventana (Window
Wizard) y seguimos sus pasos para crear una venta solo con
boton de cerrar en el Window Customization.








8. En esta ventana agregaremos las variables globales MM:From, MM:ToAddress, MM:Subject,
MM:PathName, MM:MessageText que tiene este template y las pondremos sobre las
ventana.















9. En esta misma ventana, agreamos el Control template MSAddress Call the MS-Mail Address
Dialog, el cuan agrega un boton que llama a la ventana para elegir la libreta de direcciones de
Outlook express.




10. En las acciones de este boton asiganamos la
variable donde se guardara la direccionde
correo seleccionada y ademas seleccionamos
el tipo de ventana de direcciones de correo,
Address-Iist.




_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 169
www.gopac.com.mx
cursosgopac.com.mx



11. En la ventna se mostrara un boton para elegir,
la direccin de correo electrnico que sera el
destino, este boton llama la ventana de
seleccin de direcciones de Outlook Express.








12. De los control templates selecionaremos el
MSSend CaII the ManuaI MS-MaiI Send, y
lo pondremos sobre la ventana.


13. En las acciones del boton Send, Vienen preconfiguradas las
variables globales del template.








14. Antes de compilar y probar el template debemos agregarle valores a las variables que forman
parte de la configuracin del template, como el Tema y el Texto que tendr el correo, asi como
el nombre de algun archivo Adjunto y la ruta de dicho archivo. Para esto en el Punto de
Embed, Open Window tecleamos el siguiente Codigo :

!LIenar variabIes de configuracin de correo

MMom = 'correo_origen@hotmaiI.com'
MM:Subject = 'Enviado en ' format(today(),@D8.)
MM:MessageText = 'Reporte de ventas'
MM:PathName = 'DOC_EXP\RepVentas.pdf'
DispIay()


15. Como se puede ver en el codigo anterior a la
variable MM:PathName se le agrega la ruta de
donde se encuentra el archivo PDF del reporte de
ventas, este reporte sera llamado desde el boton
de enviar e-mail. Antes de Parent Call.





16. Compilamos y Probamos.

_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 170
www.gopac.com.mx
cursosgopac.com.mx



5.4.0 Administrador de Cambios

Es imprescindible tener un manejo adecuado de las versiones de los archivos de datos.
As mismo es necesario contar con una herramienta que pueda administrar de manera
automtica los cambios que han realizado en las estructuras de las bases de datos, sin
que esto implique tener que ser modificadas directamente por el desarrollador, sino que la
misma aplicacin detecte y realice los cambios necesarios. Es un template que cada
desarrollador debera usar.

File Manager 3 ( FM3 ) genera la informacin de los archivos utilizando tcnicas de
actualizacin directamente desde la aplicacin, conocida como AutoUP, nicamente
cambie el diccionario y recompile FM3 se encarga de lo dems, al momento de ejecutar el
programa FM3 automticamente entra en accin actualizando la estructura de las tablas a
la ultima versin. Esto implica no volver a generar programas de conversin.


FuncionaIidad


5.4.2 Auto Up - ActuaIizacin automtica de archivos

Permite a la aplicacin actualizar automticamente los archivos cuando estos
necesiten ser actualizados. Esto significa que lo nico que uno tiene que hacer
es realizar los cambios en los diccionarios y recompilar y distribuir. AutoUp
realiza lo dems. Soporta los drivers de Topspeed, Clarion y Btrieve. Todas los
tipos de campos son soportadas excepto los tipos dimensionados y BLOBS,
pero soporta campos tipo arreglos. Permite actualizar mltiples versin en un
solo paso sin necesidad de pasar de versin en versin, as mismo permite al
usuario utilizar sus datos respaldados de versiones anteriores. Adems que
permite borrar, cambiar, remover llaves, campos de llaves, campos de la tabla,
soportando tablas encriptadas y con cambios en las claves de acceso. Es un
solo template de tipo GLOBAL EXTENSON. Funcionando correctamente en
aplicacin con DLL's, con el template DET de Mosley Group. Aplicaciones d 16 y
32 bits, Local y Stand Alone.

5.4.3 AutoNet - ActuaIizacin de Archivos en red

Esta diseado para permitir la actualizacin de archivos y DLL's a travs de la
red, fcilmente. Esto permite actualizar la aplicacin mucho mas fcil en una red,
actualizando nicamente el servidor. Todas las estaciones se actualizaran a
travs del servidor de manera automtica. Esto significa que los archivos de las
aplicaciones pueden estar almacenadas localmente en cada estacin sin que
esto implique el mantenimiento normal a esos archivos. Esto es importante para
reducir el trafico en la red las velocidades en la transmisin de las estaciones.
AutoNet trabaja en mantener el directorio en el servidor y en la estacin de
trabajo en sincronizacin. Cada vez que la aplicacin se corre esta checa los
archivos locales contra los archivos en el servidor, si alguno de ellos tiene una
actualizacin estos son actualizados a la estacin de trabajo

5.4.4 AutoBuiId - Administracin de Archivos por Usuario

AutoBuild aade rutinas de Administracin de Archivos a la aplicacin. Presenta
una lista de los archivos de datos y permite realizar mantenimiento bsico a los
_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 171
www.gopac.com.mx
cursosgopac.com.mx

mismos como reorganizar llaves ( BuiId ), remover registros borrados de los
archivos ( Pack ), desbloquear archivos o registros ( ReIease ), consultar el
nmero de registros que contiene un archivo ( Info ) y realizar llamados a la
herramienta de TPSFix para arreglar archivos corruptos tipo TPS ( Fix ).


5.4.5 AutoFix - Integracin con TPSFix

Permite automticamente detectar cuando un archivo se encuentra corrupto, e
invoca al TPSFix. Auto Fix trabaja verificando que archivo se esta abriendo
cuando ocurre un error fatal. Desafortunadamente no podemos hacer nada con
el error fatal pero AutoFix detecta el archivo y la prxima vez que se ejecute el
programa ejecutara TPSFix para arreglar el archivo que se detecto.

5.5.5 C-Scan - Browser para usuario finaI

C-Scan es un programa para visualizar y editar archivos de datos, parecido al
Browse. Permite cambiar los formatos de las columnas. Agrega la funcionalidad
de realizar una bsqueda columnar por un valor determinado, as como
bsquedas parciales o bsquedas en cualquier parte ( bsquedas parciales de
strings en cualquier parte de un String )


































_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 172
www.gopac.com.mx
cursosgopac.com.mx



TopScan ( TopSpeed Database Scanner UtiIity )


El %op$can es la Herramienta de Exploracin de Tablas TopSpeed, que permite editar y visualizar
los datos de las tablas %!$. Originalmente diseada para permitir dar acceso a este tipo de tablas
fuera de una aplicacin, ahora incluye caractersticas que permite actualizaciones masivas, anlisis
detallado de la tabla, as como una gran variedad de opciones de visualizacin de los datos.

El programa %op$can ( %!$CAN. ) se encuentra en el directorio \bin de la instalacin de
Clarion. Por omisin el programa de instalacin crea una asociacin de todos los archivos de
extensin %!$ para que sean accesados por el programa al presionar doble click sobre estos
archivos.

Para distribuir el programa de %op$can , el cual puede ser distribuido libremente por los usuarios
registrados de Clarion para ser usado por o para sus aplicaciones, se requieren de anexar los
siguientes archivos :

TOPSCAN.EXE
C55RUN.DLL
C55ASC.DLL
C55TPS.DLL
C55DFIF.DLL
TOPSCAN.HLP

Opciones de Ia Ventana de TopScan

Abre la lista que contiene las tablas %opspee/ abiertas mas recientemente.

Abre una tabla %op$pee/. Puede seleccionar una tabla ya sea para visualizarla o
procesarla. Si la tabla esta protegida con contrasea, ser necesario ingresar una
contrasea vlida.

Permite grabar la tabla con los cambios que se registraron. Esta opcin esta disponible
nicamente cuando se realiza un cambio desde la ltima vez que se grabo.

Aade un registro nuevo a la tabla y permite introducir datos en los campos del registro.


Permite pasar a modo de edicin en el registro que esta situado, permitiendo
modificar los datos de los campos del registro.

Borra el registro seleccionado de la tabla


Mueve la columna seleccionada a la izquierda


Permite modificar el espaciado, justificacin, encabezado y mscara de la columna
seleccionada
Mueve la columna seleccionada a la derecha
_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 173
www.gopac.com.mx
cursosgopac.com.mx


_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 174
www.gopac.com.mx
cursosgopac.com.mx

TopScan FiIe AnaIyze

Esta opcin se encuentra en el men principal File / File Analyze. Permite desplegar informacin
estadstica de la tabla %op$pee/ incluyendo ruta completa de la ubicacin de la tabla, contrasea,
tamao y hora, as mismo informacin del registro como tamao y nmero de campos. En cuanto a
la informacin de la llave indica la etiqueta de la llave y el nmero de registros referenciados por
cada llave. Para tablas %op$pee/ que contengan mltiples tablas, permite desplegar la
informacin individual de cada una de las tablas.

TopScan FiIe Layout

Esta opcin se encuentra en el men principal File / File Layout. Representa la informacin de la
estructura de la tabla %op$pee/ en cdigo fuente de Clarion, la cual se puede tanto mandar a la
impresora como grabar en un archivo tipo %%.

TopScan Mass Update

Esta opcin se encuentra en el men principal File / Mass Up/ate. Esta opcin permite actualizar
cualquier campo de toda la tabla. Permite cualquier expresin o valor a reemplazar el valor actual,
o seleccionar de la lista e invocar al generador de expresiones, para generar una expresin vlida
que se evaluara y realizara el cambio. En la ventana se despliegan los nombres de los campos,
expresiones , el valor anterior y el valor actual. Adems existe una columna que despliega una
marca Verde o una Cruz roja, que indica si la expresin o valor que se esta utilizando son vlidos o
no. Los cambios son realizados hasta que se presione el botn de Apply

Nota : Para mayor informacin sobre las dems funciones permitidas por el %op$can, consulte la
ayuda en lnea del %op$can
_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 175
www.gopac.com.mx
cursosgopac.com.mx

TpsFix ( TopSpeed Database Recover UtiIity )

El sistema de archivos %op$pee/ esta diseado para reparar la mayora de los errores de manera
automtica. En caso que los datos de la tabla estn fsicamente daados durante una anomala del
sistema, la herramienta de recuperacin de archivos de %op$pee/ ( %!$FI. ) permite
recuperar la parte de la informacin que no esta daada de la tabla.

El %psFi es una herramienta de reparacin en casos de emergencia y no debe de ser usada bajo
situaciones normales. Unicamente debe de utilizarse cuando la tabla se encuentra daada.

%psFi lee el archivo que esta daado y escribe los registros recuperados en una nueva tabla.
Utiliza la informacin que esta almacenada en los encabezados de las tablas o revisa las partes no
daadas para recuperar la informacin de la tabla. Opcionalmente o en caso necesario que este
daados los encabezados de la tabla ser necesario indicarle una tabla de ejemplo conteniendo la
estructura de la tabla y de las llaves de la tabla a recuperar.

La herramienta esta diseada para trabajara interactiva o transparentemente va lnea de
comandos y parmetros. nteractivamente, permite utilizar la herramienta para recuperar las tablas
daadas y suministrar los parmetros necesarios va las ventanas de dialogo. Utilizando la lnea
de comandos con parmetros, puede incorporarse esta utileria a la aplicacin utilizando el
instruccin Run() .


Funcionamiento Interactivo :

1. nicie la herramienta de %psFi que se encuentra en el grupo de programas de Clarion

2. En el la seccin de $ource ( file to Recover )
especifique el nombre de la tabla a recuperar o
presione el botn de Browse para seleccionarla.

3. En caso de que la tabla contenga contrasea
digitelo. En caso de que la tabla contenga mltiples
tablas cada una de ellas deber de contener la
misma contrasea.

4. Opcionalmente, en la seccin de Destination ( result file ) especifique el nombre de la tabla
en donde se grabaran los registros recuperados. Por omisin se aade la extensin %!R al
nombre de la tabla rigen ( $ource ). Este parmetro es opcional si es omitido, las tablas
originales son sobrescritas y respaldadas como son creadas. La tabla origen es renombrada
con la extensin %!, donde x es un nmero incremental desde 1 a 9 por cada vez que es
creado nuevamente la tabla. Si los nueve nmeros son usados, las tablas subsecuentes
tendrn extensin %! y sern sobrescritas.

5. Si la tabla destino lleva una contrasea diferente a la original digite la contrasea.

6. Presione el botn de Net
_abc Clarion Apndice : Herramientas Adicionales

Gopc Soluciones ntegrales, S.A. de C.V. 176
www.gopac.com.mx
cursosgopac.com.mx

7. En caso de ser necesario , especificar la
tabla ejemplo. La tabla ejemplo es utilizada
para determinar la estructura de la tabla as
como la definicin de las llaves, en caso de
que estas reas de la tabla origen estn
daadas.

Nota : Recomendamos ampliamente enviar o
generar la aplicacin final con tablas
ejemplos, en caso de que llegue a pasar
una anomala, se tengan las tablas para
poder regenerar las tablas daadas.

8. Si la tabla ejemplo contiene alguna contrasea, digitela.

9. Si desea que la utileria re-genere las llaves, active la casilla de Buil/ eys, en caso de omitir
esta opcin las llaves sern regeneradas por la aplicacin original cuando esta accese la tabla.

10. Si desea que se utilice la informacin del ncabeza/o de la tabla origen active esta casilla.
Utilizar la informacin del ncabeza/o optimiza el rendimiento de la utileria, pero no debe de
ser utilizado en caso de que se detecte que el ncabeza/o esta corrupto. Si es omitido la
herramienta buscara toda la informacin de la tabla que se pueda recuperar.

11. Si la aplicacin utiliza archivo de Ambiente ( Locale. NV ) para secuencias de caracteres
diferentes, especifique el archivo necesario .

12. Si la tabla utiliza atributo OEM para el control de la secuencia de caracteres active esta casilla.

13. Presione el botn de $tart para iniciar el proceso de recuperacin

Nota : Si la herramienta no detecta ningn error durante el proceso, aparecer un mensaje
informando que no fueron detectado ningn error .

_abc Clarion Apndice

Gopc Soluciones ntegrales, S.A. de C.V. 177
www.gopac.com.mx
cursosgopac.com.mx







































Estructura Acme,
DatamodeIIer Acme,
Informacin ReIevante



Objetivo

Breve introduccin al uso y manejo de los
Wizatrons para mostrar las ventajas de su uso,
as mismo mostrar las herramientas adicionales
de Clarion 6.0
CIarion para Windows
Introduccin






Apndices
_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 142
www.gopac.com.mx
cursosgopac.com.mx

APENDICE I - Estructura Diccionario Acme

Nombre : PooI ( Tabla a generar )
Prefijo : POO
Opciones :
Llaves :

GeneraI
Tipo

Long.

Picture
Attributes HeIp VaIidity
Check
Window Report
Codigo Decimal 5 @N05 Mess/Tip String String
Nombre String 40 @S40 Word Capitalize Mess/Tip Cannot Be 0 Entry String
Domicilio String 40 @S40 Word Capitalize Mess/Tip Cannot Be 0 Entry String
Telefono String 15 @S15 Mess/Tip Entry String
RFC String 15 @K -######-???KB Mess/Tip Cannot Be 0 Entry String


Nombre : Vendedor ( Tabla a generar )
Prefijo : VEN
Opciones :
Llaves : PKCodigo por codigo attributes ( ,2,3,5 ) options NO AUTO POPULATE
AKNombre por nombre attributes ( 5 )
AKRFC por RFC attributes ( 1,5 )

GeneraI
Tipo

Long.

Picture
Attributes HeIp VaIidity
Check
Window Report Der.
Codigo Decimal 5 @N05 Mess/Tip String String POO
Nombre String 40 @S40 Word Capitalize Mess/Tip Cannot Be 0 Entry String POO
Domicilio String 40 @S40 Word Capitalize Mess/Tip Entry String POO
Telefono String 15 @S15 Mess/Tip Entry String POO
RFC String 15 @ -######-??? Mess/Tip Cannot Be 0 Entry String POO

Nombre : CIiente ( Tabla a generar )
Prefijo : CLI
Opciones :
Llaves : PKCodigo por codigo attributes ( ,2,3,5 ) options NO AUTO POPULATE
AKNombre por nombre attributes ( 5 )
AKRFC por RFC attributes ( ,5 )
FKVendedor por vendedor + nombre

GeneraI
Tipo

Long.

Picture
Attributes HeIp VaIidity
Check
Window Report Der.
Codigo Decimal 5 @N05 Mess/Tip String String POO
Nombre String 40 @S40 Word Capitalize Mess/Tip Cannot Be 0 Entry String POO
Domicilio String 40 @S40 Word Capitalize Mess/Tip Entry String POO
Telefono String 15 @S15 Mess/Tip Entry String POO
RFC String 15 @K -######-???KB Mess/Tip Cannot Be 0 Entry String POO
Vendedor Decimal 5 @N05 Mess/Tip Must be in Ven Entry String
Saldo Decimal 8.2 @N$11.2 Mess/Tip String String

_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 143
www.gopac.com.mx
cursosgopac.com.mx

APENDICE I - Estructura Diccionario Acme

Nombre : Factura ( Archivo a importar )
Prefijo : FAC
Tipo : TPS
Opciones :
Llaves : PKNumero por codigo attributes ( ,2,3,5 ) options
AKFecha por fecha + cIiente + numero
FKCIiente por cIiente + numero

GeneraI
Tipo

Long.

Picture
Attributes HeIp VaIidity
Check
Window Report
Numero Decimal 5 @N05 Mess/Tip String String
Fecha Long @D6B n.Value Today() Mess/Tip Spin String
Cliente Decimal 5 N05 Mess/Tip Must be in Cli Entry String
Subtotal Decimal 8.2 @N$11.2 Mess/Tip String String
VA Decimal 8.2 @N$11.2 Mess/Tip String String
Total Decimal 8.2 @N$11.2 Mess/Tip String String
Condiciones String 30 @S30 Mess/Tip Entry String

Nombre : DetaIIe ( Archivo a importar )
Prefijo : DET
Tipo : TPS
Opciones : NO AUTO POPULATE
Llaves : PKFactura por factura + rengIon attributes ( ,2,3,5 ) options
AKFacArt por factura + articuIo attributes ( ,5 )
FKArticuIo por articuIo

GeneraI
Tipo

Long.

Picture
Attributes HeIp VaIidity
Check
Window Report
Factura Decimal 5 @N05 n.Value
FAC:Numero
Mess/Tip Must be in Fac Entry String
Renglon Decimal 3 @N03 Mess/Tip String String
Articulo Decimal 5 N05 Mess/Tip Must be in Art Entry String
Cantidad Decimal 8.2 @N11.2 Mess/Tip Cannot be 0 Spin String
Precio Decimal 8.2 @N$11.2 Mess/Tip Entry String
VA Byte @N02 Mess/Tip String String

Nombre : FamiIia ( Archivo a importar del Diccionario BASE.DCT)
Prefijo : FAM
Tipo : TPS
Opciones : SmaII, EditInPIace
Llaves : PKCodigo por codigo attributes ( ,2,3,5 ) options NO AUTO
POPULATE
AKDescripcion por descripcion attributes ( ,5 )

GeneraI
Tipo

Long.

Picture
Attributes HeIp VaIidity
Check
Window Report
Codigo Decimal 5 @N05 Mess/Tip String String
Descripcion String 30 @S30 Mess/Tip Cannot be 0 Entry String
VA Byte @N02 Mess/Tip String String
_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 144
www.gopac.com.mx
cursosgopac.com.mx

APENDICE I - Estructura Diccionario Acme

Nombre : ArticuIo ( Archivo a importar del Diccionario BASE.DCT)
Prefijo : ART
Tipo : TPS
Opciones :
Llaves : PKCodigo por codigo attributes ( ,2,3,5 ) options NO AUTO
POPULATE
AKDescripcion por descripcion attributes ( ,5 )
FKFamiIia por famiIia + descripcion

GeneraI
Tipo

Long.

Picture
Attributes HeIp VaIidity
Check
Window Report Der.
Codigo Decimal 5 @N05 Mess/Tip String String
Descripcion String 30 @S30 Word Capitalize Mess/Tip Cannot be 0 Entry String
Familia Decimal 5 @N05 Mess/Tip Must be Fam Entry String
Precio Decimal 8.2 @N$11.2 Mess/Tip Cannot be 0 Entry String
Existencia Decimal 8.2 @N11.2 Mess/Tip Spin String
Unidad String 1 @N1 Mess/Tip Must be in list Drop String
Fotografia String 255 @S255 Mess/Tip Entry String
VA Byte @N2 ni.Val = 15 Mess/Tip Spin String


Nombre : Pagos ( Archivo a importar de PAGOS.DBF)
Prefijo : PAG
Tipo : DBF / CIipper
Opciones :
Llaves : PKNumero por numero attributes ( ,2,3,5 ) options NO AUTO
POPULATE
AKTipo por tipo + fecha attributes ( 5 )
AKFecha por fecha
FKCIiente por cIiente + fecha

GeneraI
Tipo

Long.

Picture
Attributes HeIp VaIidity
Check
Window Report Der.
Numero Decimal 5 @N05 Mess/Tip String String
TipoDocto String 1 @S1 Word Capitalize Mess/Tip Must be in list Drop String
Cliente Decimal 5 @N05 Mess/Tip Must be in Cli Drop String
mporte Decimal @N$10.2 Mess/Tip Cannot be 0 Entry String
Fecha Date @D06B Mess/Tip Spin String

Nombre : LOGCLIENTES ( Archivo a CREAR)
Prefijo : LOG
Tipo : ASCII
Opciones:
Llaves :

GeneraI
Tipo

Long.

Picture
Attributes HeIp VaIidity
Check
Window Report Der.
CAMPOUNCO String 200 @S200 Mess/Tip String String



_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 145
www.gopac.com.mx
cursosgopac.com.mx


Nombre : NOTASCARGO ( Archivo a Crear en el diccionario)
Prefijo : NOC
Tipo : TPS
Opciones :
Llaves : PKNuero por Numero attributes ( ,2,3,5 ) options NO AUTO
POPULATE
AKFecha por fecha attributes ( ,5 )
FKCIiente por cIiente

GeneraI
Tipo

Long.

Picture
Attributes HeIp VaIidity
Check
Window Report Der.
Numero Long 5 @N10 Mess/Tip String String
Fehca Long 8 @D8 Mess/Tip Cannot be 0 Entry String
Cliente Decimal 5 @N05 Mess/Tip Must be Clien Entry String
mporte Decimal 8.2 @N$11.2 Mess/Tip Cannot be 0 Entry String





























_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 146
www.gopac.com.mx
cursosgopac.com.mx




APENDICE II - Data ModeIIer Estructura Diccionario Acme
_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 147
www.gopac.com.mx
cursosgopac.com.mx

APENDICE III - TempIates mas PopuIares

Existen en el mercado de Clarion templates que permiten agregar funcionalidad a las aplicaciones que
se desarrollan de una manera muy fcil y rpido. Funcionalidad que si nosotros mismos tratamos de
implementarla va a costar tanto en tiempo, esfuerzo y dinero una gran cantidad, contra la rapidez y
funcionalidad total de estos templates de empresas de terceros que se dedican exclusivamente al
desarrollo y prueba de estos accesorios.

A continuacin les mostramos las caractersticas mas comunes de los 4 Accesorios mas populares de
Clarion :

Creative Reporting TooIs (CPCS)

Es una de las herramientas para reportes ms difundida. Con ella creara fcilmente y actualizara
los sofisticados y complicados reportes del mundo de los negocios. CPCS provee total y
absoluto control del nivel de proceso de los reportes. Permite realizar bsquedas, guardar /
imprimir campos mltiples de otros archivos, leer / escribir / desplegar / imprimir imgenes en
campos BLOB; filtrar reportes con listas de seleccin al momento de ejecucin, impresin de
textbox de manera automtica, imprimr reportes desde informacin almacenada en queues.

FuncionaIidad :

O Definicin de Criterios de Cortes y Totales con Encabezados y Pies de Pgina para cada
nivel adicionalmente con Puntos de Cdigo y Frmulas para ser ejecutados antes / despus
de que cada corte ocurra
O Definicin de Views / Joins y Orders parametrizables
O .mpresin de pginas especficas desde el Previsualizador ( Ejemplo 1-3,5,6,10-22 )
O Reportes pre-formateados tipo Portrait, Landscape, Label, BusCard
O mpresin de pginas especficas
O mpresin de Reportes desde un Queue ( Ascendentes / Descendentes )
O Capacidad de "mpresin de un Registro" desde un Browse o Forma
O mpresin de Reportes a un Archivo de Texto
O Customizar las funciones de Preview, Minimizar Preview, Seleccin de mpresora
O Barra de Proceso, Spinner o Animaciones en la Ventana de Proceso
O Zoom Funciones Especiales
O Optimizar la mpresin en mpresoras de Matriz
O mpresin de Reportes a Archivos de Texto ASC
O Ventana de proceso Animada
O mpresin de Mltiples copias inclusive si la impresora no soporta mltiples copias
O Soporte para impresin Rpida de mpresoras de Matriz de Puntos
O Soporte de envi por E-mail del Reporte de manera automtica va un accesorio de CPCS
Adicional : C!C$- !DF - mailer ADDon
O Soporta Web Builder, ClarioNet y Connect


_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 148
www.gopac.com.mx
cursosgopac.com.mx

APENDICE III - TempIates mas PopuIares



Insight Graphing

Por mucho tiempo se haba estado esperando una herramienta que permitiera agregar grficas a las
aplicaciones desarrolladas por Clarion. nsight Graphics es el primer accesorio tipo Template que
permite agregar de una manera fcil grficas a Browses / Formas y Reportes, tanto de tipo Lineares,
Pie, etc.

FuncionaIidad :

O Grficas de Barra, Lineales y de Pay
O Configuracin de la Escala, Mltiples Leyendas, Puntos de Datos
O Vistas de la grfica y de la informacin
O Previsualizacin
O nterfaces con el Diccionario
O Registros, Sumas y Promedios
O Vistas, Mltiples Vistas Grficas, Mltiples Vistas por Campos
O nterfase Dinmica
O Botn de Previsualizacin al momento de diseo
O Soporta Campos para Graficar o Expresiones
O Soporte Dinmico de etiquetas basado en la informacin contenida en las Tablas
O Soporte de datos almacenados en Queues para graficar.
O Soporta Mltiples Vistas por Grfica y Mltiples Vistas por Campo
O Permite Mltiples Grficas en la misma ventana
O Permite el uso del Click Derecho del mouse incluyendo opciones como Zoom n, Zoom Out,
mprimir, Guardar como, etc.
O Permite definir la ubicacin del Grfico al principio o al final del reporte.
O Permite mltiples grficos en un solo detalle

Super Security

Es esencial el mantener un sistema de seguridad de acceso a sus datos. Este template permite
incorporar de una manera fcil y eficaz seguridad al acceso de sus datos en las aplicaciones, por
medio de diferentes niveles de seguridad o puertas, as como restringir el acceso a las diferentes
opciones de acuerdo a nivel del usuario

FuncionaIidad :

O Seguridad por niveles
O Seguridad por puertas
O Administracin de la Seguridad
O Opciones Asignadas o No Asignadas
O Configuracin de Mensajes
O Accesos Restringidos en operaciones Bsicas
O Seguridad en controles de Ventanas y Reportes
O Fcil restriccin a Procedimientos, Actualizaciones y Campos
O Agrege opciones de Habilitar o Deshabilitar, Esconder opciones de acuerdo al nivel de
seguridad del usuario
O Agrege una ventana de Login como primer nivel de Seguridad a su aplicacin



Mayor nformacin sobre estos y otros accesorios ventasgopac.com.mx
_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 149
www.gopac.com.mx
cursosgopac.com.mx

APENDICE IV - TempIates Freeware

Tambien existen accesorios ratuitos o Freeware, los cuales permiten agregar cierta funcionalidad a
nuestras aplicaciones, entre los cuales se encuentran y todas ellas las encuentran en
www.gopac.com.mx\downloads.htm :





CapFIash de SterIingdata

Es un extension template (freeware) para ser usado en un proceso ( !rocess ), el cual convertir los
campos tipo String a String tipo titulo (Tipo Titulo ), con las siguientes opciones :

. Puede definirse una lista de palabras que siempre sern minsculas . Ejemplo de, la , en etc.
2. Puede definirse por el usuario una lista de palabras que siempre sean maysculas
3. Campos ndividuales pueden ser excluidos
. Compatible con CW2002 a C5.5, tanto para ABC y Legacy



APENDICE IV - TempIates Freeware


CoIour AII de Simon Burrows

Conjunto de templates gratuitos, el template de ColourAll, el cual permite de una manera muy sencilla y
rpida agregar color condicionado a todo un rengln completo de un Browse, y no hacerlo de uno por
uno. Adems de incluir templates para crear directorios, Read Only Window, Screen Resolution, Open
Close Files, Add Wallpaper to every Window


Nova de Martin AIIen

Conjunto de Templates que nos permite imprimir directamente a impresoras de matriz de punto a travs
de su template Line!rint.


Locus de LocusSoftware

Conjunto de Templates para Clarion 2.00x, Clarion 4 Legacy / ABC, Clarion 5 ABC nicamente.
Contiene : Controles de validacin y bsqueda de Edit n Place de un Browse, Actualizacin en la
aplicacin sobre cambios de diccionario. Controles RTF, entre otros mas


Les recomendamos checar constantemente nuestra pgina www.gopac.com.mx en donde encontrara
informacin importante sobre Clarion y estar enterado de los ltimos acontecimientos, informacin,
cursos, promociones, etc. Adems lo invitamos a suscribirse a nuestro boletn electrnico mensual, en el
cual encontrara la informacin ms relevante del mes en lo que concierne a la herramienta. As mismo
tambien los invitamos a que visite la pgina de www.soItvelocity.com



Newsgroup

_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 150
www.gopac.com.mx
cursosgopac.com.mx

Recomendamos ampliamente suscribirse al grupo de noticias de SoftVeIocity 3088oftv0ocitycom en
donde encontrara una gran cantidad de foros de discusin en donde la comunidad de desarrolladores de
Clarion se rene para intercambiar ideas, preguntas, respuestas, etc.


www.tomruby.com/clarion

Esta pgina es el compendio de la mayora de los links que existen de Clarion, en caso de buscar
alguna informacin revisar esta pgina pueda minimizar el tiempo y esfuerzo de bsqueda, adems es
actualizada constantemente, pueden encontrar informacin sobre productos, accesorios, freeware, etc.



cursosgopac.com.mx

Les agradecemos cualquier duda, comentario o sugerencia que ustedes crean pertinentes a la direccin
de cursos.
_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 151
www.gopac.com.mx
cursosgopac.com.mx

APENDICE CatIogo de Accesorios


BackFIash Provee a los usuarios de la funcionalidad de respaldar sus datos con solo presionar un botn.
CW 4 J 5 J 5.5 A8C J Legocy y

LSZip Compression Library Librera de compresin de datos para Windows, que permite a los desarrolladores crear y manejar
los archivos tipo ZP estndares de la industria. Compatible con Pkzip y Winzip p/ Win 95, 98, NT y 2000.
CW 2 J 4 J 5 J 5.5



Date-Time TooIs Manejo de fechas, funciones fechas, informacin sobre zona de horarios y herramientas de agenda. Provee mas
de 50 funciones de fecha y de tiempo, adems de cdigo fuente y templates para diversas clases de calendario y agenda.





Insight Graphing Permite agregar grficas a ventanas y reportes. Completamente a travs de configurar templates, no requiere
agregar cdigo a mano. Soporta grficas de Barra, Pie, Pareto, Gantt, Tiempo, Dona.
CW 4 J 5 J 5.5 A8C J Legocy 32 b|ts






CLACom / CLACom Lite Permite generar interfaces con dispositivos de punto de venta, lectoras de cdigo de barras, bsculas,
instrumentos mdicos, sistemas PBX, mdem y cualquier dispositivo que se conecte a travs del puerto de comunicaciones.
Agrega fcilmente Transferencia de Archivos.
1J32 b|ts

Super Phone DiaIer Permite utilizar el mdem para realizar una llamada desde la aplicacin de Clarion. Realiza funciones
automticas despus de iniciar el marcado. Fcil de implementar especificando la configuracin de los elementos en una extensin
global y control local / code template. Especifique un nmero y automticamente ser marcado, especifique dos o ms, y el usuario
podr seleccionar cual marcar. A8C J Legocy

Winevent Un conjunto til de funciones AP de Windows, incluyendo funciones de control RS 232 ( puerto serial ), funciones de
sonido, de barras de tarea, de versiones de Window, etc. CW 2 J 4 J 5 J 5.5 A8C J Legocy


NetTaIk Agregue comunicacin TCP/P a las aplicaciones de Clarion, para establecer dialogo a travs de LAN, WAN e inclusive
nternet. ncluye objetos que permiten enviar y recibir correo, crear clientes WEB y FTP.
CW 5 J 5.5 A8C J Legocy 1 J 32 b|ts

NetTooIs Accesorio que permite generar aplicaciones en red robustas y a niveles ptimos. ncluye prototipos de funciones,
permiten obtener el control del NetWare y a sus libreras de 16 y 32 bit, as como a las clases NetWork las cuales proveen acceso a
Windows, NetWare y otras redes a travs del Proveedor del Ruteador Multiple.
CW 5 J 5.5 A8C J Legocy 1 J 32 b|ts

MaiI Fax TempIates Aada funcionalidad de envo y recepcin de Mails y Faxes, compatible con la mayora de los sistemas de
correo actuales. Soporta sistemas de correo Local o de nternet.




SpeciaI Agent Permite crear personajes del Microsoft Agent dentro de la aplicacin de Clarion. Estos pueden dar una demo de la
aplicacin, capacitar usuarios. Ensee al agente en tiempo de ejecucin, no necesita programar nada. CW 5 J 5.5
A8C J Legocy

Makeover Detecta automticamente el color del equipo y aplica un consistente estilo visual a toda la aplicacin. Disee su propia
apariencia, permita que las aplicaciones mejoren visualmente sin mucho esfuerzo. ncluye un Editor de Estilos, Estilos Ejemplos y
un conjunto de Botones. CW 4 J 5 J 5.5 A8C J Legocy 1 J 32 b|ts

Ticker Tape Adiciona uno o mltiples controles de texto que se desplaza por la ventana. Estos controles pueden desplegar
variables o texto fijo, diferentes colores y velocidades para cada control. CW 4 J 5 J 5.5 A8C J Legocy 1 J 32 b|ts

MessageEx Es una funcin mejorada que provee diferentes opciones para atraer la atencin del usuario ante determinado
mensaje. Ventanas de mensaje totalmente parametrizables, soporta juego de caracteres de Clarion.
CW 5 J 5.5 A8C J Legocy 1 J 32 b|ts
RespaIdos

Manejo de Fechas

Grficos

Comunicaciones /
Correo EIectrnico

Apariencia

_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 152
www.gopac.com.mx
cursosgopac.com.mx


SysAni Permite desplegar animaciones para aquellos procesos que tardan, esto mediante la utilizacin de los controles de
animacin del sistema. Ejecuta animaciones estndares de Windows e inclusive archivos tipo AV.
CW 5 J 5.5 A8C J Legocy 32 b|ts

SysList Control nativo para visualizar una lista tipo Explorer. Agrega una vista a una lista sin necesidad de cdigo. Agrega datos a
la lista desde un queue. Permite ordenar los datos seleccionando el encabezado de la columna. ncluye mas de 100 funciones para
manejar el control y la apariencia de la lista. Soporta nicamente listas no soporta manejo de tablas. CW 5 J 5.5 A8C J
Legocy 32 b|ts

Microsoft Tootips Support Library
Conjunto de templates genricos y libreras que proveen soporte completo a los controles de Tooltip de Microsoft, en las
aplicaciones Clarion. Permite personalizar todas las caractersticas de los tooltips : texto, color, forma, ttulos, iconos, etc. Permite
agregar la funcionalidad tipo "globo" de los tooltip del MSE. CW 5 J 5.5 A8C J Legocy 32 b|ts

CooITips Esta clase encapsula los controles de Windows Common Control Library del ToolTip. Permite agregar Tooltips a
regiones, "globos" multi lneas. ncluye cdigo fuente de la clase , documentacin en lnea, actualizaciones y soporte. CW 5.5 A8C

CapeSoft Message Box Permite crear una ventana personalizada de Mensaje, Stop y Halt, sin necesidad de re-escribir las
llamadas a mensajes actuales. Cdigo fuente completo, compatible con Special Agent y akeOver.
CW 4 J 5 J 5.5 A8C J Legocy

Simshape TempIates Este template permite agregar diferentes formas a los botones y a las cajas de seleccin, efectos de
mouseover y al presionar el botn. CW 5 J 5.5 A8C

xWinSet Permite al usuario final cambiar en tiempo de ejecucin prcticamente todas las propiedades principales de los objetos de
la ventana: tamao, tipo, color de fuente, color de fondo, tanto para controles agrupados como para controles individuales. CW 5 J
5.5

ReDesigner TempIates Standard / ProfesionaI Permiten al usuario final personalizar las pantallas en tiempo de ejecucin de
acuerdo a sus necesidades. Tan sencillo como si tuviera el editor de ventanas de Clarion en la aplicacin, el template permite al
usuario mover, cambiar de tamao los objetos, as como modificar las propiedades visuales, como el texto en los ttulos y botones,
tips y mensajes, fuentes, colores, etc. Simplemente aadir una extensin global a la aplicacin y definir un conjunto de teclas para
su activacin.




FiIe Manager 2 Genera Actualizacin de Archivos de Datos y Mantenimiento de Archivos de Datos, dentro de la aplicacin. Elimina
el error 47, simplemente agregue el template, cambie el diccionario y compile. ncluye AutoNET para actualizar programas y
archivos a travs de la red, AutoBULD y AutoFX para mantenimiento de tablas en tiempo de ejecucin. CW 2 J 4 J5 J 5.5 A8C J
Legocy 1 J 32 b|ts

Data Conversion TempIates Pretende de manera automtica convertir los archivos de datos cuando el diccionario de datos
cambie. Elimina el error 47. CW 5 J 5.5 A8C J Legocy

Data ModeIIer Editor grfico del diccionario de datos. Permite disear el diccionario de una manera ms fcil y rpida que por
mtodos convencionales, incluye advertencias y funciones de anlisis del diccionario.

RTF TooIs Es un Template de Clarion para Windows que permite al desarrollador
implementar en aplicaciones ABC los siguiente : 1. Provee un Code Template para convertir el control RTF de Softvelocity en
HTML. 2. Provee un control para crear un archivo HTM del contenido del control RTF. 3. Permite imprimir el contenido del control
RTF como texto Standard o como parte de un reporte de Clarion

Super Import / Export Permite copiar registros de una tabla a otra sin necesidad de cdigo. Clona todo o parte de una tabla.
Permite generar conversin de tablas a diferentes diseos o a diferentes drivers. Puede borrar los registros originales despus de
copiar los mismos, y mucho mas.


IMPEX Faculta al usuario de una manera fcil realizar una interfase de intercambio de datos mediante el uso del mtodo "drag &
drop". Soporta Dbase, Excel, HTML & ASC ( plano o delimitado ). CW 4 J 5 J 5.5 A8C J Legocy 32 b|ts

SearchFIash Permite realizar bsquedas de texto en todos los campos en todos los formatos con una bsqueda QBE.
CW 2 J 4 J 5 J 5.5 A8C J Legocy




Super FieId FiIIer Permite realizar cambios masivos a la base de datos sin necesidad de realizarlo manualmente, ni de generar
un procedimiento especial para cada situacin. deal para cambios de cdigo o estatus anuales. En tiempo de ejecucin permite
seleccionar el campo, el nuevo valor, el incremento para campos auto-numerados.

Herramientas para Archivos

_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 153
www.gopac.com.mx
cursosgopac.com.mx





VariView TempIates Permiten visualizar todas las variable y campos en tiempo de ejecucin al momento que la aplicacin se esta
ejecutando, incluye un visor de Eventos y de Valores de Ambiente.




MuIti-Proj Simplifica en todos los aspectos del desarrollo con Mult-DLLs. Permite realizar la compilar mltiples Aplicaciones o
Proyectos en un solo esfuerzo. Permite identificar que es lo que se esta exportando al DLL. Permite generar templates que
permitirn utilizar el DLL en otras aplicaciones. Multiversiones. CW 4 J5 J 5.5 A8C J Legocy

App-Ref Es una herramienta que permite verificar referencias cruzadas, comprobar la aplicacin y estandarizar, para
desarrolladores de Clarion. Permite localizar tablas, campos, etc. que no son usadas, comparar las caractersticas de las ventanas,
localizar donde son usados los campos.






Imaging TempIates Agregue almacenamiento de documentos y escaneo a su aplicacin Clarion. Soporta dispositivos TWAN e
utiliza los OCX's disponibles de Windows. Un conjunto completo de procedimientos y control template. Cdigo Clarion y Template.
CW 5.5 A8C J Legocy





Super Browse Manejo de Edit in Place, actualizaciones sin formas separadas. Permite utilizar los encabezados de las columnas
del Browse para ordenarlo, seleccionar otro Tab, o invertir el orden. Permite colores para identificar Browses, Tab activos, entre
otras muchas funciones.
CW 4 J 5 J 5.5


VirtuaI EIP ABC TempIates Templates que permiten transformar un forma ordinaria en un EP virtual. Tendr la conveniencia
de los puntos de cdigo normales y los controles estndares de una Forma as como los beneficios de un EP . CW 5/5.5 ABC /
Legacy

Queue Edit in PIace TempIates Permite crear una lista de datos en un queue con botones de actualizacin. Permite Cargar /
Guardar procedimientos globales en memoria, guarda queues, grupos y variables no dimensionadas.




Super QBE Permite asistentes de bsquedas en vez del estilo tradicional de bsqueda. Almacene sus criterios de bsqueda para
posterior uso. Despliegue los resultados en su Browse. Genere sus propios estilos de asistentes. Utilice mltiples operadores
Boleamos. Seleccione todos los registros que cumplan la condicin, o permita editar cada uno de los registros. Aada un filtro a un
reporte o proceso de los registros seleccin.

Super Tagging Crea reportes y procesos fcilmente, mediante la seleccin de los registros que se van a incluir en estos
procesos. Almacena la seleccin ya sea en memoria o en tablas. Permite guardar o cargar selecciones definidas con un nombre.
Soporta iconos para la seleccin y para los controles. Manejo de seleccin tipo windows ( Click, Maysculas Click, Ctrl Click ).
Soporte multi-usuario y multiple seleccin sobre una misma tabla utilizada para diferentes operaciones.

FiIe ExpIorer Permite utilizar los OCX's gratuitos de Windows para dar a sus usuarios acceso a archivos de formato html, pdf,
mp3, wav, avi, med, swf y muchos mas. Solamente agregue el control dentro de la aplicacin.
CW 5.5 A8C J Legocy 32 b|ts

Data ModeIIer Documentation Expert Crea de manera automtica documentacin de la aplicacin, utilizando los
comentarios en conjunto de la aplicacin como del diccionario.

HyperActive Permite generar hiper vnculos a cualquier archivo ( con una ventana asociada ) desde dentro de la aplicacin. Se
puede generar un hiper vnculo desde cualquier control, incluyendo los controles Browse y List. CW 4 J 5 J 5.5 A8C J Legocy


IxWord Library Esta librera permite crear un documento tipo Word directamente desde la aplicacin de Clarion. Word es
necesario que este cargado en la mquina ya que se utiliza OLE y WordBasic. CW 5.5
Debug

Herramientas para MuIti-DII's

Escaneo y AImacenamiento de Documentos

Edit in PIace

Accesorios AdicionaIes

_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 154
www.gopac.com.mx
cursosgopac.com.mx


EasyExceI Exporte sus datos a Excel de manera fcil y rpida. Es una Clase y conjunto de templates que proveen la habilidad de
importar los datos, cambiar fuentes y colores, dibujar marcos, imprimir y guardar sus documentos en Excel desde la aplicacin de
Clarion. ncluye ejemplos y documentacin completa.
CW 5 J 5.5 A8C J Legocy

Screen Capture TooIs ncluye una librera que maneja los llamados al AP de Windows, y un conjunto de templates, que
permiten incorporar imgenes tipo DB, BMP, EMF y WMF del portapapeles de Window, directamente a un control tipo imagen.
Permite capturar o imprimir parte del escritorio, de la aplicacin o una ventana individual.

CapeSoft Draw Es el reemplazo a los comandos de dibujos nativos de Clarion. Permite dibujar directamente sobre un control
tipo MAGE. Mucho mas rpido que dibujar con los comandos de Clarion. CW 4 J 5 J 5.5 A8C J Legocy 32 b|ts


LogFIash Permite identificar todos los cambios que se realicen a los datos. limitado nivel de "deshacer" , agrega auditoria de los
datos, lo cual da confianza y le da al usuario tranquilidad y seguridad.

AppInt Permite generar automticamente numero de versin, ventanas Splash y Acerca de. Agrega al EXE y/o DLL la informacin
generada de la versin, la cual se verifica en la ventana de Acerca de. Adems agrega el template que permite cerrar la aplicacin
al cerrar Windows, y el template que permite abrir una sola instancia por EXE.

Super Stuff Conjunto de herramientas que permiten : Guardar y restaurar las posiciones de las ventanas y su tamao. Adicionar
fcilmente vistas a los procedimientos con una extensin con soporte para relaciones, etc. Bsquedas de fechas, soporte
avanzado en "Drag & Drop". Formatos adicionales para Browses. Seleccionar un icono predeterminado para toda la aplicacin.
Reporte de memoria, y mucho mas.


TransIator Kit de internacionalizacin, que permite organizar los textos por tipo de control y propiedad. Consolida todos los textos
dentro de un solo archivo de traduccin. Auto-traduce la fecha, hora, nmeros, moneda, etc. utilizando la informacin del registro
de Windows. ncluye asistente para la traduccin. CW 5 J 5.5 A8C Translator Plus / CW 4 Legocy PD Translator.



ForeHeIp Premier ncluye las herramientas para desarrollar ayudas profesionales mas eficientes del mercado : ForeHelp,
ForeHTL para generar ayuda HTML, Fore'B para generar ayuda para Visual Basic, ademas incluye 5 herramientas adicionales
Index Expert, QuickContext, QuickFix, Active X for Help y Help Buttons. ForeHelp es un intuitivo ambiente de edicin y generacin
de ayudas profesionales, poderos y fasil de aprender y usar, WYSWYG, incluye su propio procesador, su unico Modo de Prueba,
manejador de proyectos, permite realizar importaciones de la mayora de los procesadores de texto. ForHelp no ocupa ningun
accesorio adicional para generar ayuda tipo Windows.

EzHeIp Aade tips de ayuda estilo Windows 98 - 95 a las aplicaciones. Utiliza el botn "?" y la opcin del mouse derecho "Qu
es esto ?".
CW 2 J 4 J 5 J 5.5 A8C J Legocy

DAS QuickHeIp Template que permite generar ayuda de la aplicacin con calidad muy parecida a la comercial, a partir de los
archivos APP o DCT . Simplemente cargue su APP en el ambiente de Clarion y esto generara un archivo de ayuda medianamente
comprensivo CW 2 J 4 J 5 J 5.5 A8C J Legocy

HTML Designer Genera de manera automtica archivos de Ayuda tipo HTML. Sin requerimientos de programacin HTML. CW
A8C J Legocy CW 2 J 4 J 5 J 5.5 A8C J Legocy



Wise La nueva tecnologa de instaladores Wise introduce juegos de herramientas tanto para
desarrolladores como administradores de sistemas. Como desarrollador, escribir un script de instalacin no debe de ser ms difcil
que escribir una aplicacin. Como administrador de sistemas, necesita de procesos de instalacin rpido, fcil y a prueba de fallas
para distribuir sus aplicaciones de Windows a usuarios dentro de la red. Es por eso que se han creado juegos de instalacin con
todo el poder y funcionalidad que se necesitan para crear programas de instalacin para Windows 3.x, Windows 95/98/2000/NT,
proporcionando un ambiente de edicin y pruebas de instaladores completo.


Linder SetupBuiIder La mas nueva herramienta de instalacin para desarrolladores de Windows. Es un programa de
instalacin RAD para crear instalaciones a 16 o 32 bits, actualizaciones de paquetes, etc.




InstaIadores

Herramientas para Programacin

InternacionaIizacin

Generadores de Ayuda

_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 155
www.gopac.com.mx
cursosgopac.com.mx

CW Assistant Conjunto de herramientas que permitirn al desarrollador trabajar ms rpido y agregar cdigo automtico. ncluye
Generador de Mensajes, Visor Diccionario, Visor del Mapa, Generador de Textos, CASE .ERRORCODE(), Ayuda de Equates,
Code Library, Tabla ASC, Organizador de Ayuda y mucho mas.

CIarion Source Search Utileria especialmente diseada para buscar y visualizar cdigo fuente Clarion y templates. ndica el
Procedimiento, Mtodo y Rutina para encontrarla en el Generador de Aplicaciones. Permite visualizar completamente el cdigo y
copiarlo al portapapeles. Permite al desollador a encontrar lo que necesita.

DAS TooIs Conjunto de herramientas con funciones para Fechas, Tiempo, Texto, Directorio, Drives, Archivos, Path, Sistema,
Multimedia, Hexadecimal, Mensajes y Redes. ncluye el juego de herramientas del programador. CW 4 J 5 J 5.5 A8C
J Legocy 1 J 32 b|ts

CIarion CIass Viewer Utilera que combina las caractersticas del Clarion Application Builder Class Viewer y el CallTree.
Permite analizar las clases, no solamente ABC, realizar anotaciones y ver la fuente de la clase y los archivos de ayuda, as como
cualquier mtodo e interfase, su rbol, estructura, valores equate y cdigo fuente. CW 5 J 5.5 A8C J Legocy

Dev Monitor Una de las utileras mas importantes para los desarrolladores de Clarion, permite identificar cuanto tiempo se ha
invertido en el desarrollo, para determinar el tiempo total invertido en el proyecto, para determinar estimaciones mas exactas. Al
final podr identificarse el tiempo total que se invirti por proyecto y si se obtuvo ganancia.


CPCS Herramienta para reportes que provee un control sobre el nivel de procesamiento de los cortes, permite crear verdaderos
reportes con calidad profesional. Permite crear reportes de multi secuencia / multi cortes en un simple procedimiento. ncorpora una
Vista de diseo, en donde se define cualquier relacin y orden necesario. Rpidamente agregue templates que le permitan realizar
bsquedas, guardar / restaurar campos, leer / escribir / desplegar / imprimir imgenes en campos blob, filtrar reportes con listas en
tiempo de ejecucin, imprimir cajas de texto, imprimir reportes desde QUEUES y mucho mas
CW 2 J 4 J 5 J 5.5 A8C J Legocy


PDF/EmaiIer Accesorio adicional de CPCS, que permite convertir los reportes generados con CPCS en documentos estndares
tipo PDF y opcionalmente enviarlos va correo electrnico a uno o mas destinatarios. Requiere CW 5 o 5.5 y el cliente MAP as
como un driver de impresin tipo PDF instalado.

Juego AdicionaI de Caractersticas para CPCS Aada vistas adicionales a los reportes de CPCS, en donde puede
especificar relaciones, criterios de bsqueda, relaciones, etc. Especifique a partir de que nmero de etiqueta inicie la impresin,
para "saltar" etiquetas previamente impresas Provee soporte para aquellos reportes que necesiten realizarse multicopias ( hasta 6
), adicionalmente permite agregar un texto diferente en cada copia como ejemplo Copia del Cliente, Copia Contabilidad, etc.


Fomin Report BuiIder Es un poderoso accesorio de reportes, fcil de usar para usuario final en las aplicaciones desarrolladas
por Clarion. La potencialidad de este accesorio aumenta el ciclo de vida y el valor de las aplicaciones, dejando al usuario final o al
grupo de staff la habilidad de crear o modificar las formas de los reportes. Esta herramienta conforma parte de la aplicacin y
puede ser distribuida libre de regalas.
A8C J Legocy 1 J 32 b|ts

WinWord Previewer Este template adicional permite adicionar la habilidad de utilizar Microsoft Word como el previsualizador de
reportes. As mismo permite grabar el reporte completo en un sencillo documento de Word ( *.doc ) ya sea de manera manual o
automtica.
CW 2 J 4 J 5 J 5.5 A8C J Legocy 1 J 32 8|ts Word .0 J 5 J 7 J 200

List LabeI Herramienta para reportes para usuario final. Permite al usuario final modificar el diseo de los reportes y crear sus
propios diseos.
Reportes

_abc Clarion Apndice


Gopc Soluciones ntegrales, S.A. de C.V. 156
www.gopac.com.mx
cursosgopac.com.mx



SecWin Permite fcilmente agregar funcionalidad de Control de Acceso y Registro del Producto. El Control de Acceso permite
acceso, clave de acceso, acceso pantalla por pantalla y control por control. El Registro del Producto limita el uso de copias en una
red, fecha de expiracin, etc.
CW 4 J 5 J 5.5 A8C J Legocy 1 J 32 8|ts

Super Security Permite fcilmente restringir el acceso a procedimientos, actualizaciones y campos. Utilice seguridad por
puertas o por niveles. ncluye DoorEdit para mantenimiento de usuarios. Mensajes configurables. Acceso restringido a los controles
del Browse, opciones no disponibles pueden mostrarse como inhabilitadas o pueden ocultarse. Acceso restringido a la ventana y a
los controles, cualquier ventana y/o control pueden ser afectados, cada uno teniendo su propio nivel/puerta y su propiedad de
deshabilitar/ocultar. Permite opcionalmente checar accesos previos. Backdoor para necesidades de soporte. Ejecute cdigo
dependiendo de los derechos de acceso del usuario. Ventana de acceso principal configurable.
A8C J Legocy

Super MuIti-User Limiter Limita el acceso a la aplicacin a travs de la red. Controla el nmero de usuario concurrentes.
Soporta candados, tiempo de inactividad, etc. Funciona en todas las redes. Cuenta con un sistema de monitoreo.

Super Passcode Previene la piratera de la aplicacin, utilizando cdigos de seguridad que dependen totalmente de la fecha del
equipo e informacin del mismo. Puede seleccionar diferentes tipos : Permanente, Anual , Mensual, Diario, Fecha, Restablecer y
Actualizacin de Demo. Es un cdigo basado en una serie de seis dgitos de acceso. Permite distribuir copias demo con restriccin
en tiempo.

DAS Registration Permite proteger el trabajo realizado por el desarrollador. Permite distribuir la aplicacin sin ningn archivo
adicional solamente debe de mantener una copia de la aplicacin Dasreg.exe, para identificar en donde se encuentran las
aplicaciones, proporcionar el registro del usuario y generar las LLAVES cuando estas sean necesarias. CW 2 J 4 J 5 J
5.5 A8C J Legocy

DAS Security Ofrece seguridad a diferentes niveles para todos los desarrollos. Todas las herramientas incluidas permiten
mejorar el conjunto de seguridad en el mercado. El cual consiste en funciones y templates que asistirn en el manejo de las tareas
difciles de aadir seguridad - amigable a las aplicaciones de Clarion.
CW 2 J 4 J 5 J 5.5 A8C J Legocy

RInstaIIer Provee una versin no registrada ( Demo ) o registrada de una aplicacin. Provee un periodo determinado para
realizar DEMO o Evaluacin del producto. Genera automticamente un nmero de serie durante la instalacin y mucho ms. CW
5.5 A8C











Mayor Informacin o Ventas
Gopac SoIuciones IntegraIes S.A.
de C.V.
Av. CubiIete #800 IocaI CoI ChapaIita
CP 45000 Guadalajara, Jalisco Mxico

Telfonos: +52 3 122 1947 ext 107
01 800 8746 722
e-mail: ventas@gopac.com.mx
www.gopac.com.mx



Reportes

También podría gustarte