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 que las orquestaciones de BizTalk interactúen 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 AS/400 y del sistema central. En función de Host Integration Server tecnología, 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 y procedimientos almacenados SQL.

El adaptador sirve dos funciones principales:

  • En el caso de 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 de recepción (solo one way), el adaptador crea un comando SQL que sondea los objetos de archivo host y crea mensajes por fila, que luego se envían al sistema de mensajes de BizTalk.

    Además, el adaptador de BizTalk para archivos de 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 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 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.

  1. En BizTalk Server Administración, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, seleccione la aplicación.

  2. Haga clic con el botón derecho en Puertos de envío, seleccione Nuevo y, a continuación, seleccione Puerto de envío unidireccional estático o Solicitar puerto de envío de respuesta.

  3. 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 una 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 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.
  4. Seleccione Aceptar para guardar los cambios.

  5. En Send Handler (Controlador de envío), seleccione la instancia de host para ejecutar el adaptador y seleccione Send Pipeline (Enviar canalización).

  6. Seleccione Aceptar para guardar los cambios.

  7. 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.

  1. En BizTalk Server Administración, expanda Grupo de BizTalk, expanda Aplicaciones y, a continuación, seleccione la aplicación.

  2. 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.

  3. 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, después, Aceptar.

  4. En 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 una 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 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 host, la definición de metadatos debe crearse como un archivo de metadatos XML (HIDX) del Diseñador de integración de host 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.

    Para especificar propiedades adicionales, haga 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 lo haya leído.
    - Update le 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) usadas entre solicitudes de sondeo. El valor predeterminado es segundos.
  5. Seleccione Aceptar para guardar los cambios.

  6. En El 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.

  7. Seleccione Aceptar para guardar los cambios.

  8. 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.

  1. Abra el proyecto de BizTalk Server Visual Studio.

  2. Haga clic con el botón derecho en el proyecto, seleccione Agregar, Agregar elementos generados y, a continuación, seleccione Agregar metadatos de adaptador.

  3. En el Asistente para agregar adaptadores, en la página Seleccionar adaptador , seleccione Archivo de host y, a continuación, seleccione Siguiente.

  4. En el Asistente para generar esquemas del adaptador de archivos de host:

    1. En Información de base de datos, vaya a una cadena de conexión existente o cree una nueva.

      Puede ser catálogo inicial, colección de paquetes, (dirección TCP y puerto) o (LU local de APPC, LU remota y modo), (nombre de usuario y contraseña) o (seguridad integrada). La longitud máxima es 1024.

    2. 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.

    3. En Información de tipo de instrucción, seleccione el tipo de comando de base de datos que se va a emitir.

      Si seleccionó puertos de envío en la página anterior, puede elegir emitir un diagrama de actualización, un procedimiento almacenado o una instrucción SELECT. Si seleccionó puertos de recepción, este paso no es necesario.

    4. 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 ha seleccionado el puerto de envío:

      • Enviar diagrama de actualización Si eligió usar un puerto de envío y diagramas de actualización, puede seleccionar la operación de diagrama de actualización aquí, así como la tabla y las columnas que estarán presentes en el diagrama de actualización.

      • Enviar comando del sistema Si eligió 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 especificar 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 eligió usar un puerto de envío y diagramas de actualización, puede seleccionar la operación de diagrama de actualización aquí, así como la tabla y las columnas que estarán presentes en el diagrama de actualización.

      • Enviar procedimiento almacenado Si eligió 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 especificar 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í.

  5. 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ó.

  1. Cree un proyecto de BizTalk en Visual Studio.

  2. Use el esquema que creó para describir el sistema de archivos de host en la aplicación de BizTalk.

  3. Use el puerto de envío que creó para enviar datos al sistema de archivos host.

  4. Si es necesario, use el puerto de recepción y la ubicación que creó.

  5. Agregue las orquestaciones, componentes o código adicionales, según sea necesario.

  6. Pruebe la aplicación.

  7. 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 host que creó.

Consulte también

Proveedor de datos administrado para Host Files