Manejando bits con Harbour

En esta entrada del blog usaremos algunas de las funciones para operar con números binarios que nos aporta Harbour.

No entrare a explicar porque se usa el sistema binario en los ordenadores (supongo que como programadores es un tema que conocéis), y solo explicare brevemente el sistema binario, si ya lo conoces puedes saltarte el siguiente párrafo.

El sistema binario es un sistema de numeración en el cual los números se representan utilizando las cifras 0 y 1 . Cada dígito de un número en este sistema se denomina bit y al igual que en base 10 (el que utilizamos habitualmente), el valor depende de la posición donde se halla.

Veamos un ejemplo y nos quedará más claro:

Normalmente la manipulación de binarios queda reducida a la programación a bajo nivel, y en el resto de programación podemos sobrevivir sin manipular bits. Pero para poder ilustrar el uso de alguna de las funciones de manejo de bits de Harbour, os propondré el uso de binarios para la gestión de estatus, variables lógicas que solo puedan ser verdadero o falso, en nuestro caso 0 o 1.

Estos campos estatus habitualmente los solucionamos mediante el uso de campos lógicos, o tipo carácter de una posición grabando S o N, según corresponda. El tamaño de estos campos, o variables, es de 1 Byte (es el tamaño mínimo que podemos definir), pero 1 Byte son 8 bits, con lo cual el valor grabado en 1 Byte nos permite identificar hasta 8 estatus diferentes.

 Imaginemos que en una factura deseamos controlar varios estatus:

• Tiene IVA
• Tiene Recargo de Equivalencia
• Esta cobrada
• Esta impresa
• Es un contado
• Factura Rectificativa

Toda esta información podemos grabarla en un solo campo carácter de una posición, y aun nos sobra para dos estatus más.

Crearemos una tabla llamada FraCab que entre otros atributos, contendrá uno llamado Estatus del tipo carácter y de una posición.

Para el ejemplo trabajaremos sobre un único registro, y dispondremos de controles CheckBox para poder activar o desactivar nuestros estatus, que se grabaran en un campo de una sola posición.

Los ocho estatus los manejaremos mediante un Hash, por comodidad las tablas hash y algunas otras variables las he definido como estáticas al proyecto para no tener que pasarlas como parámetros.

Leeremos el campo estatus de la tabla y asignaremos a cada posición del hash el valor lógico que le corresponda. 

 Para este fin usamos la función hb_BitTest( nParam, nBit )→ lResult , le pasamos como primer parámetro el valor ascii de nuestro campo estatus y como segundo el número de bit que deseamos leer. hb_BitTest nos devuelve un valor lógico dependiendo si dicho bit vale uno o cero.

Una vez que hemos recuperados los valores de cada uno de los estatus, dibujamos el dialogo que nos permitirá ver y modificar los valores.

Para su modificación usamos controles CheckBox, que en el evento onChange, actualizan el campo, y refrescan los valores de la pantalla.

Esta es la función encargada de actualizar los valores

Recibe como parámetro la clave del hash, busca cual es su posición y lo graba en la variable nPos, esto nos permite saber que bit es el que debemos manipular.

Y procedemos a calcular el valor del nuevo estatus en función de si es falso o verdadero, mediante el uso de las funciones hb_BitSet y hb_BitGet

hb_BitSet( nParam1, nBit ) → nResult Retorna el entero resultante de activar el bit nBit en el entero nParam1

hb_BitReset( nParam1, nBit ) → nResult Retorna el entero resultante de desactivar el bit nBit en el entero nParam1.

Como podéis ver, necesitamos el código ASCII para pasar a la función de manipulación de bits, y convertimos el número obtenido a su valor ASCII, para ello usamos las funciones Asc() y Chr().

Este ejemplo ha sido programado usando FWH 15.01, Harbour 3.2.0 y BCC 5.82. Para su correcto funcionamiento es necesario linkar la libreria hbMisc.lib

Descarga código fuente
Descarga exe comprimido

 Espero que os haya resultado interesante, si además podéis extrapolarlo y hacer uso en algún caso práctico mucho mejor. Y en el peor de los casos deseo que os haya servido para conocer algunas de las funciones que incorpora Harbour y que no solemos utilizar frecuentemente.
Agradezco comentarios y sugerencias, saludos desde Mallorca.

Por cierto, en http://harbouradvisor.blogspot.com.es/2012/02/funciones-para-manipular-bits.html de mi amigo Carlos Mora, podéis encontrar una explicación de todas las funciones para manejo de bits que nos proporciona Harbour.

Setter y Getter, buenas prácticas en OOP.

Ha pasado muchísimo tiempo desde la última entrada, quizás demasiado, pero por aquí seguimos.

A diferencia de la mayoría de entradas de este blog, que son eminentemente prácticas, hoy haré una entrada más bien teórica.

