Configuration d'un port d'envoi WCF-NetMsmq

Vous pouvez configurer un port d'envoi WCF-NetMsmq par programme ou à l'aide de la console Administration de BizTalk.

Propriétés de configuration

Le modèle objet Explorer BizTalk expose une interface spécifique à l’adaptateur pour les ports d’envoi nommée ITransportInfo qui a la propriété de lecture/écriture TransportTypeData. Celle-ci accepte le jeu de propriétés de configuration du port d'envoi WCF-NetMsmq sous la forme d'une paire nom-valeur de chaînes XML.

La propriété TransportTypeData de l’interface ITransportInfo n’est pas requise. Si elle n'est pas définie, l'adaptateur utilise les valeurs par défaut pour la configuration du port d'envoi 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 les ports d'envoi WCF-NetMsmq.

Configurer un port d’envoi WCF-NetMsmq avec la console d’administration BizTalk

Vous pouvez définir les variables de l'adaptateur du port d'envoi WCF-NetMsmq dans la console Administration de BizTalk. Si les propriétés ne sont pas définies pour le port d'envoi, les valeurs par défaut pour la configuration du port d'envoi WCF-NetMsmq sont utilisées, comme indiqué dans le tableau précédent.

Configurer des variables pour un port d’envoi WCF-NetMsmq

1. Dans la console Administration de BizTalk, créez un port d'envoi ou double-cliquez sur un port d'envoi existant pour le modifier. Pour plus d’informations, consultez Création d’un port d’envoi. Configurez toutes les options de port d’envoi et spécifiez WCF-NetMsmq pour l’option Type dans la section Transport de l’onglet Général de l’aide de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs.

2. Sous l’onglet Général , dans la section Transport , cliquez sur le bouton Configurer en regard de Type.

3. 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, l’identité du service et l’en-tête SOAPAction pour le port d’envoi WCF-NetMsmq. Pour plus d’informations sur l’onglet Général dans la boîte de dialogue Propriétés du transport WCF-NetMsmq , consultez la boîte de dialogue Propriétés de transport WCF-NetMsmq, Onglet Envoyer, 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.

4. Dans la boîte de dialogue Propriétés du transport WCF-NetMsmq , sous l’onglet Liaison , configurez les paramètres 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 du transport WCF-NetMsmq , consultez la boîte de dialogue Propriétés de transport WCF-NetMsmq, Onglet Envoyer, Liaison dans l’aide de l’interface utilisateur et référence de l’espace de noms d’API des développeurs.

5. 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é du port d’envoi 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, Envoyer, 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.

6. 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 du transport WCF-NetMsmq , consultez la boîte de dialogue Propriétés de transport WCF-NetMsmq, onglet Envoyer, 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 port d’envoi WCF-NetMsmq par programmation

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

<CustomProps>  
  <ServiceCertificate vt="8" />  
  <UseSSO vt="11">0</UseSSO>  
  <CloseTimeout vt="8">00:01:00</CloseTimeout>  
  <MessageClientCredentialType vt="8">Windows</MessageClientCredentialType>  
  <SendTimeout vt="8">00:01:00</SendTimeout>  
  <OutboundXmlTemplate vt="8"><bts-msg-body xmlns="http://www.microsoft.com/schemas/bts2007" encoding="xml"/></OutboundXmlTemplate>  
  <MsmqProtectionLevel vt="8">Sign</MsmqProtectionLevel>  
  <OpenTimeout vt="8">00:01:00</OpenTimeout>  
  <UseSourceJournal vt="11">0</UseSourceJournal>  
  <AlgorithmSuite vt="8">Basic256</AlgorithmSuite>  
  <SecurityMode vt="8">Transport</SecurityMode>  
  <CustomDeadLetterQueue vt="8" />  
  <ClientCertificate vt="8" />  
  <MsmqEncryptionAlgorithm vt="8">RC4Stream</MsmqEncryptionAlgorithm>  
  <StaticAction vt="8">http://www.northwindtraders.com/Service/Operation</StaticAction>  
  <MsmqSecureHashAlgorithm vt="8">Sha1</MsmqSecureHashAlgorithm>  
  <EnableTransaction vt="11">-1</EnableTransaction>  
  <TimeToLive vt="8">1.00:00:00</TimeToLive>  
  <MsmqAuthenticationMode vt="8">WindowsDomain</MsmqAuthenticationMode>  
  <DeadLetterQueue vt="8">System</DeadLetterQueue>  
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>  
</CustomProps>  

Le fragment de code suivant illustre la création d'un port d'envoi WCF-NetMsmq :

// Use BizTalk Explorer object model to create new WCF-NetMsmq send port.  
string server = System.Environment.MachineName;  
string database = "BizTalkMgmtDb";  
string connectionString = string.Format("Server={0};Database={1};Integrated Security=true", server, database);  
string transportConfigData = @"<CustomProps>  
                                 <StaticAction vt=""8"">http://www.northwindtraders.com/Service/Operation</StaticAction>  
                                 <OpenTimeout vt=""8"">00:01:00</OpenTimeout>  
                               </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 static one-way send port  
SendPort sendPort = application.AddNewSendPort(false, false);   
sendPort.Name = "SampleSendPort";  
sendPort.PrimaryTransport.TransportType = explorer.ProtocolTypes["WCF-NetMsmq"];  
sendPort.PrimaryTransport.Address = "net.msmq://mycomputer/private/samplequeue";  
sendPort.PrimaryTransport.TransportTypeData = transportConfigData; // propertyData; // need to change  
sendPort.SendPipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruTransmit"];  
// Save  
explorer.SaveChanges();  

Voir aussi

Propriétés et schéma de propriété des adaptateurs WCF
Installation de certificats pour les adaptateurs WCF
Spécification du corps de message pour les adaptateurs WCF
Configuration de l’adaptateur WCF-NetMsmq
Configuration des ports d’envoi dynamiques à l’aide des propriétés de contexte des adaptateurs WCF