Preguntas frecuentes sobre temas funcionales y técnicos.

Esta FAQ es un punto inicial de soporte, y cubre preguntas diversas pero mayormente relacionadas con manejo de fuentes y compilación de WIFE.

Funcionales

1. Por qué el nombre "WIFE"?

Además de ser la nomenclatura en Ingles para la participante femenina de un matrimonio, en el contexto de este proyecto la palabra no tiene ningún significado. Fue elegida originalmente por ser una palabra fácil de recordar y que comparte varias letras con "SWIFT".

2. Soporta WIFE el MTxxx?

Si. Toda la funcionalidad de WIFE esta diseñada en forma genérica para soportar todos los tipos de mensaje SWIFT, categorías 0 a 9, incluyendo los mensajes de sistema y servicio. Si encuentra algún problema para un MT particular porfamor cargue un issue en el tracker.

3. Soporta WIFE los mensajes de ACK/NACK?

Si. Toda la funcionalidad de WIFE esta diseñada en forma genérica para soportar todos los tipos de mensaje SWIFT, categorías 0 a 9, incluyendo los mensajes de sistema y servicio. Notar que algunas aplicaciónes de enlace a SWIFT colocan el mensaje original confirmado como adjunto del mensaje de sistema ACK, en esos casos el parser dejará el mensaje original como adjunto en el objeto unparsed text (por favor refierase al javadoc para mayor detalle).

4. Esta soportada / planeada la validación del MTxxx?

La validación de mensajes no es un feature implementado en la version Community.

5. Cómo puedo procesar múltiples mensajes contenidos en un solo fichero?

El parser espera la ocurrencia de un solo mensaje por llamada. Los archivos de múltiples mensajes no son soportados pero pueden ser particionados facilmente en su aplicación antes de invocar el parser. En el formato RJE de SWIFT los múltiples mensajes están separados por un símbolo '$' (notar que este s'imbolo es el único caracter que no esta presente en ningún set de caracteres SWIFT).
Si se pasa más de un mensaje al parser, el primero será parseado y los restantes serán colocados como unparsed text en el objeto construido.

6. Cómo puedo parsear y obtener componentes dentro de un campo?

El parser de WIFE inicialmente no parsea el contenido de los campos. Por ejemplo para el campo ":32A:050902JPY3520000," el objeto Tag contendrá como valor el String "050902JPY3520000,". Sin embargo puede usar las calsses de MTnnn y Fieldnn para esto, por ejemplo:

SwiftMessage m = (new SwiftParser()).parse(fin);
Field32A f = new Field32A(m.getBlock3().getTagValue("32A"));
Calendar date = f.getComponent1AsCalendar();
BigDecimal amount = new BigDecimal(f.getComponent3AsNumber().doubleValue());

7. Soporta WIFE el estándard IS0 7775?

WIFE es compatible con el ISO 15022 que reemplaza el viejo ISO 7775. No hemos analizado en profundidad el estándard ISO 7775 porque hasta donde sabemos ha sido deprecado para intercambios SWIFT. Si encuentra algún problema procesando mensajes de estándard ISO 7775 por favor cargue un issue en el tracker.

Distribución y requerimientos

1. Cómo esta distribuido el código fuente y los binarios?

la versión actual de WIFE se distribuye como un fichero zip conteniento el código fuente, los binarios compilados, y las dependencias. Los binarios se encuentran en el jar wife.jar y wife-ide.jar (este últmo conteniendo además el  javadoc). Las dependencias (librerías) estan provistas junto con los fuentes.

2. Cómo se identifica la versión del jar de WIFE jar?

El fichero jar tiene siempre el mismo nombre, y la versión específica esta identificada dentro del mismo en el MANIFEST.

3. Qué versión de JRE necesito para ejecutar WIFE?

El paquete principal de WIFE es compatible con Java 1.4 y eso es todo lo necesario para ejecutar elc omponente en un entorno de producción. El paquete de test, separado en un directorio distinto de CVS, requiere Java 1.5 (ya que utiliza Junit 4).

4. Qué dependencias necesito para ejecutar WIFE?

El paquete principal de WIFE se distribuye con todas las dependenicas necesarias incluidas, por lo tanto no se requiere ningúna librería adicional para compilar o ejecutar el componente.

Compilación de WIFE

1. No puedo compilar el componente porque fallan algunos test

Los test por muchas razones pueden fallar. Algunas veces escribimos casos de test para funcionalidades pendientes de implementación. Si necesita compilar sin la ejecución de los test puede setear el property test.skip a true en la línea de comando ant de la siguiente forma:

ant dist -Dtest.skip=true -Drelease.name=myRelease

2. JUnit Test Failing

Esto es probablemente debido a que el build requires ant-1.7 (aparentemente, ant-1.6.5 no reconoce correctamente los test de junit 4).
Eclipse (3.2.2) trae ant-1.6.5 con lo cual si es su caso debe descargar e instalar ant y lugo en Eclipse: Menu -> Window -> Preferences -> Select ANT/Runtime -> Click en "Ant Home" y seleccionar el directorio base de su instalación de ant.

3. "junit" tag no definido para ant

Si esto sucede, es probable que sea por algunos problemas de Eclipse (3.2.2) respecto de los classpaths. Para arreglarlo:

A) copiar los ficheros "junit-4.3.1.jar", "junit-4.3.1-javadoc.jar", "xmlunit-1.0.jar" descargados por el build al directorio "target/lib/test" hacia el directorio donde esta instalado ant o bien a $HOME/.ant/lib

B) Intentar el rebuild. Si aún falla, en Eclipse: Menu -> Window -> Preferences -> Select ANT/Runtime -> Select Classpath tab -> Select item "Ant Home Entries" -> Click en "Add External JARs..." y agregar los jars copiados.