Voy a hablar de los DATA ( variables de instancia ), a estas alturas todos hemos leído bastante sobre OOP (poo), y estamos familiarizados con su uso y bondades (polimorfismo, encapsulación, …).

Una de las costumbres habituales de los programadores de Harbour es manipular directamente las variables de instancia(los DATA de las clases), que es algo que va en contra de la encapsulación, pero también es cierto que nos vemos abocados a hacerlo porque muchas clases no disponen de métodos set y get o setget.

Lo normal y correcto es que los datas sean privados a la clase, y solo puedan ser manipulados desde sus métodos públicos.

Para ilustrar la importancia, lo haremos usando un ejemplo de código de la clase tAppl, que contiene, entre otras cosas, un data con los objetos font que se utilizan en la aplicación.

En su día este data se implemento usando un Array, y en la clase existían dos métodos uno para asignar y otro para recuperar.

Desde la aplicación, la clase se usa como ilustra el siguiente código, como podéis ver no se accede directamente a la variable, añadimos nuevos fonts usando AddFont y los recuperamos con GetFont.

Para facilitar el uso y la legibilidad del código, se realizaba un define para cada font del tipo

#define COUR10BOLD 3, que identificaba el font y tamaño con la posición del array.

Pasados los años en Harbour se incluyo el tipo de dato hash (arrays asociativos), que entre uno de los muchos beneficios que aporta, nos permite manejar de una forma más elegante estructuras de datos como el caso de los fonts.

La idea es sustituir el array que guarda los fonts por un hash, y cambiar la forma de recuperar el font, pasando como parámetro su nombre y no su indice, pero queremos mantener la compatibilidad con todas nuestras aplicaciones.

En este momento es cuando es importante el no haber manejado el data aFont directamente desde nuestras aplicaciones, ya que ahora cambiaremos el tipo de dato y la forma de recuperarlo.

La nueva forma de recuperar los fonts será oAppl:GetFont(“COUR10”)

Empezamos cambiando el nombre del data que pasa a ser hFont, solo este cambio rompería la compatibilidad si hubiéramos accedido directamente al data desde nuestros programas.

Inicializamos hFont en el método new(), hFont={=>}, hash vacio.

Y ahora pasamos a modificar los métodos AddFont y GetFont

En addFont hemos añadido un parámetro adiconal, que es el nombre por el que queremos recuperar el font ( la clave para el hash), como que este parámetro en la versión anterior no se pasaba, lo que hacemos es construirlo en el caso de que no lo recibamos como parámetro.

En GetFont, recibimos un nombre, o un indice numérico (para mantener compatibilidad). Comprobamos el tipo de parámetro recibido, si es numérico retornamos el font ubicado en la posición que indica el parámetro, de lo contrario retornamos el elemento cuya clave sea el parámetro recibido. Como posible mejora podemos comprobar previamente si existe la clave en la tabla hash, para evitar errores en tiempo de ejecución.(IF hb_hHasKey( ::hFont, uFont) )

De esta forma hemos modernizado nuestra clase tAppl para usar hash, manteniendo compatibilidad con las versiones anteriores.

Espero que este ejemplo haya ilustrado la importancia de definir Setters y Getters en lugar de acceder directamente a los datas de las clases.

Usando ficheros comprimidos ZIP desde Harbour.

