Notas del release para WebSphere Business Integration Adapters Versión 2.3.1, para Windows

Estas notas del release tratan de la información del release para WebSphere Business Integration Adapters, versión 2.3.1, para Windows. Éstas contienen las secciones siguientes:
Novedades de este release API de WebSphere Business Integration Adapters
Historial de arreglos del producto Problemas conocidos y soluciones temporales
Requisitos de hardware y software Actualizaciones de la documentación
Información de instalación, migración, actualización y configuración

Nota: Es posible que información importante sobre este producto esté disponible en las Últimas noticias de soporte técnico (Technical Support Flashes) emitidas después de la publicación de estas notas del release. Éstas se pueden encontrar en el sitio Web de soporte de WebSphere Business Integration, http://www.ibm.com/websphere/integration/wbiserver/support. Seleccione el área del componente de su interés y realice búsquedas en la sección de últimas noticias (flashes).

Novedades de este release 

Esta sección lista las nuevas características y mejoras realizadas en este release.

WebSphere Business Integration Adapters Framework

API de WebSphere Business Integration Adapters

Para ver detalles, consulte el manual Connector Development Guide for Java.

Historial de arreglos del producto

API de WebSphere Business Integration Adapters

Número
de CR
Descripción
12271 Soporte para un nuevo manejador de objetos comerciales personalizados. Se ha añadido una nueva interfaz, CWCustomBOHandlerInterface, que tiene el método doVerbForCustom. Los adaptadores que utilizan manejadores de objetos comerciales personalizados deben implementar esta interfaz. Además, la información específica de la aplicación del verbo de objeto comercial debe cambiar de forma que CBOH=nombre_clase_manejador_OC_personalizados (asegúrese de utilizar el nombre completo de vía de acceso, es decir, empiece la vía de acceso con "com.").
17975 Cuando se produce una excepción, los métodos de la API de WebSphere Business Integration Adapters ahora registran el mensaje de excepción e imprimen el rastreo de pila.
19664

Se ha añadido una nueva propiedad, EventStoreFactory. Si está establecida en la instancia de fábrica del almacén de sucesos del conector, es decir, com.crossworlds.connectors.JDBC.JDBCEventStoreFactoryInstance, se utiliza para obtener el almacén de sucesos; si no está establecida en dicha instancia, la API intenta crear el nombre de clase de instancia de fábrica de almacén de sucesos en base a la información del paquete. Además, se han añadido TRUESTRING y FALSESTRING a CWConnectorAttrType, y las cadenas codificacadas "true" se han sustituido por esto.

19665 Si se especifica cualquier otro dato que no sea un entero para pollQuantity, pollForEvents devuelve un resultado no satisfactorio (FAIL).
19673 Se ha añadido un nuevo método, getAppText, que toma un delimitador y un nombre de propiedad, a CWConnectorBusObj. En base al nombre de propiedad y delimitador, se devuelve el valor para la propiedad en la información específica de la aplicación.
22702 Se ha añadido un nuevo método, setDEEId, en la clase CWConnectorBusObj. Establece el atributo ObjectEventId en el ID de suceso:

public void setDEEId(String eventid)

devuelve AttributeNotFoundException, AttributeValueException.

22877 Se ha añadido un nuevo método, getEventStore, a la clase CWConnectorAgent. Este método obtiene el almacén de sucesos del conector y devuelve un objeto CWConnectorEventStore:

public CWConnectorEventStore getEventStore()

El método pollForEvents por omisión se ha modificado para realizar una llamada a este método. Además, existe una implementación por omisión para este método. Primero comprueba la propiedad EventStoreFactory. Se debe establecer la propiedad EventStoreFactory en la implementación de la interfaz CWConnectorEventStoreFactory. Si lo está, se crea la instancia de esta clase y obtiene el almacén de sucesos del conector. Si la propiedad no está establecida, el método intenta crear el nombre de implementación a partir del paquete del conector.

El conector tiene la opción de alterar temporalmente este método y proporcionar su propio método. Es útil si el conector desea utilizar constructores que no sean el constructor por omisión.

23369 APPRESPONSETIMEOUT de la llamada de método doVerbFor no termina anormalmente el conector cuando se llama a doVerbFor desde dentro de pollForEvents. Para habilitar esto, el estado se debe propagar hacia arriba de pollforEvents y pollForEvents debe devolver APPRESPONSETIMEOUT.
23406 Se han añadido las constantes de verbo EXISTS y RETRIEVEBYCONTENT a la clase CWConnectorConstants.
23612 Para ver información específica de la aplicación a nivel de atributo o de objeto comercial, los identificadores que no tengan valores como por ejemplo nombre_archivo_ior=;nombre_poa=server fallaban con "No such element found Exception". Esto se ha arreglado.
23620 El establecimiento del metaobjeto de configuración y la creación del manejador de datos no se realiza en un paso atómico (o sincronizado). Esto estaba causando problemas con la clase de base del manejador de datos cuando múltiples pasos de proceso entraban en la API de WebSphere Business Integration Adapters. Ahora se ha sincronizado el código para llamar a setConfigMO. Además, se llama al método sólo una vez, y las llamadas subsiguientes continúan creando el manejador de datos.

