Propriétés et schéma de propriété des adaptateurs WCF

Découvrez les propriétés promues dans le schéma de propriété de l’adaptateur WCF. Les adaptateurs WCF attribuent des valeurs aux propriétés que vous pouvez utiliser dans votre application. L'adaptateur WCF offre également un mécanisme permettant d'écrire (mais non de promouvoir) les propriétés personnalisées dans le contexte de message BizTalk et un mécanisme permettant de promouvoir les propriétés personnalisées dans le contexte de message BizTalk. Pour plus d’informations, consultez En-têtes SOAP avec les services WCF publiés.

Propriétés promues

Espace de noms :http://schemas.microsoft.com/BizTalk/2006/01/Adapters/WCF-properties

Action

Spécifiez le champ d’en-tête SOAPAction pour les messages sortants. 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/Op1 ), l’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. Cette propriété est automatiquement promue à partir de messages entrants, avec le format d'action unique.

Type : Chaîne Valeur par défaut : Une chaîne vide S’applique à : Tous les adaptateurs d’envoi WCF

AffiliateApplicationName

Spécifiez l'application associée à utiliser pour l'authentification unique (SSO) de l'entreprise. Cette propriété est requise si la propriété UseSSO a la valeur True.

Type : Chaîne Valeur par défaut : une chaîne vide S’applique à : Toutes les cartes d’envoi WCF à l’exception de l’adaptateur WCF-NetNamedPipe

AlgorithmSuite

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

Pour plus d’informations sur les valeurs applicables à la propriété AlgorithmSuite , consultez la propriété Suite d’algorithmes dans la boîte de dialogue Propriétés de transport WCF-NetTcp, 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.

Type : Chaîne Valeur par défaut : Basic256 S’applique à :

• Adaptateur WCF-BasicHttp
• adaptateur WCF-NetMsmq
• Adaptateur WCF-NetTcp
• Adaptateur WCF-WSHttp

BindingConfiguration

Spécifiez une chaîne XML avec l’élément <de liaison> pour configurer différents types de liaisons prédéfinies fournies par Windows Communication Foundation (WCF). Pour plus d'informations sur la liaison fournie par le système et la liaison personnalisée, consultez les rubriques correspondantes de la section Voir aussi.

Exemple :

<binding name="wsHttpBinding" transactionFlow="true">
<security><message clientCredentialType="UserName"></security>
</binding>

Type : Chaîne Valeur par défaut : chaîne vide S’applique à : adaptateur WCF-Custom, adaptateur WCF-CustomIsolated

BindingType

Spécifiez le type de liaison à utiliser pour le point de terminaison. Pour plus d’informations sur les valeurs applicables à la propriété BindingType , consultez la propriété Type de liaison dans la boîte de dialogue Propriétés de transport personnalisées WCF, 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.

Type : Chaîne Valeur par défaut : chaîne vide S’applique à : adaptateur WCF-Custom, adaptateur WCF-CustomIsolated

ClientCertificate

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 .

Type : Chaîne Valeur par défaut : une chaîne vide S’applique à :

• Adaptateur d'envoi WCF-BasicHttp
• Adaptateur d'envoi WCF-WSHttp
• adaptateur d’envoi WCF-NetTcp
• adaptateur d’envoi WCF-NetMsmq

CloseTimeout

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.

Type : Chaîne Valeur par défaut : 00 :01 :00 S’applique à : toutes les cartes WCF à l’exception des WCF-Custom et des WCF-CustomIsolated

CustomDeadLetterQueue

Spécifiez l’URI complet avec le schéma net.msmq pour l’emplacement de la file d’attente de lettres mortes par application, où sont placés les messages ayant expiré ou ayant échoué le transfert ou la remise. Par exemple, net.msmq://localhost/deadLetterQueueName. La file d'attente de lettres mortes par application est une file d'attente sur le gestionnaire de files d'attente de l'application émettrice pour les messages ayant expiré dont la remise a échoué. Cette propriété est requise si la propriété DeadLetterQueue a la valeur Custom.

