Configuration d'un emplacement de réception WCF-NetMsmq

Vous pouvez configurer un emplacement de réception WCF-NetMsmq par programme ou à l'aide de la console Administration de BizTalk.

Propriétés de configuration

Le modèle objet de l'Explorateur BizTalk permet de créer et de configurer les emplacements de réception par programme. Le modèle objet Explorer BizTalk expose l’interface de configuration de l’emplacement de réceptionIReceiveLocation qui a une propriété de lecture/écriture TransportTypeData. Cette propriété accepte le jeu de propriétés de configuration de l'emplacement de réception WCF-NetMsmq sous la forme d'une chaîne XML composée d'une paire nom/valeur. Pour définir cette propriété dans le modèle objet BizTalk Explorer, vous devez définir la propriété InboundTransportLocation de l’interface IReceiveLocation.

La propriété TransportTypeData de l’interface IReceiveLocation n’a pas besoin d’être définie. Dans ce cas, l'adaptateur WCF-NetMsmq utilise les valeurs par défaut pour la configuration de l'emplacement de réception WCF-NetMsmq, comme indiqué dans le tableau suivant.

Le tableau suivant répertorie les propriétés de configuration que vous pouvez définir dans le modèle objet de l'Explorateur BizTalk pour l'emplacement de réception WCF-NetMsmq.

Configurer un emplacement de réception WCF-NetMsmq avec la console d’administration BizTalk

Vous pouvez définir des variables d'emplacement de réception pour l'adaptateur WCF-NetMsmq 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 sont utilisées.

Configurer des variables pour un emplacement de réception WCF-NetMsmq

1. Dans la console Administration BizTalk, développez BizTalk ServerAdministration, BizTalk Group, Applications, puis l’application dans laquelle vous souhaitez créer un emplacement de réception.

2. Dans le volet gauche de la console Administration de BizTalk, 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.

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

4. 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 WCF-NetMsmq dans la liste déroulante, puis cliquez sur Configurer.

5. Dans la boîte de dialogue Propriétés du transport WCF-NetMsmq , sous l’onglet Général , configurez l’adresse du point de terminaison et l’identité du service pour l’emplacement de réception WCF-NetMsmq. Pour plus d’informations sur l’onglet Général de la boîte de dialogue Propriétés de transport WCF-NetMsmq , consultez la boîte de dialogue Propriétés de transport WCF-NetMsmq, Onglet Recevoir, Général dans l’aide de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs.

6. Dans la boîte de dialogue Propriétés du transport WCF-NetMsmq , sous l’onglet Liaison , configurez les propriétés de délai d’attente et de transaction. Pour plus d’informations sur l’onglet Liaison dans la boîte de dialogue Propriétés de transport WCF-NetMsmq , consultez la boîte de dialogue Propriétés de transport WCF-NetMsmq, Onglet Réception, Liaison dans l’aide de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs.

7. Dans la boîte de dialogue Propriétés du transport WCF-NetMsmq , sous l’onglet Sécurité , définissez les fonctionnalités de sécurité de l’emplacement de réception WCF-NetMsmq. Pour plus d’informations sur l’onglet Sécurité dans la boîte de dialogue Propriétés de transport WCF-NetMsmq , consultez la boîte de dialogue Propriétés de transport WCF-NetMsmq, Recevoir, onglet Sécurité dans l’aide de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs.

8. Dans la boîte de dialogue Propriétés du transport WCF-NetMsmq , sous l’onglet Messages , spécifiez la sélection des données pour l’élément SOAP Body . Pour plus d’informations sur l’onglet Messages dans la boîte de dialogue Propriétés de transport WCF-NetMsmq , consultez la boîte de dialogue Propriétés de transport WCF-NetMsmq, Onglet Réception, Messages dans l’aide de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs.

Configurer un emplacement de réception WCF-NetMsmq par programmation

Vous pouvez utiliser le format suivant pour définir les propriétés :

