Tutorial 4: Migrieren eines von SAP empfangenen IDOC BizTalk-Projekts
Die vorherige Version des SAP-Adapters, der im Lieferumfang von Microsoft BizTalk Server enthalten ist, unterscheidet sich vom WCF-basierten SAP-Adapter in vielen Aspekten, einschließlich:
Die Entwurfszeiterfahrung beim Erstellen eines BizTalk-Projekts.
Die Benutzeroberfläche zum Abrufen von Metadaten.
Schemadateiname und Namespace.
Datentypzuordnungen.
Die Vorgänge, die mit dem Adapter ausgeführt werden können.
Konfiguration des physischen Ports in der BizTalk Server-Verwaltungskonsole.
Sie können jedoch Änderungen am BizTalk-Projekt vornehmen, das mit der vorherigen Version des Adapters erstellt wurde, und dafür sorgen, dass es mit dem WCF-basierten SAP-Adapter funktioniert.
Dieses Tutorial enthält Anweisungen zu den Änderungen, die Sie an dem vorhandenen BizTalk-Projekt vornehmen sollten, das mit der vorherigen Version des Adapters erstellt wurde.
Hinweis
In diesem Tutorial wird der Einfachheit halber die vorherige Version des SAP-Adapters als vPrev-SAP-Adapter bezeichnet. Entsprechend wird ein BizTalk-Projekt, das den SAP-Adapter vPrev verwendet, als vPrev BizTalk-Projekt bezeichnet.
Beispiel für das Tutorial
Dieses Tutorial basiert auf einem Beispiel (ReceiveIDOC_Migration), das veranschaulicht, wie ein vPrev BizTalk-Projekt migriert wird, das ein Flatfile-IDOC von einem SAP-System empfängt. Das Beispiel wird mit dem BizTalk-Adapterpaket bereitgestellt. Weitere Informationen finden Sie unter Adapterbeispiele.
Voraussetzungen
Sie benötigen ein vPrev BizTalk-Projekt. Dieses Tutorial umfasst ein BizTalk-Projekt, das ein ORDERS03 IDOC von einem SAP-System empfängt.
Erstellen einer Schlüsseldatei mit starkem Namen und Kennenlernen der Tools
Grundlegendes zu einem BizTalk-Projekt, das mit der vorherigen Version des Adapters erstellt wurde
Die wichtigsten Komponenten eines vPrev BizTalk-Projekts, um ein IDOC zu erhalten, sind:
BizTalk-Orchestrierung. Dies ist eine einfache Orchestrierung, die aus einem SAP-Empfangsport besteht, der ein Flatfile-IDOC von einem SAP-System empfängt. Das BizTalk-Projekt enthält einen Flatfile-Disassembler zum Konvertieren des Flatfile-IDOC in einen XML-Code, damit es in einer Orchestrierung verwendet werden kann. Bevor das XML-IDOC über einen Dateiport an einen Dateispeicherort kopiert wird, wird es mithilfe eines Flatfile-Assemblers wieder in ein Flatfile-IDOC konvertiert.
Schema für das IDOC, das Sie an das SAP-System senden möchten. Dieses Tutorial umfasst ein BizTalk-Projekt, das ORDERS03 IDOC vom SAP-System empfängt. Das für das IDOC generierte Schema ist ORDERS03.xsd. Dieses Schema wird mithilfe des SAP-Adapters vPrev generiert.
Migrieren eines BizTalk-Projekts, das mit der vorherigen Version des Adapters erstellt wurde
In diesem Migrationstutorial soll es Ihnen ermöglicht werden, ein Flatfile-IDOC von einem SAP-System zu erhalten, das einen WCF-Custom Sendeport anstelle des Sendeports für den vPrev-SAP-Adapter verwendet. Bevor Sie verstehen, welche Einstellungen für den WCF-Custom Sendeport erforderlich sind, müssen Sie zunächst verstehen, welche physischen Ports für die vPrev-Sende-IDOC-Orchestrierung erforderlich sind.
Ein vPrev-SAP-Empfangsport, der ein Flatfile-IDOC von einem SAP-System empfängt. Der Port konvertiert dies auch in ein XML-IDOC mithilfe eines Flatfile-Disassemblers, der als Teil der BizTalk-Anwendung vPrev verfügbar ist. Das XML-IDOC entspricht dem Schema (ORDERS03.xsd), das Sie mit dem vPrev-SAP-Adapter generiert haben.
Ein Datei-Sendeport, der das IDOC in den Ordner kopiert. Dieser Port verwendet auch die Flatfile-Assemblerpipeline, die in der BizTalk-Anwendung verfügbar ist, um das XML-IDOC in ein Flatfile-IDOC zu konvertieren.
Um Ihr vorhandenes vPrev BizTalk-Projekt zu migrieren, müssen Sie den Dateisendeport, der das Flatfile-IDOC in einen Ordner kopiert, nicht ändern. Sie müssen nur einen neuen WCF-Custom Empfangsport mit den richtigen Konfigurationseinstellungen konfigurieren. In diesem Tutorial wird veranschaulicht, wie Sie den WCF-Custom Empfangsport für den Empfang von IDOCs von einem SAP-System mithilfe des WCF-basierten SAP-Adapters konfigurieren.
In diesem Abschnitt
Schritt 1: Erstellen und Bereitstellen von vPrev BizTalk-Projekten zum Empfangen eines IDOC
Schritt 2: Konfigurieren eines unidirektionalen WCF-Custom-Empfangsports