PDF de programación - Manual Para crear Aplicación Multi-Dll Con Clarión 6.3

Ing. R. Pacheco

Analista Programador

[email protected]
Santo Domingo, Rep. Dominicana

Manual

Para crear Aplicación Multi-Dll

Con Clarión 6.3



Introducción
Ante de comenzar con este pequeño instructivo sobre la creación de aplicaciones
Multi-Dll, quiero advertir sobre la existencia de algunos errores comunes que se
presentan en el desarrollo de la misma, y en donde muchos programadores quedan
frustrados con el tema y lo dejan abandonado, hago este aclarando por que yo fui uno de
ellos, pero retome el tema con dedicación y con deseo de aprender y no me dejé vencer
por la impotencia al no encontrar la forma de solución a estos errores, por eso comienzo
limpiándote el camino y sacando las dudas de tu corazón.

Lo que me motiva hacer este manual o instructivo, es que tuve la oportunidad de leer
varios manuales para la creación de aplicaciones muti-Dll y ningunos de ellos llenaron mi
expectativa, porque no me supieron explicar con detalle los pasos a dar, ni los
inconvenientes que me iba a encontrar en la creación de aplicación multi-dll. Por eso
quiero ir explicando paso a paso todo los referentes al tema. Lo que espero es que este
humilde manual llene tu expectativa y pueda adquirir los conocimientos básicos sobre el
tema. Te prometo que si sigue cada paso como está establecido en este manual no será
un programador frustrado sobre el tema de la Dlls.

Errores que se presentan en la creación de aplicación Multi-Dll
Unos de los errores más comunes que se les presenta a muchos programadores y se
convierte en un dolor de cabeza es este error cskeys.clw, donde el compilador de
clarión no dice que no encuentra este archivo, que no es más que un código con
extensión Clw de clarión. Este error es producido por el témplate ACBfree y que venía
con el témplate para la versión 5.0 y 5.5, aunque hay una versión del témplate para 6.3
no trae el archivo y ocasiona el error y no se encuentra por ningún lado, solamente en la
versión viaja de clarión 5.0 o 5.5 se puede encontrar.

El témplate trae una extensión para agregar en tu DLL de datos la extensión se llama
"Exclude goblal classes generation in DLL". Se coloca en la propiedad global del Dll
de datos o app de datos. Cuando se agrega esta extensión en el Dll de datos o app de
datos el témplate no da errores. Pero si da errores en los Dll de procedimientos y en el
exe o app de menú, donde presenta este error de errorStatusclass y otros errores.
En mi caso le puedo decir que hice todos lo posible para solucionar estos errores
producido por este témplate y no pude dar con dicha solución, gracia a la sugerencia de
un colega me dijo que la solución más adecuada era desinstalar el témplate, así mismo
hice y no tuve solución, la alternativa final que se me ocurrió fue reinstalar clarión de
nuevo partiendo de cero y así tuve solución, aunque te recomiendo que el trabajo es
tedioso porque son muchas cosas que hay que volver a justar, Te digo como dice la Biblia
¨ Los que aman a Dios todas las cosas le ayudan a bien. Romanos 8:28


Ing. R. Pacheco

Analista Programador

[email protected]
Santo Domingo, Rep. Dominicana



Mis recomendaciones es evitar instalar este témplate si piensa trabajar con sistema dll,
si ya lo tiene por favor desinstálelo desde cero, para que te evite grande dolor de
cabeza.

Por otro lado si tiene instalado el témplate de NETTALK de capesoft también procede
muchos errores, pero si le agrega la extensión global Activate dll de datos o app de
datos, los erres desaparecen, solo activate no hay que hacer mas nada. Observe la
imagen.



Error al crear menú con frame en dll de Procedimiento.
A la hora de programar aplicaciones grandes con varios módulos que tengan
Menú y sub Menú debemos tener en cuenta de no usar el témplate frame de clarion
En los Dll de procedimiento, sino usar Window o ventana luego crear en ella el menú
Con el constructor de menú, esto te evitaría tener este error que se muestra en la
imagen.



Ing. R. Pacheco

Analista Programador

[email protected]
Santo Domingo, Rep. Dominicana



Error en la modificaciones de la Dll de Procedimiento
Cada vez que actualice modifique tu Dll de procedimiento puede ser que se te presente
un error como el que vez en la imagen siguiente.



donde

se

el

aplicación

encuentra

Para solucionar este error váyase al menú de clarión Project Generate all, esto significa
vuelva a generar todos el proyecto o el sistema de nuevo.

