Consejería de Hacienda y Administración Pública

Trew@ v2.0.0

Notas sobre AppletScan v2.0.3

Versión: v01r00
Fecha: 25/03/2011

Queda prohibido cualquier tipo de explotación y, en particular, la reproducción, distribución,

comunicación pública y/o transformación, total o parcial, por cualquier medio, de este documento sin
el previo consentimiento expreso y por escrito de la Junta de Andalucía.
 Consejería de Hacienda y
Trew@ v2.0.0
Administración Pública
Notas sobre AppletScan v2.0.3

HOJA DE CONTROL

Título Trew@ v2.0.0

Entregable Notas sobre AppletScan v2.0.3

Nombre del Fichero TRW001E_OTR_Notas AppletScan_0100.doc

Autor Guadaltel, s.a.

Versión/Edición v01r00 Fecha Versión 25/03/2011

Aprobado por Fecha Aprobación -

Nº Total Páginas 010

REGISTRO DE CAMBIOS

Responsable del Área Fecha del

Versión Causa del Cambio
Cambio Cambio

Adaptación a la plantilla de la oficina Trew@

v01r00 de calidad Guadaltel, s.a. v2.0.0 25/03/2011

CONTROL DE DISTRIBUCIÓN

Nombre y Apellidos Cargo Área Nº Copias

Manuel Perera Domínguez
Francisco Mesa Villalba
Francisco González Guillén
Servicio de Coordinación de
Jefe de Servicio Admón. Electrónica 1
Servicio de Coordinación de
Admón. Electrónica 1
Servicio de Coordinación de
Admón. Electrónica 1

Trew@ v2.0.0 v01r00 Página 2 de 10

 Consejería de Hacienda y
Trew@ v2.0.0
Administración Pública
Notas sobre AppletScan v2.0.3

ÍNDICE

1 INTRODUCCIÓN ......................................................................................................................................... 4

1.1 Objeto........................................................................................................................................................ 4

1.2 Alcance ..................................................................................................................................................... 4

2 AppletScan..................................................................................................................................................... 5

2.1 Ficheros a distribuir................................................................................................................................... 5

2.2 Novedades de la versión v2.0.3................................................................................................................. 5

2.3 Parámetros del Applet (Desde v2.0.2)....................................................................................................... 5

2.4 Desbordamientos de memoria................................................................................................................... 7

2.5 Errores controlados ................................................................................................................................... 8

3 ANEXOS ..................................................................................................................................................... 10

4 GLOSARIO ................................................................................................................................................. 10

5 BIBLIOGRAFÍA Y REFERENCIAS.......................................................................................................... 10

Trew@ v2.0.0 v01r00 Página 3 de 10

 Consejería de Hacienda y
Trew@ v2.0.0
Administración Pública
Notas sobre AppletScan v2.0.3

1 INTRODUCCIÓN

1.1 Objeto

El presente documento define el conjunto consideraciones a tener en cuenta para integrar AppletScan en
aplicaciones clientes de “Trew@” (tal y como se puede encontrar en la aplicación de ejemplo “agenda y
escritorio de tramitación” distribuida con el entregable de Trew@ ).

1.2 Alcance

Este documento va dirigido a:

• La dirección del proyecto w@ndA.

• El colectivo de usuarios y desarrolladores de sistemas que usan Trew@ como motor de tramitación.

Trew@ v2.0.0 v01r00 Página 4 de 10

 Consejería de Hacienda y
Trew@ v2.0.0
Administración Pública
Notas sobre AppletScan v2.0.3

2 AppletScan

2.1 Ficheros a distribuir

A continuación se detallan los ficheros y librerías necesarios para poder integrar el AppletScan en una aplicación
de tipo escritorio así como el uso y destino de los mismos.

Fichero Descripción Destino

jtwain.dll Librería desarrollada en C y que es quien Windows\System o cualquier otra

verdaderamente maneja a más bajo nivel la carpeta que forme parte del
interfaz del escáner. PATH del sistema.

JFreeTwain.jar Jar firmado que actúa de nexo de unión public_html

entre nuestra aplicación y la librería
jtwain.dll.

Su funcionamiento es sencillo, carga la

jtwain.dll en memoria y define las
cabeceras de métodos nativos que al
invocarlos no hacen más que invocar los
métodos reales de la jtwain.dll.

itext-1.3.1.jar Librería utilizada para la generación de public_html

pdfs.

scanFreeApplet.jar Es el Applet firmado. Contiene la lógica public_html

del proceso, y utiliza para ello las librerías
JFreeTwain.jar e itext-1.3.1.jar.

2.2 Novedades de la versión v2.0.3

Esta versión corrige un BUG detectado en la v2.0.2: Tras incorporar ( o no, dependiendo de la
parametrización ) el fichero PDF al ServLet, si el desarrollador había indicado vía parámetro que deseaba
eliminar el fichero PDF al final del proceso, el Applet omitía este parámetro y nunca eliminaba el fichero
PDF del equipo local.