<CustomProps>
  <ServiceCertificate vt="8" />
  <InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
  <InboundBodyPathExpression vt="8" />
  <MessageClientCredentialType vt="8">Windows</MessageClientCredentialType>
  <SendTimeout vt="8">00:01:00</SendTimeout>
  <IncludeExceptionDetailInFaults vt="11">0</IncludeExceptionDetailInFaults>
  <OpenTimeout vt="8">00:01:00</OpenTimeout>
  <AlgorithmSuite vt="8">Basic256</AlgorithmSuite>
  <MaxConcurrentCalls vt="3">16</MaxConcurrentCalls>
  <SecurityMode vt="8">Transport</SecurityMode>
  <OrderedProcessing vt="11">0</OrderedProcessing>
  <CloseTimeout vt="8">00:01:00</CloseTimeout>
  <MsmqEncryptionAlgorithm vt="8">RC4Stream</MsmqEncryptionAlgorithm>
  <MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>
  <MsmqProtectionLevel vt="8">Sign</MsmqProtectionLevel>
  <DisableLocationOnFailure vt="11">0</DisableLocationOnFailure>
  <MsmqSecureHashAlgorithm vt="8">Sha1</MsmqSecureHashAlgorithm>
  <SuspendMessageOnFailure vt="11">-1</SuspendMessageOnFailure>
  <EnableTransaction vt="11">-1</EnableTransaction>
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
  <MsmqAuthenticationMode vt="8">WindowsDomain</MsmqAuthenticationMode>
</CustomProps>

Le fragment de code suivant illustre la création d'un emplacement de réception WCF-NetMsmq :

// Use BizTalk Explorer object model to create new WCF-NetMsmq receive location
string server = System.Environment.MachineName;
string database = "BizTalkMgmtDb";
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);
string transportConfigData = @"<CustomProps>
  <InboundBodyLocation vt=""8"">UseBodyElement</InboundBodyLocation>
  <UseSSO vt=""11"">0</UseSSO>
  <Identity vt=""8"">
    <identity>
    <userPrincipalName value=""username@contoso.com"" />
    </identity>
  </Identity>
</CustomProps>";
//requires project reference to \Program Files\Microsoft BizTalk Server 2009\Developer Tools\Microsoft.BizTalk.ExplorerOM.dll
BtsCatalogExplorer explorer = new Microsoft.BizTalk.ExplorerOM.BtsCatalogExplorer();
explorer.ConnectionString = connectionString;
// Add a new BizTalk application
Application application = explorer.AddNewApplication();
application.Name = "SampleBizTalkApplication";
// Save
explorer.SaveChanges();

// Add a new one-way receive port
IReceivePort receivePort = application.AddNewReceivePort(false);
receivePort.Name = "SampleReceivePort";
// Add a new one-way receive location
IReceiveLocation receiveLocation = receivePort.AddNewReceiveLocation();
receiveLocation.Name = "SampleReceiveLocation";
// Find a receive handler for WCF-NetMsmq
int i = 0;
for(i=0; i < explorer.ReceiveHandlers.Count; ++i)
{
    if("WCF-NetMsmq" == explorer.ReceiveHandlers[i].TransportType.Name)
        break;
}
receiveLocation.ReceiveHandler = explorer.ReceiveHandlers[i];
receiveLocation.Address = "net.msmq://mycomputer/private/sampleQueue";
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];
receiveLocation.TransportType = explorer.ProtocolTypes["WCF-NetMsmq"];
receiveLocation.TransportTypeData = transportConfigData;
// Save
explorer.SaveChanges();

Voir aussi

Publication des métadonnées de service pour les adaptateurs de réception WCFGestion des hôtes Et des instances hôtes BizTalkComment modifier les comptes de service et les mots de passeInstallation de certificats pour les adaptateurs WCFSpécification du corps du message pour les adaptateurs WCFConfiguration de la remise ordonnée de l’adaptateur WCF-NetMsmqdes messagesd’envoi et de récupération de messages dans une file d’attente de messages de transaction et des files d’attente publiques et privéesActive Directory