Type : Chaîne Valeur par défaut : chaîne vide S’applique à : WCF-NetMsmq adaptateur d’envoi

DeadLetterQueue

Spécifiez la file d'attente des messages non distribués vers laquelle seront transférés les messages qui n'ont pas pu être remis à l'application. Pour plus d’informations sur les messages remis à la file d’attente de lettres mortes, consultez la boîte de dialogue Propriétés de transport WCF-NetMsmq, Onglet Envoi, Liaison dans les instructions de l’interface utilisateur et les informations de référence sur l’espace de noms d’API des développeurs.

Type : Chaîne Valeur par défaut : Système s’applique à : WCF-NetMsmq adaptateur d’envoi

DisableLocationOnFailure

Spécifiez s'il faut désactiver l'emplacement de réception pour lequel le traitement entrant a échoué en raison d'une erreur de pipeline de réception ou d'un échec de routage. Vous pouvez définir cette propriété sur True lorsque les emplacements de réception peuvent être désactivés et que le déni de service (DoS) n’est pas un problème.

Par exemple :

• adaptateur WCF-Custom : lorsque la propriété BindingType est définie sur netMsmqBinding.
• WCF-Custom adaptateur : lorsque la propriété BindingType est définie sur customBinding et que la propriété BindingConfiguration est configurée pour utiliser des canaux personnalisés qui s’appuient sur des transports en file d’attente tels que MSMQ.
• adaptateur WCF-CustomIsolated : lorsque la propriété BindingType est définie sur customBinding et que la propriété BindingConfiguration est configurée pour utiliser des canaux personnalisés qui reposent sur des transports mis en file d’attente tels que MSMQ
• adaptateur WCF-NetMsmq

Type : Valeur booléenne par défaut : False S’applique à :

• adaptateur de réception WCF-NetMsmq
• adaptateur de réception WCF-Custom
• Adaptateur de réception WCF-CustomIsolated

EnableTransaction

L'effet de cette propriété varie selon l'adaptateur WCF. Pour plus d’informations sur cette propriété, consultez les rubriques de procédure pour chaque adaptateur WCF dans adaptateurs WCF.

Type : Boolean S’applique à :

• Adaptateur WCF-WSHttp
• Adaptateur WCF-NetTcp
• adaptateur WCF-NetNamedPipe
• adaptateur WCF-NetMsmq

EndpointBehaviorConfiguration

Spécifiez une chaîne XML avec l’élément <behavior> de l’élément <endpointBehaviors> pour configurer les paramètres de comportement d’un point de terminaison WCF. Pour plus d’informations sur l’élément <endpointBehaviors> , consultez la rubrique appropriée dans Voir aussi.

Exemple :

<behavior name="sampleBehavior"><callbackTimeouts/></behavior>

Type : Chaîne Valeur par défaut : chaîne vide S’applique à : WCF-Custom adaptateur d’envoi

EstablishSecurityContext

Spécifiez si le canal de sécurité établit une session sécurisée. Une session sécurisée établit un jeton de contexte de sécurité (SCT) avant d'échanger les messages d'application.

Type : Valeur booléenne Valeur par défaut : True Appliqué à : adaptateur WCF-WSHttp

FromAddress

Indiquez l'adresse du point de terminaison source par le biais duquel les messages WCF entrants sont envoyés. La propriété est automatiquement promue à partir de messages entrants.

Type : String S’applique à : toutes les cartes WCF à l’exception de l’adaptateur d’envoi WCF-NetMsmq

En-têtes

Spécifiez les références de point de terminaison utilisées pour fournir des informations d'adressage supplémentaires au-delà de l'URI. Lorsque cette propriété est utilisée, cette propriété doit avoir l’élément <headers> comme élément racine. Tous les en-têtes d’adresse doivent être placés à l’intérieur de l’élément <headers> . Cette propriété est automatiquement promue pour les messages entrants.

Exemple :

<headers>
<Region xmlns="Uri">"String"</Region>
<Member xmlns="Uri">"String"</Member>
</headers>

