Freigeben über

Konfigurationseigenschaften für integrierte BizTalk-Adapter

  • Artikel

Das BizTalk-Explorer-Objektmodell macht die Eigenschaften IReceiveLocation.CustomData und ISendPort.CustomData verfügbar, die den Adapterkonfigurationseigenschaftenbehälter in Form einer XML-Zeichenfolge für das Name-Wert-Paar enthalten. Diese NAME-Wert-Paar-XML-Zeichenfolge wird in einem <CustomProps-Element> in einem <TransportTypeData-Element> in einer Bindungsdatei gespeichert. Die meisten Informationen im <CustomProps-Element> entsprechen Informationen, die für einen Adapter in der BizTalk Server Benutzeroberfläche festgelegt werden können (z. B. bizTalk-Verwaltungskonsole oder BizTalk Explorer). Wenn diese Werte in einer Bindungsdatei vorhanden sind, werden sie beim Importieren der Bindungsdatei auf die Adapterkonfiguration für die angegebenen Empfangsspeicherorte und Sendeports angewendet. Konfigurationsinformationen für alle Adapter werden in der Datenbank für Einmaliges Anmelden (SSO) gespeichert.

In diesem Abschnitt werden die Konfigurationseigenschaften erläutert, die für die integrierten BizTalk-Adapter festgelegt werden können.

Hinweis

Kennwortinformationen, die <im TransportTypeData-Element> einer Bindungsdatei gespeichert sind, werden maskiert, sodass vertrauliche Daten nicht im Klartext gespeichert werden. Je nach Transport werden Kennwörter durch NULL oder Sternchen ersetzt. Diese Informationen müssen manuell in die Bindungsdatei eingegeben werden, um die Adapterkonfiguration zu aktualisieren, bevor die Bindungsdatei in die BizTalk Server-Zielkonfiguration importiert wird.

Die Konfigurationsdaten für Adapter, die mit dem Adapter Framework erstellt wurden, werden in einem <AdapterConfig-Element> gespeichert. Da das <AdapterConfig-Element> den datentyp VT_BSTR (vt="8") angibt, müssen die < > in diesem Element enthaltenen Zeichen mit Escapezeichen versehen werden, sonst tritt beim Importieren der Bindungsdatei ein Fehler auf. Dadurch wird der Text mit den Konfigurationsdaten für Benutzer allerdings schlechter lesbar. Im folgenden Beispiel wird die Auswirkung von Escapezeichen in Beispielkonfigurationsdaten für einen an den POP3-Adapter gebundenen Sendeport veranschaulicht.

TransportTypeData-Konfigurationsdaten, die die <> im <AdapterConfig-Element> verwendeten Zeichen nicht escapen

Diese Konfigurationsdaten sind ungültig, da das <AdapterConfig-Element> den Datentyp VT_BSTR (vt="8") angibt und die <> im <AdapterConfig-Element> enthaltenen Zeichen nicht escaped sind:

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

TransportTypeData-Konfigurationsdaten, die die <> im <AdapterConfig-Element> verwendeten Zeichen als Escapezeichen verwenden

Da das <AdapterConfig-Element> den Datentyp VT_BSTR (vt="8") angibt, müssen die <> Zeichen aus dem <AdapterConfig-Element> mit escapediert werden, wie unten dargestellt:

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

Zu den integrierten Adaptern, die mit dem Adapterframework erstellt wurden, zählen folgende:

  • FTP-Adapter

  • MQSeries-Adapter

  • MSMQ-Adapter

  • POP3-Adapter

  • Windows Sharepoint Services-Adapter

    Beispiele zu TransportTypeData-Konfigurationsdaten für die einzelnen integrierten Adapter finden Sie in diesem Abschnitt im jeweiligen Thema über die Konfigurationseigenschaften für den Adapter.

In diesem Abschnitt

Variablentypen für Konfigurationseigenschaften

Konfigurationseigenschaften des Dateiadapters

Konfigurationseigenschaften des FTP-Adapters

Konfigurationseigenschaften des HTTP-Adapters

Konfigurationseigenschaften des MQSeries-Adapters

Konfigurationseigenschaften des MSMQ-Adapters

Konfigurationseigenschaften des POP3-Adapters

Konfigurationseigenschaften des SMTP-Adapters

Konfigurationseigenschaften des SOAP-Adapters

Konfigurationseigenschaften des Windows SharePoint Services-Adapters