Freigeben über


So verwenden Sie mehrteilige Nachrichtentypen

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

Sie können direkt in Ihrer Orchestrierung auf Nachrichtenteile zugreifen oder diese zuweisen, oder Sie können einzelne Elemente von Nachrichtenteilen verwenden, die als separate Felder oder Eigenschaftsfelder verfügbar gemacht werden. Weitere Informationen finden Sie unter Verwenden von Distinguished Fields and Message Properties.

Hinweis

Ein mehrteiliger Nachrichtentyp enthält nicht unbedingt mehrere Teile.

Hinweis

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

Hinzufügen eines mehrteiligen Nachrichtentyps

  1. Erweitern Sie in der 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 eingeklappt ist, und ein neuer mehrteiliger Nachrichtentyp mit einem Standardnachrichtenteil wird hinzugefügt.

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

    Wenn Ihr mehrteiliger Nachrichtentyp mehr als einen Nachrichtenteil erfordert, können Sie zusätzliche Teile hinzufügen, indem Sie dem <Teil "Neue> Nachricht" einen Namen zuweisen.

  4. Ordnen Sie jeden Nachrichtenteil einem Typ zu, z. B. einer .NET-Klasse oder einem 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

    Wenn Sie einen mehrteiligen Nachrichtentyp aus Ihrer Orchestrierung entfernen, werden auch die Typinformationen aus Nachrichten entfernt, die ihn verwenden.

    Hinweis

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

Entfernen eines Teils aus einem mehrteiligen Nachrichtentyp

  • Klicken Sie im Fenster " Orchestrierungsansicht " mit der rechten Maustaste auf den Teil, den Sie entfernen möchten, 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 " auf "True" für einen anderen Teil des Nachrichtentyps festlegen.

Festlegen des Typmodifizierers für einen mehrteiligen Nachrichtentyp

  • Legen Sie im Eigenschaftenfenster die folgende Eigenschaft fest:

    Eigentum BESCHREIBUNG
    Typmodifizierer Bestimmt den Umfang des mehrteiligen Nachrichtentyps:

    - Privat —Der Zugriff auf diesen mehrteiligen Nachrichtentyp ist auf das enthaltende Modul beschränkt.
    - Öffentlich —Der Zugriff auf diesen mehrteiligen Nachrichtentyp ist nicht beschrä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 bietet die Möglichkeit, Einer mehrteiligen XLANG-Nachricht Teile hinzuzufügen und auch auf einen Nachrichtenteil durch einen Index zu verweisen, der größer als die ursprünglich deklarierte Anzahl von Teilen ist, wenn der Teil vorhanden ist. Diese Funktion kann für das Senden oder Empfangen von SMTP-Nachrichten mit einer variablen Anzahl von Anlagen nützlich sein. Diese Funktionalität wird wie folgt implementiert:

  • 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.AddPart(…) unter Verwendung der entsprechenden Argumente aus einem Ausdrucks-Shape auf.

    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, die mehr als die Anzahl deklarierter Teile enthält, empfangen wird, liest das Orchestrierungsmodul, 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.

Siehe auch

IBaseMessage.AddPart-Methode (COM) in der UI-Anleitung und Entwickler-API-Namespacereferenz
XSD-Ressourcen im Web
Verwenden von Unterscheidungsmerkmalen und Eigenschaftsfeldern
Verwenden von Nachrichten in Orchestrierungen