Leer en inglés

Compartir a través de


Variables de adaptador

Hay numerosas variables que todo adaptador personalizado necesita controlar. Los valores asignados a estas variables influyen en la lógica personalizada que implementa el adaptador. Las propiedades de configuración específicas de aplicación o de transporte también pueden ayudar a admitir la solución. En la siguiente tabla se incluyen las variables comunes. Debe decidir si desea admitir cada una de ellas en el adaptador personalizado.

El adaptador debe implementar interfaces específicas para cada opción. Debajo de la tabla se encuentra una lista de opciones de variables con vínculos que conducen a más información acerca de la escritura de código del adaptador para que sea compatible con las decisiones de diseño.

Variable de adaptador Descripción
Dirección de comunicación Recibir. el adaptador de recepción escucha una dirección específica de protocolo para un mensaje entrante. Cuando se recibe un mensaje, el adaptador de recepción entrega el mensaje al motor de mensajería, que pasa el mensaje a través de una canalización de recepción, para que se almacene finalmente en la base de datos de cuadro de mensajes.

Send. cuando el motor de mensajería necesita enviar un mensaje a un extremo específico, lo pasa a la canalización de envío. Un adaptador de envío acepta un mensaje que proviene de una canalización de envío y lo envía al puerto de envío.
Asignación de host a adaptador En curso: Se crea un adaptador en proceso y se hospeda en el proceso de servicio de BizTalk, BTSNTSvc.exe. Si el host es de 64 bits, el proceso se denomina BTSNTSvc64.exe. Para simplificar el trabajo, no se volverá a mencionar el proceso de 64 bits en esta sección.

Esto significa que BizTalk Server crea y administra la duración del adaptador, la inicializa con el proxy de transporte, los servicios que solicita el adaptador y finaliza el adaptador al apagar el servicio.

En el caso de los adaptadores en proceso, BizTalk Server también entrega información de configuración al adaptador en tiempo de ejecución, incluido el controlador, el puerto de envío y la configuración de ubicación de recepción. Asimismo, los aspectos de la configuración, como las ventanas de servicio, se controlan mediante el motor de mensajería, de modo que no es necesario que el adaptador compruebe que una ubicación de recepción o un puerto de envío esté fuera de una ventana de servicio.

Tenga en cuenta que todos los adaptadores de envío son adaptadores de tipo En curso y deben ejecutarse en el proceso BTSNTSvc.exe.

Aislado: El adaptador se crea en un host aislado que no forma parte del entorno de ejecución de BizTalk Server. Un ejemplo de adaptador aislado es el adaptador de recepción HTTP, que se ejecuta en el espacio de procesos de Internet Information Services (IIS).

El modelo de proceso de IIS está establecido de este modo para que IIS administre el período de vida de las aplicaciones ASP.NET y extensiones ISAPI. Cuando BizTalk Server no puede administrar la duración del adaptador, el adaptador se conoce como adaptador aislado.

Dado que BizTalk Server no administra la creación de instancias de un adaptador aislado, el adaptador debe crear su propio proxy de transporte y registrarse con ese proxy de transporte.

Tenga en cuenta que la arquitectura de BizTalk Server elimina la comunicación innecesaria entre procesos. Puesto que el adaptador aislado y la pila de BizTalk se encuentran en el mismo proceso, no hay comunicación entre procesos cuando el adaptador llama al motor de mensajería. La única comunicación entre procesos se establece entre el motor de mensajería y la base de datos, lo cual es inevitable.

Las aplicaciones COM+ no pueden alojar los adaptadores de envío escritos en código no administrado.
Patrón de intercambio de mensajes Unidireccional. el mensaje puede ser entrante o saliente.

Request-Response (bidireccional). Los adaptadores de solicitud-respuesta siempre reciben adaptadores. Un adaptador de recepción de solicitud-respuesta recibe un mensaje de solicitud del cliente y envía el mensaje a BizTalk Server. Después de BizTalk Server haya procesado el mensaje de solicitud, devuelve un mensaje de respuesta al adaptador. El adaptador transmite el mensaje de respuesta al cliente.

Solicitud-Respuesta (bidireccional). Los adaptadores de solicitud-respuesta siempre son adaptadores de envío. Un adaptador de envío de petición-respuesta envía un mensaje de solicitud desde BizTalk Server al destino, espera al mensaje de respuesta y lo vuelve a enviar a BizTalk Server.
Enlace de puerto de envío Puertos de envío dinámicos y ubicaciones de recepción: la variable URI del puerto de envío o de la ubicación de recepción usada en el enlace dinámico se determina en el tiempo de ejecución.

Puertos de envío estáticos y ubicaciones de recepción: la variable URI del puerto de envío o de la ubicación de recepción es estática y se configura antes del tiempo de ejecución.
Adaptadores de envío sincrónico frente a adaptadores de envío asíncronos Adaptador de envío sincrónico: durante la ejecución de una operación de envío, el motor de mensajería bloquea el subproceso de proxy de transporte hasta que se haya enviado el lote de mensajes y se devuelva. El proxy de transporte controla la eliminación de mensajes después de que el mensaje se transmita, reintente o se suspenda, o el paso a la siguiente operación se complete.

