Konfigurieren einer physischen Portbindung mithilfe einer Portbindungsdatei zu Oracle Database

Wenn Sie das Add-In "Consume Adapter Service BizTalk Project" verwenden, um Metadaten für ein Oracle-Datenbankartefakt zu generieren, generiert das Add-In neben den Schemadateien auch eine Portbindungskonfigurationsdatei. 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 Oracle Database Adapter-Bindungen. Wenn Sie diese Bindungsdatei importieren, müssen Sie keinen physischen Sende- oder Empfangsport manuell erstellen.

Von Bedeutung

Wenn Sie beim Verwenden des Add-Ins "Verbrauchsadapterdienst BizTalk Project" keinen Wert für eine Bindungseigenschaft vom Typ "Zeichenfolge" angeben und deren Standardwert null ist, steht diese Bindungseigenschaft in der Bindungsdatei nicht zur Verfügung. Sie müssen die Bindungseigenschaft und den zugehörigen Wert in der Bindungsdatei bei Bedarf manuell hinzufügen.

Beim Erstellen eines Ports mithilfe einer Portbindungsdatei werden immer bidirektionale Sende- und Empfangsports erstellt. Wenn Sie unidirektionale Sende- oder Empfangsports erstellen möchten, können Sie sie manuell erstellen, indem Sie das unter "Manuelle Konfiguration einer physischen Portbindung" für den Oracle-Datenbankadapter beschriebene Verfahren ausführen. Oder Sie können die in diesem Thema dokumentierte Problemumgehung anwenden, um die Portbindungsdatei zu ändern und unidirektionale Sende- oder Empfangsports zu erstellen.

Im Folgenden sind einige wichtige Punkte aufgeführt, die Sie in Bezug auf die bindungsdatei verstehen müssen, die vom Add-In "Adapterdienst verbrauchen" generiert wird:

• Die Dateien werden mit einer bestimmten Benennungskonvention erstellt. Wenn Sie Metadaten für ausgehende Vorgänge generiert haben, ist dies das Senden von Nachrichten an die Oracle-Datenbank, der Name der Datei ist WcfSendPort_OracleDBBinding_Custom.bindinginfo.xml.

  Wenn Sie Metadaten für eingehende Vorgänge generiert haben, um Nachrichten aus der Oracle-Datenbank zu empfangen, lautet der Name der Datei WcfReceivePort_OracleDBBinding_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 importieren, um einen Port zu erstellen, werden alle relevanten Informationen, die zum Konfigurieren eines physischen Ports erforderlich sind, automatisch für den Port festgelegt.

  Von Bedeutung

  Standardmäßig ist die Aktion für den Sendeport dem Vorgangsnamen zugeordnet, für den Sie Metadaten generieren. Wenn Sie beispielsweise Metadaten für einen Select-Vorgang in der TABELLE ACCOUNTACTIVITY generieren, wird die Aktion für den Port auf <Operation Name="Select" Action="http://Microsoft.LobServices.OracleDB/2007/03/SCOTT/Table/ACCOUNTACTIVITY/Select" /> festgelegt. Der Vorgangsname des logischen Sendeports, den Sie in der BizTalk-Orchestrierung erstellen, ist jedoch möglicherweise nicht identisch. Sie müssen sicherstellen, dass der Vorgangsname im logischen Port (in der BizTalk-Orchestrierung) und der physische Sendeport (in der BizTalk Server-Verwaltungskonsole) identisch sind. Wenn nicht, erhalten Sie beim Senden von Nachrichten über den Sendeport eine Fehlermeldung an die Oracle-Datenbank.

• Sie müssen nur die Anmeldeinformationen für den Port angeben, um eine Verbindung mit der Oracle-Datenbank herzustellen. Die Bindungsdatei behält zwar den Benutzernamen, mit dem eine Verbindung hergestellt werden soll, aus Sicherheitsgründen enthält die Bindungsdatei nicht das Kennwort.

Wichtige Überlegungen zur Verwendung der Portbindungsdatei

