Erweitern von Mapper (BizTalk Server-Beispiel)

Das Beispiel "Extend Mapper" veranschaulicht, wie BizTalk Mapper verwendet und erweitert wird. Das Beispiel enthält mehrere BizTalk Server-Kartendateien (BTM), die jeweils verschiedene Features von BizTalk Mapper veranschaulichen.

Funktionsweise dieses Beispiels

Das Extending Mapper-Beispiel verwendet inhaltsbasiertes Routing (CBR) und kommt ohne Orchestrierung aus. Durch Angeben eines Filters für den Beispiel-Sendeport ist er direkt mit dem Beispiel-Empfangsport verbunden. Für den Sendeport ist eine Zuordnung angegeben, die auf das verarbeitete Dokument angewendet werden soll.

Wo finde ich dieses Beispiel?

<Beispielpfad>\XmlTools\ExtendingMapper

Die folgende Tabelle zeigt die Dateien in diesem Beispiel und beschreibt deren Zweck.

Erstellen und Initialisieren dieses Beispiels

Verwenden Sie das folgende Verfahren, um das Beispiel 'Extending Mapper' zu erstellen und zu initialisieren.

So erstellen und initialisieren Sie dieses Beispiel

1. Wechseln Sie in einem Befehlsfenster das Verzeichnis (cd) zu dem folgenden Ordner:

   <Beispielpfad>\XmlTools\ExtendingMapper

2. Führen Sie die Datei Setup.bataus, die die folgenden Aktionen ausführt:

   • Erstellt die Eingabeordner (\In) und Ausgabeordner (\Out) für dieses Beispiel.

   • Kompiliert und stellt das Visual Studio-Projekt für dieses Beispiel bereit.

   • Erstellt und konfiguriert den Empfangsort des BizTalk Servers sowie die Sende- und Empfangsports.

     Wenn Sie die Scriptor_CallExternalAssembly.btm- oder Scriptor_InlineXsltCallingExternalAssembly.btm-Karten verwenden möchten, öffnen Sie ExtendingMapper.sln in Visual Studio, und nehmen Sie die folgenden Änderungen vor (andernfalls gehen Sie zu Schritt 3):

   1. Öffnen Sie im Lösungs-Explorer Scriptor_CallExternalAssembly.btm.

   2. Wählen Sie im Mapper-Raster das Scripting-Functoid aus.

   3. Wählen Sie im Eigenschaftenraster die Script-Eigenschaft aus, und klicken Sie auf die Schaltfläche mit den Auslassungspunkten (...), um das Functoid-Skript zu konfigurieren.

   4. Wählen Sie im Dialogfeld Skripting-Funktionszuordnung konfigurieren die Skript-Funktionszuordnung-Konfiguration aus, und geben Sie Folgendes an:

      Legen Sie dies fest.	Zu diesem Thema
      Skripttyp	Externe Baugruppe
      Skriptzusammenstellung	Microsoft.Samples.BizTalk.ExtendingMapper.MapperClassLibrary
      Script-Klasse	Microsoft.Samples.BizTalk.ExtendingMapper.MapperHelper
      Script-Methode	MyConcat

   5. Wählen Sie im Menü "Datei" von Visual Studio die Option "Speichern", um Änderungen an der Kartendatei zu speichern, und schließen Sie die Lösung.

3. Drücken Sie eine beliebige Taste, um mit Setup.batfortzufahren.

   Von Bedeutung

   Wenn Sie Scriptor_InlineXsltCallingExternalAssembly.btm verwenden möchten, müssen Sie die ExternalAssembly.xml Datei bearbeiten. ExternalAssembly.xml wird von BizTalk verwendet, um den registrierten Namespace eines Mapper-Erweiterungsobjekts einer .NET-Assembly zuzuordnen. Da auf die abhängige Assembly mit dem vollqualifizierten Namen (einschließlich des automatisch generierten öffentlichen Schlüsseltokens) verwiesen wird, müssen Sie diesen Wert aktualisieren. Wenn Sie Scriptor_InlineXsltCallingExternalAssembly.btm nicht verwenden möchten, müssen Sie die Schritte a bis e nicht ausführen.

4. Navigieren Sie im Windows-Explorer zu <Windows-Ordner>\Assembly\.

   1. Klicken Sie mit der rechten Maustaste auf "Microsoft.Samples.BizTalk.ExtendingMapper.MapperClassLibrary ", und wählen Sie "Eigenschaften" aus.

   2. Kopieren Sie den Wert des öffentlichen Schlüsseltokens.

   3. Öffnen Sie in einem Text-Editor <Samples Path>\XML Tools\ExtendingMapper\ExternalAssembly.xml.

   4. Wählen Sie den AssemblyName="Microsoft.Samples.BizTalk.ExtendingMapper.MapperClassLibrary, Version=1.0.0.0, Culture=neutral, PublicKeyToken=68496d20c737d84b"-Attribut aus, und ersetzen Sie den PublicKeyToken-Wert durch den Wert des öffentlichen Schlüsseltokens , den Sie in Schritt c kopiert haben.

   5. Speichern und schließen Sie ExternalAssembly.xml.

   Hinweis

   Vergewissern Sie sich, dass während des Build- und Initialisierungsprozesses keine Fehler gemeldet wurden, bevor Sie versuchen, dieses Beispiel auszuführen.

So konfigurieren, auflisten und starten Sie den Sendeport

1. Klicken Sie auf "Start", wählen Sie "Alle Programme" aus, wählen Sie "Microsoft BizTalk Server", und wählen Sie dann "BizTalk Server Administration" aus.

2. Klicken Sie in der BizTalk Server-Verwaltungskonsole, um die BizTalk Server-Verwaltung zu erweitern, klicken Sie, um die BizTalk-Gruppe [<Servername>:<Verwaltungsdatenbank>] zu erweitern, und klicken Sie dann, um Anwendungen zu erweitern.

