Freigeben über


Info zu BizTalk-Nachrichtenkontexteigenschaften

Wenn ein Dokument von einem BizTalk Server-Adapter empfangen wird, erstellt der Adapter für das Dokument eine BizTalk-Nachricht. Die BizTalk-Nachricht enthält das empfangene Dokument und den Nachrichtenkontext. Der Nachrichtenkontext dient als Container für verschiedene Eigenschaften, die beim Verarbeiten des Dokuments von BizTalk Server verwendet werden. Jede Eigenschaft im Nachrichtenkontext besteht aus einem Namen, einem Namespace und einem Wert. Die folgende Nachrichtenkontexteigenschaft beschreibt die Austausch-ID für ein Dokument:

<Property Name="InterchangeID" Namespace="http://schemas.microsoft.com/BizTalk/2003/system-properties" Value="{AC07BF30-2F1A-42B0-8390-191EF38BA839}"/>  

Nachrichtenkontexteigenschaften werden dem Nachrichtenkontext während der gesamten Lebensdauer der Nachricht auf dem Weg durch BizTalk Server hinzugefügt.

Es gibt zwei Typen von Nachrichtenkontexteigenschaften, die von BizTalk verwendet werden:

Eigenschaftenfelder

Eigenschaftenfelder sind Nachrichtenkontexteigenschaften, die von der BizTalk-Messaging-Engine zum Dokumentenrouting, zur Nachrichtenüberwachung und zur Auswertung in Orchestrierungen verwendet werden. Sie können ein Feld in einem Dokument explizit in den Nachrichtenkontext als Eigenschaftsfeld erhöhen, indem Sie das Schema für das Dokument im BizTalk Server Schema-Editor bearbeiten, der in Visual Studio verfügbar ist. Um ein Feld in einem Dokument als Eigenschaftenfeld zum Nachrichtenkontext hinzuzufügen, muss dem Dokumentschema ein Eigenschaftsschema zugeordnet sein. Eigenschaftenfelder können maximal 255 Zeichen enthalten. Die IsPromoted-Eigenschaft von Property-Feldern im Nachrichtenkontext ist auf True festgelegt.

Distinguished Fields

Gekennzeichnete Felder sind Nachrichtenkontexteigenschaften, für die kein eigenes Eigenschaftsschema erforderlich ist und auf die der Zugriff nur aus Orchestrierungen möglich ist. Gekennzeichnete Felder können nicht zum Routing oder Überwachen verwendet werden. Da für gekennzeichnete Felder kein separates Eigenschaftsschema erforderlich ist, erzeugt die Orchestrierungs-Engine beim Auswerten von gekennzeichneten Feldern einen geringeren Overhead als beim Auswerten von Eigenschaftenfeldern. Für die Auswertung von Eigenschaftenfeldern ist eine XPath-Abfrage erforderlich. Für die Auswertung von gekennzeichneten Feldern ist dies nicht der Fall, da der Pipelinedisassembler die gekennzeichneten Felder im Kontext auffüllt und die Orchestrierungs-Engine die zwischengespeicherten Werte liest. Wenn jedoch die Orchestrierungs-Engine die Eigenschaft im Kontext nicht finden kann, wird die XPath-Abfrage initialisiert, um den Wert zu suchen. Gekennzeichnete Felder haben keine Größeneinschränkung. Die IsPromoted-Eigenschaft von Distinguished-Feldern im Nachrichtenkontext ist auf False festgelegt.

Zusammenfassung der Unterschiede zwischen Eigenschaftenfeldern und gekennzeichneten Feldern

In der nachfolgenden Tabelle finden Sie eine Zusammenfassung der Unterschiede und Übereinstimmungen zwischen Eigenschaftenfeldern und gekennzeichneten Feldern:

Attribut Eigenschaftenfeld Gekennzeichnetes Feld
Eigenschaft "IsPromoted" True False
Größenbeschränkung 255 Zeichen Keine Begrenzung
Für das Routing verwendet Ja Nein
Für die Überwachung verwendet Ja Nein
In Orchestrierungen verwendet Yes Yes
Eigenschaftsschema erforderlich Ja Nein
Zugriff durch Pipelines und Ports Ja Nein

Siehe auch

Möglichkeiten der Verwendung von Nachrichteninhalten zum Steuern der Nachrichtenverarbeitung