Requisitos de hardware y software

Los requisitos de hardware y software se incluyen en la documentación del producto. Consulte Información de instalación, migración, actualización y configuración para ver enlaces a estas guías.

Información de instalación, migración, actualización y configuración

Si está instalando el software desde el CD o descargándolo de Passport Advantage e instalándolo desde un directorio local, consulte la guía adecuada:

Estas guías también incluyen información de migración, actualización y configuración.

API de WebSphere Business Integration Adapters

Asegúrese de ejecutar los adaptadores con la API de WebSphere Business Integration Adapters (WBIA) versión 1.5.0 o posterior.

Verificación de la versión de la API de WBIA

Para comprobar la versión de la API de WBIA, localice el archivo de manifiesto (DirProducto/lib/WBIA.jar) y ábralo en un editor Java JAR adecuado. Busque las líneas siguientes:

Implementation-Title: "CWConnectorAPI"
Implementation-Version: 1.5.0
Implementation version (Versión de implementación) indica la versión actual de la API de WBIA.

Si la versión no es 1.5.0 o posterior, debe descargar la versión más reciente de la API de WBIA.

Descarga de la API de WBIA

Para descargar la versión más reciente de la API de WBIA:

  1. Vaya a http://www.ibm.com.
  2. Pulse la pestaña Support and downloads (Soporte y descargas).
  3. Bajo la cabecera Downloads (Descargas), pulse All downloads & drivers (Todas las descargas y controladores).
  4. En el campo Enter search terms (Entrar términos de búsqueda), escriba "wbia api" y pulse Submit (Someter).

Después de descargar e instalar la API, debe ver los archivos siguientes:

lib/WBIA.jar
lib/WBIA/3.0.0/WBIA.jar
lib/WBIA/4.0.0/WBIA.jar
lib/WBIA/4.1.1/WBIA.jar
bin/CWConnEnv.sh
bin/CWODAEnv.sh
connectors/messages/CwConnectorAgentMessages.txt

Habilitación de los adaptadores para versiones anteriores de Adapter Development Kit e InterChange Server

Para habilitar que un adaptador funcione con varias versiones de ADK o InterChange Server, siga el procedimiento adecuado de más abajo:

InterChange Server versiones 4.0.1, 4.1.0, ADK versión 2.0.x

En CWConnEnv.sh, establezca la variable CWVERSION en 4.X.

set CWVERSION="4.X"
InterChange Server versiones 4.1.x (excepto 4.1.0), ADK versión 2.1.x

En CWConnEnv.sh, establezca la variable CWVERSION en 4.1.X.

set CWVERSION="4.1.X"
Ejecución de un Object Discovery Agent (ODA) contra InterChange Server versiones 4.0.1 y 4.1.x, ADK versiones 2.0.x y  2.1.x

En bin/CWODAEnv.sh, establezca la variable CWVERSION en 4.1.X.

set CWVERSION="4.1.X"

Problemas conocidos y soluciones temporales

Versión en tiempo de ejecución de WebSphere Business Integration Adapters

Número
de CR
Problema
23373 La ejecución de conectores creados con la versión 2.1 de Connector Development Kit (CDK) con el build de 2.3.1 CDK devuelve errores de tiempo de ejecución.

Solución temporal: Vuelva a compilar el conector con el parche de 2.1 CDK.

23374 La ejecución de conectores creados con la versión 2.0 de Connector Development Kit (CDK) con el build de 2.3.1 CDK devuelve errores en tiempo de ejecución.

Solución temporal: Vuelva a compilar los conectores con el parche de 2.0 CDK.

23482

Debido a una limitación de WebSphere MQ, los adaptadores no pueden escribir texto de mensaje XML de más de 100 MB en una cola MQ para procesar. Este problema se produce cuando JMS es el transporte y WMQI o WAS es el intermediario de integración. La versión en tiempo de ejecución del adaptador convierte los objetos comerciales en mensajes XML, que se pueden hacer muy grandes.

Solución temporal: Evite crear más de 25000 objetos hijo por objeto comercial.

24108 La ejecución de los conectores creados con la versión 2.2 de Connector Development Kit (CDK) con el build de 2.3.1 CDK devuelve errores en tiempo de ejecución.

Solución temporal: Vuelva a compilar los conectores con el parche de 2.2 CDK.

 Herramientas de WebSphere Business Integration Adapter

Número
de CR
Descripción
19283 No instale las herramientas de WebSphere Business Integration Adapters en un directorio con un espacio en su nombre (por ejemplo, C:\Archivos de programa). La instalación de las herramientas en un directorio que contenga un espacio impide que éstas funcionen con el Gestor del sistema.

