Konfigurieren einer physischen Portbindung mithilfe einer Portbindungsdatei für Oracle Database

Wenn Sie das BizTalk-Projekt-Add-In Zum Generieren von Metadaten für ein Oracle-Datenbankartefakt mit Ausnahme der 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 Oracle Database Adapter-Bindungen. Wenn Sie diese Bindungsdatei importieren, müssen Sie keinen physischen Sende- oder Empfangsport manuell erstellen.

Wichtig

Wenn Sie beim Verwenden des BizTalk-Projekt-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 einer Portbindungsdatei werden immer zweiseitige Sende- oder 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 an den Oracle-Datenbankadapter beschriebene Verfahren ausführen. Alternativ können Sie die in diesem Thema beschriebenen Problemumgehungen befolgen, um die Portbindungsdatei so zu ändern, dass unidirektionale Sende- oder Empfangsports erstellt werden.

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

• Die Dateien werden mit einer bestimmten Benennungskonvention erstellt. Wenn Sie Metadaten für ausgehende Vorgänge generiert haben, d. h. nachrichten an die Oracle-Datenbank senden, wird der Name der Datei WcfSendPort_OracleDBBinding_Custom.bindinginfo.xml.

  Wenn Sie Metadaten für eingehende Vorgänge generiert haben, d. h. nachrichten aus der Oracle-Datenbank empfangen, wird 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 auf den Port festgelegt.

  Wichtig

  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 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 Port (in der BizTalk-Orchestrierung) und des physischen Sendeports (in BizTalk Server Verwaltungskonsole) identisch sind. Andernfalls erhalten Sie eine Fehlermeldung beim Senden von Nachrichten an die Oracle-Datenbank über den Sendeport.

• Sie müssen nur die Anmeldeinformationen für den Port angeben, um eine Verbindung mit der Oracle-Datenbank herzustellen. Während 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. 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 bidirektionalen Sende- oder Empfangsport. Möglicherweise verfügen Sie jedoch über eine Orchestrierung mit einem unidirektionalen Sende- oder Empfangsport. 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, um einen unidirektionalen Sendeport zu konfigurieren	– Ä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: <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, um einen unidirektionalen Empfangsport zu konfigurieren	– Ä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: <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 Add-Ins "Adapterdienst verbrauchen" generiert wurde

Das Add-In Adapterdienst nutzen erstellt eine Portbindungsdatei, die Sie in BizTalk Server Verwaltungskonsole importieren können. Sie können dieselbe Portbindungsdatei verwenden, um auch den BizTalk-WCF-OracleDB-Port in 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 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 BizTalk Server Verwaltungskonsole. Anweisungen zum Importieren der Bindungsdatei finden Sie unter Wiederverwenden von Oracle Database Adapter-Bindungen.

Weitere Informationen

Bausteine zum Entwickeln von BizTalk-Anwendungen mit Oracle Database