Konfigurieren einer physischen Portbindung mithilfe einer Portbindungsdatei für SAP
Wenn Sie das BizTalk-Projekt-Add-In Zum Generieren von Metadaten für ein anderes SAP-Artefakt als die Schemadateien verwenden, generiert das Add-In Consume Adapter Service auch eine Portbindungsdatei. Sie können diese Bindungsdatei in Ihre BizTalk-Anwendung importieren, um einen physischen Sende- oder Empfangsport zu erstellen. Das Wiederverwenden von SAP-Adapterbindungen umfasst Schritte zum Importieren von Bindungsdateien. 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 Sende- oder Empfangsport erstellt. Wenn Sie einen unidirektionalen Port erstellen möchten, können Sie ihn manuell erstellen, indem Sie die Schritte unter Manuelles Konfigurieren einer physischen Portbindung an den SAP-Adapter ausführen. Alternativ können Sie die in diesem Thema beschriebenen Problemumgehungen befolgen, um die Portbindungsdatei so zu ändern, dass unidirektionale Ports erstellt werden.
Wichtig
Mit dem Assistenten zum Hinzufügen von Adaptermetadaten wird keine Portbindungsdatei erstellt, mit der Sie einen WCF-SAP-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-SAP-Port zu erstellen. Weitere Informationen finden Sie unter Konfigurieren eines WCF-SAP-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 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 das SAP-System senden, wird der Name der Datei WcfSendPort_SAPBinding_Custom.bindinginfo.xml.
Wenn Sie Metadaten für eingehende Vorgänge generiert haben, d. h. zum Empfangen von Nachrichten vom SAP-System, wird der Name der Datei WcfReceivePort_SAPBinding_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 RFC_CUSTOMER_GET generieren, wird die Aktion für den Port auf
<Operation Name="RFC_CUSTOMER_GET" Action="http://Microsoft.LobServices.Sap/2007/03/Rfc/RFC_CUSTOMER_GET " />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 das SAP-System über den Sendeport.Sie müssen nur die Anmeldeinformationen für den Port angeben, um eine Verbindung mit dem SAP-System 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.
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 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" />So bearbeiten Sie die Portbindungsdatei, um einen unidirektionalen Empfangsport zu konfigurieren 1. Ä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">
2. 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-SAP-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-SAP-Port in BizTalk Server Verwaltungskonsole zu erstellen. Vor dem Erstellen des WCF-SAP-Ports müssen Sie jedoch die folgenden Aufgaben ausführen, um die Portbindungsdatei zu ändern.
Öffnen Sie die Portbindungsdatei in einem Text-Editor.
Suchen Und ersetzen Sie "WCF-Custom" durch den Namen, mit dem Sie den WCF-SAP-Adapter in BizTalk Server Verwaltungskonsole hinzugefügt haben. Wenn Sie beispielsweise den WCF-SAP-Adapter als "SAPAdapter" hinzugefügt haben, ersetzen Sie "WCF-Custom" durch "SAPAdapter".
Suchen Sie nach dem Attribut "ConfigurationClsid", und ersetzen Sie den vorhandenen Wert des Attributs durch "A5F15999-8879-472d-8C62-3B5EA9406504".
Speichern und schließen Sie die Bindungsdatei.
Importieren Sie die Bindungsdatei in BizTalk Server Verwaltungskonsole. Wiederverwendung von SAP-Adapterbindungen listet die Schritte auf.
Weitere Informationen
Erstellen von Blöcken zum Entwickeln von BizTalk-Anwendungen