Adaptador de envío asíncrono: el adaptador de envío asíncrono no bloquea el subproceso de proxy de transporte, sino que usa un subproceso independiente durante la realización de las operaciones de envío. Al contrario que el adaptador sincrónico, este adaptador debe implementar toda la lógica de eliminación y de reintentos; el proxy de transporte no controla la lógica.

Los adaptadores que envían mensajes asincrónicos permiten un mejor rendimiento BizTalk Server que los que envían mensajes sincrónicos. Esto se debe a que los subprocesos pasan mucho tiempo esperando a que se completen las operaciones entrantes y salientes. Puesto que el motor de mensajería está altamente enlazado a la CPU, el bloqueo del subproceso del motor de mensajería degrada el rendimiento de los adaptadores.

Se recomienda el uso de transmisiones asíncronas, ya que mejora el rendimiento.
Adaptadores de recepción asíncronos Todos los adaptadores de recepción son asíncronos. Esto quiere decir que cuando el adaptador envía mensajes nuevos al motor de mensajería de BizTalk, no espera a que se procesen completamente antes de efectuar la devolución.
Compatibilidad transaccional Adaptador transaccional: admite el envío y la recepción transaccional de los mensajes. En el caso de los envíos, solo los adaptadores de envío de procesamiento por lotes asíncronos son compatibles con las transacciones.

Adaptador no transaccional: se trata de un adaptador que no recibe ni envía un mensaje en el ámbito de una transacción explícita. Numerosos adaptadores son no transaccionales, ya que realizan envíos desde un sistema o hacia él, como, por ejemplo, el sistema de archivos de Windows, que no es compatible con las transacciones.
Adaptadores de envío compatibles con lotes frente a adaptadores de envío incompatibles con lotes Adaptador compatible con lotes: el adaptador de envío puede procesar mensajes en lotes de operaciones.

Los adaptadores pueden recopilar todos los mensajes disponibles para el envío y, a continuación, enviarlos de una sola vez a la base de datos de cuadro de mensajes, con lo que se reduce el número de actualizaciones de bases de datos necesarias. En algunos casos, esto quiere decir que la longitud del lote equivale a una unidad. Asimismo, los adaptadores de envío recopilan todos los mensajes que están disponibles para el envío, los extrae y los envía a su destino de una sola vez.

En general, BizTalk Server trata un lote como una unidad de trabajo para las actualizaciones de la base de datos. En el mismo lote, los adaptadores pueden enviar mensajes unidireccionales, de solicitud-respuesta y de petición-respuesta; también suspender mensajes, eliminar mensajes, solicitar el reintento de transmisión de un mensaje o su traslado al transporte de reserva. Siempre que sea posible, debe usar las transmisiones por lotes.

Tanto los adaptadores de envío como los de recepción se pueden procesar por lotes, aunque solo los adaptadores de envío asíncronos procesados por lotes son compatibles con las transacciones.

Adaptador incompatible con lotes: es necesario que cada mensaje realice llamadas independientes al servidor.
Adaptadores de recepción compatibles con lotes Todos los adaptadores de recepción son compatibles con lotes.
Configuración dinámica del adaptador en tiempo de diseño frente a configuración estática Tiempo de diseño de adaptador dinámico: para que un adaptador sea compatible con la configuración dinámica en tiempo de diseño, debe desarrollar una interfaz de usuario personalizada (UI) para trabajar con el Asistente para agregar metadatos de adaptador. Esta interfaz permite al usuario seleccionar el esquema que se va a agregar a un proyecto de BizTalk y devuelve la descripción del servicio a través de un archivo de Lenguaje de descripción de servicios Web (WSDL). El adaptador proporciona una interfaz de usuario personalizada para obtener esquemas. Cuando se importa un servicio mediante el Asistente para agregar metadatos de adaptador, agrega tipos de puertos, tipos de mensajes y una orquestación al proyecto de BizTalk, además de los esquemas.

Para obtener más información, consulte Configuración del adaptador de Design-Time estática.

Tiempo de diseño de adaptador estático: para que un adaptador sea compatible con la configuración estática en tiempo de diseño, debe implementar interfaces estándar para que el Asistente para agregar metadatos de adaptador pueda seleccionar un esquema para agregarlo a un proyecto de BizTalk. El marco de trabajo de adaptadores de BizTalk proporciona la UI del adaptador.

Para obtener información sobre cómo modificar el adaptador de archivo de ejemplo, vea Configuración dinámica del adaptador de Design-Time.
Adaptadores de transporte frente a adaptadores de aplicación Adaptadores de transporte: los adaptadores de transporte son compatibles con un protocolo específico y no usan un esquema. De los doce adaptadores nativos, nueve son adaptadores de transporte: MSMQ, serie MQ, archivo, FTP, HTTP, SMTP, POP3 y SOAP.

Adaptadores de aplicación: los adaptadores de aplicación usan esquemas de datos para enviar datos a la aplicación específica. De los adaptadores nativos, dos son adaptadores de aplicación: Windows SharePoint Services y SQL.

Para obtener información acerca de las interfaces que se implementan en el código de adaptador personalizado, use el vínculo de la siguiente tabla correspondiente al tipo de adaptador que piensa crear. En algunos casos, tendrá que combinar las interfaces enumeradas que cumplen un requisito con las interfaces enumeradas en una página independiente que cumplen otro requisito.

Consulte también

Desarrollo de adaptadores personalizados
Uso de adaptadores
Ejemplos de adaptador: desarrollo