Freigeben über

Konfigurieren einer physischen Portbindung mithilfe einer Portbindungsdatei für die Verwendung des SQL-Adapters

  • Artikel

Wenn Sie das BizTalk-Projekt-Add-In Zum Generieren von Metadaten für ein anderes SQL Server Artefakt als die Schemadateien verwenden, generiert das Add-In "Adapterdienst nutzen" auch eine Portbindungsdatei. Sie können diese Bindungsdatei in Ihre BizTalk-Anwendung importieren, um einen physischen Sende- oder Empfangsport zu erstellen. Anweisungen zum Importieren von Bindungsdateien finden Sie unter Wiederverwenden von Adapterbindungen. Wenn Sie diese Bindungsdatei importieren, müssen Sie keinen physischen Sende- oder Empfangsport manuell erstellen.

Wichtig

Wenn Sie beim Verwenden des Add-Ins "Adapterdienst nutzen" keinen Wert für eine Bindungseigenschaft vom Typ Zeichenfolge angeben, deren Standardwert NULL ist, ist diese Bindungseigenschaft in der Bindungsdatei nicht verfügbar. Sie müssen die Bindungseigenschaft und ihren Wert bei Bedarf manuell in der Bindungsdatei hinzufügen.

Beim Erstellen eines Ports mithilfe der Portbindungsdatei wird immer ein bidirektionale Sendeport oder ein unidirektionale Empfangsport erstellt. Wenn Sie einen unidirektionalen Sendeport erstellen möchten, können Sie ihn manuell erstellen, indem Sie die Schritte unter Manuelles Konfigurieren einer physischen Portbindung an den SQL-Adapter ausführen. Alternativ können Sie die in diesem Thema beschriebenen Problemumgehungen befolgen, um die Portbindungsdatei so zu ändern, dass unidirektionale Sendeports erstellt werden.

Hinweis

Bei eingehenden Vorgängen erstellt die Portbindungsdatei immer einen unidirektionalen Empfangsport. Dies liegt daran, dass der SQL-Adapter nur unidirektionale Empfangsports für eingehende Vorgänge unterstützt.

Wichtig

Mit dem Assistenten zum Hinzufügen von Adaptermetadaten wird keine Portbindungsdatei erstellt, mit der Sie einen WCF-SQL-Port erstellen können. Sie können jedoch einige Änderungen an der Portbindungsdatei vornehmen, die vom Add-In "Adapterdienst nutzen" generiert wurde, und sie verwenden, um einen WCF-SQL-Port zu erstellen. Weitere Informationen finden Sie unter Konfigurieren eines WCF-SQL-Ports mithilfe der Portbindungsdatei, die mithilfe des Add-Ins "Adapterdienst nutzen" generiert wurde.

Im Folgenden sind einige wichtige Punkte aufgeführt, die Sie in Bezug auf die Bindungsdatei verstehen müssen, die das Add-In "Adapterdienst nutzen" generiert:

  • Die Dateien werden mit einer bestimmten Benennungskonvention erstellt. Wenn Sie Metadaten für ausgehende Vorgänge generiert haben, d. h. zum Senden von Nachrichten an SQL Server, wird der Name der Datei WcfSendPort_SqlAdapterBinding_Custom.bindinginfo.xml.

    Wenn Sie Metadaten für eingehende Vorgänge generiert haben, d. h. zum Empfangen von Nachrichten von SQL Server, wird der Name der Datei WcfReceivePort_SqlAdapterBinding_Custom.bindinginfo.xml.

  • Die Datei enthält Informationen über die Bindungskonfiguration, den Bindungstyp, den Endpunkt-URI und die Portaktion basierend auf den Vorgängen, für die Metadaten generiert wurden. Wenn Sie diese Bindungsdatei in Ihre BizTalk-Anwendung importieren, um einen Port zu erstellen, werden alle relevanten Informationen, die zum Konfigurieren eines physischen Ports erforderlich sind, automatisch für den Port festgelegt.

    Wichtig

    Standardmäßig wird die Aktion für den Sendeport dem Vorgangsnamen zugeordnet, für den Sie Metadaten generiert haben. Wenn Sie beispielsweise Metadaten für den Insert-Vorgang in der Tabelle Customer generieren, wird die Aktion für den Port auf <Operation Name="Insert" Action="TableOp/Insert/dbo/CustomerTable" />festgelegt. Der Vorgangsname für den logischen Sendeport, den Sie in der BizTalk-Orchestrierung erstellen, ist jedoch möglicherweise nicht identisch. Sie müssen sicherstellen, dass der Vorgangsname im logischen Sendeport (in der BizTalk-Orchestrierung) und dem physischen Sendeport (in BizTalk Server Verwaltungskonsole) identisch sind. Andernfalls erhalten Sie eine Fehlermeldung beim Senden von Nachrichten an SQL Server über den Sendeport.

  • Sie müssen nur die Anmeldeinformationen für den Port angeben, um eine Verbindung mit SQL Server herzustellen. Obwohl die Bindungsdatei den Benutzernamen beibehält, mit dem eine Verbindung hergestellt werden soll, enthält die Bindungsdatei aus Sicherheitsgründen das Kennwort nicht.