• Wenn Sie die Bindungsdatei importieren, wird möglicherweise eine Dialogfeldmeldung angezeigt, in der Sie darüber informiert werden, 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 mit demselben Namen wie ein bereits vorhandener Port in derselben BizTalk-Anwendung erstellt, wird eine Fehlermeldung angezeigt. Sie müssen die Bindungsdatei manuell bearbeiten, um einen eindeutigen Namen für die Ports oder Empfangsorte anzugeben.

• Die Bindungsdatei enthält auch Informationen zum Verbindungs-URI. Wenn die Bindungsdatei einen Empfangsspeicherort erstellt, der den gleichen Empfangs-URI wie einen bereits vorhandenen Empfangsspeicherort in derselben BizTalk-Anwendung aufweist, wird eine Fehlermeldung angezeigt. Sie müssen die Bindungsdatei manuell bearbeiten, um einen eindeutigen URI anzugeben. Sie können einen eindeutigen URI angeben, indem Sie eine Abfrage-ID einschließen.

• Standardmäßig enthält die Portbindungsdatei immer Definitionen für bidirektionale Ports (Senden oder Empfangen). Wenn Sie diese Datei in eine BizTalk-Anwendung importieren, erstellt sie einen bidirektionale Sende- oder Empfangsport. Möglicherweise verfügen Sie jedoch über eine Orchestrierung, die über einen unidirektionale Sende- oder Empfangsport verfügt. 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 als Teil der Orchestrierung erstellt haben, ein unidirektionaler Port ist, während der physische Port, der in der Orchestrierung erstellt wurde, ein bidirektionaler Port ist. In solchen Fällen können Sie die Bindungsdatei bearbeiten, um die folgenden Änderungen vorzunehmen:

  Hierfür	Mach das
  So bearbeiten Sie die Portbindungsdatei zum Konfigurieren eines unidirektionalen Sendeports	- Ä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"> - Kommentieren Sie die folgenden Auszüge aus: <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" />
  So bearbeiten Sie die Portbindungsdatei zum Konfigurieren eines unidirektionalen Empfangsports	- Ändern Sie im folgenden Auszug den Wert der IsTwoWay-Eigenschaft in "false". Ursprünglich ist dies auf "true" festgelegt. <ReceivePort Name="port_name" IsTwoWay="false" BindingOption="1"> - Kommentieren Sie die folgenden Auszüge aus: <SendPipeline Name="Microsoft.BizTalk.DefaultPipelines.XMLTransmit" FullyQualifiedName="Microsoft.BizTalk.DefaultPipelines.XMLTransmit, Microsoft.BizTalk.DefaultPipelines, Version=3.0.1.0, Culture=neutral, PublicKeyToken=token" Type="2" TrackingOption="None" Description="" /> <SendPipelineData xsi:nil="true" /> <SendPipelineData xsi:nil="true" />

Konfigurieren eines WCF-OracleDB-Ports mithilfe der Portbindungsdatei, die mithilfe des "Consume Adapter Service" Add-ins generiert wurde

Das Add-In "Consume Adapter-Dienst" erstellt eine Portbindungsdatei, die in der BizTalk Server-Verwaltungskonsole importiert werden kann. Sie können dieselbe Portbindungsdatei verwenden, um auch den BizTalk-WCF-OracleDB-Port in der BizTalk Server-Verwaltungskonsole zu erstellen. Bevor Sie jedoch WCF-OracleDB Port erstellen, müssen Sie 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-OracleDB Adapter in der BizTalk Server-Verwaltungskonsole hinzugefügt haben. Wenn Sie beispielsweise den WCF-OracleDB Adapter als "OracleDBAdapter" hinzugefügt haben, ersetzen Sie "WCF-Custom" durch "OracleDBAdapter".

3. Suchen Sie nach dem Attribut "ConfigurationClsid", und ersetzen Sie den vorhandenen Wert des Attributs durch "D7127586-E851-412e-8A8A-2428AEDDC219".

4. Speichern und schließen Sie die Bindungsdatei.

5. Importieren Sie die Bindungsdatei in der BizTalk Server-Verwaltungskonsole. Anweisungen zum Importieren der Bindungsdatei finden Sie unter Wiederverwenden von Oracle Database Adapter-Bindungen.

Siehe auch

Bausteine zur Entwicklung von BizTalk-Anwendungen mit Oracle-Datenbank