Verwenden von mehrteiligen Nachrichtentypen

Jede Nachricht verfügt über einen mehrteiligen Nachrichtentyp, eine Beschreibung der Struktur der Nachricht, die aus null oder mehr Nachrichtenteilen besteht. Diese Teile werden durch XSD-Sprachschemas (XML-Schemadefinition) oder .NET-Klassen definiert. Sie können eigene mehrteilige Nachrichtentypen definieren oder bestehende .NET-Klassen und -Schemas verwenden.

Sie können die Nachrichtenteile direkt innerhalb Ihrer Orchestrierung aufrufen oder zuweisen, oder Sie können einzelne Elemente von Nachrichtenteilen verwenden, die als gekennzeichnete Felder oder Eigenschaftsfelder zugänglich sind. Weitere Informationen finden Sie unter Using Distinguished Fields and Message Properties .For more information, see Using Distinguished Fields and Message Properties.

Hinweis

Ein mehrteiliger Nachrichtentyp muss nicht zwingend mehrere Teile enthalten.

Hinweis

Ein Nachrichtenteil kann durch den .NET-Typ XmlDocument definiert werden, der verwendet werden kann, um ein beliebiges XML-Dokument zu enthalten, durch jeden .NET-Typ, der XML-serialisierbar ist, oder durch einen beliebigen .NET-Typ, der benutzerdefinierte Serialisierung unterstützt.

Hinzufügen eines mehrteiligen Nachrichtentyps

1. Erweitern Sie im Fenster Orchestrierungsansicht den Knoten Typen .

2. Klicken Sie mit der rechten Maustaste auf Mehrteilige Nachrichtentypen , und klicken Sie dann auf Neuer mehrteiliger Nachrichtentyp.

   Der Ordner Mehrteilige Nachrichtentypen wird erweitert, wenn er reduziert ist, und ein neuer mehrteiliger Nachrichtentyp wird mit einem Standardnachrichtenteil hinzugefügt.

3. Benennen Sie den mehrteiligen Nachrichtentyp und den bereitgestellten Nachrichtenteil.

   Wenn ihr mehrteiliger Nachrichtentyp mehrere Nachrichtenteile erfordert, können Sie zusätzliche Teile hinzufügen, indem Sie dem <Neuen> Nachrichtenteil einen Namen zuweisen.

4. Ordnen Sie jedem Nachrichtenteil einen Typ zu, z. B. eine .NET-Klasse oder ein .NET-Schema.

Entfernen eines mehrteiligen Nachrichtentyps

• Klicken Sie im Fenster Orchestrierungsansicht mit der rechten Maustaste auf den mehrteiligen Nachrichtentyp, den Sie entfernen möchten, und klicken Sie dann auf Löschen.

  Hinweis

  Durch das Entfernen eines mehrteiligen Nachrichtentyps werden auch die Typinformationen aus den Nachrichten entfernt, für die er verwendet wird.

  Hinweis

  Elemente, die als schreibgeschützt angezeigt werden, sind in einer anderen Orchestrierung definiert.

Entfernen eines Teils aus einem mehrteiligen Nachrichtentyp

• Klicken Sie im Fenster Orchestrierungsansicht mit der rechten Maustaste auf den Zu entfernenden Teil, und klicken Sie auf Löschen.

  Hinweis

  Sie können den Nachrichtenteil eines Nachrichtentyps nicht löschen, wenn die Eigenschaft Nachrichtentextteil auf true festgelegt ist. Sie müssen zuerst die Eigenschaft Nachrichtentextteil für einen anderen Teil des Nachrichtentyps auf True festlegen.

Festlegen des Typmodifizierers für einen mehrteiligen Nachrichtentyp

• Legen Sie im Fenster Eigenschaften die folgende Eigenschaft fest:

  Eigenschaft	BESCHREIBUNG
  Typmodifizierer	Legt den Bereich des mehrteiligen Nachrichtentyps fest: - Privat –Der Zugriff auf diesen mehrteiligen Nachrichtentyp ist auf das enthaltende Modul beschränkt. - Öffentlich –Der Zugriff auf diesen mehrteiligen Nachrichtentyp ist nicht eingeschränkt. - Intern –Der Zugriff auf diesen mehrteiligen Nachrichtentyp ist auf Module innerhalb desselben Projekts beschränkt.

Hinzufügen von Teilen zu einer vorhandenen mehrteiligen Nachricht

• BizTalk Server ermöglicht das Hinzufügen von Teilen zu einer mehrteiligen XLANG-Nachricht und das Verweisen auf einen Nachrichtenteil durch einen Index, der größer als die ursprünglich deklarierte Anzahl von Teilen ist, wenn das Teil vorhanden ist. Diese Funktionalität kann für das Senden oder Empfangen von SMTP-Nachrichten mit einer variablen Anzahl von Anhängen nützlich sein. So implementieren Sie diese Funktion:

• Fügen Sie in Ihrem Projekt einen Verweis auf Microsoft.XLANGs.BaseTypes hinzu.

• Erstellen Sie eine Variable (z. B . xlangPart) vom Typ Microsoft.XLANGs.BaseTypes.XLANGMessage.

• Rufen Sie xlangPart auf. AddPart(...) mit den entsprechenden Argumenten aus einem Ausdrucks-Shape.

  Hinweis

  Die hinzugefügten Teile sind vom Typ XmlDocument , sodass Sie keinen benutzerdefinierten formatierten Nachrichtenteil mithilfe der AddPart()- Methode hinzufügen können.

Hinweis

Wenn eine mehrteilige Nachricht empfangen wird, die mehr als die Anzahl der deklarierten Teile enthält, liest die Orchestrierungs-Engine, wie viele Teile in der Nachricht vorhanden sind, erstellt dann die richtigen Teiletypen für die Teile, die der Anzahl der Teile im deklarierten Nachrichtentyp entsprechen, und erstellt dann XmlDocument-Teile für die verbleibenden Teile.

Weitere Informationen

IBaseMessage.AddPart-Methode (COM) in der Referenz zu benutzeroberflächenbasierten API-Namespaces für Entwickler
XSD-Ressourcen im Web
Verwenden von gekennzeichneten Feldern und Eigenschaftenfeldern
Verwenden von Nachrichten in Orchestrierungen