Créer le port d’envoi et l’emplacement de réception par programmation
Configurez un WCF-BasicHttp l’emplacement de réception et le port d’envoi par programmation. Pour utiliser la console d’administration BizTalk, consultez Adaptateur WCF-BasicHttp.
Configurer l’emplacement de réception par programmation
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-BasicHttp 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-BasicHttp utilise les valeurs par défaut pour la configuration de l'emplacement de réception WCF-BasicHttp, comme indiqué dans le tableau suivant.
Le fragment de code suivant illustre la création d’un emplacement de réception WCF-BasicHttp à l’aide du modèle objet Explorer BizTalk :
// Use BizTalk Explorer object model to create new WCF-BasicHttp 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-BasicHttp
int i = 0;
for(i=0; i < explorer.ReceiveHandlers.Count; ++i)
{
if("WCF-BasicHttp" == 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-BasicHttp"];
receiveLocation.TransportTypeData = transportConfigData;
// Save
explorer.SaveChanges();
Vous pouvez utiliser le format suivant pour définir les propriétés dans <CustomProps>:
<CustomProps>
<ServiceCertificate vt="8" />
<InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
<UseSSO vt="11">0</UseSSO>
<MessageClientCredentialType vt="8">UserName</MessageClientCredentialType>
<InboundBodyPathExpression vt="8" />
<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">
<identity>
<userPrincipalName value="username@contoso.com" />
</identity>
</Identity>
<AlgorithmSuite vt="8">Basic256</AlgorithmSuite>
<SecurityMode vt="8">None</SecurityMode>
<TransportClientCredentialType vt="8">None</TransportClientCredentialType>
<MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>
<TextEncoding vt="8">utf-8</TextEncoding>
<CloseTimeout vt="8">00:01:00</CloseTimeout>
<SuspendMessageOnFailure vt="11">0</SuspendMessageOnFailure>
<InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
<IncludeExceptionDetailInFaults vt="11">0</IncludeExceptionDetailInFaults>
<MaxConcurrentCalls vt="3">16</MaxConcurrentCalls>
<MessageEncoding vt="8">Text</MessageEncoding>
<OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>
Le tableau suivant répertorie les propriétés de configuration que vous pouvez définir pour l’emplacement de réception :
| Nom de la propriété | Type | Description |
|---|---|---|
| Identité | Blob XML Exemple : <identity> <userPrincipalName value="username@contoso.com » /> </Identité> |
Spécifiez l'identité du service fourni par cet emplacement de réception. Les valeurs qui peuvent être spécifiées pour la propriété Identity diffèrent en fonction de la configuration de la sécurité. Ces paramètres permettent au client d'authentifier cet emplacement de réception. Lors du processus d'établissement de liaison entre le client et le service, l'infrastructure WCF (Windows Communication Foundation) garantit que l'identité du service attendu correspond aux valeurs de cet élément. La valeur par défaut est une chaîne vide. |
| OpenTimeout | System.TimeSpan | Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération d'ouverture de canal soit réalisée. Valeur par défaut : 00:01:00 |
| SendTimeout | System.TimeSpan | Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération d'envoi soit réalisée. En cas d'utilisation d'un port de réception de requête-réponse, cette valeur indique une période pour la réalisation de l'intégralité de l'interaction, même si le client renvoie un message volumineux. Valeur par défaut : 00:01:00 |
| CloseTimeout | System.TimeSpan | Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération de fermeture de canal soit réalisée. Valeur par défaut : 00:01:00 |
| MaxReceivedMessageSize | Integer | Spécifiez la taille maximale en octets d'un message (en-têtes inclus) et pouvant être reçu sur le câble. La taille des messages est limitée par la quantité de mémoire allouée pour chacun d'eux. Vous pouvez vous servir de cette propriété afin de limiter les expositions aux attaques de type refus de service. L’adaptateur WCF-BasicHttp tire parti de la classe BasicHttpBinding en mode de transfert mis en mémoire tampon pour communiquer avec un point de terminaison. Pour le mode de transport mis en mémoire tampon, la propriété BasicHttpBinding.MaxBufferSize est toujours égale à la valeur de cette propriété. Valeur par défaut : 65536 |
| MessageEncoding | Énumération - Texte : utilisez un encodeur de message texte. - Mtom : utilisez un encodeur MTOM (Message Transmission Optimization Mechanism 1.0). |
Indiquer l’encodeur utilisé pour coder le message SOAP. Valeur par défaut : Texte |
| TextEncoding | Énumération - unicodeFFF : encodage Unicode BigEndian. - utf-16 : encodage 16 bits. - utf-8 - Encodage 8 bits |
Spécifiez l’encodage du jeu de caractères à utiliser pour émettre des messages sur la liaison lorsque la propriété MessageEncoding a la valeur Text. Valeur par défaut : utf-8 |
| MaxConcurrentCalls | Integer | Spécifier le nombre d'appels simultanés par instance de service unique. Les appels excédentaires sont mis en file d'attente. La plage de cette propriété est comprise entre 1 et Int32.MaxValue. Valeur par défaut : 200 |
| Securitymode | Énumération - Aucun - Message - Transport - TransportWithMessageCredential - TransportCredentialOnly Pour plus d’informations sur les noms des membres de la propriété SecurityMode , consultez la propriété Mode de sécurité dans la boîte de dialogue Propriétés de transport WCF-BasicHttp, Réception, onglet Sécurité dans les instructions de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs. |
Spécifier le type de sécurité utilisé. Valeur par défaut : None |
| TransportClientCredentialType | Pour plus d’informations sur les noms de membres de la propriété TransportClientCredentialType , consultez la propriété Type d’informations d’identification du client de transport dans WCF-BasicHttp Transport Properties Dialog Box, Receive, Security (Recevoir, 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. | Spécifier le type d’informations d’identification à utiliser lors de l’authentification du client. Valeur par défaut : None |
| MessageClientCredentialType | Énumération - Nom d'utilisateur - Certificat Pour plus d’informations sur les noms des membres de la propriété MessageClientCredentialType , consultez la propriété Type d’informations d’identification du client Message dans la boîte de dialogue Propriétés de transport WCF-BasicHttp, onglet Réception, Sécurité dans les conseils de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs. |
Spécifier le type d'informations d'identification à utiliser lors de l'authentification du client à l'aide de la sécurité basée sur le message. Valeur par défaut : UserName |
| AlgorithmSuite | Énumération Pour plus d’informations sur les noms des membres de la propriété AlgorithmSuite , consultez la propriété Suite d’algorithmes dans la boîte de dialogue Propriétés de transport WCF-BasicHttp, 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. |
Spécifier les algorithmes de chiffrement et Key Wrap du message. Ces algorithmes sont associés à ceux définis dans la spécification Security Policy Language (WS-SecurityPolicy). Valeur par défaut : Basic256 |
| ServiceCertificate | String | Spécifier l'empreinte du certificat X.509 pour cet emplacement de réception permettant au client d'authentifier le service. Le certificat à utiliser pour cette propriété doit être installé dans mon magasin à l’emplacement Utilisateur actuel . Note: Vous devez installer le certificat de service dans l’emplacement Utilisateur actuel du compte d’utilisateur pour le gestionnaire de réception hébergeant cet emplacement de réception. La valeur par défaut est une chaîne vide. |
| UseSSO | Boolean | Indiquez s'il faut utiliser l'authentification unique de l'entreprise pour extraire les informations d'identification du client afin d'émettre un ticket d'authentification unique. Pour plus d’informations sur les configurations de sécurité prenant en charge l’authentification unique, consultez la section « Enterprise Single Sign-On Supportability for the WCF-BasicHttp Receive Adapter » dans la boîte de dialogue Propriétés de transport WCF-BasicHttp, 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. Valeur par défaut : False |
| InboundBodyLocation | Énumération - UseBodyElement : utilisez le contenu de l’élément SOAP Body d’un message entrant pour créer la partie corps du message BizTalk. Si l’élément Body a plusieurs éléments enfants, seul le premier élément devient la partie corps du message BizTalk. - UseEnvelope : créez la partie corps du message BizTalk à partir de l’enveloppe SOAP entière d’un message entrant. - UseBodyPath : utilisez l’expression de chemin du corps dans la propriété InboundBodyPathExpression pour créer la partie corps du message BizTalk. L’expression de chemin du corps est évaluée par rapport à l’élément enfant immédiat de l’élément SOAP Body d’un message entrant. Cette propriété est valide uniquement pour des ports de sollicitation-réponse. Pour plus d’informations sur l’utilisation de la propriété InboundBodyLocation , consultez Spécification du corps du message pour les adaptateurs WCF. |
Spécifiez la sélection des données pour l’élément SOAP Body des messages WCF entrants. Valeur par défaut : UseBodyElement |
| InboundBodyPathExpression | String Pour plus d’informations sur l’utilisation de la propriété InboundBodyPathExpression , consultez Schéma et propriétés de la propriété adaptateurs WCF. |
Spécifiez l'expression de chemin de corps afin d'identifier une partie spécifique du message entrant utilisée pour créer le corps du message BizTalk. Cette expression de chemin de corps est évaluée par rapport à l’élément enfant immédiat du nœud SOAP Body d’un message entrant. Si cette expression de chemin de corps retourne plusieurs nœuds, seul le premier devient le corps du message BizTalk. Cette propriété est obligatoire si la propriété InboundBodyLocation a la valeur UseBodyPath. La valeur par défaut est une chaîne vide. |
| InboundNodeEncoding | Énumération - Encodage Base64 - Base64. - Hexadécimal - Encodage hexadécimal. - Chaîne - Encodage de texte - UTF-8 - XML : les adaptateurs WCF créent le corps du message BizTalk avec le XML externe du nœud sélectionné par l’expression de chemin du corps dans InboundBodyPathExpression. |
Spécifiez le type d’encodage que l’adaptateur de réception WCF-BasicHttp utilise pour décoder le nœud identifié par l’expression de chemin du corps spécifiée dans InboundBodyPathExpression. Cette propriété est obligatoire si la propriété InboundBodyLocation a la valeur UseBodyPath. Valeur par défaut : XML |
| OutboundBodyLocation | Énumération - UseBodyElement : utilisez la partie corps du message BizTalk pour créer le contenu de l’élément SOAP Body pour un message de réponse sortant. - UseTemplate : utilisez le modèle fourni dans la propriété OutboundXMLTemplate pour créer le contenu de l’élément SOAP Body pour un message de réponse sortant. Pour plus d’informations sur l’utilisation de la propriété OutboundBodyLocation , consultez Spécification du corps du message pour les adaptateurs WCF. |
Spécifiez la sélection des données pour l’élément SOAP Body des messages WCF sortants. Cette propriété est valide uniquement pour des emplacements de réception de type requête-réponse. Valeur par défaut : UseBodyElement |
| OutboundXMLTemplate | String Pour plus d’informations sur l’utilisation de la propriété OutboundXMLTemplate , consultez Spécification du corps du message pour les adaptateurs WCF. |
Spécifiez le modèle au format XML pour le contenu de l’élément SOAP Body d’un message de réponse sortant. Cette propriété est obligatoire si la propriété OutboundBodyLocation a la valeur UseTemplate. Cette propriété est valide uniquement pour des emplacements de réception de type requête-réponse. La valeur par défaut est une chaîne vide. |
| SuspendMessageOnFailure | Boolean | Spécifier s'il faut interrompre le message de requête dont le traitement entrant a échoué en raison d'une erreur de pipeline de réception ou d'un échec de routage. Valeur par défaut : False |
| IncludeExceptionDetailInFaults | Boolean | Spécifiez s'il faut inclure des informations sur l'exception gérée dans le détail des dysfonctionnements SOAP renvoyé au client à des fins de débogage. Valeur par défaut : False |
Configurer le port d’envoi par programmation
Le fragment de code suivant illustre la création d’un port d’envoi WCF-BasicHttp à l’aide du modèle objet Explorer BizTalk :
// Use BizTalk Explorer object model to create new WCF-BasicHttp 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-BasicHttp"];
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();
Vous pouvez utiliser le format suivant pour définir les propriétés dans <CustomProps>:
<CustomProps>
<ServiceCertificate vt="8" />
<InboundBodyLocation vt="8">UseBodyElement</InboundBodyLocation>
<UseSSO vt="11">0</UseSSO>
<MessageClientCredentialType vt="8">UserName</MessageClientCredentialType>
<InboundBodyPathExpression vt="8" />
<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">None</SecurityMode>
<TransportClientCredentialType vt="8">None</TransportClientCredentialType>
<ClientCertificate vt="8" />
<ProxyUserName vt="8" />
<MaxReceivedMessageSize vt="3">2097152</MaxReceivedMessageSize>
<TextEncoding vt="8">utf-8</TextEncoding>
<StaticAction vt="8">http://www.northwindtraders.com/Service/Operation</StaticAction>
<CloseTimeout vt="8">00:01:00</CloseTimeout>
<ProxyToUse vt="8">Default</ProxyToUse>
<InboundNodeEncoding vt="8">Xml</InboundNodeEncoding>
<PropagateFaultMessage vt="11">-1</PropagateFaultMessage>
<ProxyAddress vt="8" />
<MessageEncoding vt="8">Text</MessageEncoding>
<OutboundBodyLocation vt="8">UseBodyElement</OutboundBodyLocation>
</CustomProps>
Le tableau suivant répertorie les propriétés de configuration que vous pouvez définir pour le port d’envoi :
| Nom de la propriété | Type | Description |
|---|---|---|
| Securitymode | Énumération - Aucun - Message - Transport - TransportWithMessageCredential - TransportCredentialOnly Pour plus d’informations sur les noms des membres de la propriété SecurityMode , consultez la propriété Mode de sécurité dans la boîte de dialogue Propriétés de transport WCF-BasicHttp, Envoyer, onglet Sécurité dans les instructions de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs. |
Spécifier le type de sécurité utilisé. Valeur par défaut : None |
| MessageClientCredentialType | Énumération - Nom d'utilisateur - Certificat Pour plus d’informations sur les noms de membres de la propriété MessageClientCredentialType , consultez la propriété Type d’informations d’identification du client Message dans la boîte de dialogue Propriétés de transport WCF-BasicHttp, onglet Envoyer, Sécurité dans les instructions de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs. |
Spécifier le type d'informations d'identification à utiliser lors de l'authentification du client à l'aide de la sécurité basée sur le message. Valeur par défaut : UserName |
| TransportClientCredentialType | Énumération - Aucun - Base - Windows - Certificat - Digérer - Ntlm Pour plus d’informations sur les noms de membres de la propriété TransportClientCredentialType , consultez la propriété Type d’informations d’identification du client de transport dans WCF-BasicHttp Transport Properties Dialog Box, Onglet Envoyer, 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. |
Spécifier le type d'informations d'identification à utiliser lors de l'authentification du port d'envoi. Valeur par défaut : None |
| UserName | String | Spécifiez le nom d’utilisateur à utiliser pour l’authentification auprès du serveur de destination lorsque la propriété UseSSO a la valeur False. Il n'est pas nécessaire de se conformer au format domaine\utilisateur pour cette propriété. La valeur par défaut est une chaîne vide. |
| Mot de passe | String | Spécifiez le mot de passe à utiliser pour l’authentification auprès du serveur de destination lorsque la propriété UseSSO a la valeur False. La valeur par défaut est une chaîne vide. |
| AffiliateApplicationName | String | Spécifiez l'application associée à utiliser pour l'authentification unique (SSO) de l'entreprise. La valeur par défaut est une chaîne vide. |
| UseSSO | Boolean | Indiquez si l'authentification unique est utilisée pour l'extraction des informations d'identification d'un client en vue d'une authentification auprès du serveur de destination. Valeur par défaut : False |
| ClientCertificate | String | Spécifiez l'empreinte du certificat X.509 pour l'authentification de ce port d'envoi auprès des services. Cette propriété est requise si la propriété ClientCredentialsType a la valeur Certificate. Le certificat à utiliser pour cette propriété doit être installé dans mon magasin à l’emplacement Utilisateur actuel . La valeur par défaut est une chaîne vide. |
| ServiceCertificate | String | Spécifiez l'empreinte du certificat X.509 pour l'authentification du service auquel ce port d'envoi envoie des messages. Le certificat à utiliser pour cette propriété doit être installé dans le magasin Other Personnes à l’emplacement de l’ordinateur local. La valeur par défaut est une chaîne vide. |
| ProxyToUse | Énumération - Aucun : n’utilisez pas de serveur proxy pour ce port d’envoi. - Par défaut : utilisez les paramètres de proxy dans le gestionnaire d’envoi hébergeant ce port d’envoi. - UserSpecified : utilisez le serveur proxy spécifié dans la propriété ProxyAddress |
Spécifiez le serveur proxy à utiliser pour le trafic HTTP sortant. Valeur par défaut : None |
| ProxyAddress | String | Indiquez l’adresse du serveur proxy. Utilisez le schéma https ou http en fonction de la configuration de sécurité. Cette adresse peut être suivie d'un deux-points et du numéro de port. Par exemple : http://127.0.0.1:8080. La valeur par défaut est une chaîne vide. |
| ProxyUserName | String | Indiquez le nom d'utilisateur à utiliser pour le proxy. L’adaptateur WCF-BasicHttp tire parti de BasicHttpBinding en mode de transfert mis en mémoire tampon pour communiquer avec un point de terminaison. Les informations d’identification du proxy de BasicHttpBinding s’appliquent uniquement lorsque le mode de sécurité est Transport, None ou TransportCredentialOnly. Si vous définissez la propriété SecurityMode sur Message ou TransportWithMessageCredential, l’adaptateur WCF-BasicHttp n’utilise pas les informations d’identification spécifiées dans les propriétés ProxyUserName et ProxyPassword pour l’authentification auprès du proxy. Note: L’adaptateur d’envoi WCF-BasicHttp utilise l’authentification de base pour le proxy.. La valeur par défaut est une chaîne vide. |
| ProxyPassword | String | Indiquez le mot de passe à utiliser pour le proxy. La valeur par défaut est une chaîne vide. |
| InboundBodyLocation | Énumération - UseBodyElement : utilisez le contenu de l’élément SOAP Body d’un message entrant pour créer le composant corps du message BizTalk. Si l’élément Body a plusieurs éléments enfants, seul le premier élément devient le corps du message BizTalk. Cette propriété est valide uniquement pour des ports de sollicitation-réponse. - UseEnvelope : créez la partie corps du message BizTalk à partir de l’enveloppe SOAP entière d’un message entrant. - UseBodyPath : utilisez l’expression de chemin d’accès au corps dans la propriété InboundBodyPathExpression pour créer le composant corps du message BizTalk. L’expression de chemin de corps est évaluée par rapport à l’élément enfant immédiat de l’élément SOAP Body d’un message entrant. Cette propriété est valide uniquement pour des ports de sollicitation-réponse. Pour plus d’informations sur l’utilisation de la propriété InboundBodyLocation , consultez Spécification du corps du message pour les adaptateurs WCF. |
Spécifiez la sélection des données pour l’élément CORPS SOAP des messages WCF entrants. Valeur par défaut : UseBodyElement |
| OutboundBodyLocation | Énumération - UseBodyElement : utilisez la partie corps du message BizTalk pour créer le contenu de l’élément SOAP Body pour un message sortant. - UseTemplate : utilisez le modèle fourni dans la propriété OutboundXMLTemplate pour créer le contenu de l’élément SOAP Body pour un message sortant. Pour plus d’informations sur l’utilisation de la propriété OutboundBodyLocation , consultez Spécification du corps du message pour les adaptateurs WCF. |
Spécifiez la sélection des données pour l’élément CORPS SOAP des messages WCF sortants. Valeur par défaut : UseBodyElement |
| InboundBodyPathExpression | String Pour plus d’informations sur l’utilisation de la propriété InboundBodyPathExpression , consultez Schéma et propriétés de la propriété d’adaptateurs WCF. |
Spécifiez l'expression de chemin de corps afin d'identifier une partie spécifique du message entrant utilisée pour créer le corps du message BizTalk. Cette expression de chemin de corps est évaluée par rapport à l’élément enfant immédiat du nœud CORPS SOAP d’un message entrant. Si cette expression de chemin de corps retourne plusieurs nœuds, seul le premier devient le corps du message BizTalk. Cette propriété est obligatoire si la propriété InboundBodyLocation est définie sur UseBodyPath. Cette propriété est valide uniquement pour des ports de sollicitation-réponse. La valeur par défaut est une chaîne vide. |
| OutboundXMLTemplate | String Pour plus d’informations sur l’utilisation de la propriété OutboundXMLTemplate , consultez Spécification du corps du message pour les adaptateurs WCF. |
Spécifiez le modèle au format XML pour le contenu de l’élément SOAP Body d’un message sortant. Cette propriété est requise si la propriété OutboundBodyLocation est définie sur UseTemplate. La valeur par défaut est une chaîne vide. |
| InboundNodeEncoding | Énumération - Encodage Base64 - Base64. - Hexadécimal - Encodage hexadécimal. - Chaîne - Encodage de texte - UTF-8 - XML : les adaptateurs WCF créent le corps du message BizTalk avec le code XML externe du nœud sélectionné par l’expression de chemin d’accès au corps dans InboundBodyPathExpression. |
Spécifiez le type d’encodage utilisé par l’adaptateur d’envoi WCF-BasicHttp pour décoder le nœud identifié par l’expression de chemin d’accès du corps spécifiée dans InboundBodyPathExpression. Cette propriété est obligatoire si la propriété InboundBodyLocation est définie sur UseBodyPath. Cette propriété est valide uniquement pour des ports de sollicitation-réponse. Valeur par défaut : XML |
| StaticAction | String | Spécifiez le champ d’en-tête HTTP SOAPAction pour les messages sortants. Cette propriété peut également être définie via la propriété de contexte de message WCF. Action dans un pipeline ou une orchestration. Vous pouvez spécifier cette valeur de deux manières différentes : le format d’action unique et le format de mappage d’actions. Si vous définissez cette propriété au format d’action unique, par exemple , http://contoso.com/Svc/Op1l’en-tête SOAPAction des messages sortants est toujours défini sur la valeur spécifiée dans cette propriété.Si vous définissez cette propriété au format de mappage d’actions, l’en-tête SOAPAction sortant est déterminé par le BTS. Propriété de contexte d’opération . Par exemple, si cette propriété est définie sur le format XML suivant et le BTS. La propriété Operation a la valeur Op1, l’adaptateur d’envoi WCF utilise http://contoso.com/Svc/Op1 pour l’en-tête SOAPAction sortant.<BtsActionMapping> <Operation Name="Op1 » Action= »http://contoso.com/Svc/Op1" /> <Operation Name="Op2 » Action= »http://contoso.com/Svc/Op2" /> </BtsActionMapping> Si les messages sortants proviennent d’un port d’orchestration, les instances d’orchestration définissent dynamiquement le BTS. Propriété Operation avec le nom de l’opération du port. Si les messages sortants sont routés avec un routage basé sur le contenu, vous pouvez définir le BTS. Propriété d’opération dans les composants de pipeline. La valeur par défaut est une chaîne vide. |
| MaxReceivedMessageSize | Integer | Spécifiez la taille maximale en octets d'un message (en-têtes inclus) et pouvant être reçu sur le câble. La taille des messages est limitée par la quantité de mémoire allouée pour chacun d'eux. Vous pouvez vous servir de cette propriété afin de limiter les expositions aux attaques de type refus de service. L’adaptateur WCF-BasicHttp tire parti de la classe BasicHttpBinding en mode de transfert mis en mémoire tampon pour communiquer avec un point de terminaison. Pour le mode de transport mis en mémoire tampon, la propriété BasicHttpBinding.MaxBufferSize est toujours égale à la valeur de cette propriété. Valeur par défaut : 65 536 |
| MessageEncoding | Énumération - Texte : utilisez un encodeur de message texte. - Mtom : utilisez un encodeur MTOM (Message Transmission Organization Mechanism 1.0). |
Indiquer l’encodeur utilisé pour coder le message SOAP. Valeur par défaut : Texte |
| TextEncoding | Énumération - unicodeFFF - Encodage Unicode BigEndian. - utf-16 - encodage 16 bits. - utf-8 - encodage 8 bits |
Spécifiez l’encodage du jeu de caractères à utiliser pour émettre des messages sur la liaison lorsque la propriété MessageEncoding a la valeur Text. Valeur par défaut : utf-8 |
| SendTimeout | System.TimeSpan | Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération d'envoi soit réalisée. En cas d’utilisation d’un port d’envoi sollicitation-réponse, cette valeur indique une période pour la réalisation de l’intégralité de l’interaction, même si le service renvoie un message volumineux. Valeur par défaut : 00:01:00 |
| OpenTimeout | System.TimeSpan | Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération d'ouverture de canal soit réalisée. Valeur par défaut : 00:01:00 |
| CloseTimeout | System.TimeSpan | Spécifier une valeur de période qui indique l'intervalle de temps donné pour qu'une opération de fermeture de canal soit réalisée. Valeur par défaut : 00:01:00 |
| AlgorithmSuite | Énumération Pour plus d’informations sur les noms de membres de la propriété AlgorithmSuite , consultez la propriété Suite d’algorithmes dans wcf-BasicHttp Transport Properties Dialog Box, Send, Security onglet dans l’aide de l’interface utilisateur et informations de référence sur l’espace de noms d’API des développeurs. |
Spécifier les algorithmes de chiffrement et Key Wrap du message. Ces algorithmes sont associés à ceux définis dans la spécification Security Policy Language (WS-SecurityPolicy). Valeur par défaut : Basic256 |
| Identité | Blob XML Exemple : <identity> <userPrincipalName value="username@contoso.com » /> </Identité> |
Spécifiez l'identité du service attendu par ce port d'envoi. Ces paramètres permettent au port d'envoi d'authentifier le service. Lors du processus d'établissement de liaison entre le client et le service, l'infrastructure WCF (Windows Communication Foundation) garantit que l'identité du service attendu correspond aux valeurs de cet élément. La valeur par défaut est une chaîne vide. |
| PropagateFaultMessage | Boolean - True : routez le message qui échoue le traitement sortant vers une application d’abonnement (par exemple, un autre port de réception ou une planification d’orchestration). - False : suspendez les messages ayant échoué et générez un accusé de réception négatif (NACK). |
Spécifiez si le routage ou la suspension des messages a échoué dans le traitement sortant. Cette propriété est valide uniquement pour des ports de sollicitation-réponse. Valeur par défaut : True |
Voir aussi
Qu’est-ce que les adaptateurs WCF ?Publication de services WCF avec les adaptateurs de réception WCF isolésConfiguration d’IIS pour les adaptateurs de réception WCF isolésGestion des hôtes BizTalk et des instances hôtesComment modifier les comptes de service et les mots de passeInstallation de certificats pour les adaptateurs WCFSpécification du corps du message pour leschéma de la propriété Adaptateurs WCF adaptateurs WCF et propriétésConfiguration des ports d’envoi dynamiques à l’aide des propriétés de contexte des adaptateurs WCF
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour