Partager via

Propriétés de configuration des adaptateurs BizTalk intégrés

  • Article

Le modèle objet bizTalk Explorer expose les propriétés IReceiveLocation.CustomData et ISendPort.CustomData qui contiennent le sac de propriétés de configuration de l’adaptateur sous la forme d’une chaîne XML de paire nom/valeur. Cette chaîne XML de paire nom/valeur est stockée dans un <élément CustomProps> au sein d’un <élément TransportTypeData> dans un fichier de liaison. La plupart des informations contenues dans l’élément <CustomProps> correspondent à des informations qui peuvent être définies pour une carte dans l’interface utilisateur BizTalk Server (par exemple, la console d’administration BizTalk ou bizTalk Explorer). Si ces valeurs sont présentes dans un fichier de liaison, elles sont appliquées à la configuration des adaptateurs pour les emplacements de réception et les ports d'envoi spécifiés lors de l'importation du fichier de liaison. Les informations de configuration de tous les adaptateurs sont enregistrées dans la base de données de l'authentification unique.

Cette section décrit les propriétés pouvant être définies pour chaque adaptateur BizTalk intégré.

Notes

Les informations de mot de passe stockées dans l’élément <TransportTypeData> d’un fichier de liaison sont masquées afin que les données sensibles ne soient pas enregistrées en texte clair. En fonction du transport, ces informations sont soit remplacées par NULL, soit remplacées par des astérisques. Vous devez les entrer manuellement dans le fichier de liaison avant l'importation du fichier de liaison dans la configuration BizTalk Server cible.

Les données de configuration des adaptateurs créés à l’aide de Adapter Framework sont stockées dans un <élément AdapterConfig> . Étant donné que l’élément <AdapterConfig> spécifie le type de données VT_BSTR (vt="8 »), les caractères contenus dans cet élément doivent être placés dans une < > séquence d’échappement ou une erreur se produit lorsque vous tentez d’importer le fichier de liaison. L'utilisation de ces caractères d'échappement rend les données de configuration moins faciles à lire pour l'utilisateur. L'exemple suivant, portant sur les données de configuration d'un port d'envoi lié à l'adaptateur POP3, illustre ce fait.

Données de configuration TransportTypeData qui n’échappent pas aux <> caractères utilisés dans l’élément <AdapterConfig>

Ces données de configuration ne sont pas valides, car l’élément <AdapterConfig> spécifie le type de données VT_BSTR (vt="8 ») et les <> caractères contenus dans l’élément AdapterConfig> ne sont pas placés dans une <séquence d’échappement :

<TransportTypeData>  
<CustomProps>  
<AdapterConfig vt="8">  
<Config xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance xmlns:xsd="http://www.w3.org/2001/XMLSchema">  
<mailServer>test.microsoft.com</mailServer>  
<serverPort>0</serverPort>  
<userName>testuser</userName>  
<password>******</password>  
<authenticationScheme>Basic</authenticationScheme>  
<sslRequired>false</sslRequired>  
<applyMIME>true</applyMIME>  
<bodyPartContentType>text/xml</bodyPartContentType>  
<bodyPartIndex>1</bodyPartIndex>  
<errorThreshold>10</errorThreshold>  
<pollingInterval>5</pollingInterval>  
<pollingUnitOfMeasure>Minutes</pollingUnitOfMeasure>   
<uri>POP3://test.microsoft.com#testuser</uri>  
</Config>  
</AdapterConfig>  
</CustomProps>  
</TransportTypeData>

Données de configuration TransportTypeData qui échappent aux <> caractères utilisés dans l’élément <AdapterConfig>

Étant donné que l’élément <AdapterConfig> spécifie le type de données VT_BSTR (vt="8 »), les caractères doivent être placés dans une <> séquence d’échappement de l’élément <AdapterConfig> , comme indiqué ci-dessous :

<TransportTypeData>  
<CustomProps>  
<AdapterConfig vt="8">  
<Config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
xmlns:xsd="http://www.w3.org/2001/XMLSchema"><mailServer>test  
microsoft.com</mailServer><serverPort>0</serverPort>&  
lt;userName>testuser</userName><password>******</pass  
word><authenticationScheme>Basic</authenticationScheme>&  
lt;sslRequired>false</sslRequired><applyMIME>true</ap  
plyMIME><bodyPartContentType>text/xml</bodyPartContentType&  
gt;<bodyPartIndex>1</bodyPartIndex><errorThreshold>10  
</errorThreshold><pollingInterval>5</pollingInterval>  
<pollingUnitOfMeasure>Minutes</pollingUnitOfMeasure><uri  
>POP3://test.microsoft.com#testuser</uri></Config>  
</AdapterConfig>  
</CustomProps>  
</TransportTypeData>

Les adaptateurs intégrés créés avec l'infrastructure d'adaptateurs sont les suivants :

  • adaptateur FTP

  • Adaptateur MQSeries

  • Adaptateur MSMQ

  • Adaptateur POP3

  • Adaptateur Windows Sharepoint Services

    Pour afficher un exemple de chaîne utilisée comme données de configuration TransportTypeData pour chaque adaptateur intégré, reportez-vous à la rubrique sur les propriétés de configuration associée à l'adaptateur de cette section.

Dans cette section

Types de variables des propriétés de configuration

Propriétés de configuration de l’adaptateur de fichier

Propriétés de configuration de l’adaptateur FTP

Propriétés de configuration de l’adaptateur HTTP

Propriétés de configuration de l’adaptateur MQSeries

Propriétés de configuration de l’adaptateur MSMQ

Propriétés de configuration de l’adaptateur POP3

Propriétés de configuration de l’adaptateur SMTP

Propriétés de configuration de l’adaptateur SOAP

Propriétés de configuration de l’adaptateur Windows SharePoint Services