3. Klicken Sie, um "ExtendingMapperApplication" zu erweitern, und klicken Sie dann auf "Ports senden".

4. Klicken Sie im rechten Bereich mit der rechten Maustaste auf "Ports senden", und klicken Sie dann auf "Eigenschaften".

5. Klicken Sie im Dialogfeld ExtendingMapperSP – Eigenschaften des Sendeports auf die Registerkarte Ausgehende Karten.

   Wählen Sie in der Spalte "Karte " die erforderliche Karte aus der Dropdownliste aus, und klicken Sie dann auf "OK". Die Karten werden in der folgenden Tabelle beschrieben.

   Abbildung zur Anwendung der Eigenschaft	BESCHREIBUNG
   Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_CallExternalAssembly	Veranschaulicht das Aufrufen einer Funktion in einer externen .NET-Assembly aus einem Scripting-Functoid in einer Karte basierend auf den Eingabeparametern für dieses Funktoid. Dadurch wird jegliche Verarbeitungslogik sauber von der Kartendatei getrennt. Diese Kartendatei verwendet die Assembly MapperClassLibrary.dll, die mit diesem Beispiel geliefert wird.
   Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_InlineScripts	Veranschaulicht, wie einfache Inlineskripts in Skripting-Functoiden in einer Kartendatei mit .NET-Sprachen wie C#, Visual Basic.NET und JScript.NET geschrieben werden.
   Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_GlobalVariableInInlineScript	Veranschaulicht, wie globale Variablen in den Inline-Skripten von Scripting-Functoiden verwendet werden. Globale Variablen werden in der Regel verwendet, um Zustandsinformationen in einer Kartendatei über verschiedene Skripting-Functoids hinweg zu verwalten.
   Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_InlineXslt	Veranschaulicht, wie Die Struktur im Zieldokument mithilfe von unformatierter INLINE-XSLT in einem Scripting-Functoid in der Karte erstellt wird. Sie können einige Teile des Zieldokuments mithilfe von Scripting Functoids mit Inline-XSLT erstellen, wenn dies in BizTalk Mapper nicht mithilfe anderer Functoids möglich ist.
   Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_XsltCalltemplate	Veranschaulicht, wie man eine Struktur im Zieldokument mithilfe einer XSLT-Aufrufvorlage innerhalb eines Scripting-Functoids im Mapping erstellt. Der Vorteil einer XSLT-Aufrufvorlage gegenüber inline XSLT besteht darin, dass die Aufrufvorlage Parameter akzeptieren kann, sodass Sie die Struktur basierend auf Eingabeparametern für das Skripting-Functoid erstellen können. Sie können einige Teile des Zieldokuments mithilfe von Scripting Functoids mit Inline-XSLT erstellen, wenn dies in BizTalk Mapper nicht mithilfe anderer Functoids möglich ist.
   Microsoft.Samples.BizTalk.ExtendingMapper. Scriptor_InlineXsltCallingExternalAssembly	Veranschaulicht das Aufrufen einer externen .NET-Assembly aus der Inline-XSLT eines Scripting-Functoids in einer Karte. Erläutert, wie Sie die XML-Eigenschaft der benutzerdefinierten Erweiterung des BizTalk Mapper-Rasters mit der benutzerdefinierten Erweiterungsdatei ExternalAssembly_extxml.xml überschreiben können, die die Details der externen .NET-Assembly enthält, die aufgerufen werden soll. Sie können einige Teile des Zieldokuments mithilfe von Scripting-Functoids mit Inline-XSLT erstellen, wenn dies in der Mapper-Oberfläche nicht mithilfe anderer Functoids möglich ist.
   Microsoft.Samples.BizTalk.ExtendingMapper. OverridingMapXslt	Veranschaulicht, wie die kompilierte XSLT der BizTalk Mapper-Datei mit einer benutzerdefinierten XSLT-Datei vollständig außer Kraft setzen kann. Sie können dies tun, indem Sie die Eigenschaft "Custom XSL Path" und optional die Eigenschaft "Custom Extension XML" im BizTalk Mapper-Gitter überschreiben. Die von Ihnen bereitgestellte benutzerdefinierte XSLT-Datei ist in der kompilierten BizTalk Server-Assembly des Projekts enthalten, das Sie zur Laufzeit verwenden möchten. In diesem Fall werden die Inhalte der Kartendatei (BTM) ignoriert. Diese Zuordnungsdatei verwendet OverridingMapXslt.xslt und OverridingMapXslt.xml für die Eigenschaften Custom XSL Path bzw. Custom Extension XML. Sie können eine Kartendatei im Solution Explorer überprüfen. Anschließend können Sie sie als Vorlagendatei verwenden, die Sie für die Benutzerdefinierte XSL Path-Eigenschaft des BizTalk Mapper-Rasters bearbeiten und verwenden können. Sie können auf diese Option zurückgreifen, wenn es nicht möglich ist, diese XSLT mit BizTalk Mapper zu erstellen.

Das Beispiel ausführen

Verwenden Sie das folgende Verfahren, um das Beispiel "Extending Mapper" auszuführen.

So führen Sie dieses Beispiel aus

1. Kopieren Sie die Eingabedatei ExtendingMapper.xml in den Eingabeordner unter <Samples Path>\XmlTools\ExtendingMapper\In.

2. Beachten Sie, wie die Datei transformiert und an den <Ordner "Samples Path>\XmlTools\ExtendingMapper\Out" weitergeleitet wird. Die transformation, die auftritt, basiert auf der karte, die Sie angewendet haben.

Siehe auch

XML-Tools (BizTalk Server Beispielordner)