Como pone en la página web de harbour (http://www.harbour-project.org/), harbour es software libre 100 % compatible con compiladores Clipper.

Pero ademas de las funciones Clipper, el compilador ha ido añadiendo una serie de funciones nuevas (todas las que su nombre empieza por HB_... ), que muchas veces desconocemos, y que nos aportan funcionalidad extra.
Estas funciones son usadas escasamente por la comunidad de usuarios, bien porque desconoce su existencia, bien porque la documentación es excasa o nula para poderlas usar.

En la entrada de hoy vamos a centrarnos sobre dos funciones en concreto, HB_ZipFile y HB_UnZipFile, que nos va a permitir comprimir y descomprimir archivos en formato ZIP.

HB_ZipFile( cZipName, cFile | aFiles, nLevel, bBlock, lOverRide, cPassWord, lWithPath, lWithDrive, pFileProgress )

cZipName	Nombre del fichero ZIP a crear
cFile | aFiles	Nombre del fichero a comprir o array de ficheros a comprimir. Unidad y Path pueden ser usados.
nLevel	Nivel de compresión. De 0 a 9
bBlock	Code block a ejecutar mientras se comprime
lOverRide	Sobreescribir el fichero si existe.
cPassWord	Password para encriptar el fichero ZIP
lWithPath	Guardar el path si/no
lWithDrive	Guardar la unidad si/no
pFileProgress	Code bloclk para progreso de archvios.

HB_UnZipFile( cFile, bBlock, lWithPath, cPassword, cPath, cFile | aFiles, FileProgress )

cFile	Nombre del fichero a descomprimir
bBlock	Code block a ejecutar a medida que se va descomprimiendo
lWithPath	Permitir crear directorios si es necesario
cPassWord	Contraseña a usar para descomprimir el fichero
cPath	Path donde estraer los ficheros
cFile | aFiles	Nombre de un archivo, o array de nombres de archivos a extraer
pFileProgress	Code block para visualizar progreso de los ficheros

Las dos funciones retorman un valor booleano, informandonos si el proceso a concluido con éxito.


Veamos un primer ejemplo sencillo de comprimir / descomprimir.


Vamos a complicarlo y elaborarlo un poco mas, en el fondo haremos lo mismo, pero con una barra de evolución tanto para comprimir como descomprimir. Simplemente haremos uso de los parametros adicionales que nos permiten ejecutar codeblocks.



Como podeis ver en el fuente, hemos creado dos funciones comprime y descomprime, que son muy sencillas de usar. Comprime recibe dos parámetros, nombre del fichero zip que queremos crear, y array (arreglo) con los ficheros que queremos comprimir. Descomprime recibe como único parámetro el nombre del fichero ZIP a descomprimir.
En el interior de cada una de las funciones creamos un dialogo para visualizar la evolución, y montamos e code block necesario para que se vaya actualizando.
Como visteis al principio existen más parámentros en la función HB_ZipFile y Hb_UnZipFile, se trata de que vayais experimentando con ellos y usando los que os hagan falta. Este ejemplo es un ejemplo básico, pero creo que cubre las necesidades más comunes de compresión y descompresión.

Existen una serie de funciones adicionales para manejo de ficheros Zip, pero os las dejo para que vosotros mismos las investigueis, en descomprime por ejemplo hacemos uso de hb_GetFilesInZip ,para determinar el número de archivos contenidos en el fichero comprimido.

Ya habeis visto que no es nada complicado, si solo quereis comprimir / descompriir, con dos funciones y usando dos parámetros ya lo esta listo.

El último escollo, pero también importante, es linkar las librerías adecuadas para poder hacer uso de las funciones de manejo de ficheros ZIP.
Las librerias a ñadir a vuestro proyecto son:
hbZiparc.lib
hbmzip.lib
hbzlib.lib

Descargar fuentes

Espero que os sea de utilidad, saludos desde Mallorca.
Biel Maimó

Actualización automática de aplicaciones

En la entrada anterior publique un sistema para realizar actualizaciones de nuestras aplicaciones via FTP. Hoy seguiremos hablando del tema, y le daremos otra vuelta de tuerca.

Para actualizar nuestra aplicación usábamos un pequeño programa “ActVer”, que se encargaba de renombrar y lanzar la ejecución de nuestra aplicación.

Al realizar este programa en [x]Harbour, nos queda de un tamaño bastante considerable teniendo en cuenta lo poco que hace, eso es debido a que como poco cualquier ejecutable Harbour se lleva dentro la maquina virtual.
Para mejorar el tamaño crearemos una versión de ActVer, pero escrita en C, con lo que pasaremos de los 1,46 MB de la versión de harbour a los 16 KB de la versión compilada en C (1,519,616 bytes menos).

Ademas para no tener que distribuir dos ejecutables, embeberemos ActVer.exe dentro de nuestra aplicación, concretamente en el fichero de recursos, y lo extraeremos solo en el momento que sea necesario actualizar nuestra aplicación.

El codigo de ActVer.C queda de la siguiente manera.

#include "stdio.h"
#include "windows.h"

int main( int argc, char *argv[])
{
Sleep(700);
DeleteFile( argv[1]);
rename( "tmp.exe",argv[1]);
WinExec(argv[1],1);
return EXIT_SUCCESS;
}

Ahora vamos a insertarlo dentro de nuestra aplicación, para ello añadimos la siguiente linea en nuestro fichero de recursos, xxxxx.RC

ACTVER RCDATA "ActVer.exe"

RCDATA nos permite insertar directamente datos binarios en nuestro ejecutable (graficos, otros exe, …)

Con esta linea, la siguiente vez que compilemos nuestra aplicación, actver quedara incrustado dentro de nuestro programa, ahora solo nos hace falta el poder extraerlo, cosa que haremos con el siguiente código (también en c).

Insertamos el código de la función en c, en nuestro fuente prg Harbour.

#pragma BEGINDUMP
#include "Windows.h"
#include "hbApi.h"
HB_FUNC( RESTOFILE )
{
HRSRC res=FindResource(NULL,"ACTVER",RT_RCDATA);
LPDWORD bytesWritten;
int size=SizeofResource(NULL,res);
HGLOBAL hRes=LoadResource(NULL,res);
unsigned char *pRes=(unsigned char *)LockResource(hRes);
HANDLE hFile=CreateFile("ACTVER.EXE",GENERIC_WRITE,0,NULL,CREATE_ALWAYS,0,NULL);
WriteFile(hFile,pRes,size,&bytesWritten,NULL);
CloseHandle(hFile);
}
#pragma ENDDUMP

Y con esto ya veis que es muy sencillo el incorporar ficheros binarios en nuestro EXE, esta es una posible utilidad, pero seguro que le encontrareis alguna otra.

Para que el PRG de nuestro anterior hilo incorpore esta funcionalidad, debemos añadir el codigo antes citado, y realizar una llamada a la función ResToFile() en la linea anterior a WinExec.

UpdFtp2.prg
ActVer.c
UpdFtp2.zip contiene UpdFtp2.exe
ActVer.rc
ActVer.Exe

Actualización automatica de aplicaciones via FTP

En esta entrada del blog vamos a diseñar un sistema para automatizar las actualizaciones de las versiones de nuestros programas.
Para ello, necesitaremos disponer de un servidor FTP. El motivo de usar un servidor FTP, es que nos va a permitir tanto una solución vía intranet como Internet.

Vamos a explicar la teoría de este sistema, y después iremos con la practica y el código fuente.

1º Dispondremos de un servidor FTP, en el cual montaremos una estructura de carpetas, donde el nombre de la carpeta, será el de la aplicación, y dentro de esta carpeta alojaremos la última versión de nuestro programa ejecutable.

2º Especificaremos a nuestro programa, la información necesaria para poderse conectar al servicio FTP( ip, usuario,...), con esa información se conectara, y comprobara la antigüedad del fichero alojado en el servidor, la comparara con él mismo, y si la versión del FTP es más nueva, procedera a la descarga del fichero ejecutable, en un fichero temporal en nuestra unidad local.

3º Si había actualizaciones para descargar, y la descarga se ha completado con éxito, ejecutaremos otro proceso, que borrara la versión antigua, re nombrara y lanzara su ejecución.

Y con esto ya tendremos actualizado nuestro programa. Viendo la teoría, no parece muy complicado ;-)