Type : String S’applique à : Tous les adaptateurs WCF

Identité

Spécifiez l'identité du service fourni par un emplacement de réception ou attendu par un port d'envoi. Les valeurs qui peuvent être spécifiées pour la propriété Identity diffèrent en fonction de la configuration de sécurité. Ces paramètres permettent aux clients d'authentifier les services. Lors du processus d'établissement de liaison entre les clients et les services, l'infrastructure WCF (Windows Communication Foundation) garantit que l'identité des services correspond aux valeurs des clients.

Exemple :

<identity>
<userPrincipalName value="username@contoso.com"/>
</identity>

Type : Chaîne Valeur par défaut : Une chaîne vide S’applique à : Tous les adaptateurs WCF

InboundBodyLocation

Spécifiez la sélection des données pour l’élément CORPS SOAP des messages WCF entrants. Pour plus d’informations sur l’utilisation de la propriété InboundBodyLocation , consultez Spécification du corps du message pour les adaptateurs WCF.

Type : Valeur par défaut de la chaîne : UseBodyElement

Les valeurs applicables sont les suivantes :

• UseBodyElement : utilisez le contenu de l’élément CORPS SOAP d’un message entrant pour créer le 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.
• 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.

S’applique à : toutes les cartes WCF à l’exception WCF-NetMsmq envoyer

InboundBodyPathExpression

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

Type : Chaîne Valeur par défaut : une chaîne vide S’applique à : toutes les cartes WCF à l’exception de l’adaptateur d’envoi WCF-NetMsmq

InboundHeaders

Utilisez la propriété InboundHeaders pour accéder aux en-têtes SOAP des messages WCF entrants. Les adaptateurs WCF copient toutes les valeurs d'en-tête SOAP des messages entrants dans cette propriété, ce qui inclut les en-têtes SOAP personnalisés et les en-têtes SOAP standard utilisés par l'infrastructure WCF, par exemple, pour WS-Addressing, WS-Security et WS-AtomicTransaction. La valeur contenue dans la propriété de contexte est une chaîne contenant des données XML avec l’élément < racine des en-têtes>, et les en-têtes SOAP entrants sont copiés en tant qu’éléments enfants de l’élément <headers>. Pour plus d’informations sur l’accès aux en-têtes SOAP avec les adaptateurs WCF, consultez l’exemple sdk, Utilisation d’en-têtes SOAP personnalisés avec les adaptateurs WCF, à partir de https://go.microsoft.com/fwlink/?LinkId=79960.

Type : String S’applique à : toutes les cartes WCF à l’exception de l’adaptateur d’envoi WCF-NetMsmq

InboundNodeEncoding

Spécifiez le type d’encodage utilisé par l’adaptateur de réception WCF 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.

Type : Chaîne Valeur par défaut : XML

Les valeurs applicables sont les suivantes :

• Base64 : encodage Base64
• Hexadécimal : encodage hexadécimal
• String: codage 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 d’accès au corps dans InboundBodyPathExpression.

S’applique à : toutes les cartes WCF à l’exception de l’adaptateur d’envoi WCF-NetMsmq

IsFault

Indiquez si les messages d'erreur SOAP sont reçus. La propriété est automatiquement promue à partir de messages entrants.

Type : Boolean S’applique à : toutes les cartes WCF à l’exception de l’adaptateur d’envoi WCF-NetMsmq

LeaseTimeout

Spécifiez la durée de vie maximale d'une connexion active placée dans le pool. Une fois le temps spécifié écoulé, la connexion est fermée une fois la demande en cours traitée.

L’adaptateur WCF-NetTcp tire parti de la classe NetTcpBinding pour communiquer avec un point de terminaison. Lorsque vous utilisez NetTcpBinding dans des scénarios à charge équilibrée, envisagez de réduire le délai d’expiration du bail par défaut. Pour plus d’informations sur l’équilibrage de charge lors de l’utilisation de NetTcpBinding, consultez la rubrique appropriée dans Voir aussi.

