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

Vous pouvez configurer un emplacement de réception WCF-WSHttp 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-WSHttp 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. De cette manière, l'adaptateur WCF-WSHttp utilise les valeurs par défaut pour la configuration de l'emplacement de réception WCF-WSHttp, 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-WSHttp.

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

Vous pouvez définir des variables d'emplacement de réception pour l'adaptateur WCF-WSHttp dans la console Administration de BizTalk. 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-WSHttp

1. Dans la console Administration BizTalk, développez BizTalk Server Administration, Groupe BizTalk, 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-WSHttp dans la liste déroulante, puis cliquez sur Configurer.

5. Dans la boîte de dialogue Propriétés de transport WCF-WSHttp , 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-WSHttp. Pour plus d’informations sur l’onglet Général de la boîte de dialogue Propriétés de transport WCF-WSHttp , consultez la boîte de dialogue Propriétés de transport WCF-WSHttp, Recevoir, Onglet 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 de transport WCF-WSHttp , sous l’onglet Liaison , configurez les propriétés de délai d’attente, d’encodage et de transaction. Pour plus d’informations sur l’onglet Liaison dans la boîte de dialogue Propriétés de transport WCF-WSHttp , consultez la boîte de dialogue Propriétés de transport WCF-WSHttp, Recevoir, onglet 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 de transport WCF-WSHttp , sous l’onglet Sécurité , définissez les fonctionnalités de sécurité de l’emplacement de réception WCF-WSHttp. Pour plus d’informations sur l’onglet Sécurité de la boîte de dialogue Propriétés de transport WCF-WSHttp , consultez la boîte de dialogue Propriétés de transport WCF-WSHttp, 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 de transport WCF-WSHttp , 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 de la boîte de dialogue Propriétés de transport WCF-WSHttp , consultez la boîte de dialogue Propriétés de transport WCF-WSHttp, Onglet Recevoir, 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-WSHttp par programmation

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

<CustomProps>  
  <InboundBodyPathExpression vt="8" />  
  <InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>  
  <UseSSO vt="11">0</UseSSO>  
  <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>  
  <OpenTimeout vt="8">00:01:00</OpenTimeout>  
  <AlgorithmSuite vt="8">Basic256</AlgorithmSuite>  
  <SecurityMode vt="8">Message</SecurityMode>  
  <TransportClientCredentialType vt="8">Windows</TransportClientCredentialType>  
  <NegotiateServiceCredential vt="11">-1</NegotiateServiceCredential>  
  <MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>  
  <TextEncoding vt="8">utf-8</TextEncoding>  
  <CloseTimeout vt="8">00:01:00</CloseTimeout>  
  <SuspendMessageOnFailure vt="11">0</SuspendMessageOnFailure>  
  <EnableTransaction vt="11">0</EnableTransaction>  
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>  
  <EstablishSecurityContext vt="11">-1</EstablishSecurityContext>  
  <IncludeExceptionDetailInFaults vt="11">0</IncludeExceptionDetailInFaults>  
  <MaxConcurrentCalls vt="3">16</MaxConcurrentCalls>  
  <ServiceCertificate vt="8" />  
  <MessageEncoding vt="8">Text</MessageEncoding>  
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>  
</CustomProps>  

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

// Use BizTalk Explorer object model to create new WCF-WSHttp 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 = "SampleBizTalkApplication1001";  
// 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-WSHttp   
int i = 0;  
for(i=0; i < explorer.ReceiveHandlers.Count; ++i)   
{  
    if("WCF-WSHttp" == explorer.ReceiveHandlers[i].TransportType.Name)  
        break;  
}  
receiveLocation.ReceiveHandler = explorer.ReceiveHandlers[i];  
receiveLocation.Address = "/samplepath/sampleservice.svc";  
receiveLocation.ReceivePipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruReceive"];  
receiveLocation.TransportType = explorer.ProtocolTypes["WCF-WSHttp"];  
receiveLocation.TransportTypeData = transportConfigData;  
// Save  
explorer.SaveChanges();   

Voir aussi

Publication des services WCF avec les adaptateurs de réception WCF isolés
Configuration d’IIS pour les adaptateurs de réception WCF isolés
Gestion des hôtes et des instances d'hôte BizTalk
Comment modifier les comptes de service et les mots de passe
Installation de certificats pour les adaptateurs WCF
Spécification du corps de message pour les adaptateurs WCF
Configuration de l’adaptateur WCF-WSHttp