Partager via


Interfaces pour adaptateur de réception isolé

Les adaptateurs de réception isolés sont hébergés dans un espace de processus autre que le processus BizTalk Server. Pour interagir avec le moteur de messagerie, un adaptateur de réception isolé s'inscrit lui-même au démarrage, de sorte à être configuré et contrôlé par le moteur. L’adaptateur crée le proxy de transport, interroge l’interface IBTTransportProxy et appelle IBTTransportProxy.RegisterIsolatedReceiver pour inscrire son interface de rappel IBTTransportConfig auprès du moteur de messagerie. Cet appel synchrone se produit avant que l’adaptateur envoie son premier message à BizTalk Server. Cela permet au moteur de messagerie d'effectuer un rappel dans l'adaptateur et d'indiquer les points de terminaison actifs devant être écoutés pour les messages entrants. Les adaptateurs isolés doivent implémenter les interfaces suivantes :

  • IBTTransport

  • IBTTransportConfig

  • IBaseComponent

  • IPersistPropertyBag

    L'inscription de l'adaptateur implique que l'adaptateur envoie un emplacement de réception configuré et activé. Le processus hôte de l'adaptateur doit être membre du groupe Utilisateurs d'hôtes BizTalk isolés. En outre, l'adaptateur est interrogé afin de vérifier qu'il dispose de l'ID de classe approprié et qu'il s'exécute sur l'ordinateur qui a été configuré pour cette instance d'hôte.

    Une fois l’adaptateur inscrit auprès du proxy de transport, le moteur de messagerie transmet les informations de configuration et les autres emplacements de réception à l’adaptateur en appelant respectivement la méthode Load de l’interface IPersistPropertyBag et la méthode AddReceiveEndpoint de l’interface IBTTransportConfig .

    Lorsqu’un adaptateur de réception isolé met fin au traitement des messages et qu’il va être arrêté, il doit appeler la méthode TerminateIsolatedReceiver de l’interface IBTTransportProxy .

    L'illustration suivante montre les interactions d'objets impliquées dans la création d'un adaptateur de réception isolé.

    Image montrant les interactions d’objet impliquées dans la création d’un adaptateur de réception isolé.
    Workflow d'initialisation d'un adaptateur de réception isolé

Notes

Nous recommandons que l’adaptateur effectue le suivi des demandes en cours d’exécution pour BizTalk Server. L’adaptateur doit bloquer la méthode Terminate jusqu’à ce que le nombre de travail ait atteint zéro. Du côté de la réception, ce travail inclut toutes les demandes en attente qui n’ont pas été publiées sur BizTalk Server. Notez que les messages de réponse ne sont généralement pas remis à un adaptateur de réception après l’appel de Terminate . En général, après que l’adaptateur a appelé la méthode Terminate , le moteur de messagerie n’accepte pas les demandes de publication de nouveaux messages, à l’exception des messages de réponse pour les paires sollicitation-réponse.

Notes

Un processus peut héberger plusieurs instances d'adaptateurs isolés, mais un seul processus peut héberger un adaptateur.

Voir aussi

Variables d’adaptateur
Développement d’un adaptateur de réception
Instanciation et initialisation d’un adaptateur de réception
Interfaces pour un adaptateur de réception In-process
Interfaces pour un adaptateur de réception pris en charge par lot
Interfaces pour un adaptateur de réception pris en charge par lot transactionnel
Interfaces pour un adaptateur de réception de type requête-réponse synchrone