Konfigurieren der Form 'Transformation'

Transformation (Form)

Transformationen werden nur verwendet, wenn Sie Meldungen erstellen, sodass Die Transformationsform immer innerhalb eines Shapes Zum Erstellen von Nachrichten angezeigt wird. Sie können das Shape Nachricht konstruktieren auf der Entwurfsoberfläche ablegen und dann das Transformieren-Shape darin ablegen, oder Sie können einfach die Transformationsform auf der Entwurfsoberfläche ablegen, und Orchestrierungs-Designer erstellt das einschließende Shape "Nachricht erstellen" für Sie.

Hinweis

Alle Quell- oder Zielnachrichten in einer Transformation müssen auf einem Schema basieren.

Prozedur

So konfigurieren Sie eine Form vom Typ 'Transformation'

1. Klicken Sie im Eigenschaftenfenster auf die Schaltfläche Ellipse (...) für die Eigenschaft Eingabenachrichten, Ausgabemeldungen oder Zuordnungsname .

2. Verwenden Sie das Dialogfeld Transformationskonfiguration , um die Transformationsform zu konfigurieren.

Hinweis

Ein Transformations-Shape kann nur innerhalb eines Shapes "Nachricht konstruktieren " vorhanden sein. Wenn Sie ein Nachrichtenzuweisungs-Shape an eine andere Stelle auf der Entwurfsoberfläche ziehen, wird ein neues Shape "Nachricht erstellen " erstellt.

Wichtige Überlegungen zur Leistung

BizTalk Server optimiert die Fähigkeit, Transformationen für große Nachrichten durchzuführen, indem das Dokument in den Arbeitsspeicher gestreamt wird, während die Transformation angewendet wird, anstatt das gesamte Dokument gleichzeitig in den Arbeitsspeicher zu laden. Diese Optimierung ermöglicht das Zuordnen und Transformieren von wesentlich größeren Dokumenten als in früheren Versionen von BizTalk Server. Diese Optimierung ist jedoch begrenzt wirksam, wenn eine Orchestrierung mehrere Ein- und/oder Ausgaben zum Transformieren von Formen akzeptiert.

Wenn eine Orchestrierung mehrere Ein- und/oder Ausgaben zum Transformieren von Formen akzeptiert, wird kein Dokumentstreaming durchgeführt und wesentlich mehr Speicher verbraucht. Eine Möglichkeit, dieses Problem zu umgehen, besteht darin, die Transformation bzw. die Transformationen in einer Empfangspipeline anzuwenden, sodass die Orchestrierung zum Transformieren von Formen nie mehr als eine Ein- und/oder Ausgabe akzeptiert.

Neue/Vorhandene Zuordnung

In diesem Abschnitt können Sie entweder auf die Optionsschaltfläche Neue Karte oder vorhandene Karte klicken, um eine Karte auszuwählen, die der Transformationsform zugewiesen werden soll.

Verwenden Sie das Feld Name unterhalb der ausgewählten Optionsschaltfläche, um eine Zuordnung anzugeben. Wenn Sie Neue Karte ausgewählt haben, können Sie eine Bezeichnung für die Zuordnung eingeben, die Sie zuweisen möchten. Wenn Sie die Option Neue Karte verwenden, müssen Sie den vollqualifizierten Namen der Karte im Textfeld angeben. Das Textfeld zeigt standardmäßig ein Beispiel für einen solchen Namen an, da es mit einem eindeutigen Bezeichnernamen basierend auf dem Projektnamespace und Transformieren des Shapenamens: <Projektnamespace> vorab aufgefüllt wird.<Transformieren des Shapenamens>_Map (z. B. MyProject.Transform3_Map).