Type : Chaîne Valeur par défaut : 00 :05 :00 S’applique à : WCF-NetTcp adaptateur de réception

MaxConcurrentCalls

Spécifier le nombre d'appels simultanés par instance de service unique. Les appels excédentaires sont mis en file d'attente. Définir cette valeur sur 0 équivaut à la définir sur Int32.MaxValue.

Type : Entier Valeur par défaut : 200 S’applique à : toutes les cartes de réception WCF à l’exception des cartes WCF-Custom et WCF-CustomIsolated

MaxConnections

Spécifier un nombre maximal de connexions que l’écouteur peut mettre en attente d’acceptation par l’application. Lorsque cette valeur de quota est dépassée, les nouvelles connexions entrantes sont supprimées plutôt que mises en attente d'acceptation.

Type : Entier Valeur par défaut : 10 S’applique à : adaptateur WCF-NetNamedPipe, adaptateur WCF-NetTcp

MaxReceivedMessageSize

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.

Type : Entier Valeur par défaut : 65536 S’applique à :

• Adaptateur WCF-BasicHttp
• Adaptateur WCF-WSHttp
• Adaptateur WCF-NetTcp
• adaptateur WCF-NetNamedPipe
• adaptateur de réception WCF-NetMsmq

MessageClientCredentialType

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.

Les valeurs applicables diffèrent pour chaque adaptateur WCF. Pour plus d’informations sur la propriété MessageClientCredentialType , consultez les rubriques de procédure pour chaque adaptateur WCF dans adaptateurs WCF.

Type : Chaîne S’applique à :

• Adaptateur WCF-BasicHttp
• Adaptateur WCF-WSHttp
• Adaptateur WCF-NetTcp
• adaptateur WCF-NetNamedPipe

MessageEncoding

Indiquer l’encodeur utilisé pour coder le message SOAP.

Type : Chaîne Valeur par défaut : Texte

Valeurs applicables :

• Texte : utiliser un encodeur de message texte
• Mtom : utiliser un encodeur MTOM (Message Transmission Organization Mechanism 1.0)

S’applique à : adaptateur WCF-BasicHttp, adaptateur WCF-WSHttp

MsmqAuthenticationMode

Spécifiez le mode d'authentification du message par le transport MSMQ.

Type : Valeur par défaut de la chaîne : WindowsDomain Pour plus d’informations sur les valeurs applicables à la propriété MsmqAuthenticationMode , consultez la propriété du mode d’authentification MSMQ dans la boîte de dialogue Propriétés du transport WCF-NetMsmq, 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. S’applique à : adaptateur WCF-NetMsmq

MsmqEncryptionAlgorithm

Spécifiez l'algorithme à utiliser pour le chiffrement des messages lors de leur transfert entre les gestionnaires de files d'attente. Cette propriété est disponible uniquement si la propriété MsmqProtectionLevel a la valeur EncryptAndSign.

Type : Chaîne Valeur par défaut : RC4Stream

Les valeurs applicables sont : RC4Stream, AES

S’applique à : adaptateur WCF-NetMsmq

MsmqProtectionLevel

Spécifier le mode de sécurisation des messages au niveau du transport MSMQ.

Type : Chaîne Valeur par défaut : Signe

Les valeurs applicables sont les suivantes :

• Aucun : aucune protection
• Signe : les messages sont signés
• EncryptAndSign : les messages sont chiffrés et signés. Pour utiliser ce niveau de protection, vous devez activer l’intégration Active Directory pour MSMQ

S’applique à : adaptateur WCF-NetMsmq

MsmqSecureHashAlgorithm

Spécifiez l'algorithme de hachage à utiliser pour traiter la synthèse du message. Cette propriété n’est pas disponible si la propriété MsmqProtectionLevel a la valeur None.

Type : Chaîne Valeur par défaut : SHA1

Les valeurs applicables sont : MD5, SHA1, SHA25, SHA512

S’applique à : adaptateur WCF-NetMsmq