Esta solución, la tengo implementada como parte de una clase (tAppl), que utilizo en todas mis aplicaciones, aquí para poderos poner un ejemplo auto contenido, y no complicarnos explicando la creación de las clases, lo realizaremos con funciones, aunque luego el lector lo podrá adaptar a una clase o de la manera que le parezca mas cómoda para su forma de trabajo.

Nuestra aplicación, empezara definiendo la dirección del servidor FTP, y la carpeta donde comprobar el fichero a actualizar, seguidamente ejecutaremos la función ChkUpdFtp, y aquí se bifurcara, dependiendo de si hay que actualizar o no.

Veamos ahora la función(ChkUpdFtp) encargada de determinar si existen versiones nuevas de nuestro programa, para ello utilizaremos las clases tInternet y fFtp.
Lo primero que haremos será comprobar si disponemos de los parámetros necesarios para conectarnos, y si existe el programa ActVer(mas adelante veremos su código fuente) que será el encargado de renombrar y relanzar nuestro programa. Pasado este primer filtro, pasamos a intentar realizar la conexión con el FTP, si dicha conexión tiene éxito, solo nos resta comprobar las fecha y hora de creación de los archivos y determinar si debe o no actualizarse, en caso de que se deba actualizar llamaremos a la función Actualiza.

En este proceso usamos funciones que no vamos a comentar su funcionamiento, simplemente os incluyo su codigo fuente (prg y C). ( TimeToSec, FileTimes, FileSize ) O bien podeis utilizar alguna alternativa vuestra si en vuestro set de funciones ya las teneis definidas.

La función actualiza, es la encargada de descargar el nuevo fichero ( GetFile ), y visualizar en pantalla una barra de evolución de la descarga .


Al llegar a este punto, si la función Actualiza nos devuelve verdadero, significará que ya tenemos descargado nuestra nueva versión en la carpeta local, solo debemos cerrar la versión actual, e invocar ActVer que se encargará de borrar la versión anterior, y renombrar el fichero que acabos de recibir, y posteriormente ejecutarlo.

Veamos el sencillo código de ActVer.exe, recibe como parámetro el fichero a actualizar, borra la versión anterior, renombra y ejecuta.

Y con esto ya tenemos implementado nuestro sistema de actualizacion via Ftp de nuestras aplicaciones.
Dos cosas importantes a tener en cuenta si vuestro servidor de FTP es LINUX, los nombre de ficheros, en linux son case sensitive, y la hora de creacion del fichero se guarda en UTC.
UpdFtp.prg
ActVer.prg
UpdFtp.exe y ActVer.exe

Nota: me comentan que al compilar con xHarbour falta la función HB_IsChar, simplemente sustituir HB_ISCHAR( cTime ) por ValType(cTime)=='C'.

