Instalar y configurar los adaptadores de Microsoft BizTalk para aplicaciones empresariales
Los adaptadores de Microsoft BizTalk para aplicaciones empresariales incluyen los siguientes adaptadores:
Adaptador de Microsoft BizTalk para JD Edwards OneWorld
Adaptador de Microsoft BizTalk para JD Edwards EnterpriseOne
Adaptador de Microsoft BizTalk para PeopleSoft Enterprise
Adaptador de Microsoft BizTalk para TIBCO Rendezvous
Adaptador de Microsoft BizTalk para TIBCO Enterprise Message Service
Importante
- Realice una copia de seguridad de todos los datos antes de realizar cualquier cambio de configuración.
- Debe tener experiencia con la aplicación de empresa específica antes de realizar cualquier cambio de configuración.
Versiones admitidas & requisitos
Componente | Requisitos |
---|---|
Sistema operativo | El adaptador admite el mismo sistema operativo que BizTalk Server: |
Sistema empresarial compatible | |
JD Edwards OneWorld XE |
|
JD Edwards EnterpriseOne | El adaptador llama a la API JD Edwards EnterpriseOne que usa JDBC, que necesita un controlador para la base de datos. Si instala JD Edwards EnterpriseOne con una base de datos SQL, necesita controladores MS SQL. Del mismo modo, si instaló JD Edwards EnterpriseOne con una base de datos de Oracle, necesita controladores de Oracle; o si ha instalado con una base de datos DB2, necesita controladores DB2. |
PeopleSoft Enterprise |
|
TIBCO Rendezvous |
|
TIBCO Enterprise Message Service | La versión Enterprise Message Service (EMS) 5.x y superiores incluye un cliente SDK (mediante la API TIBCO EMS C#). El adaptador de BizTalk para TIBCO EMS lo usa para comunicarse con el servidor. |
JD Edwards OneWorld XE
En esta sección se incluye información clave sobre el uso del adaptador de Microsoft BizTalk para JD Edwards OneWorld XE con BizTalk Server.
Crear los archivos JAR
Esta sección describe los requisitos para que JD Edwards OneWorld trabaje con el adaptador de Microsoft BizTalk para JD Edwards OneWorld.
Archivos JAR y CLASSPATH
Los archivos JAR de JD Edwards OneWorld deben estar disponibles para el adaptador. Por ejemplo, para conectarse a la versión B7.3.3.3, se requieren los siguientes archivos JAR. En función del servidor que conecte, la lista de archivos jar puede cambiar:
- Connector.jar
- Kernel.jar
Estos archivos se encuentran en un equipo que ejecuta JD Edwards OneWorld, en las siguientes ubicaciones:
JD Edwards OneWorld XE_install_Directory\System\classes\Connector.jar
JD Edwards OneWorld XE_install_Directory\System\classes\Kernel.jar
Puede copiar estos archivos en cualquier ubicación. Sin embargo, debe especificar la ubicación de los archivos JAR en CLASSPATH. CLASSPATH debe incluir la ruta de acceso completa del archivo y el nombre del archivo JAR (separado por punto y coma).
El adaptador de BizTalk para JD Edwards OneWorld proporciona el archivo JAR JDEJAccess para su uso con JD Edwards OneWorld. De forma predeterminada, se hace referencia al archivo JDEJAccess.jar desde Archivos de programa\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\J.D. Edwards OneWorld(r)\classes\JDEJAccess.jar.
Nota
Debe comprobar el registro del archivo jdeinterop.ini antes de poder utilizar el adaptador de BizTalk para JD Edwards OneWorld. Asegúrese de incluir una ruta de acceso a este archivo en la página Propiedad de transporte de JDE al crear el puerto de envío en BizTalk Server. Para obtener una explicación completa, consulte "Personalizar el archivo jdeinterop.ini".
Creación del archivo BTSLIBinterop.jar
Cree el archivo y confirme que el adaptador puede acceder a él. Use el ejemplo siguiente como guía:
Cree el archivo BTSLIB.cmd que contiene el código siguiente:
define library BTSLIB login library BTSLIB interface JDEAdapter import B5500900 build logout
Ejecute el siguiente comando:
GenJava /cmd .\BTSLIB.cmd
Comprobación de la configuración
Use una versión compatible, incluido el número de Service Pack (sistemas de línea de negocio (LOB) y Enterprise compatibles. Los Service Packs (ESU y ASU) actualizan los archivos binarios del sistema. El requisito previo del Service Pack proporciona la opción de menú ASU/ESU para la importación.
Configure el archivo jdeinterop.ini para usar la unidad correcta para el registro, si difiere de la unidad C. Por ejemplo, la actualización de JD Edwards OneWorld puede producir un error si el directorio TEMP está fuera del espacio.
Determine si debe agregar un archivo de configuración para el margen izquierdo o derecho de los campos de JD Edwards OneWorld.
Compruebe que la variable de entorno JAVA_HOME apunta a la instalación del Kit de desarrollo de Java (JDK) para habilitar los comandos javac y java desde cualquier programa en el equipo.
Compruebe que la variable de entorno CLASSPATH está establecida. Esto permite que el adaptador de BizTalk para JD Edwards OneWorld busque los archivos Kernel.jar y Connect.jar.
La ruta de acceso de los archivos JAR distingue mayúsculas de minúsculas.
Pruebe el entorno escribiendo el comando siguiente, que distingue mayúsculas de minúsculas.
javap -s -p com.microsoft.jde.JDEJAccess
El comando que proporciona, javap, es el Desensamblador de archivos de clase de Java:
http://java.sun.com/j2se/1.3/docs/tooldocs/solaris/javap.html
El
javap
comando desensambla un archivo de clase. El resultado depende de las opciones utilizadas. Si no se utiliza ninguna opción, javap imprime el paquete, protegido, y los campos públicos y métodos de las clases pasan a él. El comando javap imprime su salida a stdout.Si no hay ningún error, todos los archivos de Java y sus dependencias se encuentran en CLASSPATH.
Configure la resolución DNS mediante la configuración del archivo host local (C:\WINNT\system32\drivers\etc\hosts), con el nombre del servidor del sistema JD Edwards OneWorld.
Creación e instalación del paquete personalizado
Instale el paquete personalizado BTSREL para usar el adaptador de BizTalk para JD Edwards OneWorld. En esta sección se describe:
- Proceso de creación de paquetes personalizado de JD Edwards OneWorld
- Creación e instalación de BTSREL
- Los objetos BTSREL creados en JD Edwards OneWorld
Nota:
BTSREL.exe es un paquete personalizado (una actualización de software automatizada o ASU, en la terminología de JD Edwards OneWorld). Contiene funciones de negocio para extraer metadatos. Debe crearse un paquete personalizado para una configuración específica y la versión de JD Edwards OneWorld.
Definición de un paquete personalizado
Un paquete personalizado es una versión posterior a la entrega que proporciona cambios de software para fines específicos, como los cambios de las disposiciones legales o mejoras. Estos paquetes personalizados se crean para funcionalidades específicas. Por ejemplo, BTSREL se crea para extraer metadatos. Cuando se instala el paquete personalizado de BTSREL, actualiza los módulos seleccionados en el entorno de JD Edwards OneWorld. Para actualizar, se deben combinar objetos BTSREL en el entorno adecuado de JD Edwards OneWorld. Para obtener una lista detallada de los módulos actualizados por BTSREL, consulte la lista de módulos.
Instalación del paquete personalizado BTSREL
Descargue BTSREL. Instálelo en el servidor de implementación y, a continuación, impleméntelo en el servidor de empresa.
El paquete BTSREL.exe existente funciona directamente con la versión B7333. Para que el paquete funcione con la versión B7334, a continuación:
Descargue y extraiga el contenido de BTSREL.exe en la carpeta de trabajo.
Modifique los valores ReleaseLevelRequired y Release a B7334 en el archivo Deployment.Inf.
Ejecute el programa de instalación.
Para instalar BTSREL, se requiere lo siguiente:
- Instalación del servidor de implementación
- Plataforma de trabajo de la instalación
Instalación de BTSREL en el servidor de implementación
El paquete personalizado solo funciona en un sistema operativo Windows y se usa con el servidor de implementación. Debe compilarse en el servidor de implementación y, a continuación, implementarse en el servidor de empresa. El servidor de empresa suele ser un servidor de producción y puede estar en el sistema operativo Windows o UNIX.
Nota:
Al aplicar la ASU al servidor de implementación de JD Edwards OneWorld, compruebe que está en modo de actualización . El modo Prueba comprueba que no hay errores en la ASU, mientras que el modo de actualización se designa para cuando se aplica el ASU.
Inicie sesión en el servidor de implementación como JDE de usuario.
Cree una carpeta nueva, llamada BTSREL, en la carpeta Servidor de implementación (raíz) /B7.
Copie BTSREL.exe en la carpeta BTSREL recién creada.
Ejecute BTSREL.exe desde la carpeta .../B7/BTSREL. El administrador de instalación se inicia automáticamente.
En la ventana de instalación, seleccione Siguiente y, a continuación, seleccione Finalizar. Se muestra un mensaje si la instalación se realiza correctamente.
Inicie sesión en el entorno JDEPLAN como usuariode JDE en el servidor de implementación de JD Edwards OneWorld.
Si la actualización electrónica de software (ESU) que incluye SAR #4533357 no está instalada en el sistema, seleccione Software Novedades en el menú Herramientas de instalación del sistema (GH9612).
Escriba 02 para la opción 1 en el panel Opciones de procesamiento .
Si la ESU que incluye SAR #4533357 se ha instalado en el sistema, seleccione Actualización de software de aplicación en el menú Herramientas de instalación del sistema (GH9612).
Instalación de BTSREL en JD Edwards OneWorld WorkBench
En la pantalla Trabajar con actualización de aplicaciones , haga doble clic en la actualización BTSREL y, a continuación, seleccione Siguiente.
Haga doble clic en los entornos en los que desea instalar la actualización y, a continuación, seleccione Siguiente.
Compruebe Unattended Workbench si desea que la actualización de software se ejecute en modo desatendido.
Seleccione Copia de seguridad si desea una copia de seguridad de las especificaciones (de modo que se puedan restaurar las especificaciones originales).
En la pantalla Trabajar con plan de instalación , seleccione el plan de la actualización que va a instalar y, a continuación, Seleccione.
Una vez finalizada la instalación, vea los archivos PDF generados automáticamente para consultar los errores.
Nota
Si se producen errores, busque sugerencias para resolver problemas en la Guía de actualización de software de JD Edwards OneWorld o póngase en contacto directamente con JD Edwards OneWorld.
Registre manualmente la biblioteca de funciones empresariales mediante los pasos incluidos en "Registrar manualmente la biblioteca de funciones empresariales" en esta sección.
Desinstalación del paquete personalizado
No hay ningún requisito para desinstalar el paquete personalizado. Sin embargo, si desea limpiar el sistema, puede desinstalar el paquete de maneras diferentes. Después de desinstalar, vuelva a generar el paquete mediante uno de los métodos siguientes:
Use el servidor de implementación JD Edwards OneWorld, Gh8612— P96470, en el menú FILA , seleccione Actualizar y, a continuación, seleccione Desinstalar.
Consulte todos los objetos personalizados (BTSREL) en un equipo cliente y eliminarlos.
Aplique una instantánea de base de datos anterior.
Durante la limpieza, compruebe otras modificaciones a otros objetos de JD Edwards OneWorld.
Registrar manualmente la biblioteca de funciones empresariales
Debido a una limitación del proceso de empaquetado del producto de JD Edwards OneWorld, el archivo DLL de la biblioteca de funciones de negocio personalizada para el adaptador de BizTalk para JD Edwards OneWorld debe registrarse manualmente con JD Edwards OneWorld. Este proceso consta de los pasos siguientes.
Paso 1: Creación de la biblioteca de funciones empresariales personalizada
Con Object Management Workbench (OMW) de JD Edwards OneWorld, cree la biblioteca de funciones de negocio personalizada. El siguiente procedimiento debe realizarse en la configuración inicial y se aplica a todas las plataformas.
Inicie el área de trabajo de administración de objetos (ruta de acceso rápida: "OMW" o selección de menú: GH902 Object: P98220).
Seleccione Agregar y seleccione la opción biblioteca de funciones empresariales.
Escriba la siguiente información para el nuevo objeto de biblioteca de funciones de negocio:
- Nombre: ACBLIB
- Descripción: Microsoft DLL
- Código de producto: 55
- Código del sistema del producto: 55
Seleccione Aceptar.
Paso 2: Recompilación de bibliotecas desde el servidor de implementación
Complete los pasos siguientes sobre la configuración inicial de cada plataforma.
Para iniciar el programa BusBuild en modo independiente, seleccione Iniciar, Ejecutar y, después,busbuild.exe.
Inicie sesión en JD Edwards OneWorld en el código de ruta de acceso (PY7333, PD7333 o DV7333).
En la lista Rebuild Libraries (Recompilar bibliotecas ), seleccione build ( Compilar).
Paso 3: Copia del archivo DLL personalizado
Copie el archivo DLL personalizado del directorio pathcode en los directorios de paquetes primarios en el servidor de implementación de JD Edwards OneWorld y en JD Edwards OneWorld Enterprise Server.
En el servidor de implementación de JD Edwards OneWorld XE
Copie ACBLIB.dll de DV7333\bin32 a DV7333\Packages\DV7333FA\bin32.
Copie ACBLIB.def, ACBLIB.dmp y ACBLIB.mak de la carpeta DV7333\obj a la carpeta DV7333\Packages\DV7333FA\obj.
Copie ACBLIB.exp, ACBLIB.lib y sACBLIB.lib de la carpeta DV7333\lib32 a la carpeta DV7333\Packages\DV7333FA\lib32.
En JD Edwards OneWorld Enterprise Server
Después de crear cada directorio y archivo, compruebe la autorización.
Cree un directorio ACBLIB en DV7333FA\obj\.
Cree un directorio ACBLIB en DV7333FA\source.
FTP b5500900.c del directorio del servidor de implementación DV7333\source al directorio DV7333FA\source\ACBLIB.
FTP b5500900.h del directorio Deployment Server DV7333\include al directorio DV7333FA\include.
Paso 4: Compilar un paquete completo
Debido a una limitación del proceso de compilación de paquetes de JD Edwards, cree un paquete completo para los entornos a los que aplicó la actualización BTSREL o la compilación del paquete de actualización no funciona correctamente. Consulte la documentación de JD Edwards sobre cómo crear una compilación del paquete completo.
Nota
Al aplicar JD Edwards OneWorld como ASU/ESU, ASU/ESU no crea normalmente una nueva biblioteca y las funciones empresariales. Por lo tanto, el proceso es sencillo: sin embargo, el adaptador de BizTalk para el paquete personalizado JD Edwards OneWorld crea una nueva biblioteca. Por lo tanto, debe realizar pasos adicionales, como crear manualmente un directorio y ejecutar una compilación de paquete completa.
Lista de módulos
El paquete personalizado BTSREL crea los siguientes objetos en JD Edwards OneWorld. BTSREL contiene las funciones de negocio para extraer metadatos y funciones personalizadas para probar los tipos de datos.
Nota
Hay un error en la actualización de JD Edwards OneWorld. Si no tiene todas las funciones empresariales y personalizadas, compruebe que se completó una compilación de paquete completa, en lugar de una compilación de paquete de actualización.
Si faltan archivos en la lista, por ejemplo, si tiene todos los elementos por debajo de ACBTEST y nada por encima de él, puede que le falten los elementos del diccionario de datos (DD). Puede ir a Trabajar con elementos de datos y buscar archivos que faltan.
Si faltan otros elementos, como ACBCHAR01, ACBDATE01, ADBINT01, ACBMATH01 y ACBSTR01, estos son los elementos de datos principales. Al combinar objetos de planes a DEV, muchos informes se ejecutan en segundo plano. Puede abrir los informes de combinación y buscar posibles errores. Los informes deben mostrar todos los elementos e indicar que se completaron sin errores o advertencias. Con esta comprobación puede continuar porque se tienen en cuenta todos los elementos.
ACBCHAR01: PRUEBA DE CARÁCTER TIPO 01
ACBCUST: ID. DE CLIENTE ACB
ACBDATE01: TIPO DE FECHA DE PRUEBA 01
ACBDEF: DEFINICIÓN DE TIPO DE FUNCIÓN ACB
ACBFCNT: RECUENTO DE LISTA DE NOMBRES DE FUNCIÓN ACB
ACBFUNC: LISTA DE NOMBRES DE FUNCIÓN ACB
ACBFUNCN: NOMBRE DE LA FUNCIÓN ACB
ACBINT01: PRUEBA DE ENTERO TIPO 01
ACBLIB: BIBLIOTECA DE CONTROLES DE BROKER
ACBMATH01: PRUEBA MATEMÁTICA TIPO 01
ACBNEWS: ESTADO NUEVO ACB
ACBORDER: NÚMERO DE PEDIDO ACB
ACBPRC: PRECIO DE ARTÍCULO ACB
ACBPROD: ID. DE PRODUCTO ACB
ACBQTY: CANTIDAD DE ARTÍCULOS ACB
ACBRES: INDICADOR DE RESULTADO ACB
ACBSTAT: ESTADO ACB
ACBSTR01: PRUEBA DE CADENA TIPO 01
ACBTEST: PRUEBA DE PANTALLA ACB
ACBTEST2- PANTALLA DE PRUEBA ACB 2
ACBTEST3 - PANTALLA DE PRUEBA ACB 3
B5500900: MÓDULO DE SOPORTE TÉCNICO DE BROKER DE CONTROL
D5500900: ESTRUCTURA DE DATOS DE BROKER DE CONTROL
D5500900A: ESTRUCTURA DE DATOS DE BROKER DE CONTROL
D5500900B: FETCH PRICE DATA STRUCTURE
D5500900C: OBTENER ESTRUCTURA DE DATOS DE ESTADO DE CLIENTE
D5500900D: ESTABLECIMIENTO DE LA ESTRUCTURA DE DATOS DE ESTADO DEL CLIENTE
D5500900E: ACTUALIZACIÓN DE LA ESTRUCTURA DE DATOS DE ESTADO DEL PEDIDO DE VENTAS
D5500900F: PRUEBA ENTERO
D5500900G: CADENA DE PRUEBA
D5500900H: FECHA DE PRUEBA
D5500900I- TEST CHAR
D5500900J: PRUEBA MATEMÁTICA NUMÉRICA
D5500900K - FECHA DE PRUEBA 2
Personalización del archivo jdeinterop.ini
Las clases del conector XE de JD Edwards OneWorld en Connector.jar y Kernel.jar requieren que use el archivo de configuración de jdeinterop.ini. Este archivo está definido por el software de JD Edwards OneWorld y usa su terminología. La guía de interoperabilidad de JD Edwards Release OneWorld puede proporcionar más información sobre el propósito y la terminología de este archivo. Hay un archivo jdeinterop.ini de ejemplo en <Adapter_Installation>\config\jde
.
Actualice jdeinterop.ini para que coincida con los valores de parámetro que definió en la pantalla Propiedades de transporte . Varios sistemas lógicos de JD Edwards OneWorld pueden compartir el mismo archivo jdeinterop.ini si sus parámetros son compatibles. Por lo general, si dos sistemas lógicos apuntan a dos equipos JD Edwards OneWorld diferentes, necesitan dos copias diferentes de jdeinterop.ini.
Nota:
El inicio de sesión jdeinterop.ini debe desactivarse y los parámetros de los distintos archivos de registro se pueden omitir de forma segura.
La tabla siguiente detalla la configuración encontrada en el archivo jdeinterop.ini. La información está organizada por secciones. Por ejemplo, [JDENET] y las secciones que se muestran en el orden en que aparecen en el software de JD Edwards OneWorld.
configuración del archivo de jdeinterop.ini
Sección | Parámetro y descripción |
---|---|
[JDENET] | EnterpriseServerTimeout. El valor de tiempo de espera para una solicitud en el servidor de empresa en milisegundos. El tamaño predeterminado es 120000. maxPoolSize. El tamaño de grupo de conexión de socket JDENET. El tamaño predeterminado es 30. |
[SERVER] | glossaryTextServer. El servidor de empresa y el puerto que proporcionan información de texto de glosario. Este es el servidor que devuelve las descripciones de texto para los errores. Suele ser los mismos host y puerto que el servidor de aplicación de JD Edwards OneWorld. Puede haber más de un servidor de glosario para las diferentes codificaciones de idioma admitidas. Por ejemplo, JDED:6010 o actsrv1:6009. Los valores deben coincidir con los establecidos en la definición del sistema. Codepage. Esquema de codificación. El valor predeterminado es 1252. - 1252 Inglés y Europa Occidental - 932 japonés - 950 chino tradicional - 936 Chino simplificado - 949 coreano |
[REGISTROS] | log= c:\jas.log. Ubicación del archivo de registro. Puede omitir este parámetro de forma segura. debuglog= c:\jasdebug.log. Ubicación del archivo de registro de depuración. Puede omitir este parámetro de forma segura. Depuración. Determina si la depuración de JDENET está activada. El valor predeterminado es FALSE. |
[DEBUG] | JobFile= c:\Interop.log. La ubicación del archivo de error. Puede omitir este parámetro de forma segura. DebugFile= c:\InteropDebug.log. Ubicación del archivo de depuración. Puede omitir este parámetro de forma segura. log= c:\net.log. Ubicación del archivo de registro. Puede omitir este parámetro de forma segura. debugLevel= 0 - 12. Niveles de depuración. Puede omitir este parámetro de forma segura. Define el nivel de seguimiento proporcionado por el conector de COM y el componente Callobject en el archivo de registro especificado, solo en el servidor COM. - 0 Ninguno. El registro está desactivado y solo los errores se escriben en el archivo JobFile. - 2 Errores (mensajes de error) - 4 Errores del sistema (mensajes de excepción) - 6 Información de advertencia - 8 Min Trace (operaciones de clave. Por ejemplo, Logon, Logoff, Business Function calls). - 10 Información de solución de problemas (Ayuda). - 12 Información de depuración completa (registra todo) - De forma predeterminada, no es necesario activar el seguimiento, pero el seguimiento es útil al depurar el código. - NetTraceLevel=0. Niveles de seguimiento. Puede omitir este parámetro de forma segura. Define el nivel de seguimiento proporcionado por el componente ThinNet en el archivo de registro especificado, solo en el servidor COM. Los valores impares se reservan para agregar futuros niveles. - En la lista siguiente se describen los niveles de depuración aún más: - 0 Sin seguimiento - 1 Hace referencia al identificador del proceso de registro, el identificador de subproceso y el estado de socket disponible cuando se agrega una nueva conexión y se busca en el grupo de sockets. - 2 Incluye la información en el nivel de seguimiento 1 y también realiza un seguimiento de todas las llamadas realizadas en la clase del administrador de conexiones. - 3 Incluye toda la información en el nivel de seguimiento 2, y también realiza un seguimiento de las llamadas getPort() y las llamadas getHost(). |
[INTEROP] | enterpriseServer. Este valor es el nombre del servidor host. Asegúrese de que este valor es el mismo que escribe en el campo Nombre de host de la sección Credenciales de JDE en Definición del sistema en el cuadro de diálogo Propiedades de transporte . El valor predeterminado es JDED. puerto Este valor es el número de puerto que se utiliza para intercambiar datos. Asegúrese de que este valor es el mismo que escribe en el campo Número de puerto de la sección Credenciales de JD Edwards de las propiedades de transporte, definición del sistema. Por ejemplo, 6010 o 6009. Los valores deben coincidir con los establecidos en Definición del sistema. inactive_timeout. Valor de tiempo de espera en milisegundos para una transacción en modo de confirmación automática. Si el usuario está inactivo durante este período de tiempo (en milisegundos), el servidor de interoperabilidad cierra al usuario. Puede cambiar este valor a un período de tiempo menor. El valor predeterminado es 1200000. manual_timeout. El valor de tiempo de espera en milisegundos para una transacción en el modo de confirmación manual. El valor predeterminado es 120000. Repositorio. Apunta a la ubicación del directorio que contiene Connector.jar y Kernel.jar. En UNIX, se trata de una ruta de acceso completa. |
[CORBA] | Puede omitir este parámetro de forma segura. Multithread. Se puede omitir la configuración. Establézcalo en 1 para compatibilidad multiproceso con CORBA. Objects= CORBA::Connector;CORBA::OneWorldVersion Define los objetos que el servidor CORBA crea durante el inicio. Reemplaza también la opción -DIORFILENAME = línea de comandos, por ejemplo: CORBA::Connector=connector.ior. |
JD Edwards EnterpriseOne
En estas secciones se incluye información clave sobre el uso del adaptador de Microsoft BizTalk para JD Edwards EnterpriseOne con BizTalk Server.
Ejecución de una función de negocio maestra JD Edwards EnterpriseOne
Puede usar el adaptador de BizTalk para JD Edwards EnterpriseOne para invocar una función empresarial principal de JD Edwards EnterpriseOne, como la libreta de direcciones, un pedido de compra o un pedido venta. También puede usar el adaptador como parte de un esfuerzo de integración para conectar JD Edwards EnterpriseOne con BizTalk Server.
Acceso a los datos almacenados en JD Edwards EnterpriseOne
El adaptador acepta mensajes XML para permitir que las aplicaciones de BizTalk Server se comuniquen e intercambien transacciones con JD Edwards EnterpriseOne mediante una de las siguientes opciones:
- Adaptador de transmisión, que usa un puerto de envío estático Solicit-Response para enviar un mensaje a JD Edwards EnterpriseOne y espera una respuesta.
- Adaptador de recepción, que usa un puerto de recepción de One-Way estático para recibir mensajes de JD Edwards EnterpriseOne.
Marco de interoperabilidad
JD Edwards EnterpriseOne proporciona integración con sistemas a través de su marco de interoperabilidad. El adaptador usa el marco JD Edwards EnterpriseOne y aprovecha varios métodos de acceso de integración para proporcionar la mayor flexibilidad y funcionalidad.
El adaptador de BizTalk para JD Edwards EnterpriseOne admite los siguientes métodos de acceso de integración:
JD Edwards EnterpriseOne ThinNet API
JD Edwards EnterpriseOne XML
Tablas de transacciones sin editar de JD Edwards EnterpriseOne (tablas Z)
El adaptador utiliza la API ThinNet de JD Edwards EnterpriseOne para comunicarse con la aplicación JD Edwards EnterpriseOne. Mediante el uso de la API ThinNet, el adaptador puede invocar una función empresarial principal (MBF) en una sola unidad de trabajo (UOW). Cuando se produce un error en una MBF, se produce un error en toda la UOW. Esto evita las actualizaciones parciales. La validación de datos, las reglas de negocios y las comunicaciones a la base de datos subyacente se administran mediante la aplicación JD Edwards EnterpriseOne.
Marco de trabajo de procesamiento de salida de JD Edwards
En el proceso de salida, el evento se inicia cuando se ejecuta una MBF específica en el entorno de JD Edwards EnterpriseOne. La MBF escribe la información necesaria para el evento en la tabla de interfaz adecuada y, a continuación, notifica a la función por lotes de subsistema (BF) que se produjo un evento. A continuación, la función BF de subsistema incluye una entrada sobre el evento en la cola de datos del subsistema.
El subsistema de salida recupera la entrada de la cola de datos y busca en la tabla de control de exportación de datos los procesos externos para notificar. A continuación, el subsistema de salida llama al adaptador de BizTalk para el agente de escucha de JD Edwards EnterpriseOne con la notificación. El agente de escucha pasa la notificación al generador. A continuación, el generador utiliza la API ThinNet de JD Edwards EnterpriseOne para recuperar la información correspondiente de la tabla de interfaz.
Establecer la justificación de la cadena en Jdearglist
Para configurar determinados argumentos de cadena como justificados a la derecha y a la izquierda rellenados en el archivo J.D. Edwards EnterpriseOne jdearglist.txt, debe saber a qué función empresarial desea acceder; en concreto, debe saber a qué campos de la función empresarial desea llamar.
Debe actualizar jdearglist.txt antes de generar los enlaces (esquemas) en la orquestación. Las instrucciones para actualizar el archivo jdearglist.txt descrito en la sección "Control de valores de cadena".
Si recibe un mensaje de advertencia de jdearglist.txt en el registro, su finalidad es informarle de que falta el jdearglist.txt. Sin embargo, si ejecuta la función empresarial SalesOrder o PurchaseOrder, debe tener ese archivo en la ruta de acceso o no funciona.
Comprender jdeinterop.ini
Las clases del conector JD Edwards EnterpriseOne de Connector.jar y Kernel.jar requieren que use un archivo de configuración denominado jdeinterop.ini. Este archivo se define mediante el software JD Edwards EnterpriseOne y usa su terminología. Para obtener más información sobre el propósito y la terminología de este archivo, consulte la Guía de interoperabilidad de JD Edwards. Hay un archivo de ejemplo jdeinterop.ini en: Archivos de programa\ Adaptadores de Microsoft BizTalk para Aplicaciones empresariales\ J.D. Edwards EnterpriseOne(r)\config.
No se recomienda editar este archivo manualmente porque interactúa con el cuadro de diálogo Propiedades de transporte para el puerto de envío; por ejemplo, esos campos marcados como <configurados por BizTalk>.
PeopleSoft Enterprise
En esta sección se incluye información clave sobre el uso del adaptador de Microsoft BizTalk para PeopleSoft Enterprise con BizTalk Server.
Requisitos de PeopleSoft del controlador de recepción
PeopleSoft Integration Broker debe poder comunicarse con BizTalk Server. Es posible que lo siguiente ya haya ocurrido en un entorno PeopleSoft existente y podrá volver a usar un nodo existente. Por lo tanto, no tendrá que hacer nada salvo obtener las especificaciones de HTTP desde un administrador del sistema de PeopleSoft. Para obtener información detallada, consulte la documentación de PeopleSoft.
En los pasos siguientes se proporciona información general para completar en PeopleSoft:
Configure el mensaje y haga que esté activo a través de Application Designer.
Realice un cambio una sola vez en el archivo integration.gateway.properties de PeopleSoft.
Cree y configure la puerta de enlace y los nodos para activar HTTP:
- El nodo debe utilizar algún método desencadenador, por ejemplo, el mecanismo LOCATION_SYNC.
- El nodo debe utilizar HTTP.
- El nodo debe señalar el host y el puerto al que está enviando el evento.
Envío de requisitos de PeopleSoft del controlador
El adaptador de BizTalk para PeopleSoft Enterprise consta de una interfaz de componente personalizada (CI) que proporciona acceso a través de una API de Java. Un objeto de CI personalizado, GET_CI_INFO, se implementa en el sistema PeopleSoft mediante PeopleSoft Tools, para proporcionar información de metadatos que requiere el adaptador de BizTalk para PeopleSoft Enterprise. Para obtener más información, consulte la documentación de PeopleSoft.
La carga de la interfaz de componente personalizado solo se realiza una vez. Este archivo, GET_CI_INFO.pc, se proporciona con el producto y debe instalarse en el sistema PeopleSoft antes de que pueda usar el adaptador para buscar CI. Debe tener acceso a peopleSoft Application Designer; sin embargo, application Designer no tiene que estar cerca del equipo de BizTalk Server. Use application Designer para cargar la CI personalizada en el equipo peopleSoft que vaya.
Debe tener acceso al equipo PeopleSoft porque debe establecer la variable de entorno CLASSPATH (o establecer la información en la ventana Propiedades de transporte ) para que apunte al archivo PeopleSoft PSJOA/psjoa.jar.
Establecimiento de la variable de entorno y uso de la interfaz de componente
Para obtener más información sobre PeopleSoft, consulte la documentación de PeopleSoft.
Establecimiento de la variable de entorno ClassPath
Actualizar JAVA_HOME
Defina la variable JAVA_HOME para que señale a la instalación de JDK, por ejemplo:
set JAVA_HOME=C:\j2sdk1.4.2_06
Actualizar CLASSPATH
Para usar interfaces de componentes (solo PeopleSoft 8), debe actualizar CLASSPATH para incluir el archivo jar de interfaz de componentes de PeopleSoft:
En Panel de control, abra Sistema.
En la pestaña Opciones avanzadas , seleccione Variables de entorno y, a continuación, seleccione CLASSPATH.
Agregue la ruta de acceso. Por ejemplo, escriba:
<PeopleSoft_Home>\web\PSJOA\psjoa.jar
El adaptador de BizTalk para PeopleSoft Enterprise requiere el archivo psjoa.jar. Esto se realiza al crear un puerto de envío. Para obtener más información, consulte "Configuración de propiedades de transporte en el sistema PeopleSoft" en la documentación del adaptador.
Nota:
Solo hay uno de estos directorios en su RUTA para asegurarse de que el adaptador de BizTalk para PeopleSoft Enterprise recoge las DLL correctas. Un error al configurar el entorno correctamente para la versión deseada de PeopleSoft podría provocar errores que son difíciles de seguir.
Uso de interfaces de componentes
Carga de una CI personalizada en PeopleSoft
El adaptador de BizTalk para PeopleSoft Enterprise requiere una modificación de la aplicación PeopleSoft. Para utilizar las interfaces de componentes, debe cargar una interfaz de componentes personalizada, GET_CI_INFO, en PeopleSoft. Solo debe importar GET_CI_INFO durante la instalación inicial para utilizar el adaptador. El adaptador utiliza GET_CI_INFO para obtener información sobre otras interfaces de componentes existentes en PeopleSoft.
En esta sección se explica cómo importar manualmente una interfaz de componente personalizada que le permita examinar las interfaces de componentes en PeopleSoft. Tenga en cuenta que los métodos personalizados no utilizan ni modifican las propiedades de la interfaz de componentes que está instalada. Para importar la interfaz de componentes personalizada, puede utilizar uno de los métodos siguientes:
Crear un componente nuevo para importar los métodos personalizados.
Utilizar un componente existente que no contiene ninguna clave, por ejemplo, INSTALLATION_RS.
La interfaz de componentes simple no debe contener claves. Si no está seguro de si una interfaz de componente determinada contiene claves, puede ejecutar la siguiente instrucción SQL mediante la herramienta consulta SQL. Proporciona una lista de todas las interfaces de componente de la aplicación que no tienen claves.
select distinct BCNAME from PSBCITEM bc1 where not exists (select 1 from PSBCITEM bc2 where bc1.BCNAME = bc2.BCNAME and bc2.BCTYPE in (1, 2))
Puede seguir la documentación de PeopleSoft para crear un único componente simple para almacenar el adaptador de BizTalk para métodos personalizados de PeopleSoft Enterprise. También puede clonar una de las interfaces de componente ya existente y utilizarla para almacenar los métodos personalizados.
Para comprobar que su GET_CI_INFO no tiene claves, ejecute la herramienta de prueba de la interfaz de componentes del diseñador de aplicaciones de PeopleTools.
Creación de una interfaz de componente
Siga estos pasos para crear una interfaz de componente con PeopleSoft, Application Designer:
Abra el Designer de la aplicación PeopleSoft.
Escriba un tipo de conexión de tres niveles y, a continuación, haga clic en Aceptar. Por ejemplo, seleccione Servidor de aplicaciones en la lista.
En application Designer, en el menú Archivo, seleccione Nuevo.
En el cuadro de diálogo Nuevo , seleccione Interfaz de componente y, a continuación, haga clic en Aceptar.
Haga clic en Seleccionar.
En la lista de todos los componentes, seleccione cualquier componente sencillo. Por ejemplo, seleccione INSTALLATION_RS o un nuevo componente de PeopleSoft que haya creado.
Los métodos personalizados no usan ni modifican ninguna propiedad de la interfaz de componente en la que está instalado.
Esta interfaz de componente simple no debe contener claves. Si no está seguro de si una interfaz de componente determinada contiene claves, puede ejecutar la siguiente instrucción SQL mediante la herramienta consulta SQL. Proporciona una lista de todas las interfaces de componente de la aplicación que no tienen claves:
select distinct BCNAME from PSBCITEM bc1 where not exists (select 1 from PSBCITEM bc2 where bc1.BCNAME = bc2.BCNAME and bc2.BCTYPE in (1, 2))
Nota
También puede seguir la documentación de PeopleSoft para crear un componente sencillo único para almacenar métodos personalizados para el adaptador de BizTalk para PeopleSoft Enterprise.
Para comprobar que su GET_CI_INFO no tiene claves, ejecute la herramienta de prueba de la interfaz de componentes del diseñador de aplicaciones de PeopleTools.
Comprobación de la interfaz de componente
Ha completado la carga del adaptador de Microsoft BizTalk para PeopleSoft GET_CI_INFO en su sistema PeopleSoft. GET_CI_INFO es una interfaz de componentes personalizados definida por el usuario. Contiene métodos definidos por el usuario. La interfaz del componente GET_CI_INFO le permite examinar las interfaces de componentes en su sistema PeopleSoft mediante el asistente para adaptador de Microsoft. Puede localizar y expandir GET_CI_INFO para ver sus métodos definidos por el usuario.
Nota
Para obtener más información sobre los métodos definidos por el usuario, vea "PeopleSoft: Component Interface User-Defined Methods" en la documentación del adaptador.
Establecimiento de la seguridad de la interfaz de componente
Después de instalar la interfaz personalizada de componentes de GET_CI_INFO PeopleSoft en PeopleSoft, establezca la configuración de seguridad para los métodos GetCINamespace, GetDetails y GetCollections para el adaptador de BizTalk para PeopleSoft Enterprise. Se trata de una práctica estándar al crear componentes personalizados o métodos definidos por el usuario.
Nota
El siguiente procedimiento describe cómo configurar la seguridad de todas las versiones compatibles de PeopleSoft en todos los modos compatibles.
Para configurar la seguridad de la interfaz de componentes
Seleccione PeopleTools, seleccione Seguridad, Permisos & Roles y, a continuación, seleccione Permiso Listas.
En la ventana Mantener la seguridad, haga clic en Búsqueda, seleccione la correspondiente Lista de permisos y, a continuación, haga clic en el hipervínculo de la lista procedente.
En el panel Lista de permisos de la derecha, haga clic en la flecha derecha situada junto a la pestaña Tiempos de inicio de sesión para mostrar la pestaña Interfaces de componentes .
Haga clic en la pestaña Interfaces de componentes .
Haga clic en el signo más (+) para agregar una nueva fila a la lista Interfaces de componentes .
Seleccione la interfaz de componente GET_CI_INFO y, a continuación, haga clic en Editar.
Para establecer los métodos en Acceso completo, haga clic en Acceso completo (Todo) y, a continuación, haga clic en Aceptar.
Desplácese hasta la parte inferior de la ventana Interfaces de componentes y, a continuación, haga clic en Guardar.
Prueba de la interfaz de componente
Ha terminado de configurar la seguridad de la interfaz de componentes GET_CI_INFO proporcionada con el adaptador de BizTalk para PeopleSoft Enterprise. La interfaz de componentes de PeopleSoft está lista y puede examinar las interfaces de componentes de PeopleSoft.
Siga estos pasos para probar la interfaz de componentes en el diseñador de aplicaciones.
Para probar la interfaz de componente
Inicie el Designer de la aplicación PeopleSoft.
En el menú Archivo , seleccione Abrir y, a continuación, seleccione Definición = Interfaz de componente.
En la lista de interfaces de componentes, seleccione GET_CI_INFO CI.
Después de abrir GET_CI_INFO, haga clic con el botón derecho en cualquier parte del panel derecho de la definición de la interfaz de componente y, a continuación, seleccione Probar interfaz de componente.
Se abre la ventana Evaluador de interfaz de componentes . No debería haber ninguna clave indicada. Si el GET_CI_INFO contiene claves, o si hay otra opción para la selección, vuelva a Application Designer y elimine todas las claves de GET_CI_INFO.
Pasos de instalación
Antes de instalar, asegúrese de BizTalk Server y de todos los requisitos previos de software para los adaptadores están instalados. Se recomienda que cierre todas las aplicaciones antes de ejecutar el programa de instalación.
Ejecute el BizTalk Server Setup.exey seleccione Instalar adaptadores de Microsoft BizTalk para aplicaciones empresariales.
Para BizTalk Server 2016 y versiones anteriores:
Ejecute el BizTalk Server Setup.exe, seleccione Instalar adaptadores de Microsoft BizTalk y seleccione Instalar adaptadores de Microsoft BizTalk para aplicaciones empresariales.Nota:
- También puede ejecutar una instalación silenciosa con el siguiente comando:
msiexec /i <msi\> /qn /l* <logfile\>
, donde<logfile\>
es opcional, pero resulta útil en caso de que se produzca un error en la instalación. - La instalación actualiza la variable de entorno PATH. Para asegurarse de que usa las variables correctas, cierre la ventana de comandos de instalación para actualizar las variables.
- También puede ejecutar una instalación silenciosa con el siguiente comando:
Acepte el Contrato de licencia y seleccione Siguiente.
Escriba la información del cliente y seleccione Siguiente.
Seleccione una instalación completa o personalizada :
Completado: instala todos los adaptadores de Microsoft BizTalk para aplicaciones empresariales, todas las características del programa y se usa para el desarrollo y el tiempo de ejecución.
Personalizado: elija los adaptadores y características que desea instalar y dónde están instalados.
Para establecer el destino, seleccione Examinar y establezca la ruta de instalación.
Seleccione Next (Siguiente) para continuar.
Instale y seleccione Finalizar cuando haya finalizado.
Importante
Es posible que encuentre el siguiente error durante la instalación:
Error 1609. An error occurred while applying security settings. CREATOR OWNER is not a valid user or group
Para solucionar este error, haga lo siguiente y vuelva a ejecutar la instalación:
- Abra un símbolo del sistema
- Escriba:
net user "CREATOR OWNER" /add
. Esto crea un nuevo usuario llamado CREATOR OWNER. - Escriba:
net localgroup Users /add
. Esto crea un nuevo grupo denominado Usuarios.
Para agregar los adaptadores a BizTalk Server, vea "Agregar adaptadores a BizTalk Administración" en este tema.
Agregar adaptadores a BizTalk Administración
Nota
Si instala BizTalk en un entorno multicomputer (instalación solo en tiempo de ejecución en un equipo y una instalación solo de herramientas de administración en otro equipo), debe instalar los adaptadores de BizTalk para aplicaciones empresariales en ambos equipos.
Abra la consola de administración de BizTalk Server, expanda Microsoft BizTalk Server y, a continuación, expanda Configuración de la plataforma.
Haga clic con el botón derecho en Adaptadores, seleccione Nuevoy, a continuación, seleccione Adaptador.
Escriba un nombre, como PeopleSoft.
Seleccione el nombre que especificó en la lista Adaptador y seleccione Aceptar.
Posterior a la instalación: JD Edwards OneWorld
El adaptador de Microsoft BizTalk para JD Edwards OneWorld consta de un adaptador de transmisión que interfaces las bases de datos y los sistemas de servidor compatibles con Microsoft BizTalk Server. El adaptador de transmisión permite invocar la llamada de un sistema de servidor desde BizTalk Server. La configuración del adaptador de transmisión (el controlador de envío de administración de BizTalk Server) especifica la ubicación de la base de datos SQL.
Consulte la documentación del adaptador para obtener información sobre cómo usar el adaptador de BizTalk para JD Edwards OneWorld y sobre la asignación entre su modelo y el modelo de BizTalk Server.
Inicio de sesión único
El adaptador de BizTalk para JD Edwards OneWorld proporciona compatibilidad con Enterprise Single Sign-On (SSO). Si selecciona usar el inicio de sesión único en la página Propiedades de transporte , se usan las credenciales de la aplicación afiliada en la base de datos de credenciales de SSO. Una aplicación afiliada representa una aplicación, es decir, un elemento back-end que requiere credenciales.
Componentes instalados
La instalación del adaptador instala y registra los siguientes componentes en la caché global de ensamblados (GAC). Para comprobar el registro, abra la carpeta de ensamblados en el explorador (<%WINDIR%>\assembly) o use desde
gacutil /l
el símbolo del sistema de Visual Studio:- Microsoft.BizTalk.Adapters.BizUtil.dll
- Microsoft.BizTalk.Adapters.JDEProperties.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
btsTask.exe instala e implementa el
Microsoft.BizTalk.Adapters.JDEProperties.dll
archivo en la GAC. Los resultados del registro de implementación de BizTalk Server están en\Program Files\Microsoft BizTalk Adapters for Enterprise Applications\jdeDeploy.html
y jdeDeploy.xml.Los archivos específicos del adaptador se instalan en
Program Files
yProgram Files\Common Files
.sdk\
está instalado enProgram Files\Microsoft BizTalk Adapters for Enterprise Applications\J.D. Edwards OneWorld(r)
.Program Files\Microsoft BizTalk Adapters for Enterprise Applications\JD Edwards OneWorld(r)\
contiene los siguientes archivos:- classes\JDEJAccess.jar
- Config\ J.D. Edwards OneWorld(r) \BTSREL.exe
- Config\ J.D. Edwards OneWorld(r) \jdearglist.txt
- Config\ J.D. Edwards OneWorld(r) \jdeinterop.ini
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\Bin\
contiene los siguientes archivos:- Microsoft.BizTalk.Adapters.JDEProperties.dll
- jdecba.dll
Posterior a la instalación: JD Edwards EnterpriseOne
El adaptador de Microsoft BizTalk para JD Edwards EnterpriseOne contiene un adaptador de transmisión que interactúa con bases de datos admitidas y sistemas de servidor a BizTalk Server. El adaptador de transmisión permite invocar la llamada del sistema del servidor desde BizTalk Server.
El adaptador de BizTalk para JD Edwards EnterpriseOne proporciona compatibilidad con enterprise Single Sign-On (SSO). Si selecciona usar el inicio de sesión único en la página Propiedades de transporte , se usan las credenciales de la aplicación afiliada en la base de datos de credenciales de SSO. Una aplicación afiliada representa una aplicación, es decir, un elemento back-end que requiere credenciales.
Componentes instalados
La instalación del adaptador instala y registra los siguientes componentes en la caché global de ensamblados (GAC). Para comprobar el registro, abra la carpeta de ensamblados en el explorador (<%WINDIR%>\assembly) o use desde
gacutil /l
el símbolo del sistema de Visual Studio:- Microsoft.BizTalk.Adapters.BizUtil.dll
- Microsoft.BizTalk.Adapters.JDEProperties.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
Los archivos específicos del adaptador se instalan en la
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\Bin
carpeta . Esta carpeta contiene los archivos siguientes:- Jdecba.dll
- Microsoft.BizTalk.Adapters.JDEProperties.dll
Los archivos siguientes se instalan en
Program Files\Microsoft BizTalk Adapters for Enterprise Applications\J.D. Edwards EnterpriseOne(r)
:- Bin\BTAJDEEnterpriseOneTrace.cmd
- Classes\JDEDynAccess.jar
- Config\btaJDEEnterpriseOneTrace.mof
- Config\jdearglist.txt
- Config\jdeinterop.ini
- Config\jdelog.properties
- Sdk
Posterior a la instalación: PeopleSoft Enterprise
El adaptador de Microsoft BizTalk para PeopleSoft Enterprise contiene un adaptador de transmisión que interfaces las bases de datos y los sistemas de servidor compatibles con BizTalk Server. El adaptador de transmisión permite invocar la llamada del sistema del servidor desde BizTalk Server. La configuración del adaptador de transmisión (el controlador de envío de administración de BizTalk Server) especifica la ubicación de la base de datos SQL.
El adaptador de BizTalk para PeopleSoft Enterprise proporciona compatibilidad con enterprise Single Sign-On (SSO). Si selecciona usar el inicio de sesión único en la página Propiedades de transporte , se usan las credenciales de la aplicación afiliada en la base de datos de credenciales de SSO. Una aplicación afiliada representa una aplicación, es decir, un elemento back-end que requiere credenciales.
La instalación del adaptador incluye ejemplos en el directorio \sdk.
Componentes instalados
La instalación del adaptador instala y registra los siguientes componentes en la caché global de ensamblados (GAC). Para comprobar el registro, abra la carpeta de ensamblados en el explorador (<%WINDIR%>\assembly) o use desde
gacutil /l
el símbolo del sistema de Visual Studio:- Microsoft.BizTalk.Adapters.BizUtil.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
Los archivos específicos del adaptador se instalan en
*
archivosand
de programa\Archivos de programa de archivos comunes. The following files are installed in
\Adaptadores de Microsoft BizTalk para aplicaciones empresariales\PeopleSoft Enterprise (r)':- bin\BTAPeopleSoftTrace.cmd
- config\btaPeopleSoftTrace.mof
- config\GET_CI_INFO.pc
- config\GET_CI_INFO.pc
- sdk\
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications
contiene los siguientes archivos:- bin\psosa.dll
- bin\Microsoft.BizTalk.Adapters.CoreManagement.dll
- bin\Microsoft.BizTalk.Adapters.CoreReceiver.dll
- bin\Microsoft.BizTalk.Adapters.CoreTransmitter.dll
Información general posterior a la instalación: TIBCO Rendezvous
El adaptador de Microsoft BizTalk para TIBCO Rendezvous contiene la funcionalidad de recepción y transmisión que interactúa con bases de datos y sistemas de servidor compatibles para BizTalk Server.
El lado de recepción escucha llamadas salientes del sistema del servidor.
El lado de transmisión permite invocar la llamada del sistema del servidor desde BizTalk Server.
Consulte la documentación del adaptador para obtener información sobre cómo usar el adaptador de Microsoft BizTalk para TIBCO Rendezvous y sobre la asignación entre su modelo y el modelo de BizTalk Server.
Componentes instalados
La instalación del adaptador instala y registra los siguientes componentes en la caché global de ensamblados (GAC). Para comprobar el registro, abra la carpeta de ensamblados en el explorador (<%WINDIR%>\assembly) o use desde
gacutil /l
el símbolo del sistema de Visual Studio:- Microsoft.BizTalk.Adapters.TibcoRV
- Microsoft.BizTalk.Adapters.TibcoRV.Common
- Microsoft.BizTalk.Adapters.TibcoRV.Service
- Microsoft.BizTalk.Adapters.TibRV.Properties
- Microsoft.BizTalk.Adapters.TibcoEMS
- Microsoft.BizTalk.Adapters.TibcoEMS.Properties
- Microsoft.BizTalk.Adapters.TibcoRVManagement
- Microsoft.BizTalk.Adapters.TibcoRVReceiver
- Microsoft.BizTalk.Adapters.TibcoRVTransmitter
Los archivos específicos del adaptador se instalan en
Program Files
yProgram Files\Common Files
. Los archivos siguientes se instalan enProgram Files\Microsoft BizTalk Adapters for Enterprise Applications\ TIBCO(r) Rendezvous(r)
:- bin\BTATibcoRVTrace.cmd
- bin\mbaRV.exe
- bin\Microsoft.BizTalk.Adapters.TibcoRV.Common.dll
- bin\Microsoft.BizTalk.Adapters.TibcoRV.dll
- bin\Microsoft.BizTalk.Adapters.TibcoRV.Service.dll
- bin\Microsoft.BizTalk.Adapters.BizUtil.dll
- bin\Microsoft.BizTalk.Adapters.CoreManagement.dll
- bin\Microsoft.BizTalk.Adapters.CoreReceiver.dll
- bin\Microsoft.BizTalk.Adapters.CoreTransmitter.dll
- bin\Microsoft.BizTalk.Adapters.TibRV.Properties.dll
- Config\btaTibcoRVTrace.mof
- sdk\
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications
contiene los siguientes archivos:- bin\tibcorvcba.dll
- Microsoft.BizTalk.Adapters.CoreManagement.dll
- Microsoft.BizTalk.Adapters.CoreReceiver.dll
- Microsoft.BizTalk.Adapters.CoreTransmitter.dll
Agregar TIBCO.Rendezvous.dll a la GAC
El adaptador de BizTalk para TIBCO Rendezvous requiere el archivo TIBCO.Rendezvous.dll . La versión mínima necesaria es la 1.0.3036.23330 FileVersion, que se incluye con la versión 8.1 del producto. El adaptador desencadena una excepción y registra un mensaje adecuado si este ensamblado no está instalado.
Debe usar el enlace en tiempo de ejecución para cargar ensamblados para que los ensamblados de TIBCO Rendezvous no produzcan un error cuando una versión determinada del TIBCO.Rendezvous.dll y el módulo de TIBCO.Rendezvous.net no estén en el equipo de destino.
Componente de tiempo de ejecución
Compruebe que tiene el componente de tiempo de ejecución de TIBCO Rendezvous instalado en el equipo. El componente de tiempo de ejecución es el único componente que debe instalar al instalar TIBCO Rendezvous.
En un símbolo del sistema de Visual Studio, cambie los directorios a la ubicación del archivo TIBCO.Rendezvous.dll. La ruta de acceso de este archivo DLL en la instalación predeterminada de TIBCO Rendezvous es C:\TIBCO\TIBRV\BIN\TIBCO.Rendezvous.dll.
En el símbolo del sistema, escriba lo siguiente:
C:\TIBCO\TIBRV\BIN > gacutil /i TIBCO.Rendezvous.dll
Ahora TIBCO. Rendezvous.dll muestra la lista GAC. Para ver la lista, en Panel de control, abra Herramientas de administrador, abra Configuración de Microsoft .NET Framework y, a continuación, abra Caché de ensamblados.
Después de la instalación: TIBCO Enterprise Message Service
El adaptador de Microsoft BizTalk para TIBCO Enterprise Message Service (EMS) contiene una funcionalidad de recepción y transmisión que interactúa con bases de datos admitidas y sistemas de servidor a BizTalk Server.
El lado de recepción escucha llamadas salientes del sistema del servidor.
El lado de transmisión permite invocar la llamada del sistema del servidor desde BizTalk Server.
Consulte la documentación del adaptador para obtener información sobre cómo usar el adaptador de BizTalk para TIBCO EMS y sobre la asignación entre su modelo y el modelo de BizTalk Server.
Componentes instalados
La instalación del adaptador instala y registra el
Microsoft.BizTalk.Adapters.TibcoEMS.dll
archivo en la caché global de ensamblados (GAC). Para comprobar el registro, abra la carpeta de ensamblados en el explorador (<%WINDIR%>\assembly) o use desdegacutil /l
el símbolo del sistema de Visual Studio.Los archivos específicos del adaptador se instalan en
Program Files
yProgram Files\Common Files
. Los archivos siguientes se instalan enProgram Files\Microsoft BizTalk Adapters for Enterprise Applications\TIBCO(r) Enterprise Message Service(TM)
:- bin\BTATibcoEMSTrace.cmd
- Microsoft.BizTalk.Adapters.TibcoEMS.dll
- Config\btaTibcoEMSTrace.mof
- sdk\
Program Files\Common Files\Microsoft BizTalk Adapters for Enterprise Applications\bin
folder contiene los siguientes archivos:Microsoft.BizTalk.Adapters.CoreManagement.dll
Microsoft.BizTalk.Adapters.CoreReceiver.dll
Microsoft.BizTalk.Adapters.CoreTransmitter.dll
Nota:
Debe usar el enlace en tiempo de ejecución para cargar ensamblados de modo que los ensamblados EMS de TIBCO no produzcan un error cuando una versión determinada del TIBCO.EMS.dll no esté presente en el equipo de destino.
Adición de TIBCO.EMS.dll API a la GAC
El adaptador de BizTalk para TIBCO EMS requiere que agregue el TIBCO.EMS.dll a la GAC. El adaptador de BizTalk para TIBCO EMS desencadena una excepción y registra un mensaje adecuado si este ensamblado no está instalado.
Copie la API de C#DE TIBCO EMS en el equipo de BizTalk.
En un símbolo del sistema de Visual Studio, cambie los directorios a la ubicación del archivo de API de C#.
En un símbolo del sistema de Visual Studio, escriba lo siguiente:
C:\\<TIBCO EMS Folder\>bin> gacutil /i TIBCO.EMS.dll
TIBCO. EMS.dll ahora se muestra en la lista C:\Windows\assembly. O bien, en Panel de control, abra Herramientas de administrador> Caché deensamblados deMicrosoft .NET Framework> para ver la lista de GAC.
Limitaciones
El adaptador de BizTalk para TIBCO EMS usa TIBCO.EMS.dll para comunicarse con el servidor. A continuación se muestran las limitaciones al usar el TIBCO.EMS.dll:
La compresión de mensajes, que permite al cliente EMS de TIBCO enviar mensajes en un formulario comprimido a EMS, no está disponible.
El cifrado de mensajes entre el adaptador y el servidor no está disponible. TIBCO. EMS.dll no permite el cifrado SSL mediante las bibliotecas OpenSSL, pero los adaptadores admiten SLL con Tibco.EMS.dll con ProductVersion 5.0 y versiones posteriores.
No se admite la API de administración para EMS.
Seguimiento del adaptador
Habilitación del seguimiento
El nombre de archivo utilizado con el seguimiento de Windows es decisión del administrador. La aplicación escribe en el sistema operativo, que omite todos los registros hasta que desee los registros de un determinado sistema back-end. Esto se hace ejecutando adaptadores de BizTalk independientes para el archivo de comandos de las aplicaciones empresariales. Uno de los argumentos de ese comando es el nombre del archivo que se usa para capturar la información de seguimiento. Para obtener más información, vea "Usar el evento de seguimiento de Windows" (en este tema).
Los archivos de seguimiento se instalan en \Program Files\Microsoft BizTalk Adapters for Enterprise Applications\
.
- bin\BTATrace.cmd
- config\btaTrace.mof
Uso del evento de seguimiento de Windows
Los errores de registro de adaptadores, advertencias y mensajes de información al Visor de eventos de Windows. Puede ver mensajes de seguimiento adicionales mediante la herramienta Seguimiento de eventos para Windows (ETW). Cuando está habilitado ETW, crea un archivo *.etl para recibir los mensajes. Este archivo está en formato binario y se debe convertir para poder leerse. Para ello, debe tener una aplicación de consumidor disponible para interpretar el archivo *.etl, por ejemplo, Windows tracerpt.exe o tracedmp.exe.
Componentes ETW
Seguimiento de eventos para Windows tiene tres componentes:
Aplicación de controlador: Activa y desactiva un proveedor. Por ejemplo, tracelog.exe o logman.exe.
Configure su variable de entorno PATH para que señale la ubicación de tracelog.exe. Esto garantiza que las llamadas de seguimiento del nombre>del adaptador BTA<puedan localizar tracelog.exe en el sistema. De forma predeterminada, el seguimiento del nombre>del adaptador BTA<busca en la ruta de acceso actual.
Nota:
tracelog.exe está disponible en microsoft SDK y es compatible con los comandos proporcionados por adaptadores de Microsoft BizTalk para aplicaciones empresariales. Para usar logman.exe, consulte la documentación de Logman.
Aplicación de consumidor: Lee los eventos registrados.
Para que la aplicación de consumidor pueda leer el evento en el archivo .etl, Seguimiento de eventos para Windows debe volcarlos en dicho archivo. Normalmente, esto se hace cuando el controlador desactiva el seguimiento.
Para usar la aplicación de consumidor sin desactivar el seguimiento, el controlador debe activar el seguimiento con la opción en tiempo real, <Tiempo> real = -rt.
Proveedor: Se usa para proporcionar el evento .
Cada adaptador incluye cinco proveedores diferentes. Están registrados en el Instrumental de administración de Windows (WMI). Para encontrar los proveedores registrados en la ruta root\WMI\EventTrace, puede usar herramientas tales como WMI CIM Studio.
Los cinco proveedores le permiten registrar diferentes tipos de mensajes:
- Proveedor de registro del receptor: el modificador del <elemento> Trace es - receiver.
- Receptor CastDetails Provider: el modificador del <elemento> Trace es - castDetailsReceive.
- Proveedor de registro del transmisor: el <modificador del elemento> Trace es - transmisor.
- Transmisor CastDetails Provider: El modificador del <elemento> Trace es - castDetailsTransmit.
- Proveedor de registro de administración: el modificador de <elemento> Trace es - management.
Para usar ETW, ejecute el comando para el adaptador específico: BTA<Adapter Name\>Trace.cmd
. Use este comando como sigue:
BTA<Adapter Name>Trace <Trace element> -start [-cir <MB>|
-seq <MB>] [-rt] logfile
BTA<Adapter Name>Trace <Trace element> -stop
Donde:
<El elemento> Trace (obligatorio) es el tipo de proveedor. Las opciones son las siguientes:
-castDetailsTransmit
-transmitter
-castDetailsReceive
-Receptor
-Administración
-start, -stop: Active o desactive el proveedor.
-Cir <MB>: tamaño y tipo de archivo. -cir es un archivo circular. <MB>: tamaño en megabytes.
-Seq <MB>: tamaño y tipo de archivo. -seq es un archivo secuencial. <MB>: tamaño en megabytes.
-Rt: Establezca el modo en tiempo real activado.
Logfile: Nombre del archivo de registro (c:\rtlog.etl es el valor predeterminado).
Por ejemplo:
BTAXXXTrace -transmitter -start -cir 10 -rt c:\log\mylog.etl
BTAXXXTrace -transmitter -stop
Nota
Utilice el comando tracerpt.exe para dar formato a los archivos .etl.