NegotiateServiceCredential

Spécifiez si les informations d'identification du service sont générées au niveau du client hors bande ou sont obtenues à partir du service sur ce client via un processus de négociation. Ce type de négociation précède l'échange habituel de messages.

Si la propriété MessageClientCredentialType est égale à None, Username ou Certificate, la définition de cette propriété sur False signifie que le certificat de service est disponible sur le client hors bande et que le client doit spécifier le certificat de service. Ce mode est interopérable avec les piles SOAP qui implémentent WS-Trust et WS-SecureConversation.

Si la propriété MessageClientCredentialType est définie sur Windows, la définition de cette propriété sur False spécifie l’authentification Kerberos. Cela signifie que le client et le service doivent faire partie du même domaine Kerberos. Ce mode est interopérable avec les piles SOAP qui implémentent le profil de jeton Kerberos (comme défini dans OASIS WSS TC) ainsi que WS-Trust et WS-SecureConversation.

Lorsque cette propriété a la valeur True, elle provoque une négociation SOAP .NET qui tunnelle l’échange SPNego sur les messages SOAP.

Type : Valeur booléenne par défaut : True S’applique à : adaptateur WCF-WSHttp

OpenTimeout

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.

Type : Chaîne Valeur par défaut : 00 :01 :00 S’applique à : tous les adaptateurs WCF à l’exception des adaptateurs WCF-Custom et WCF-CustomIsolated

OrderedProcessing

Spécifier si vous voulez traiter les messages par séries. Lorsque cette propriété est sélectionnée, cet emplacement de réception prend en charge la remise des messages ordonnés lorsqu’il est utilisé conjointement avec une messagerie BizTalk ou un port d’envoi d’orchestration pour lequel l’option Remise ordonnée est définie sur True. Pour plus d’informations sur l’option Livraison ordonnée , consultez les rubriques appropriées dans Voir aussi.

Cette propriété est applicable dans les cas suivants :

• adaptateur WCF-Custom : lorsque la propriété BindingType est définie sur netMsmqBinding
• adaptateur WCF-Custom : lorsque la propriété BindingType est définie sur customBinding et que la propriété BindingConfiguration est configurée pour utiliser des canaux personnalisés qui s’appuient sur des transports prenant en charge la remise ordonnée, comme MSMQ.
• adaptateur WCF-CustomIsolated : lorsque la propriété BindingType est définie sur customBinding et que la propriété BindingConfiguration est configurée pour utiliser des canaux personnalisés qui s’appuient sur des transports prenant en charge la remise ordonnée.
• adaptateur WCF-NetMsmq

Type : Chaîne Valeur par défaut : False S’applique à :

• adaptateur de réception WCF-NetMsmq
• adaptateur de réception WCF-Custom
• Adaptateur de réception WCF-CustomIsolated

OutboundBodyLocation

Spécifiez la sélection des données pour l’élément SOAP Body des messages WCF sortants. Pour plus d’informations sur l’utilisation de la propriété OutboundBodyLocation , consultez Spécification du corps du message pour les adaptateurs WCF.

Type : Valeur par défaut de chaîne : UseBodyElement

Les valeurs applicables sont les suivantes :

• UseBodyElement : utiliser la partie corps du message BizTalk pour créer le contenu de l’élément SOAP Body pour un message sortant
• UseTem****plate : 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

S’applique à : tous les adaptateurs WCF à l’exception de l’adaptateur de réception WCF-NetMsmq

OutboundCustomHeaders

Spécifiez les en-têtes SOAP personnalisés pour les messages sortants. Lorsque cette propriété est utilisée, la propriété doit avoir l’élément <headers> comme élément racine. Tous les en-têtes SOAP personnalisés doivent être placés à l’intérieur de l’élément <headers> . Si la valeur d’en-tête SOAP personnalisée est une chaîne vide, vous devez affecter <des en-têtes></en-têtes> ou <des en-têtes> à cette propriété. Pour plus d’informations sur l’utilisation des en-têtes SOAP avec les adaptateurs WCF, consultez l’exemple sdk, Utilisation d’en-têtes SOAP personnalisés avec les adaptateurs WCF, à partir de https://go.microsoft.com/fwlink/?LinkId=79960.

