WireLess Mobile Downloader

Web Downloader.doc

20040802 Version 1.0_es

WireLess Mobile Downloader

Resumen.

Se encuentra disponible la nueva versión del Cliente WireLess Mobile para Pocket PC 2002 (1.1.0). Incluye un nuevo paradigma para establecer las preferencias. El paradigma anterior (es decir, la configuración es actualizada a través de opciones de menú en el Modo Administrador) está aún vigente, pero se ha agregado una nueva que permite leer parte de la configuración desde un archivo, y cargarla en el registro. Este archivo se genera externamente y se transfiere al dispositivo a través de Active Sync o mediante un nuevo componente llamado WireLess Mobile Downloader.

WireLess Mobile Downloader trabaja sobre HTTP, y permite descargar un grupo de archivos. Uno de ellos es el _dnlce.cfg, que contiene los nombres del resto de los archivos a descargar, así como la ruta de la aplicación a la cual se devuelve el control, luego de que el descargador finalice su tarea.

Uno de los archivos que pueden incluirse en _dnlce.cfg es el _wirelessmobile.cfg. Si se descarga este archivo al directorio raíz del dispositivo, el Cliente WireLess Mobile carga todas las entradas del archivo en el registro, y luego borra el archivo.

Dado que el Cliente WireLess Mobile se cierra cuando llama a la ejecución de WireLess Mobile Downloader, es posible actualizar la versión del Cliente WireLess Mobile, incluyendo el archivo ejecutable en la lista de archivos a descargar.

Estructura de _dnlce.cfg

La primera línea es siempre la misma. La segunda indica la versión. Para cada línea, la doble barra “//” indica que lo que sigue en esa línea es un comentario, y es ignorado por el descargador. Existen dos secciones, y sus nombres se escriben entre corchetes. Las líneas entre dos nombres de secciones, o más allá del último nombre de sección, se consideran parte de la sección correspondiente al nombre de sección inmediatamente anterior.

Las líneas de una sección comparten la siguiente sintaxis:

Key=Value

Una de las secciones debe ser [DOWNLOADS]. Esta sección contiene una clave “Number” cuyo valor es la cantidad de archivos a descargar. A continuación deben indicarse claves de la forma “FileXX”, donde XX (2 dígitos) va de 01 hasta el valor esepecificado en “Number”. La estructura de la clave “FileXX” es:

File<XX>=[relative_url]source_file[,[absolute_path]destination_file]

relative_url es relativa a la página de descarga a la cual se conecta Web Downloader. Si no se indica relative_url, el descargador asume que se trata de la página a la cual está conectado.

source_file (obligatorio): es el nombre del archivo a descargar.

absolute_path: es la ruta del directorio donde se descarga el archivo. Si no se indica, Web Downloader asume que se trata del directorio raíz (\) del dispositivo.

destination_file: el nombre que Web Downloader usa para almacenar el archivo descargado. Si no se indica, se utiliza el nombre original.

Se puede incluir una sección opcional llamada[RETURN]. Consiste de solo una clave “To” que contiene la ruta absoluta del archivo a ejecutar una vez que se concluye con las tareas del descargador. El Cliente Wireless Mobile se fija a sí mismo como aplicación a la cual volver desde el Downloader. Así, si no se incluye esta sección, el descargador devolverá el control al Cliente WireLess Mobile, por defecto.

Ejemplo:

%%FILE=_dnlce.cfg%%

// V100

// dnlce associated files for download

[DOWNLOADS]

Number=4

File01= _wirelessmobile.cfg

File02= AOBE.cd_ , WM\AOBE.cdb

File03= WM/wm-app.ex_ , \WM\wm-app.exe

File04= WM/zip.dll_ , \zip.dll

File05= WM/unzip.dll_ , unzip.dll

[RETURN]

To= \Windows\WM\wm-app.exe

Si _dnlce.cfg está alojado en http://my_site/dnl, y Web Downloader está configurado para conectarse a esta dirección, descargará los siguientes archivos:

http://my_site/dnl/_wirelessmobile.cfg en \_wirelessmobile.cfg

http://my_site/dnl/AOBE.cd_ en \WM\AOBE.cdb

http://my_site/dnl/WM/wm-app.ex_ en \WM\wm-app.exe

http://my_site/dnl/WM/zip.dll_ en \zip.dll

http://my_site/dnl/WM/unzip.dll_ en \unzip.dll

y devolverá el control a la versión actualizada (recientemente descargada) de wm-app.exe.

Estructura de _wirelessmobile.cfg

Este archivo se utiliza para configurar todas las opciones que pueden ser modificadas en el dispositivo. La primera línea es siempre la misma. La segunda indica el número de versión. El doble caracter “%%” indica que lo que sigue es un comentario, y es ignorado por el cliente. Las líneas de una sección comparten la siguiente sintaxis:

Key = Value

Antes de procesar las claves y valores, los espacios en blanco y tabuladores son removidos. Por lo tanto, no importa si se usa este tipo de caracteres para ordenar los datos en columnas. Los valores pueden ser NULL, indicando que el valor está vacío.

Existen varias secciones y sus nombres se escriben entre corchetes. Las líneas entre dos nombres de secciones, o más allá del último nombre de sección, se consideran parte de la sección correspondiente al nombre de sección inmediatamente anterior. Las entradas que están por encima de la primera sección no corresponden a ninguna sección. La estructura formada por las secciones, y las claves y valores se considera como una relación uno-a-uno con el registro. Todas las secciones que no existan en el registro se agregarán. Esta característica funcionará tanto para la versión actual del cliente como para versiones futuras. De esta manera, Web Downloader manejará entradas adicionales utilizadas por los clientes.

A continuación se muestra un ejemplo de configuración de un cliente a la fecha.

%%FILE=_wirelessmobile.cfg%%

%% V100

%% Null Section Root of the tree. It will be stored into

%% HKEY_CURREN_USER\Software\<Corp_Id>\

%% 12 entries

Password = %% Commentary

OldInstallDir =

MsgDll = ResAobeUs.dll

BackgroundTimer = 300

AppName = WM Intranet

CabTitle = WireLess Mobile

CreatorId = WMWM

EmptyDb = empty.cdb

CacheSize = 128

OutGoingDataLocation = \Windows\WM

HomepageLogo = LogoWM.gif

Homepage = WM.html

[LoginDlg]

%% 5 entries

TitleLbl = WM

PasswdLbl = Password

LogoFilename = SOFTOGO.gif

LoginLbl = Login

AutoChangeUser = off

[Servers]

%% 4 entries

DeviceType = ppc02

ConnectionName = WMCon

AutoDial = off

ConnectionType = ras

[Servers\srvWM]

%% 3 entries

URL = http://10.10.10.15/wm_fr/PalmSynchro/PalmSynchSrv.asp

PWD = 41de8b

UID = marcela