Configurer un port d’envoi WCF-WSHttp

Vous pouvez configurer un port d'envoi WCF-WSHttp 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-WSHttp 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-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 les ports d'envoi WCF-WSHttp.

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

Vous pouvez définir les variables de l'adaptateur du port d'envoi WCF-WSHttp 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-WSHttp sont utilisées, comme indiqué dans le tableau précédent.

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

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-WSHttp pour l’option Type dans la section Transport de l’onglet Général .

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-WSHttp , sous l’onglet Général , configurez l’adresse du point de terminaison, l’identité du service et l’en-tête HTTP SOAPAction pour le port d’envoi 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, Envoyer, 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.

4. 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, Onglet Envoyer, Liaison dans l’aide de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs.

5. 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é du port d’envoi 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, 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 de transport WCF-WSHttp , sous l’onglet Proxy , configurez le paramètre de proxy pour le port d’envoi WCF-WSHttp. Pour plus d’informations sur l’onglet Proxy 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, Onglet Envoyer, Proxy 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 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 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-WSHttp par programmation

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

 <CustomProps>
  <ServiceCertificate vt="8" />
  <UseSSO vt="11">0</UseSSO>
  <InboundBodyPathExpression vt="8" />
  <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>
  <Identity vt="8" />
  <AlgorithmSuite vt="8">Basic256</AlgorithmSuite>
  <SecurityMode vt="8">Message</SecurityMode>
  <TransportClientCredentialType vt="8">Windows</TransportClientCredentialType>
  <TextEncoding vt="8">utf-8</TextEncoding>
  <NegotiateServiceCredential vt="11">-1</NegotiateServiceCredential>
  <MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>
  <ClientCertificate vt="8" />
  <ProxyUserName vt="8" />
  <CloseTimeout vt="8">00:01:00</CloseTimeout>
  <ProxyToUse vt="8">Default</ProxyToUse>
  <EnableTransaction vt="11">0</EnableTransaction>
  <InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
  <InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
  <EstablishSecurityContext vt="11">-1</EstablishSecurityContext>
  <StaticAction vt="8">http://www.northwindtraders.com/Service/Operation</StaticAction>
  <PropagateFaultMessage vt="11">-1</PropagateFaultMessage>
  <ProxyAddress vt="8" />
  <MessageEncoding vt="8">Text</MessageEncoding>
  <OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>

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

// Use BizTalk Explorer object model to create new WCF-WSHttp 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>
                                 <MessageEncoding vt=""8"">Text</MessageEncoding>
                                 <TextEncoding vt=""8"">utf-8</TextEncoding>
                                 <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-WSHttp"];
sendPort.PrimaryTransport.Address = "http://mycomputer/samplepath";
sendPort.PrimaryTransport.TransportTypeData = transportConfigData; // propertyData; // need to change
sendPort.SendPipeline = explorer.Pipelines["Microsoft.BizTalk.DefaultPipelines.PassThruTransmit"];
// Save
explorer.SaveChanges();

Voir aussi

Schéma et propriétés de la propriété adaptateurs WCFConfiguration de l’adaptateur WCF-WSHttpSpécification du corps du message pour les adaptateurs WCFInstallation de certificats pour les adaptateurs WCFConfiguration des ports d’envoi dynamique à l’aide des propriétés de contexte des adaptateurs WCF