So konfigurieren Sie die Transform-Form

Form transformieren

Transformationen werden nur verwendet, wenn Sie Nachrichten erstellen, sodass das Transform-Shape immer in einem Shape "Nachricht konstruieren " angezeigt wird. Sie können das Shape " Nachricht konstruieren " auf der Entwurfsoberfläche ablegen und dann das Transform-Shape darin ablegen, oder Sie können das Transform-Shape einfach auf der Entwurfsoberfläche ablegen, und der Orchestrierungs-Designer erstellt das eingeschlossene Shape "Nachricht erstellen " für Sie.

Hinweis

Jede Quell- oder Zielnachricht in einer Transformation muss auf einem Schema basieren.

Prozedur

So konfigurieren Sie eine Transformationsform

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

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

Hinweis

Ein Transformations-Shape kann nur in einem Shape "Nachricht konstruieren " vorhanden sein. Wenn Sie eine Message Assignment-Form an eine andere Stelle auf der Entwurfsoberfläche ziehen, wird eine neue Construct Message-Form erstellt.

Wichtige Leistungsaspekte

BizTalk Server optimiert die Möglichkeit, 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 die Zuordnung/Transformation von viel größeren Dokumenten als bei früheren Versionen von BizTalk Server. Eine Einschränkung dieser Optimierung tritt auf, wenn eine Orchestrierung mehrere Eingaben und/oder Ausgaben zum Transformieren von Shapes akzeptiert.

Wenn eine Orchestrierung mehrere Eingaben und/oder Ausgaben für die Umwandlung von Datenstrukturen akzeptiert, wird das Dokumentstreaming nicht ausgeführt, was zu einem erheblich erhöhten Speicherverbrauch führt. Eine mögliche Problemumgehung für dieses Problem wäre das Anwenden der Transformation oder Transformationen in einer Empfangspipeline, sodass die Orchestrierung niemals mehr als eine einzelne Eingabe oder eine einzelne Ausgabe auf ein Transformations-Shape akzeptiert.

Neue/vorhandene Kartendatei?

In diesem Abschnitt können Sie entweder auf die Optionsschaltfläche "Neue Karte " oder auf die Optionsschaltfläche " Vorhandene Karte " klicken, um eine Karte auszuwählen, die dem Transformations-Shape zugewiesen werden soll.

Verwenden Sie das Feld "Name " unterhalb der ausgewählten Optionsschaltfläche, um eine Karte 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 er bereits mit einem eindeutigen Bezeichnernamen aufgefüllt wird, der auf dem Projektnamespace und dem Transform-Shape-Namen basiert: <Project-Namespace>.<Transformieren des Shape-Namens>_Map (z. B. MyProject.Transform3_Map).

Wenn Sie "Vorhandene Karte" ausgewählt haben, klicken Sie im Feld "Name " auf den Abwärtspfeil, um auszuwählen, welche Zuordnungsdatei verwendet werden soll. In diesem Listenfeld wird eine alphabetisch sortierte Liste aller im Projekt verfügbaren vorhandenen Karten angezeigt. Wenn Sie in dieser Liste auf den Text <"Aus referenzierter Assembly> auswählen" klicken, wird das Dialogfeld "Artefakttyp auswählen " angezeigt. Weitere Informationen zu den verfügbaren Auswahlmöglichkeiten finden Sie unter Verwenden des Dialogfelds "Artefakttyp auswählen".

Quell- und Zielnachrichten auswählen

Verwenden Sie diesen Abschnitt des Dialogfelds „Transformationskonfiguration“, um die Karte zu konfigurieren, die Sie im Abschnitt „Neue/Vorhandene Zuordnungsdatei?“ 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 Karte" ausgewählt haben, können Sie diesen Abschnitt verwenden, um eines von zwei Dingen zu erledigen:

• Wählen Sie eine vorhandene Karte aus, um as-is in der aktuellen Transformation wiederzuverwenden.

• Wählen Sie eine vorhandene Karte aus, um sie zu ändern (neu zu konfigurieren), und verwenden Sie sie dann in der neuen Konfiguration in der aktuellen Transformation.

  Geben Sie Quell- und Zielnachrichten mithilfe der Rastersteuerelemente " Quellnachrichten " und "Zielnachrichten " an. Sie können diese Rastersteuerelemente verwenden, um die Kartendatei auf verschiedene Arten zu ändern. Wenn Sie eine Nachricht löschen (eine Zeile in einem Rastersteuerelement), eine Nachricht hinzufügen oder eine Nachricht eines anderen Typs auswählen, ändern Sie die Struktur der Karte. Wenn Sie die Struktur einer Karte ändern, müssen alle anderen Transformationen, die sie verwenden, geändert werden, um der neuen Struktur der Karte zu entsprechen. Andere Änderungen, z. B. das Entfernen einer Nachricht und das Einfügen einer Nachricht am selben Typ, ändern nicht die Struktur der Karte.

  Die Rastersteuerelemente für Quellnachrichten und Zielnachrichten sind in Darstellung und Verhalten identisch. Jedes Rastersteuerelement verfügt über zwei Spalten: Nachricht und Typ. Sie füllen die Rastersteuerelemente, indem Sie Nachrichten in der Spalte "Nachricht" auswählen. (Sie fügen Daten nur in der Spalte "Nachricht" hinzu, da die Spalte "Typ" schreibgeschützt ist.) Die Zellen in der Spalte "Nachricht" enthalten Dropdownlisten, die mit Nachrichteninstanzen gefüllt sind, die sich innerhalb des Gültigkeitsbereichs für die aktuelle Orchestrierung befinden.

  Sie können eine Zeile in beiden Rastersteuerelementen auswählen, indem Sie auf die Schaltfläche mit dem Pfeil nach rechts (>) auf der linken Seite des Rastersteuerelements klicken. Nachdem Sie eine Zeile ausgewählt haben, können Sie sie löschen, indem Sie die ENTF-TASTE drücken. Beim Löschen einer Zeile (einer Nachricht) wird die Struktur der entsprechenden Mapping-Datei verändert. Sie können nur Kartendateien ändern, die lokal im Projekt gespeichert sind.

Wenn ich auf "OK" klicke, starten Sie den BizTalk Mapper

Wenn ich auf "OK" klicke, öffnet sich der BizTalk Mapper automatisch, wenn Sie auf "OK" klicken, um das Dialogfeld "Transformationskonfiguration" zu schließen und Ihre Änderungen zu speichern. Änderungen können jedoch nicht gespeichert werden, wenn erforderliche Informationen fehlen. Schließen Sie in diesem Fall das Ausfüllen der Felder im Dialogfeld ab, und klicken Sie dann auf "OK".

Siehe auch

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