Configuration d'un emplacement de réception MSMQ
Vous pouvez définir des variables d'adaptateur d'emplacement de réception MSMQ dans la console Administration de BizTalk Server. Si les propriétés ne sont pas définies pour l'emplacement de réception, les valeurs par défaut du gestionnaire de réception définies dans la console Administration de BizTalk Server sont utilisées.
Notes
Avant d'effectuer la procédure suivante, vous devez avoir ajouté un port de réception. Pour plus d’informations, consultez Comment créer un port de réception.
Important
Si une instance de l'hôte est associée à un port d'envoi ou à un emplacement de réception MSMQ, vérifiez que le service MSMQ est en cours d'exécution sur cet ordinateur. Si le service ne fonctionne pas, les ports de réception MSMQ sont fermés peu de temps après leur démarrage, et l'envoi de messages aux ports d'envoi MSMQ est suspendu.
Dans un scénario de mise en cluster, non seulement l'instance MSMQ en cluster doit être en cours d'exécution, mais le service MSMQ sur chaque ordinateur du cluster doit l'être également.
Pour configurer les variables d'un emplacement de réception MSMQ
Pour configurer les variables d'un emplacement de réception MSMQ, procédez comme suit :
Dans la console Administration BizTalk Server, développez BizTalk Server Administration, BizTalk Group, Applications, puis l’application dans laquelle vous souhaitez créer un emplacement de réception.
Dans la console d’administration BizTalk Server, dans le volet gauche, cliquez sur le nœud Port de réception. Dans le volet droit, cliquez avec le bouton droit sur le port de réception associé à un emplacement de réception existant ou auquel associer un nouvel emplacement, puis cliquez sur Propriétés.
Dans la boîte de dialogue Propriétés du port de réception, dans le volet gauche, sélectionnez Emplacements de réception, puis dans le volet droit, double-cliquez sur un emplacement de réception existant ou cliquez sur Nouveaupour créer un emplacement de réception.
Dans la boîte de dialogue Propriétés de l’emplacement de réception, dans la section Transport en regard de Type, sélectionnez MSMQ dans la liste déroulante, puis cliquez sur Configurer.
Dans la boîte de dialogue Propriétés du transport MSMQ , procédez comme suit :
Propriété Pour Type de date Valeur par défaut Mot de passe Définir un mot de passe à utiliser pour une file d'attente distante. String Vide Nom d’utilisateur Indiquer le nom d'utilisateur à utiliser, en même temps que le mot de passe, pour accéder à une file d'attente distante. Vous ne pouvez pas indiquer ici le nom de l'utilisateur local de l'ordinateur distant. String Vide Taille de lot Configurer la taille de lot. L'adaptateur MSMQ envoie des messages par lot à la base de données MessageBox. La taille du lot par défaut est 20, et la taille minimale 1. Note: Si la propriété Transactional de l’emplacement de réception est définie sur True ; chaque lot de messages est envoyé à la base de données MessageBox dans le contexte d’une transaction MSDTC (Microsoft Distributed Transaction Coordinator). La transaction MSDTC qui est créée pour un lot de messages reste ouverte jusqu'à ce que chaque message du lot conservé dans la base de données MessageBox soit placé dans la file d'attente d'abonné appropriée. Par conséquent, la durée de cette transaction MSDTC est augmentée à mesure que le paramètre Batch Size est augmenté. Étant donné que le fait d’avoir un grand nombre de transactions MSDTC ouvertes simultanément peut avoir un impact négatif sur les performances globales, le paramètre Batch Size ne doit pas être défini sur une valeur très élevée lorsque la prise en charge des transactions est activée. Int 20 En cas d’échec Indiquer comment l'adaptateur doit réagir à une erreur. Définir cette propriété sur l'une des valeurs suivantes :
- Arrêter. Arrêtez de recevoir des messages via cet emplacement de réception si une condition d’erreur se produit.
- Suspend(non-reprise). Suspendez les messages et marquez comme ne pouvant pas être repris.
- Suspend(reprise). Suspendez les messages et marquez comme pouvant être repris. Important: Si l’option True pour la propriété Traitement ordonné , l’option Arrêter de la propriété On Failure et l’option False pour la propriété Transactional sont appliquées en même temps, les messages qui échouent à la remise ne seront pas suspendus ou laissés dans la file d’attente source. mais perdus. Pour éviter la perte de données, lors de l’utilisation de la fonctionnalité Traitement ordonné , l’option Arrêter de la propriété En cas d’échec ne doit être appliquée que si l’option True de la propriété transactionnelle est appliquée. Par la suite, si la remise d'un message échoue, le message d'origine sera conservé dans la file d'attente MSMQ source. Si la propriété Traitement ordonné est définie sur la valeur False, la propriété On Failure n’entre pas en vigueur et si un échec de remise de message se produit, le message est suspendu avec un status de Suspendu (pouvant être repris).String Suspendu (peut être repris) Traitement chronologique Définissez cette propriété sur True ou False. Cette option indique s'il faut traiter les messages en série. La définition de la propriété sur True prend en charge la remise ordonnée des messages lorsqu’elle est utilisée conjointement avec un port d’envoi de messagerie Ou d’orchestration BizTalk dont l’option Remise ordonnée est définie sur True. Pour plus d’informations, consultez Remise ordonnée de messages.
La définition de cette propriété sur True optimise également l’utilisation des ressources lors de la gestion des messages volumineux en rendant l’adaptateur monothread. Pour plus d’informations, consultez Envoi et réception de messages volumineux à l’aide de l’adaptateur MSMQ.Boolean False File d'attente Taper un chemin d'accès valide à la file d'attente. En fonction du chemin spécifié, le système effectue les validations appropriées. Note: L’URI d’un port d’envoi ou d’un emplacement de réception ne peut pas dépasser 256 caractères. Note: L’adaptateur de réception MSMQ utilise un mécanisme d’interrogation pour surveiller la file d’attente MSMQ spécifiée pour les nouveaux messages toutes les 0,5 secondes. Cet intervalle est fixe. String Vide Transactionnelle Définissez cette propriété sur True ou False. Note: L’adaptateur prend en charge les lectures transactionnelles des files d’attente distantes avec Message Queuing 4.0 ou version ultérieure uniquement. Dans ce scénario, le BizTalk Server et le serveur Message Queuing distant doivent exécuter Message Queuing 4.0 ou version ultérieure.
Pour plus d’informations, consultez Configuration de l’adaptateur MSMQ et Considérations relatives à l’exécution de gestionnaires d’adaptateurs au sein d’un hôte cluster.Boolean False Notes
Le nom d’utilisateur et le mot de passe s’appliquent uniquement aux comptes Windows utilisés pour accéder aux files d’attente distantes.
Cliquez sur OK.
Dans la boîte de dialogue Propriétés de l’emplacement de réception, entrez les valeurs appropriées pour terminer la configuration de l’emplacement de réception, puis cliquez sur OK pour enregistrer les paramètres. Pour plus d'informations sur la boîte de dialogue Propriétés de l'emplacement de réception , consultez la rubrique Création d'un emplacement de réception.