Wichtige Überlegungen zur Verwendung der Portbindungsdatei

  • Wenn Sie die Bindungsdatei importieren, erhalten Sie möglicherweise eine Dialogmeldung, die darüber informiert, dass der Name der BizTalk-Anwendung in der Bindungsdatei nicht mit dem Anwendungsnamen übereinstimmt, in den Sie die Bindungsdatei importieren. Sie können diese Nachricht sicher ignorieren und fortfahren.

  • Die Bindungsdatei enthält auch Namen von Ports und Empfangsspeicherorten. Wenn die BizTalk-Anwendung, in die Sie die Bindungsdatei importieren, einen Port oder einen Empfangsspeicherort erstellt, der denselben Namen wie ein bereits vorhandener Port in derselben BizTalk-Anwendung hat, wird eine Fehlermeldung angezeigt. Sie müssen die Bindungsdatei manuell bearbeiten, um einen eindeutigen Namen für die Ports oder Empfangsspeicherorte anzugeben.

  • Die Bindungsdatei enthält auch Informationen zum Verbindungs-URI. Wenn die Bindungsdatei einen Empfangsspeicherort erstellt, der denselben Empfangs-URI wie ein bereits vorhandener Empfangsspeicherort in derselben BizTalk-Anwendung aufweist, erhalten Sie eine Fehlermeldung. Sie müssen die Bindungsdatei manuell bearbeiten, um einen eindeutigen URI anzugeben.

  • Standardmäßig enthält die Portbindungsdatei für ausgehende Vorgänge immer Definitionen für einen bidirektionalen Sendeport. Wenn Sie diese Datei in eine BizTalk-Anwendung importieren, wird ein bidirektionales Sendeport erstellt. Möglicherweise verfügen Sie jedoch über eine Orchestrierung mit einem unidirektionalen Sendeport. Wenn Sie also eine solche Orchestrierung konfigurieren und den Port verwenden, der durch importieren der Bindungsdatei erstellt wurde, ist der Port in der Liste nicht verfügbar. Dies geschieht, weil der logische Port, den Sie im Rahmen der Orchestrierung erstellt haben, ein unidirektionaler Port ist, während der in der Orchestrierung erstellte physische Port ein bidirektionaler Port ist. In solchen Fällen können Sie die Bindungsdatei bearbeiten, um die folgenden Änderungen vorzunehmen:

    Option Aktion
    So bearbeiten Sie die Portbindungsdatei zum Konfigurieren eines unidirektionalen Sendeports 1. Ändern Sie im folgenden Auszug den Wert der IsTwoWay-Eigenschaft in false. Ursprünglich ist dies auf true festgelegt.
    <SendPort Name="port_name" IsStatic="true" IsTwoWay="false" BindingOption="0">
    2. Kommentieren Sie die folgenden Auszüge:
    <ReceivePipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLReceive" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLReceive, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="1" TrackingOption="None" Description=""/>
    <ReceivePipelineData xsi:nil="true" />

    Wichtig

    Bei eingehenden Vorgängen erstellt die Portbindungsdatei immer einen unidirektionalen Empfangsport. Dies liegt daran, dass der SQL-Adapter nur unidirektionale Empfangsports für eingehende Vorgänge unterstützt.

Konfigurieren eines WCF-SQL-Ports mithilfe der Portbindungsdatei, die mithilfe des Add-Ins "Adapterdienst nutzen" generiert wurde

Das Add-In Adapterdienst nutzen erstellt auch eine Portbindungsdatei, die Sie in BizTalk Server Verwaltungskonsole importieren können. Sie können dieselbe Portbindungsdatei verwenden, um auch den BizTalk WCF-SQL-Port in BizTalk Server Verwaltungskonsole zu erstellen. Vor dem Erstellen des WCF-SQL-Ports müssen Sie jedoch die folgenden Aufgaben ausführen, um die Portbindungsdatei zu ändern.

  1. Öffnen Sie die Portbindungsdatei in einem Text-Editor.

  2. Suchen Und ersetzen Sie "WCF-Custom" durch den Namen, mit dem Sie den WCF-SQL-Adapter in BizTalk Server Verwaltungskonsole hinzugefügt haben. Wenn Sie beispielsweise den WCF-SQL-Adapter als "SQLAdapter" hinzugefügt haben, ersetzen Sie "WCF-Custom" durch "SQLAdapter".

  3. Suchen Sie nach dem Attribut "ConfigurationClsid", und ersetzen Sie den vorhandenen Wert des Attributs durch "59B35D03-6A06-4734-A249-EF561254ECF7".

  4. Speichern und schließen Sie die Bindungsdatei.

  5. Importieren Sie die Bindungsdatei in BizTalk Server Verwaltungskonsole. Anweisungen zum Importieren der Bindungsdatei finden Sie unter Wiederverwenden von Adapterbindungen.

Weitere Informationen

Bausteine zum Entwickeln von BizTalk-Anwendungen mit dem SQL-Adapter