Solución temporal: Cuando el Instalador le solicite una ubicación en la que instalar, seleccione un directorio sin espacios en su nombre. Si está instalando los plugins de WebSphere Business Integration Toolset en una instalación existente de WebSphere Application Developer Integration Edition, asegúrese de que el directorio de instalación existente no contenga espacios.

22302 Si inicia una de las herramientas del diseñador, y se devuelve un error de "clase no encontrada", debe iniciar el Gestor del sistema y, a continuación, iniciar la herramienta de nuevo. El Gestor del sistema no tiene que permanecer en ejecución una vez que la herramienta ya está iniciada.

Instalador de WebSphere Business Integration Adapters

Número
de CR
Descripción
11983, 12221, 13382, 17788, 20169 Se han arreglado múltiples problemas existentes en la versión 4.2.1.0 con el panel Selección de componentes. Éstos incluyen:
  • El panel se renueva después de cada selección
  • Texto no legible en el panel al contraer componentes
  • La selección de los componentes padre no selecciona todos los subcomponentes
  • La selección de un subcomponente seleccionaba todos los subcomponentes
20679 Si InterChange Server es el intermediario de integración, asegúrese de instalar los adaptadores desde WebSphere Business Integration Adapters, versión 2.3.1, en el directorio donde ICS está instalado.
19283 Vea la descripción.
22937

Debido a los cambios de nombre del adaptador, es posible que la instalación de la versión 2.3.1 de WebSphere Business Integration Adapters sobre la 2.3.0 dé como resultado atajos de escritorio redundantes. Por ejemplo, la versión anterior de Adapter for e-Mail creaba un atajo denominado "Conector de EMail". La actualización del adaptador a la versión 2.3.1 crea un nuevo nombre de atajo, "Conector de e-Mail".

Solución temporal:  Elimine manualmente el atajo de escritorio antiguo para evitar la confusión. Por ejemplo, pulse con el botón derecho Inicio > Abrir todos los usuarios. Navegue a Programas > IBM WebSphere Business Integration Adapters > Adaptadores > Conectores y a continuación suprima el atajo "Conector de EMail".

23604 El script de inicio del Gestor del sistema tiene una barra inclinada invertida adicional ( \ ), que causa que el Gestor del sistema no pueda cargar algunos de los archivos de los plugins de las herramientas.

Solución temporal: Elimine manualmente la barra inclinada invertida adicional ( \ ) del archivo startcsm.bat, que está en el directorio DirProducto\bin (donde DirProducto es el directorio en el que ha instalado el producto). Modifique la tercera línea del archivo startcsm.bat:

set WSWB_PATH=C:\WebSphereAdapters\Tools\WSWB203\

cambiándola a:

set WSWB_PATH=C:\WebSphereAdapters\Tools\WSWB203

donde C:\WebSphereAdapters\Tools\WSWB203 es la ubicación de la instalación de WebSphere Studio Workbench 2.0.3.

24554 Cuando ejecute cualquier desinstalador en entornos locales distintos del inglés, es posible que la GUI muestre caracteres no legibles.

Solución temporal: Utilice una desinstalación silenciosa. Desde la línea de mandatos, vaya al directorio _uninstall y entre el mandato siguiente:

java -cp ./uninstall.jar run -silent

Instalador de terceros

Número
de CR
Problema
23778 Es posible que el texto del título en el panel Selección de idioma esté truncado en el entorno local del idioma que seleccione. No se puede cambiar el tamaño del diálogo Selección de idioma.
24013 Si está utilizando el entorno local de chino simplificado, no se pueden entrar caracteres chinos en el campo de entrada del Panel de destino. 

Soluciones temporales: Puede utilizar una de estas soluciones temporales

  • Cree la carpeta de instalación del producto antes de ejecutar el instalador. Durante el procedimiento de instalación, en el Panel de destino, pulse Examinar para seleccionar la carpeta que ha creado. 
  • Se puede forzar al instalador a utilizar otra versión de Java Runtime Environment, si está instalado en el sistema, ejecutando el siguiente mandato de Java:

    java -cp setup.jar run

    Puede utilizar el producto Sun JRE 1.4.0, que se puede instalar desde el sitio Web de Sun Microsystems. Este producto le permite utilizar los caracteres de chino simplificado.

Actualizaciones de la documentación

La documentación del producto no se incluye como parte del paquete del producto, en soporte de CD ni mediante distribución electrónica del producto. La documentación de este producto se puede encontrar en los Centros de información siguientes:

Para obtener la documentación del producto, visite el sitio Web y descargue el conjunto de documentación actual para el release que esté utilizando. Siga las instrucciones proporcionadas en la página del Centro de información para completar la instalación.

Copyright IBM Corp. 1997, 2003