Type : Chaîne S’applique à : tous les adaptateurs WCF à l’exception de l’adaptateur de réception WCF-NetMsmq

OutboundXmlTemplate

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 obligatoire si la propriété OutboundBodyLocation a la valeur UseTemplate. Pour plus d’informations sur l’utilisation de la propriété OutboundXMLTemplate , consultez Spécification du corps du message pour les adaptateurs WCF.

Type : Chaîne Valeur par défaut : une chaîne vide S’applique à : tous les adaptateurs WCF à l’exception de l’adaptateur de réception WCF-NetMsmq

Mot de passe

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.

Type : Chaîne Valeur par défaut : une chaîne vide S’applique à : Tous les adaptateurs d’envoi WCF à l’exception de l’adaptateur WCF-NetNamedPipe

PropagateFaultMessage

Spécifiez si les messages dont le traitement sortant a échoué sont acheminés ou interrompus. Cette propriété est valide uniquement pour des ports de sollicitation-réponse.

Type : Valeur par défaut booléenne : True

Les valeurs applicables sont les suivantes :

• 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 : Suspendre les messages ayant échoué et générer un accusé de réception négatif (NACK)

S’applique à : tous les adaptateurs d’envoi WCF à l’exception de l’adaptateur WCF-NetMsmq

ProxyAddress

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. La propriété est obligatoire si la propriété ProxyToUse est définie sur UserSpecified (par exemple, http://127.0.0.1:8080)

Type : Chaîne Valeur par défaut : une chaîne vide S’applique à : WCF-BasicHttp adaptateur d’envoi, WCF-WSHttp adaptateur d’envoi

ProxyPassword

Spécifiez le mot de passe à utiliser pour le serveur proxy spécifié dans la propriété ProxyAddress .

Type : Chaîne Valeur par défaut : une chaîne vide S’applique à : WCF-BasicHttp adaptateur d’envoi, WCF-WSHttp adaptateur d’envoi

ProxyToUse

Spécifiez le serveur proxy à utiliser pour le trafic HTTP sortant.

Type : Chaîne Valeur par défaut : Aucun

Les valeurs applicables sont les suivantes :

• 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 qui héberge ce port d’envoi
• UserSpecified : utiliser le serveur proxy spécifié dans la propriété ProxyAddress

S’applique à : adaptateur d’envoi WCF-BasicHttp, adaptateur d’envoi WCF-WSHttp adaptateur d’envoi

ProxyUserName

Spécifiez le nom d’utilisateur à utiliser pour le serveur proxy spécifié dans la propriété ProxyAddress . La propriété est requise si la propriété ProxyToUse a la valeur UserSpecified.

Pour plus d’informations sur cette propriété, consultez Guide pratique pour configurer un port d’envoi WCF-WSHttp et Configurer un port d’envoi WCF-BasicHttp.

Type : Chaîne S’applique à : adaptateur d’envoi WCF-BasicHttp, WCF-WSHttp adaptateur d’envoi

ReplyToAddress

Indiquez l'adresse du point de terminaison de réponse pour les messages WCF sortants qui correspondent aux messages entrants reçus par les emplacements de réception de requête-réponse. La propriété est automatiquement promue à partir de messages entrants.

Type : Valeur par défaut de la chaîne : une chaîne vide S’applique à : tous les adaptateurs WCF à l’exception de l’adaptateur WCF-NetMsmq

SecurityMode

Spécifier le type de sécurité utilisé. Les valeurs applicables diffèrent pour chaque adaptateur WCF. Pour plus d’informations sur la propriété SecurityMode , consultez les rubriques de procédures pour chaque adaptateur WCF dans adaptateurs WCF.

Type : Chaîne S’applique à : tous les adaptateurs WCF à l’exception des adaptateurs WCF-Custom et WCF-CustomIsolated

SendTimeout

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. Cette valeur spécifie une période pour l'exécution de toute l'interaction, même si le correspondant envoie un message volumineux.

Type : Chaîne Valeur par défaut : 00 :01 :00 S’applique à : tous les adaptateurs WCF à l’exception des adaptateurs WCF-Custom et WCF-CustomIsolated

ServiceBehaviorConfiguration

Spécifiez une chaîne XML avec l’élément <behavior> de l’élément <serviceBehaviors> pour configurer les paramètres de comportement d’un service WCF. Pour plus d’informations sur l’élément <serviceBehaviors> , consultez la rubrique appropriée dans Voir aussi.

Exemple :

<behavior name="SampleServiceBehavior">
<serviceAuthorization principalPermissionMode="UseAspNetRoles"/>
<serviceCredentials>
<serviceCertificate findValue="539d9ab3089bb6dc187fa7dbb382cf01f8d78f5f" storeLocation="CurrentUser" x509FindType="FindByThumbprint"/>
</serviceCredentials>
<serviceMetadata httpGetEnabled="true"/>
</behavior>

Type : Valeur par défaut de la chaîne : une chaîne vide S’applique à : WCF-Custom adaptateur de réception, adaptateur WCF-CustomIsolated

ServiceCertificate

Si cette propriété est utilisée pour les emplacements de réception, spécifiez l'empreinte du certificat X.509 pour les emplacements de réception que les clients utilisent pour authentifier le service. Le certificat à utiliser pour cette propriété doit être installé dans mon magasin à l’emplacement Utilisateur actuel .

Si cette propriété est utilisée pour les ports d'envoi, 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 Autres Personnes à l’emplacement Ordinateur local.

Type : Chaîne Valeur par défaut : une chaîne vide S’applique à :

• Adaptateur WCF-BasicHttp
• adaptateur WCF-NetMsmq
• Adaptateur WCF-WSHttp
• Adaptateur de réception WCF-NetTcp

SuspendMessageOnFailure

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.

Type : Valeur booléenne par défaut : True S’applique à : Tous les adaptateurs de réception WCF

TextEncoding

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.

Type : Chaîne Valeur par défaut : utf-8

Les valeurs applicables sont les suivantes :

• unicodeFFF : encodage Unicode BigEndian
• utf-16 : encodage 16 bits
• utf-8 : encodage 8 bits

S’applique à : adaptateur WCF-BasicHttp, adaptateur WCF-WSHttp

timeToLive

Spécifiez une durée de validité des messages avant qu'ils ne soient considérés comme expirés et placés dans la file d'attente des messages non distribués. Cette propriété permet de s'assurer que les messages, pour lesquels le temps est un paramètre crucial, ne deviennent pas obsolètes avant leur traitement par un port d'envoi. Tout message d'une file d'attente qui n'aurait pas été utilisé par ce port d'envoi dans le délai spécifié est déclaré comme ayant expiré. Ces messages expirés sont envoyés vers une file d'attente spéciale, appelée file d'attente des messages non distribués. L’emplacement de la file d’attente de lettres mortes est défini avec la propriété DeadLetterQueue .

Type : Chaîne Valeur par défaut : 1.00 :00 :00 S’applique à : WCF-NetMsmq adaptateur d’envoi

À

Spécifiez l'adresse du point de terminaison de destination pour les messages WCF sortants qu'envoient les ports d'envoi WCF.

Type : Chaîne Valeur par défaut : Une chaîne vide S’applique à : Tous les adaptateurs d’envoi WCF

TransactionProtocol

Spécifiez le protocole de transaction à utiliser avec cette liaison. Cette propriété est requise si la propriété EnableTransaction a la valeur True.

Type : Chaîne Valeur par défaut : OleTransaction

Les valeurs applicables sont : OleTransaction, WS-AtomicTransaction

S’applique à : adaptateur WCF-NetNamedPipe, adaptateur WCF-NetTcp

TransportClientCredentialType

Spécifier le type d'informations d'identification à utiliser lors de l'authentification du port d'envoi. Les valeurs applicables diffèrent pour chaque adaptateur WCF. Pour plus d’informations sur la propriété TransportClientCredentialType , consultez les rubriques de procédures pour chaque adaptateur WCF dans adaptateurs WCF.

Type : Chaîne S’applique à : adaptateur WCF-Basic, adaptateur WCF-NetTcp, adaptateur WCF-WSHttp

TransportProtectionLevel

Définissez la sécurité au niveau du transport TCP. La signature des messages limite le risque qu'un tiers puisse falsifier le message pendant son transfert. Le chiffrement garantit la confidentialité des données pendant le transport.

Type : Valeur par défaut de la chaîne : EncryptAndSign

Les valeurs applicables sont les suivantes :

• Aucun : aucune protection
• Signe : les messages sont signés
• EncryptAndSign : les messages sont chiffrés et signés

S’applique à : adaptateur WCF-NetTcp, adaptateur WCF-NetNamedPipe

UserName

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

Type : Chaîne Valeur par défaut : une chaîne vide S’applique à : Tous les adaptateurs d’envoi WCF à l’exception de l’adaptateur WCF-NetNamedPipe

UseSourceJournal

Spécifiez si les copies des messages traités par ce port d'envoi doivent être stockées dans la file d'attente des journaux sources.

Type : Valeur par défaut booléenne : False S’applique à : WCF-NetMsmq adaptateur d’envoi

UseSSO

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.

Note Cette propriété ne peut pas être suivie dans la base de données d’importation principale BAM avec des profils de suivi.

Type : Valeur booléenne Par défaut : False S’applique à : tous les adaptateurs d’envoi WCF à l’exception de l’adaptateur WCF-NetNamedPipe

ReferencedBindings

Spécifiez les configurations de liaison référencées par l’attribut bindingConfiguration de l’élément <émetteur> pour wsFederationHttpBinding et customBinding, qui indique le service STS (Security Token Service) qui émet des jetons de sécurité. Pour plus d’informations sur l’élément <issuer> , consultez la rubrique «< émetteur> » à l’adresse https://go.microsoft.com/fwlink/?LinkId=83476.

Les informations de liaison, y compris l’élément <émetteur> pour wsFederationHttpBinding et customBinding , peuvent être configurées via la propriété BindingConfiguration des adaptateurs WCF-Custom et WCF-CustomIsolated. Toutes les configurations de liaison référencées pour cette propriété doivent être placées sous la forme de l’élément <bindings> .

Exemple :

WCF.BindingConfiguration = @"<wsFederationHttpBinding>
<binding name=""sampleBinding"">
<security mode=""Message"">
<message issuedKeyType=""AsymmetricKey"">
<issuer address=""http://www.contoso.com/samplests"" binding=""wsFederationHttpBinding"" bindingConfiguration=""**contosoSTSBinding**""/>
</message>
</security>
</binding>
</wsFederationHttpBinding>";
WCF.ReferencedBinding =@"<bindings>
<wsFederationHttpBinding>
<binding name=""**contosoSTSBinding**"">
<security mode=""Message"">
<message negotiateServiceCredential=""false"">
<issuer address=""https://northwind.com/samplests"" bindingConfiguration=""**northwindBinding**"" binding=""wsHttpBinding"">
</issuer>
</message>
</security>
</binding>
</wsFederationHttpBinding>
<wsHttpBinding>
<binding name=""**northwindBinding**"">
<security mode=""Message"">
<message clientCredentialType=""Certificate""/>
</security>
</binding>
</wsHttpBinding>
</bindings>"

Type : Chaîne Valeur par défaut : chaîne vide S’applique à : adaptateur WCF-Custom, adaptateur WCF-CustomIsolated

Voir aussi

Comportement> des adaptateurs<WCF de <endpointBehaviors><bindings><comportement> de <serviceBehaviors>Remise ordonnée de messagesÉquilibrage de charge