Multi Idioma con [x]Harbour + FiveWin

   En esta ocasión vamos a implementar un sistema multi idoma, basado en DLL de recursos. Esto os podrá servir para distribuir vuestras aplicaciones en diferentes países, o en un mismo país con diferentes idiomas. En Baleares al igual que en otras comunidades autonomas de España, existen dos idiomas cooficiales, Castellano y Catalán. Es habitual, y sobre todo en organismos públicos que soliciten las aplicaciones en multi-idioma, o directamente traducidas al Catalán.

Para solventar este problema, sin que tengamos que modificar los fuentes de nuestra aplicación, ni debamos mantener varias versiones en paralelo, lo que haremos sera mantener tantas DLL de recursos como idiomas queramos disponer en nuestra aplicación. 

Para ello contaremos con una DLL de recursos vaciá ( vacio.dll ), que usaremos como base,  e iremos introduciendo los diálogos, y crearemos un "string table" con los mensajes que utilicemos en nuestra aplicación. (Para editar las DLL usaremos un editor de recurso cualquiera, en nuestro caso el que viene integrado con PellesC)



La tabla de cadenas tiene un formato parecido al siguiente, un código y su mensaje asociado. Desde nuestro programa iremos recuperando las cadenas de texto por su numero de código.


La idea es al principio de la aplicación cargar la DLL que queramos según el idioma seleccionado, y automáticamente tendremos los diálogos y cadenas de texto en el idioma deseado.
La carga de la DLL deseada la hacemos mediante la función SetResources( via de acceso + nombre de fichero.dll), el nombre y la via de acceso puede estar guardada por ejemplo en el registro de windows, un fichero ini, o directamente solicitar la elección del idioma por parte del usuario.

En su día tuve la idea de usar Shell.Applucattion y las extensión de NTF, para grabar junto a la DLL la descripción del idioma, pero resulto ser un fiasco, debido a que solo funciona con NTF, y en instalaciones con FAT32 no funciona, y ademas al comprimir o hacer paquetes de instalación, se pierde la información adicional de los ficheros, a modo de curiosidad, y para el que quier ver los fuentes y el manejo de Shell.Application, aquí os dejo los fuentes.

Recapitulando, al iniciar el programa, cargamos la DLL de recusos deseada
Ejemplo:
oAppl:cLng:=GetLng() //Funcion que recupera el idioma
SetResources(oAppl:cDirLocal+"Resource\ppcinst"+oAppl:cLng+".dll")
oAppl:hDll:=GetResources()
Los diálogos, ya los tenemos traducidos directamente en el diseño del recurso.
Para recuperar las cadenas de texto, usaremos la función LoadString(hDll, nResid ), le debemos pasar dos parametros, el primero es el handler del modulo que contiene las cadenas de texto, y el segundo el codigo de la cadena que quermos cargar.
LoadString( oAppl:hDll, 10001 )

Para hacerlo más fácil de leer y manejar, os recomiendo crear un fichero CH para incluir en vuestro programa, a modo de diccionario, donde iremos definiendo un texto mas legible asociado a la función y código de cadena a recuperar.




De esta forma por ejemplo visualizar un mensaje avisando de que la aplicación ya esta en ejecución pasaría de un críptico

MsgStop( LoadString( oAppl:hDll, 10001 ) )
a
MsgStop(TXT_EXERUNNING)

bastante mas descriptivo.

Aquí os pongo un pequeño ejemplo para ver el funcionamiento de lo descrito anteriormente.


MultiLng.prg
MultiLng.zip

LetoDB (RDD cliente servidor para [x]Harbour)

Hasta ahora la mayoría de entradas de este bloc, hacen referencia al acceso a datos mediante el uso de ADO, como alternativa al uso clásico de los ficheros DBF.

En esta nueva entrada, nos vamos a quedar en medio de la dos tecnologías, y hablaremos de un proyecto Open Source creado por Alexander S. Kresin, llamado LetoDB.

LetoDB, es un servidor de base de datos multi plataforma(Windows y Linux), escrito en Harbour y que nos permite trabajar con ficheros DBF e indices CDX o NTX. Se implementa como un RDD de harbour, y por tanto la forma de usarlo es prácticamente igual que usar DBFs de toda la vida, solo nos harán falta unas pocas instrucciones para realizar la conexión al servidor.

LetodDB se divide en dos partes fundamentales, el servidor (letodb.exe) y la parte cliente (rddleto.lib). También se incluye un programa de consola, que nos permite monitorizar el estado del servidor.
Aunque el tema es amplio y habría mucho que comentar sobre la implementación del servidor, el uso de multihilos, etc, como siempre intentare ser eminentemente práctico, y que de una manera rápida y senciilla podáis probar ester servidor, y si os interesa el tema vosotros mismos podréis ir profundizando.