Mantener las aplicaciones
Cuando hagamos alguna modificación a algún procedimiento sólo necesitamos recompilar
la
procedimiento.
Si agregamos un procedimiento que es llamado en otra aplicación, debemos recompilar
tanto la aplicación donde está el nuevo procedimiento, como aquella que lo llama.
Cuando hacemos algún cambio en el diccionario o en las variables globales debemos
recompilar todas las aplicaciones en estricto orden, iniciando con el DLL de datos,
siguiendo con aquellos DLLs que son llamados por otros DLLS, después los DLLs que no
son llamados por otros DLLs y finalmente los ejecutables


He tratado de limpiarte el camino para que vaya seguro a la creación de una aplicación
multi¡-Dll, ahora sigue los pasos que describe este manual.



Ing. R. Pacheco

Analista Programador

[email protected]
Santo Domingo, Rep. Dominicana



Creación de un sistema dll.
Cuando una aplicación tiene muchos procedimientos, es difícil darle mantenimiento.
Lo mejor es dividir la aplicación en pequeñas aplicaciones (DLLs) ligadas por una
aplicación maestra (EXE).

¿Qué es un DLL?
Dynamic Link Library – Librería de Ligado/Acceso Dinámico. Podemos definirlo de manera
simple como un conjunto de procedimientos, disponibles para ser llamados por otros
DLLs o EXEs.

Un sistema dll esta compuesto por tres partes principales.

Un DLL de datos o App de Datos. Contiene las definiciones de las variables globales y
de las tablas del diccionario. Además, incorpora las clases usadas en la aplicación. NO
puede contener procedimientos.

Un DLL de procedimientos o App de procedimiento. Donde se definen los
procedimientos, ya sean browses, formas, reportes, procesos, etc.. Debe estar ligado al
DLL de datos.

Un EXE. O App exe: es un ejecutable, que solo requiere un menú que llame a los
procedimientos del DLL de procedimientos. Puede, adicionalmente, contener
procedimientos. Debe estar ligado tanto al DLL de datos, como al DLL de Procedimientos.



Ventajas
En un proyecto grande, es usual que haya más de un programador involucrado. Al estar
dividido en más de una aplicación, es muy fácil dividir el trabajo.



Ing. R. Pacheco

Analista Programador

[email protected]
Santo Domingo, Rep. Dominicana



administración.

Facilidad de
Compilación más rápida al sólo regenerar y recompilar los procedimientos de la aplicación
que se modifique (Naturalmente, si se hace algún cambio en el diccionario, es necesario
recompilar
Distribución de mejoras o actualizaciones de una manera más eficiente, ya que
únicamente se redistribuyen los módulos que cambiaron.

aplicaciones asociadas).

todas las

Desventajas
Puede salirse de control la administración si no se tiene cuidado en la división de los
procedimientos (sobre todo, saber en cual aplicación está determinado procedimiento),
pero no es una desventaja en los DLLs en sí, y con una buena planeación y
administración no hay ningún problema.

con

los nombres

Cuidado
Normalmente, todas las aplicaciones de un proyecto (DLLs y EXEs) se almacenan en un
mismo directorio. Debemos asegurarnos que los cinco primeros caracteres de cada
aplicación sean diferentes. La razón es que al generar los archivos fuente, el compilador
toma sólo los cinco primeros caracteres del nombre de la aplicación y le agrega tres
dígitos consecutivos.

Creación del Dll de Datos o app de datos.
Los primero que debe hacer es crear una carpeta de trabajo en dentro del directorio de
clarión Ejemplo Tutorial dll, luego debemos crear un diccionario de datos con los campos
que usted desee que tenga su sistema. Luego creamos el nombre de nuestro app de
datos para eso váyase al menú de clarión file y seleccione New póngale un nombre en
mi caso yo le puse filedatos, trate de utilizar nombre cortos cuando este trabajando con
dll. La aplicación debe verse como se observa en la imagen.



Ing. R. Pacheco

Analista Programador

[email protected]
Santo Domingo, Rep. Dominicana



Variables Globales
Si tenemos variables globales, lo recomendable es definirlas en el diccionario, como una
tabla tipo Global. Si nuestra aplicación original contiene variables globales, podemos
(debemos) copiarlas, ya sea a nuestra DLL de datos, o directamente al diccionario.

Normalmente, a las variables globales anteponemos un prefijo GLO:, pero nuestro
archivo TXD ya incluye un prefijo GLO (en la línea que inicia con "Globales FILE".
Debemos eliminar de cada variable el prefijo GLO manualmente (todas las marcas que
aparecen después de la primera línea).

Cargando los datos de la aplicación
Aplication file: Se coloca el nombre de la dll de datos
Dictionary File: Se carga el nombre del diccionario de datos
First Procedure: Aquí se coloca el nombre