Wenn Sie Vorhandene Karte ausgewählt haben, klicken Sie im Feld Name auf den Pfeil nach unten, um auszuwählen, welche Zuordnungsdatei verwendet werden soll. In diesem Listenfeld wird eine alphabetische Liste aller im Projekt verfügbaren Zuordnungen angezeigt. Wenn Sie in dieser Liste auf den Text <Aus Assembly> auswählen klicken, auf die verwiesen wird, wird das Dialogfeld Artefakttyp auswählen angezeigt. Weitere Informationen zu den verfügbaren Auswahlmöglichkeiten finden Sie unter Verwenden des Dialogfelds Artefakttyp auswählen.

Auswählen von Quell- und Zielnachrichten

Verwenden Sie diesen Teil des Dialogfelds Konfiguration transformieren , um die Zuordnung zu konfigurieren, die Sie im Abschnitt Neue/Vorhandene Kartendatei? ausgewählt haben. Wenn Sie in diesem Abschnitt Neue Karte ausgewählt haben, erstellen Sie diese Karte, indem Sie sie in diesem Abschnitt konfigurieren.

Wenn Sie Vorhandene Zuordnung ausgewählt haben, können Sie diesen Abschnitt verwenden, um eine von zwei Aktionen auszuführen:

• Sie können eine vorhandene Zuordnung auswählen und diese unverändert in der aktuellen Transformation verwenden.

• Sie können eine vorhandene Zuordnung auswählen, diese ändern (d. h. neu konfigurieren) und sie dann mit der neuen Konfiguration in der aktuellen Transformation verwenden.

  Geben Sie Quell- und Zielnachrichten mithilfe der Rastersteuerelemente Quell- und Zielnachrichten an. Mit diesen Rastersteuerelmenten können Sie die Zuordnungsdatei auf unterschiedliche Weise ändern. Wenn Sie eine Nachricht (eine Zeile in einem der Rastersteuerelemente) löschen, eine Nachricht hinzufügen oder eine Nachricht mit einem anderen Typ auswählen, ändert sich die Struktur der Zuordnung. In diesem Fall müssen auch alle anderen Transformationen, die diese Zuordnung verwenden, entsprechend der neuen Struktur der Zuordnung geändert werden. Sonstige Änderungen (z. B. das Entfernen einer Nachricht und Einfügen einer Nachricht vom gleichen Typ) haben keine Auswirkungen auf die Struktur der Zuordnung.

  Die Rastersteuerelemente Quellnachrichten und Zielnachrichten sind in Darstellung und Verhalten identisch. Jedes Rastersteuerelement verfügt über zwei Spalten: Message und Type. Zum Auffüllen der Rastersteuerelemente müssen Sie Nachrichten in der Spalte "Nachricht" auswählen. (Sie fügen nur in der Spalte "Nachricht" Daten hinzu, die Spalte "Typ" ist schreibgeschützt.) Die Zellen in der Spalte "Nachricht" verfügen über Dropdownlisten mit Nachrichteninstanzen, die im Gültigkeitsbereich der aktuellen Orchestrierung liegen.

  Sie können eine Zeile in beiden Rastersteuerelementen auswählen, indem Sie auf die Schaltfläche nach rechts (>) auf der linken Seite des Rastersteuerelements klicken. Eine markierte Zeile kann dann mit der Taste ENTF gelöscht werden. Durch Löschen einer Zeile (d. h. einer Nachricht) wird die Struktur der Zuordnungsdatei, die diese enthält, geändert. Sie können nur Zuordnungsdateien ändern, die lokal zum Projekt gehören.

Beim Klicken auf 'OK' startet BizTalk-Mapper

Wenn ich auf OK klicke, wird BizTalk Mapper automatisch geöffnet, wenn Sie auf OK klicken, um das Dialogfeld Konfiguration transformieren zu schließen und die Änderungen zu speichern. Sie können die Änderungen jedoch nur speichern, wenn keine erforderlichen Informationen fehlen. Schließen Sie in diesem Fall das Ausfüllen der Felder im Dialogfeld ab, und klicken Sie dann auf OK.

Weitere Informationen

Informationen zu Zuordnungen
Erstellen von Nachrichten
Verwenden von Ausdrücken zum dynamischen Transformieren von Nachrichten