Configuración del adaptador de BizTalk para aplicaciones host
El cuadro de diálogo de configuración del adaptador de BizTalk para la aplicación host permite definir y administrar conexiones a sistemas remotos de IBM CICS, IMS o iSeries. Se inicia al hacer clic en el campo del valor de propiedad Cadenas de conexión. Puede usar el cuadro de diálogo de configuración del adaptador de BizTalk para la aplicación host para agregar un ensamblado .NET de TI. Puede usarlo como parte de la asignación para importar, exportar y eliminar asignaciones, editar cadenas de conexión y ver las propiedades de un ensamblado .NET de TI.
Los componentes del cuadro de diálogo de configuración de la aplicación host incluyen una barra de herramientas, un menú, una cuadrícula de datos y un panel de resultados. Este tema contiene las secciones siguientes que describen las distintas tareas que puede realizar.
Comandos de barra de herramientas y menú
Ventana de asignación de DataGrid
Creación y administración de asignaciones
Configuración y asignaciones de cadenas de conexión
Actualización desde versiones anteriores de Host Integration Server
Comandos de barra de herramientas y menú
Puede acceder a los comandos que crean y administran cadenas de conexión a través de las barras de herramientas y los menús contextuales. Puede hacer clic con el botón derecho en cualquier parte de la cuadrícula de datos para abrir menús contextuales. Por ejemplo, al hacer clic con el botón derecho en una cadena de conexión, puede ver, editar, eliminar, importar y exportar asignaciones. Puede hacer doble clic en la cadena de conexión para abrirla en modo de edición. La tecla DELETE elimina el elemento seleccionado actualmente y la tecla F1 abre la ayuda en línea.
En la lista siguiente se describen las acciones que puede realizar:
Agregar un ensamblado .NET de TI desde la caché global de ensamblados (GAC) o mediante la ruta de acceso del archivo local para agregar un ensamblado a la asignación. Las columnas se rellenan con los valores predeterminados reflejados en el ensamblado. La cadena de conexión predeterminada no se podrá usar si no se escriben los valores necesarios.
Eliminar las asignaciones seleccionadas. Aparecerá un cuadro de diálogo para confirmar la eliminación.
Editar la parte de la cadena de conexión de la asignación cuando se selecciona una asignación. Inicie el cuadro de diálogo Cadena de conexión para editar la cadena de conexión.
Exportar asignaciones a XML para realizar una copia de seguridad de las asignaciones. Puede restaurarlas más adelante mediante la característica de asignación de importaciones. Las característica Import/Export permite compartir asignaciones entre puntos de conexión.
Importar asignaciones o RE para importar el XML exportado con el cuadro de diálogo de configuración del adaptador de BizTalk para la aplicación host. También puede importar definiciones de RE exportadas por el administrador de TI cuando se selecciona una asignación.
Ver propiedades del ensamblado .NET de TI para mostrar las propiedades del ensamblado. La etiqueta XML muestra el nombre del documento de entrada y salida que admite este ensamblado. El nombre del método forma parte del nombre de etiqueta, pero no se usa al buscar una asignación. Todas las propiedades son de solo lectura.
Ventana de asignación de DataGrid
El cuadro de diálogo de asignación de DataGrid contiene los siguientes elementos:
Estado (completo o incompleto). Si falta información de conexión en la cadena de conexión, aparece una advertencia indicada por un círculo rojo con un signo de exclamación blanco. Una vez agregada la información que falta, desaparece la advertencia.
ClassName y nombre de interfaz del ensamblado de TI que se usa como parte de la asignación.
Nombre del ensamblado. Nombre seguro del ensamblado si el ensamblado se carga desde la GAC o la ruta de acceso completa al ensamblado si es un ensamblado local. Este campo se rellena automáticamente cuando se agrega un ensamblado y es de solo lectura.
Entorno remoto define la cadena de conexión. Esto representa las características de un sistema remoto que recibe solicitudes del adaptador de aplicación host de BizTalk. La cadena de conexión consta del tipo de entorno remoto, el modelo de programación, la identificación remota del host, el transporte de red y otras configuraciones que se usan al comunicarse con el host remoto.
Punto de conexión remoto: nombre DNS o dirección IP del host de IBM remoto.
El panel de resultados muestra los valores de la cadena de conexión de la asignación seleccionada actualmente.
Creación y administración de asignaciones
En esta sección se describen las tareas que puede realizar.
Adición de ensamblados para crear una cadena de conexión
En la barra de herramientas, haga clic en el icono de carpeta y seleccione Add assemblies from GAC (Agregar ensamblados desde GAC) o Add local assembly (Agregar ensamblado local). Add assemblies from GAC (Agregar ensamblados desde GAC) iniciará un cuadro de diálogo que enumera todos los ensamblados de la GAC que puede seleccionar. Si selecciona Add local assembly (Agregar ensamblado local), puede examinar los ensamblados instalados localmente.
Los ensamblados también se pueden agregar mediante las opciones para agregar GAC o agregar ensamblado local del menú.
Eliminación de una cadena de conexión
Seleccione la asignación o asignaciones que desea eliminar. Haga clic en el icono [X] de la barra de herramientas para eliminar las asignaciones seleccionadas. Se muestra un cuadro de diálogo para que pueda confirmar la eliminación.
También puede eliminar asignaciones mediante la opción Eliminar asignaciones del menú.
Edición de la cadena de conexión
La cadena de conexión se usa para hidratar la instancia de RE. Se rellena con valores predeterminados cuando se especifica un ensamblado. Haga doble clic en la asignación seleccionada, seleccione Editar o seleccione el menú Editar cadena de conexión para iniciar el cuadro de diálogo Cadena de conexión. Esto le permite editar la cadena de conexión para el RE especificado. Si no se introducen los valores necesarios, aparecerá una marca de error.
El objeto RE valida los valores mínimos de propiedad necesarios. La celda Cadena de conexión se marcará si no se establecen los valores de propiedad necesarios. Las propiedades necesarias se enumeran en la sección Configuración y asignaciones de cadenas de conexión de este tema. La validación de RE tiene un alcance limitado, y valores inadecuados podrían dar lugar a errores en el entorno de ejecución de TI.
El cuadro de diálogo muestra propiedades editables y no editables en una cuadrícula. El cuadro de texto de solo lectura de la parte inferior muestra la cadena de conexión que se crea en función de los valores especificados en la cuadrícula de propiedades. Las propiedades se recopilan en función de los métodos públicos definidos por el objeto RE, con valores definidos por el propio objeto. Se proporcionan algunos convertidores de tipos y editores de propiedades para facilitar la edición de valores de propiedad.
El entorno remoto muestra las propiedades necesarias para conectarse al host. Estos se indican mediante un asterisco (*) en la cuadrícula de propiedades. Si faltan una o varias propiedades, se muestra un círculo rojo con un signo de exclamación blanco en la cuadrícula de datos. Esta advertencia le notifica que las propiedades que faltan se pueden proporcionar mediante invalidaciones en el entorno de ejecución.
La configuración de seguridad se controla mediante enumeraciones de seguridad predefinidas que se pueden combinar mediante el operador OR para formar nuevas opciones de seguridad.
La marca Desactivado es exclusiva del cliente, el paquete y el usuario. Desactivado se borrará cuando se active cualquiera de las otras tres. Cuando está activada la opción Desactivado, se borrarán las otras tres opciones.
El editor SSOApplication se traslada desde una versión anterior con cambios menores. Puede especificar una aplicación afiliada directamente en la cuadrícula de propiedades o usar el editor para elegir una ya creada.
Configuración y asignaciones de cadenas de conexión
En las tablas siguientes se muestran las propiedades admitidas que definen el entorno de host y el modelo de programación. Los asteriscos indican las propiedades necesarias.
Los propios objetos RE establecen los valores predeterminados, y se realiza una validación limitada.
Datos de usuario de SNA
| Propiedad | Value |
|---|---|
| Propiedad | Valor |
| CodePage | 37 |
| Configuración regional | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| Nombre | SNAUserData. Solo lectura. |
| **RemoteLUName* | |
| Seguridad | Desactivado |
| SSOApplication | |
| SynLevel2Supported | False |
| TimeOut | 0 |
*Campo obligatorio.
Vínculo de SNA
| Propiedad | Value |
|---|---|
| Propiedad | Valor |
| AdministrationFlags | 0 |
| CodePage | 37 |
| Configuración regional | 1033 |
| **LocalLUName* | |
| MirrorTranId | CSMI |
| **ModeName* | PA62TKNU |
| Nombre | SNALink. Solo lectura. |
| **RemoteLUName* | |
| Seguridad | Desactivado |
| SSOApplication | |
| SyncLevel2Supported | False |
| TimeOut | 0 |
*Campo obligatorio.
Datos de usuario HTTP
| Propiedad | Value |
|---|---|
| Propiedad | Valor |
| AliasTransactionId | |
| AllowRedirects | False |
| CodePage | 37 |
| **HttpPort* | |
| **Ipaddress* | |
| Configuración regional | 1033 |
| Nombre | HttpUserData. Solo lectura. |
| Seguridad | Desactivado |
| SSOApplication | |
| TimeOut | 0 |
| UserAgent | |
| UseSsl | False |
*Campo obligatorio.
Vínculo HTTP
| Propiedad | Value |
|---|---|
| Propiedad | Valor |
| AliasTransactionId | |
| AllowRedirects | False |
| CodePage | 37 |
| Converter | |
| **HttpPort* | |
| **Ipaddress* | |
| Configuración regional | 1033 |
| MirrorProgramName | |
| Nombre | HttpLink. Solo lectura. |
| Seguridad | Desactivado |
| SSOApplication | |
| TimeOut | 0 |
| UseConverter | False |
| UserAgent | |
| UseSsl | False |
*Campo obligatorio.
IMS LU6.2
| Propiedad | Value |
|---|---|
| Propiedad | Valor |
| CodePage | 37 |
| Configuración regional | 1033 |
| **LocalLUName* | |
| **ModeName* | PA62TKNU |
| Nombre | IMSLU62. Solo lectura. |
| **RemoteLUName* | |
| Seguridad | Desactivado |
| SSOApplication | |
| TimeOut | 0 |
*Campo obligatorio.
Conexión de IMS
| Propiedad | Value |
|---|---|
| Propiedad | Valor |
| CodePage | 37 |
| ImsFormatModName | |
| **Ipaddress* | |
| ItocExitName | |
| Configuración regional | 1033 |
| Nombre | IMSConnect. Solo lectura. |
| OtmaSystemId | |
| Seguridad | Desactivado |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*Campo obligatorio.
Datos o vínculos de usuario de TRM
| Propiedad | Value |
|---|---|
| Propiedad | Valor |
| CodePage | 37 |
| ConcurrentServerTransactionId | MSCS |
| **Ipaddress* | |
| Configuración regional | 1033 |
| Nombre | TRMUserData. Solo lectura. |
| Seguridad | Desactivado |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*Campo obligatorio.
Datos o vínculos de usuario de ELM
| Propiedad | Value |
|---|---|
| Propiedad | Valor |
| CodePage | 37 |
| **Ipaddress* | |
| Configuración regional | 1033 |
| Nombre | ELMUserData. Solo lectura. |
| Seguridad | Desactivado |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*Campo obligatorio.
Llamada al programa distribuido
| Propiedad | Value |
|---|---|
| Propiedad | Valor |
| CodePage | 37 |
| **Ipaddress* | |
| Configuración regional | 1033 |
| Nombre | DistributedProgramCall. Solo lectura. |
| Seguridad | Desactivado |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*Campo obligatorio.
Datos o vínculos de usuario de sockets de sistema Z
| Propiedad | Value |
|---|---|
| Propiedad | Valor |
| CodePage | 37 |
| **Ipaddress* | |
| Configuración regional | 1033 |
| Nombre | SystemzSocketsUserData. Solo lectura. |
| Seguridad | Desactivado |
| SSOApplication | |
| **TCPPorts* | |
| TimeOut | 0 |
*Campo obligatorio.
Datos de usuario de sockets de sistema I
| Propiedad | Value |
|---|---|
| CodePage | 37 |
| **Ipaddress* | |
| Configuración regional | 1033 |
| Nombre | SystemSocketUserData. Solo lectura. |
| Seguridad | Desactivado |
| SSOApplication | *TCPPorts |
| TimeOut | 0 |
*Campo obligatorio.
Importación de asignaciones
Para importar asignaciones exportadas por la configuración del adaptador de BizTalk para la aplicación host, haga clic en el icono para importar asignaciones o RE. Seleccione Importar asignaciones o seleccione Importar asignaciones en el menú Archivo. A continuación, puede buscar el XML exportado por el cuadro de diálogo de configuración del adaptador de BizTalk para la aplicación host. Seleccione el archivo para importar. El proceso de importación no sobrescribirá las asignaciones existentes.
Importar definición de RE
Use esta opción para importar definiciones de RE exportadas por el Administrador de TI. Cuando se selecciona una asignación, haga clic en el icono para importar asignaciones o RE. Seleccione Import REs (Importar RE) o seleccione Import REs (Importar RE) en el menú Archivo. A continuación, puede buscar el XML exportado por el administrador de TI. Se mostrará un cuadro de diálogo que muestra las definiciones de RE que puede seleccionar. Solo se mostrarán las definiciones de RE que tengan el mismo modelo de programa que la asignación seleccionada.
Exportación de asignaciones
Para exportar asignaciones a un archivo XML, haga clic en el icono para exportar asignaciones a XML o seleccione Export mappings (Exportación de asignaciones) desde el menú Archivo. A continuación, puede ir a la ubicación donde se puede guardar el archivo. Puede importar este archivo mediante la característica de importar asignación.
Propiedades de ensamblado
Puede ver las propiedades pertinentes del ensamblado, así como el nombre de la etiqueta XML del documento de entrada/salida que admite este ensamblado. El nombre del método forma parte del nombre de etiqueta, pero no se usa al buscar una asignación. Todas las propiedades son de solo lectura. Seleccione la asignación y, a continuación, haga clic en el icono de propiedades del ensamblado o seleccione la opción de mostrar propiedades de ensamblado en el menú.
Actualización desde versiones anteriores de Host Integration Server
En esta sección se describe cómo migrar las aplicaciones BAHA para usar la cadena de conexión:
Si se usó RE predeterminado en BAHA, exporte la configuración mediante el administrador de TI e importe la configuración mediante el cuadro de diálogo Cadenas de conexión.
Si se usó un RE no predeterminado, asocie el objeto de implementación con el nuevo RE en el administrador de TI y exporte la configuración en el administrador de TI. Importe la configuración mediante el cuadro de diálogo Cadenas de conexión.
No puede cambiar los RE en la administración de BizTalk Server sin usar la cadena de conexión porque se ha quitado el cuadro de diálogo Tipo de host.
No se admite la invalidación de RE a través de la administración de BizTalk Server. Aunque puede usar el contexto del mensaje para lograr la invalidación de RE, no se recomienda. Se recomienda utilizar cadenas de conexión.
Si se especifica una aplicación de inicio de sesión único no predeterminada, puede usar el administrador de TI para asociar RE con la aplicación de SSO no predeterminada y seguir usando RE estático. Como alternativa, puede especificarlo en la cadena de conexión.
Importación de XML exportado por el administrador de TI
El administrador de TI no es necesario a menos que realice una migración. Puede exportar la definición de los RE y los objetos WIP a un archivo XML, que se puede importar mediante el cuadro de diálogo Cadenas de conexión.
Advertencia
Los ensamblados .NET de TI usados en asignaciones deben tener la propiedad de incluir parámetro de contexto establecida en True o la llamada al método de TI producirá un error en tiempo de ejecución.
La configuración del adaptador de BizTalk para la aplicación host usa la característica RE dinámica introducida en Host Integration Server 2009. Con RE dinámico, la información de host necesaria para el tiempo de ejecución de TI se puede especificar justo antes de invocar el método, siempre y cuando se conozca la información de conexión del host. El ensamblado de cliente de .NET no tiene que implementarse y asociarse a un RE predefinido en el administrador de TI antes de que se puedan invocar sus métodos.
En el caso de BAHA, la información de conexión se puede crear en una cadena de conexión que se analiza y se establece en el objeto RE creado en el entorno de ejecución. Se puede especificar información sobre un RE cuando se configura el puerto que hospeda el adaptador de aplicación host. Se almacena como parte de la información de configuración de puertos administrada por la instalación de administración de BizTalk. Con este enfoque, con el uso de BAHA para integrar la aplicación .NET con aplicaciones host, solo es necesario usar el diseñador de TI para crear los ensamblados de cliente .NET de TI. Todas las demás tareas se pueden realizar en BizTalk Server.
En la tabla siguiente se describen los menús y las acciones de la barra de herramientas.
| Barra de herramientas/menú | Acciones |
|---|---|
| Adición de ensamblados para crear una cadena de conexión | Agregue un ensamblado .NET de TI desde la GAC o mediante la ruta de acceso del archivo local para agregar un ensamblado a la asignación. Todas las columnas se rellenarán con los valores predeterminados reflejados en el ensamblado. La cadena de conexión predeterminada no se podrá usar si no se introducen algunos valores necesarios. |
| Eliminación de una cadena de conexión | Elimina las asignaciones seleccionadas. Se mostrará un cuadro de diálogo para confirmar la eliminación. |
| Edición de la cadena de conexión | Edite la parte de la cadena de conexión de la asignación cuando se seleccione una asignación, inicie el cuadro de diálogo Cadena de conexión para editar la cadena de conexión. |
| Exportación de asignaciones a XML | La exportación permite realizar una copia de seguridad de las asignaciones. Las asignaciones se pueden importar más adelante mediante la característica de asignación de importación. Las características Import/Export permiten intercambiar de manera sencilla las asignaciones entre los puntos de conexión. |
| Importar asignaciones o RE | Se usa para importar el XML exportado por el cuadro de diálogo de configuración del adaptador de BizTalk para la aplicación host. También se usa para importar definiciones de RE exportadas por el administrador de TI cuando se selecciona una asignación. |
| Ver las propiedades del ensamblado .NET de TI | Muestra las propiedades pertinentes del ensamblado y el nombre de etiqueta XML del documento de entrada/salida que admite este ensamblado. El nombre del método forma parte del nombre de etiqueta, pero no se usa al buscar una asignación. Todas las propiedades son de solo lectura. |