Para empezar nuestras pruebas, deberemos descargarnos una serie de archivos, aunque os los podéis descargar de sourceforge (http://sourceforge.net/projects/letodb/ ) y compilarlos con la version que deseeis, aquí os pongo un enlace para que os podeis descargar un fichero en el que ya estan los ejecutables y la librería listas para usar.

Descargar letodb.zip
Este archivo contiene lo siguiente
Letodb.exe ->Ejecutable del servidor
rddleto.lib -> RDD (compilado con Harbour 1.0.0RC1(Rev.8835) )
manage.exe -> Consola del servidor.
Una vez tengamos descargado este archivo, podemos crear una carpeta (C:\letoDB por ejemplo), y descomprimimos letodb.zip.

El servidor de LetoDB, por defecto trabaja sobre el puerto 2812, y el path por defecto es c:\, estos parametros pueden ser modificados mediante el uso del fichero letodb.ini, si no existe este fichero, se utilizaran los valores por defecto, y si existe los tomara del fichero. Debe crearse en la misma carpeta donde se encuentra ubicado letodb.exe.
Ejemplo letodb.ini

Port = 2812
DataPath =c:/letodb
Logfile = "letodb.log"
Default_Driver = CDX

Para arranncar el servidor, simplemente ejecutaremos letodb.exe, el servidor no tiene ventana asociada, y solo nos arrancara un proceso en nuestro sistema. Para detener el servidor, ejecutaremos el “letodb stop”.


Ahora ya podemos arrancar la utilidad de consola, que nos va a permitir monitorizar nuestro servidor. Para conectarnos al servidor, debemos especificar la IP donde esta letoDb ejecutandos, el port que usamos y pulsar sobre el boton Go. Si lo estamos ejecutando en local sobre nuestro PC, en la dirección pondremos 127.0.0.1 o bien localhost.
El tercer campo que por defecto tien 2 como valor, son los segundos que tarda en refrescar la información.


Una vez hemos pulsado GO, dispondremos de tres vistas, que podremos ir cambiando pulsando los botones Main, Users, Tables. La información de cada una de estas pantallas es autoexplicativa, en la primera información general del servidor, en Users veremos los usuarios y procedimientos conectados, y en Tables veremos cada proceso con los ficheros que tiene abiertos.

A estas alturas ya estamos listos para escribir el código fuente que nos permita conectar con el servidor letoDB, y realizar nuestras primeras operaciones cliente servidor usando ficheros DBF.

El código fuente es el siguiente, y para que funcione tenéis que linkarlo junto con RddLeto.lib, y por supuesto el servidor debe de estar ejecutándose.



Como podeis apreciar prácticamente todo son comandos estándar de harbour, el único comando no estándar es el que nos comprueba si tenemos conexión con el servidor, el resto son todos nativos de Harbour.
Observar también que debemos definir la dirección IP y el puerto que uso nuestro servidor LetodDB.
El ejemplo es muy sencillo, todo el código esta comentado y creo que se entiende perfectamente.
Ademas de los visto, letoDB incorpora otras funciones adicionales, pero que ya podréis descubriendo si os interesa este sistema cliente servidor, entre las cosas destacadas comentaros que incorpora control de transaccional ( leto_BeginTransaction(), leto_Rollback(), leto_CommitTransaction()), y que el autor tiene pensado en un futuro implementar procesos almacenados que estarán escritos en Harbour.

Desde aqui podeis descargar el código fuente, y el ejecutable.
Descargar ejecutable
Descargar código fuente
Descargar letodb.zip
Podréis encontrar más información sobre letoDB, y descargaros el proyecto completo con su código fuente en sourceforge (http://sourceforge.net/projects/letodb/ )

Ya que son varios los que me lo habeis pedido, aqui os pongo un fichero .bat y .bc para que podais construir la libreria y el ejecutable del servidor con Harbour(1.0.0RC1)y Borland C 5.5, para versiones anteriores de Harbour no vale, ya que se han renombrado las libreriras. Estos ficheros asumen el compilador de C en C:\Borland\bcc55\bin y Harbour en c:\harbour. Si los tienes así, copia estos dos archhivos en la carpeta donde te has descargado letoDB(desde sourcefourge)y basta con ejecutar make_b6 desde la linea de comandos(Si quieres asegurarte de limpiar copias antiguas, ejecuta primero make_b6 clean).
Descargar make_b6.bat
Descargar makefileb6.bc



Gracias a Alex Kresin, y a todos los que han contribuido en el desarrollo de LetoDB, que nos brinda otra alternativa de acceso a datos para el mundo xBase.

Saludos desde Mallorca.



...

Instalador para Pocket PC

Hasta la fecha las instalaciones de nuestras aplicaciones para PDA, las esta haciendo de una manera bastante rudimentaria y manual.
Estuve buscando por la red algún buen programa de instalación y que ademas fuera gratuito. No encontrando un software que me satisfaciera al cien por cien, recorde que habia leido en algun post del foro de FiveWin, como hacer ficheros de instalacion para PDA, usando CabWiz y EzSetup (ambos freeware).

Busque y encontre toda la documentación necesaria, parte en el foro de FiveWin (gracias a Pawel y Carles Aubia), y otra en el MSDN.

Aunque CabWiz y EzSetup funcionaban bien, la verda es que era algo engorroso el crear las instalaciones. Y aqui empezo este proyecto, se trataba de tener un gestor de scripts de instalación basados sobre CabWiz y EzSetup, pero que ademas fuese sencillo de manejar.

Y este el resultado final del instalador, aunque seguro que mejorable en muchos aspectos, para mi cubre las necesidades basicas de instalador.
El funcionamiento es muy sencillo e intuitivo, tenemos los siguientes campos
Proyecto: Es el nombre con el que se guardara el proyecto
Fichero ejecutable: Es la via de acceso y el nombre del fichero exe de la aplicacion que queremos general el setup.
Carpeta de datos: Es la carpeta que contienes los datos de nuestra aplicación, esta carpeta se creara con el nombre \DATOS y colgara de la carpeta de la aplicación(por ahora no es configurable). Todos los archivos que se encuentren en la ruta se copiaran.
Proveedor : Nombre de nuestara empresa
Nombre Aplicacion : eso

En la PDA nuestra aplicacion se instalara en la carpeta cuyo nombre sera la concatenacion de Proveedor + Nombre Aplicacion

Ahora tenemos cinco pestañas.
1.- Readme, texto que aparecera en la primera pantalla del setup
2.- Eula, condiciones de licencia de nuestro software, aparece en la segunda pantalla del setup, y debe aceptarse.
3.- Carpeta Comun, aqui estara nuestro fichero ejecutable, y podemos añadir otros ficheros manualmente.
4.- Carpeta datos, es solo lectura, y veremos que archivos seran copiados en la carpeta datos.
5.-My Documents, Nos permite añadir manualmente archivos que serán copiados en My documents de la PDA.

Los botones de la barra por orden de aparicion :
Nuevo,Recuperar un proyecto guardado, guardar proyecto actual, generar instalación, salir.

Cuando puslamos sobre el boton generar instlación, obtendremos como resultado el fichero setup.exe que es el que deberemos ejecutar en nuestro pc con el terminal conectado mediante ActiveSync, e instalara nuestra aplicacion en el Pocket PC.


Y con esto creo que esta casi todo explicado, aqui está el link para descargarel programa.
Descargar Setup.exe

Para los usuarios de Windows vista debeis istalar "Centro de dispositivos de Windows Mobile" que viene a ser el sustituto de ActiveSync, lo podeis descargar desde la página de Mircosoft.
Centro de dispositivos de Windows Mobile 6.1 para Windows Vista (32-bits)

Espero que os pueda ser util.
Saludos, y hasta la proxima.

Usando List & Label 12

Recientemente en el foro de FiveWin se viene hablando del generador de informes List & Label. Y aunque se comenta que es muy bueno, que funciona muy bioen, etc, la verdad es que no hay hasta la fecha ningún ejemplo funcional para ser usado con FiveWin. Bueno realmente si hay una primera aproximación de Jairo Centeno (gracias), que expone un ejemplo de como usar el generador de informes.

En esta entrada intentare poner un ejemplo de como usar el diseñador, y otro de lanzar un informe.

El primer punto a destacar es la filosofía de uso de este generador de informes. Mientras que la mayoria de generadores se basan en la conexion a un origen de datos, LL recibe los datos al momento, y su origen puede ser cualquiera, dejando en manos del programador el envio de datos al reporte.

La función DefineData, es la encargada de pasar los datos al reporte, tanto para diseño como para impresión. El primer paso es convertir los datos xBase a formato LL, y el segundo definir el campo o la variable dependiendo del valor recibido como parametro en lAsField. El segundo parametro oLl, es un objeto valido LL ya creado.

Para lanzar el diseñador de informes, llamamos a la funcion Disenya los pasos a seguir son muy simples.
1.- Creamos un nuevo objeto LL oLl = TActiveX():New( oWnd, "L12.List-Label12_Ctrl_32.1" )
2.- Ajustamos varias propiedades del objeto LL
3.- Llamamos a la función DefineData, que le enviara los campos al diseñador de informes.
alias->( DefineData(.t., oLl) )
4.-Invocamos el diseñador
oLl:Do("LlDefineLayout",oWnd:hWnd,"Designer",LL_PROJECT_LIST, "informe.lst")
Facil y sencillo, ahora manipulamos y diseñamos nuestro informe, y lo guardamos. Ya tenemos listo un informe para ser llamado desde nuestra aplicación.

Ya tenemos un informe creado, ahora vamos a llamar el informe desde nuestro programa, podeis revisar el código de la función Imprime que teneis más abjo, el funcionamiento es el siguiente:
1.- Creamos un nuevo objeto LL oLl = TActiveX():New( oWnd, "L12.List-Label12_Ctrl_32.1" )
2.- Ajustamos varias propiedades del objeto LL (inicio de variables, de campos, immpresora por defecto, ...)
3.- Llamamos a la función DefineData, que le enviara los campos al diseñador de informes.

Hasta aqui igual que para el diseñador.

4.- Empezamos la impresión

oLl:Do("LlPrintStart",LL_PROJECT_LIST,"Informe.lst",LL_PRINT_PREVIEW)
oLl:DO("llPrint")
5.- Montamos un bucle que recorra los registros que queremos imprimir, y para cada registro llamamos la Funcion DefineData (convierte y envia los datos aLL) y oLl:DO("llPrintFields") que imprime los campos.

5.- Una vez que hemos terminado los registros que queriamos imprimir, solo nos queda indicarle a LL que ya esta finalizado el listado.
oll:DO("llPrintEnd",0)
oLl:DO("LlPreviewDisplay", "informe.lst", , oWnd:hWnd)


Esto es un ejemplo muy sencillo, pero espero os aclare un poco el modo de funcionar, para ver con más profundidad todas las funciones y parametros, revisad la ayuda del producto.
En el código fuente incluido, se utiliza una tabla cuyo alias es tmp, y se presupone abierta, y una ventana oWnd tambien se presupone definida, y con scope en las funciones.
En la transformacion de tipos de datos, el formato fecha lo convierto a texto, aunque podria convertirse tambien a formato juliano si quisieramos hacer algún tipo de operación con la fecha dentro del informe.
Nada más, esta es mi primera entrada en el blog, así que espero os guste y os sea de utilidad. En la medida del tiempo disponible ire añadiendo nuevas entradas.

Código: #include "cmbtll12.ch" FUNCTION Disenya()    LOCAL oLL,oWnd,hJob,cName:='qsl'    oLl = TActiveX():New( oWnd, "L12.List-Label12_Ctrl_32.1" )    oLl:Do( "LlSetOption", LL_OPTION_MULTIPLETABLELINES, 1)    //Permite multiples tablas    oLl:Do( "LlDefineFieldStart" ) //Limpia buffer de campos    oLl:DO( "LlDefineVariableStart")//Limpia buffer de variablesx    Tmp->( DefineData(.t., oLl) )    oLl:Do("LlSetPrinterDefaultsDir",hJob,"C:\Windows\Temp") //Arranca diseñador    oLl:Do("LlDefineLayout",oWnd:hWnd,"Designer",LL_PROJECT_LIST, "log.lst") RETURN NIL //------------------------------------ FUNCTION Imprime()    LOCAL oLL,oWnd,hJob,cName:='log.lst',cDir:=oAppl:cDirLocal    oLl = TActiveX():New( oAppl:oWnd, "L12.List-Label12_Ctrl_32.1" )    oLl:Do( "LlSetOption", LL_OPTION_MULTIPLETABLELINES, 1)    oLl:Do( "LlDefineFieldStart" )    oLl:DO( "LlDefineVariableStart")    Tmp->( DefineData(.t., oLl) )    oLl:Do("LlSetPrinterDefaultsDir",cDir)    oLl:Do("LlPrintStart",LL_PROJECT_LIST,cName,LL_PRINT_PREVIEW)    oll:DO("llPrintOptionsDialog",oAppl:oWnd:hWnd)    oLl:DO("llPrint")    Tmp->(DBGoTop())    DO WHILE !Tmp->(Eof())       Tmp->(DefineData(.T.,oLl))       oLl:DO("llPrintFields")       Tmp->(DBSkip())    ENDDO    oll:DO("llPrintEnd",0)    oLl:DO("LlPreviewDisplay", cName, , oAppl:oWnd:hWnd)    oLl:DO("llPreviewDeleteFiles",cName,cDir) RETURN NIL //---------------------------------------------- FUNCTION DefineData(lAsField,oLl)    LOCAL FldType, FldContent, lExpr,i,DateBuffer:=Replicate(Chr(0),255)    //Convierte formato xBase a List & Label    FOR i:=1 TO FCount()       DO CASE       CASE FieldType(i)=='N'          FldType:=LL_NUMERIC          FldContent:=Str(FieldGet(i))       CASE FieldType(i)=='C'          FldType:=LL_TEXT          FldContent:=Trim(FieldGet(i))       CASE fieldType(i)=='M'          FldType:=LL_TEXT          FldContent:=FieldGet(i)       CASE FieldType(i)=='L'          FldType:=LL_BOOLEAN          FldContent:=IF(FieldGet(i),'TRUE','FALSE')       CASE FieldType(i)=='D'          FldType:=LL_TEXT          FldContent:=DToC(FieldGet(i))       ENDCASE       IF lAsField          oLl:Do("LlDefineFieldExt",FieldName(i), FldContent, FldType )       ELSE          oLl:Do("LlDefineVariableExt", FieldName(i), FldContent, FldType )       ENDIF    NEXT RETURN NIL