Se incluye una etiqueta que muestra la fecha y versión del Applet.

2.3 Parámetros del Applet (Desde v2.0.2)

A continuación de detallan los parámetros que son necesarios pasar al applet desarrollado “scanFreeApplet.jar”.

Trew@ v2.0.0 v01r00 Página 5 de 10

 Consejería de Hacienda y
Trew@ v2.0.0
Administración Pública
Notas sobre AppletScan v2.0.3

Parámetro Descripción Valores predefinidos

IdDoc Identificador del documento al que se

desea asociar el pdf obtenido tras
escanear.

Si no se especifica no se invocará al
servLet de subida tras obtener el
documento del escáner.

urlSubida Ubicación del servLet encargado de

adjuntar los documentos.

Si no se especifica no se invocará al
servLet de subida tras obtener el
documento del escáner.

rutaYNombrePDF Determina la ruta donde se almacenará Nulo o cadena vacía

y el nombre del documento que se (PARAM_PDF_SIN_RUTA): Se le
obtiene tras escanear. permite al usuario seleccionar el
nombre y la ruta.

Ruta por defecto

(PARAM_PDF_DEFAULT_RUTA
): Se genera el archivo en la carpeta
de archivos temporales de Windows
con una generación automática del
nombre del pdf.

Ruta específica: Se genera el PDF

en la ruta especificada. En caso de
no existir dicha ruta se genera en la
carpeta de archivos temporales de
Windows.

Trew@ v2.0.0 v01r00 Página 6 de 10

 Consejería de Hacienda y
Trew@ v2.0.0
Administración Pública
Notas sobre AppletScan v2.0.3

EliminarPDF Eliminar el fichero pdf tras “SI” / “NO”

incorporarlo (en caso de que se haya
producido la incorporación) o
mantener dicho fichero en la ruta local
del parámetro descrito en el punto 2 de
esta página

2.4 Desbordamientos de memoria

Se han detectado 3 puntos donde la aplicación puede provocar desbordamientos de memoria:

1. Librería jtwain.dll: La propia dll de C++ no es capaz de gestionar la adquisición de imágenes que
sobrepasen en su conjunto un cierto volumen.

* Por ejemplo, una imagen a 600x600, varias a 150x150, etc.

2. Librería itext-1.3.1: El jar encargado de generar el pdf no es capaz de gestionar la creación de documentos
pdfs a partir de las imágenes obtenidas si estas sobrepasan un cierto volumen.

* Se han llegado a generar PDFs de 30 Mb.

3. El Servlet de subida puede fallar con ficheros que superen un cierto peso.

* No se puede considerar un problema del applet, pero se recoge como incidencia a tener en cuenta a la hora de
posibles limitaciones que deban ser aplicadas.

La solución parece pasar por limitar, modificando el código de la jtwain.dll, las prestaciones máximas
soportadas, y si se detecta que el usuario ha seleccionado unas prestaciones superiores ajustar éstas
automáticamente a las preestablecidas como máximas.

Los applets desarrollados implementan un control de los errores más comunes que puedan surgir en el proceso
de obtención de imágenes y posterior subida a la base de datos. Los errores controlados de detallan en el
siguiente apartado.

Trew@ v2.0.0 v01r00 Página 7 de 10

 Consejería de Hacienda y
Trew@ v2.0.0
Administración Pública
Notas sobre AppletScan v2.0.3

2.5 Errores controlados

2.5.1 Hardware no encontrado o no disponible

El dispositivo destinado a devolvernos la imagen no se encuentra instalado o no está disponible en el momento

de su invocación.

2.5.2 Librería no encontrada

La librería nativa (dll) que usa la API Twain no se encuentra en el sistema o está en una ruta que no está incluida
en el PATH del sistema.

2.5.3 Imagen no válida

La imagen obtenida, por varios posibles motivos, no es válida.

Trew@ v2.0.0 v01r00 Página 8 de 10

 Consejería de Hacienda y
Trew@ v2.0.0
Administración Pública
Notas sobre AppletScan v2.0.3

2.5.4 Error al resolver el Servlet

No se ha podido resolver la URL de destino donde se esperaba encontrar al Servlet.

2.5.5 Error por falta de parámetros obligatorios

En la llamada al Servlet no se están pasando parámetros que se consideran obligatorios para que dicha llamada
funcione.

2.5.6 Error en la creación del fichero temporal

El fichero temporal que se genera partiendo de la imagen obtenida no se ha podido crear de forma correcta.

Trew@ v2.0.0 v01r00 Página 9 de 10

 Consejería de Hacienda y
Trew@ v2.0.0
Administración Pública
Notas sobre AppletScan v2.0.3

3 ANEXOS

No hay anexos.

4 GLOSARIO

No hay glosario, no se cree necesario.

5 BIBLIOGRAFÍA Y REFERENCIAS

Referencia Título Código

Manual de operación (instalación y configuración) de Trew@

Manuales de usuario y notas sobre los ejemplos de interfaz

Trew@ v2.0.0 v01r00 Página 10 de 10