Adaptador de BizTalk para la configuración de Host Files
Información general
El adaptador de BizTalk para archivos host es un adaptador de envío y recepción que permite a las orquestaciones de BizTalk interactuar con los sistemas host. En concreto, el adaptador habilita las operaciones de envío y recepción a través de conexiones TCP/IP y APPC para hospedar archivos que se ejecutan en plataformas de sistema central e IBM i. En función de la tecnología host Integration Server, el adaptador usa ensamblados de metadatos de la biblioteca de acceso a datos para configurar conexiones y el proveedor de datos de Microsoft .NET Framework para que los archivos host emita comandos SQL y procedimientos almacenados.
El adaptador sirve dos funciones principales:
Para las operaciones de envío (one way y solicitar respuesta), el adaptador envía comandos SQL y comandos del sistema a una instancia de archivo host, con la opción de solicitar una respuesta.
Para las operaciones receive (solo one way), el adaptador crea un comando SQL que sondea los objetos de archivo host y crea mensajes por fila, que se envían al sistema de mensajes de BizTalk.
Además, el adaptador de BizTalk para archivos host usa la herramienta estándar de seguimiento del adaptador de BizTalk como mecanismo de solución de problemas.
Nota:
El adaptador de BizTalk para archivos host es un adaptador no transaccional. Esto significa que una vez que se realiza una acción, no se puede deshacer ni revertir.
Creación de un ensamblado de metadatos
Después de instalar el adaptador, puede crear un ensamblado de metadatos que describa el sistema remoto para BizTalk Server.
Parte del proceso de creación de una aplicación de archivo host en Visual Studio describe el diseño del sistema de archivos host. Este proceso crea un ensamblado de metadatos y un esquema. El ensamblado de metadatos es una representación mediante programación del sistema de archivos de host remoto, mientras que el esquema es una representación XML del sistema de archivos host. Usará el ensamblado de metadatos para describir el sistema de archivos host para BizTalk Server.
Para obtener más información sobre cómo crear una aplicación de archivo de host en Visual Studio, consulte Creación de una aplicación con el proveedor de datos administrados para archivos de host.
Crear un puerto de envío
Inicie sesión con una cuenta que sea miembro del grupo administradores de BizTalk Server.
En BizTalk Server Administración, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, seleccione la aplicación.
Haga clic con el botón derecho en Puertos de envío, seleccione Nuevoy, a continuación, seleccione Puerto de envío unidireccional estático o Solicitar puerto de envío de respuesta.
En Propiedades de puerto de envío, establezca el Tipo de transporte en Archivo host. Seleccione Configurar y escriba las siguientes propiedades:
Use Para hacer esto Cadena de conexión Nombre de un cadena de conexión que se usa para conectarse a la base de datos de archivos de host.
Para configurar una cadena de conexión nueva o existente, haga clic en los puntos suspensivos (...). Esto inicia el Asistente para orígenes de datos. Para acceder a la Ayuda, haga clic en Ayuda en las páginas del asistente o abra la Ayuda de Host Integration Server y busque en el Asistente para orígenes de datos (archivos de host).Target Namespace de documento Espacio de nombres de destino que se usa en los documentos XML que se envían al host. Nombre de elemento raíz de respuesta Nombre del elemento raíz que se usa en los documentos XML que se reciben del host. (Esta propiedad puede estar vacía para un puerto unidireccional). URI Identificador uniforme de recursos. Nombre para identificar la ubicación del puerto de envío. Seleccione Aceptar para guardar los cambios.
En Send Handler (Controlador de envío), seleccione la instancia de host para ejecutar el adaptador y seleccione Send Pipeline (Enviar canalización).
Seleccione Aceptar para guardar los cambios.
En Puertos de envío, haga clic con el botón derecho en el nuevo puerto de envío y seleccione Inscribir y, a continuación, Iniciar.
Creación de un puerto de recepción y una ubicación
Inicie sesión con una cuenta que sea miembro del grupo administradores de BizTalk Server.
En BizTalk Server Administración, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, seleccione la aplicación.
Haga clic con el botón derecho en Puertos de recepción, seleccione Nuevoy, a continuación, seleccione Puerto de recepción unidireccional estático. Configure las propiedades del puerto de recepción y seleccione Aceptar para guardar los cambios.
Haga clic con el botón derecho en Ubicaciones de recepción, seleccione Nuevoy, a continuación, seleccione Ubicación de recepción unidireccional. Seleccione el puerto de recepción que ha creado y, a continuación, Aceptar.
En Las propiedades de ubicación de recepción, establezca el tipo de transporte en HostFiles. Seleccione Configurar y escriba las siguientes propiedades:
Use Para hacer esto Cadena de conexión Escriba el nombre de un cadena de conexión que se usará para conectarse a la base de datos host.
Para configurar una cadena de conexión nueva o existente, haga clic en los puntos suspensivos (...). Esto inicia el Asistente para orígenes de datos. Para acceder a la Ayuda, haga clic en Ayuda en las pantallas del asistente o abra la Ayuda de Host Integration Server y busque en el Asistente para orígenes de datos (archivos de host).
Al configurar una ubicación de recepción o un puerto de envío basado en el adaptador de BizTalk para archivos de host, la definición de metadatos debe crearse como un archivo de metadatos de Integración de host Designer XML (HIDX) para codificar y descodificar registros. Para obtener instrucciones sobre cómo crear un archivo HIDX, consulte Creación de una aplicación con el proveedor de datos administrados para archivos de host.Nombre de elemento raíz de documento Nombre del elemento raíz que se usa en los documentos XML que se reciben del host. Target Namespace de documento Espacio de nombres de destino que se usa en los documentos XML que se reciben del host. Comando SQL Comando Select que se ejecuta una vez para cada intervalo de sondeo. Comando Update El comando que se ejecuta después de procesar cada fila de la operación de recepción. Puede ser una instrucción delete que elimine la fila de la tabla en el comando SQL o un comando de actualización que modifique estáticamente una o varias filas. Cuando se especifica esta opción, el comando SQL debe ser una instrucción Select y tener acceso a una sola tabla.
Puede especificar propiedades adicionales haciendo clic en el botón de puntos suspensivos (...). Se abre el cuadro de diálogo Cambiar comando , que proporciona tres opciones:
- No borre las otras dos opciones si está seleccionada.
- Eliminar después de leer elimina la fila después de que el adaptador la haya leído.
- Update permite escribir un comando SQL que se va a actualizar.URI Identificador uniforme de recursos. Nombre que identifica la ubicación del puerto de recepción. Intervalo de sondeo Número de unidades entre solicitudes de sondeo. El intervalo permitido es de 1 a 65535. Unidad de sondeo de medida Unidad de medida (segundos, minutos o horas) usada entre solicitudes de sondeo. El valor predeterminado es segundos. Seleccione Aceptar para guardar los cambios.
En Controlador de recepción, seleccione la instancia de host. El controlador de recepción debe estar en ejecución en este host. Seleccione la canalización de recepción.
Seleccione Aceptar para guardar los cambios.
En Ubicaciones de recepción, haga clic con el botón derecho en la ubicación de recepción y seleccione Habilitar.
Crear un esquema
Use el Asistente para generar esquemas de archivo de host para crear los esquemas XSD para el adaptador de BizTalk para archivos de host. Después de crear el esquema, está listo para continuar la configuración en el lado BizTalk Server.
Abra el proyecto de Visual Studio BizTalk Server.
Haga clic con el botón derecho en el proyecto, seleccione Agregar, Agregar elementos generados y, a continuación, seleccione Agregar metadatos de adaptador.
En el Asistente para agregar adaptador, en la página Seleccionar adaptador , seleccione Archivo de host y, a continuación, seleccione Siguiente.
En el Asistente para generar esquemas del adaptador de archivos de host:
En Información de base de datos, vaya a un cadena de conexión existente o cree uno nuevo.
Puede ser catálogo inicial, colección de paquetes, (dirección TCP y puerto) o (LU local appC, LU remota y modo), (nombre de usuario y contraseña) o (seguridad integrada). La longitud máxima es 1024.
En Información de esquema, defina el espacio de nombres predeterminado, los elementos raíz y el tipo de puerto que desea usar en el esquema.
Si selecciona Puerto de recepción, solo se necesita un nombre de elemento raíz del documento de solicitud. Si selecciona Enviar puerto, se requieren nombres de elemento raíz de documento de solicitud y respuesta.
En Información de tipo de instrucción, seleccione el tipo de comando de base de datos que se va a emitir.
Si ha seleccionado enviar puertos en la página anterior, puede elegir emitir un diagrama de actualización, un procedimiento almacenado o una instrucción SELECT. Si seleccionó recibir puertos, este paso no es necesario.
En Información de instrucciones, escriba los detalles sobre el archivo host. En función de la información que escribió anteriormente en las páginas anteriores, escriba las siguientes propiedades. Si seleccionó el puerto de envío:
Enviar diagrama de actualización Si decide usar un puerto de envío y diagramas de actualización, puede seleccionar aquí la operación del diagrama de actualización, así como la tabla y las columnas que estarán presentes en el diagrama de actualización.
Comando Send System Si decide usar un puerto de envío y emitir un procedimiento almacenado, puede seleccionar un procedimiento almacenado en el catálogo de la conexión actual. No es necesario escribir valores para todos los parámetros de esta página.
Enviar instrucción Select Si decide usar un puerto de envío con una instrucción SELECT de SQL, puede seleccionar o examinar la instrucción aquí.
Si ha seleccionado el puerto de recepción:
Receive Select (instrucción) Si decide usar un puerto de recepción con una instrucción SQL, puede seleccionar o examinar la instrucción aquí.
Enviar diagrama de actualización Si decide usar un puerto de envío y diagramas de actualización, puede seleccionar aquí la operación del diagrama de actualización, así como la tabla y las columnas que estarán presentes en el diagrama de actualización.
Enviar procedimiento almacenado Si decide usar un puerto de envío y emitir un procedimiento almacenado, puede seleccionar un procedimiento almacenado en el catálogo de la conexión actual. No es necesario escribir valores para todos los parámetros de esta página.
Enviar instrucción Select Si decide usar un puerto de envío con una instrucción SELECT de SQL, puede seleccionar o examinar la instrucción aquí.
Seleccione Finalizar cuando haya finalizado.
Crear una aplicación de BizTalk
Después de crear el esquema, puede codificar la aplicación de BizTalk. La aplicación usa el ensamblado de metadatos que creó en Visual Studio, además del esquema y los puertos que creó.
Cree un proyecto de BizTalk en Visual Studio.
Use el esquema que ha creado para describir el sistema de archivos de host en la aplicación de BizTalk.
Use el puerto de envío que creó para enviar datos al sistema de archivos host.
Si es necesario, use el puerto de recepción y la ubicación que ha creado.
Agregue cualquier orquestación, componente o código adicional, según sea necesario.
Pruebe la aplicación.
Una vez finalizada la prueba de la aplicación, cree un paquete de .msi para mover la aplicación a un servidor provisional o activo. Al crear un paquete de BizTalk Server .msi, asegúrese de incluir el ensamblado de metadatos del archivo de host que ha creado.