Freigeben über

So verwenden Sie Nachrichtenkontexteigenschaften

Systemeigenschaften werden hauptsächlich intern von bizTalk Messaging Engine und deren Komponenten verwendet. Im Allgemeinen wird das Ändern der vom Modul für diese Eigenschaften festgelegten Werte nicht empfohlen, da sie sich auf die Ausführungslogik des Moduls auswirken kann. Es gibt jedoch eine große Anzahl von Eigenschaften, die Sie ändern können.

Die folgende Tabelle enthält eine Liste der Nachrichtenkontexteigenschaften, die die Messaging-Engine befördern kann. Sie können diese Eigenschaften zum Erstellen von Filterausdrücken für Sendeports und Orchestrierungen in Microsoft BizTalk Server verwenden. Beispiel:

PortName = MyMessage(BTS.ReceivePortName);  
MyFileName = MyMessage(FILE.ReceivedFileName);  
MySubject= MyMessage(POP3.Subject);

In einer separaten Tabelle sind zusätzliche Eigenschaften aufgeführt, die in einigen BizTalk-Anwendungen verwendet werden können, die nicht höhergestuft werden können.

Eigentum Wann und Wo es beworben wird Typ BESCHREIBUNG
BTS. AckFailureCategory Höhergestuft vom Messagingmodul vor dem Veröffentlichen einer Bestätigungsnachricht in der MessageBox-Datenbank. xs:int Identifiziert die ErrorCategory, die den Ort und Grund für die Aussetzung angibt.
BTS.AckFailureCode Vor dem Veröffentlichen einer Bestätigungsnachricht in die MessageBox-Datenbank wird dies von der Messaging-Engine gefördert. xs:string Identifiziert den ErrorCode, der den Ort und den Grund für die Sperrung angibt.
BTS AckID Bereitgestellt von der Messaging-Engine im Anschluss an die Veröffentlichung einer Bestätigungsnachricht in der MessageBox-Datenbank. xs:string Identifiziert die MessageID der ursprünglichen Nachricht.
BTS. AckInboundTransportLocation Von der Nachrichten-Engine verarbeitet, bevor eine Bestätigungsnachricht in die MessageBox-Datenbank veröffentlicht wird. xs:string Identifiziert den InboundTransportLocation aus der ursprünglichen Nachricht.
BTS. AckOutboundTransportLocation Initiert durch die Messaging-Engine vor dem Übermitteln einer Bestätigungsnachricht in die MessageBox. xs:string Identifiziert den OutboundTransportLocation aus der ursprünglichen Nachricht.
BTS.AckOwnerID Vor dem Veröffentlichen einer Bestätigungsnachricht in der MessageBox-Datenbank durch die Nachrichten-Engine gefördert. xs:string Identifiziert die Instanz-ID aus der ursprünglichen Nachricht.
BTS.AckReceivePortID Gefördert durch die Messaging-Engine vor dem Veröffentlichen einer Bestätigungsnachricht in der MessageBox-Datenbank. xs:string Identifiziert die ReceivePortID aus der ursprünglichen Nachricht.
BTS. AckReceivePortName Veranlasst durch die Messaging-Engine zur Bestätigungsnachricht. xs:string Identifiziert den ReceivePortName aus der ursprünglichen Nachricht.
BTS.AckSendPortID Vorbereitet von der Messaging-Engine, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. xs:string Identifiziert die SendPortID aus der ursprünglichen Nachricht.
BTS.AckSendPortName Höhergestuft vom Messagingmodul vor dem Veröffentlichen einer Bestätigungsnachricht in der MessageBox-Datenbank. xs:string Identifiziert den SendPortName aus der ursprünglichen Nachricht.
BTS.AckType Höhergestuft vom Messagingmodul vor dem Veröffentlichen einer Bestätigungsnachricht in der MessageBox-Datenbank. xs:string Ermöglicht die Überwachung von Bestätigungen und Nichtbestätigungen durch eine Orchestrierung. Der Wert ist ACK für eine Bestätigung und NACK für eine negative Bestätigung.
BTS.ActionOnFailure Diese Eigenschaft kann von einem Adapter vor dem Aufrufen der IBTTTransportBatch::SubmitMessage()-API festgelegt werden, um die Nachricht an BizTalk zu senden. xs:int Steuert das Verhalten des Messagingmoduls, wenn in der Empfangspipeline ein Fehler auftritt. In der Regel hält die Messaging-Engine fehlgeschlagene Nachrichten an; bestimmte Adapter (z. B. HTTP) melden den Fehler jedoch daher an den Client zurück, anstatt die Nachricht bei einem Fehler in der Empfangspipeline anzusetzen.

Gültige Werte:

-Vorgabe. Wenn die Eigenschaft nicht vorhanden ist, versucht die Messaging-Engine automatisch, die Nachricht auszusetzen.
- 0. Gibt an, dass das Messagingmodul das Modul nicht automatisch anhalten soll.

Andere Werte sind für die zukünftige Verwendung reserviert.
BTS. CorrelationToken Wenn diese Eigenschaft für den Nachrichtenkontext festgelegt ist, wird sie von der Nachrichten-Engine gefördert. Diese Eigenschaft wird implizit für einen Kontext festgelegt, wenn der Anforderungsantwortadapter oder eine Orchestrierung eine Anforderungsnachricht an die MessageBox-Datenbank sendet. xs:string Ermöglicht das Routing der Antwort an Anforderungsantwortports.
BTS. EpmRRCorrelationToken Gefördert von der Nachrichten-Engine bei der Ausführung von Nachrichten im Anforderungs-Antwort-Verfahren. Die Eigenschaft wird höhergestuft, bevor Nachrichten in die MessageBox-Datenbank übermittelt werden. xs:int Wird intern von der Messaging-Engine verwendet. Gibt den Servernamen, die Prozess-ID und eine eindeutige GUID für einen Anforderungsantwortdatenstrom von Nachrichten an.
BTS.InboundTransportLocation Von der Nachrichten-Engine initiiert, nachdem eine Nachricht von einem Empfangsadapter empfangen wurde und bevor sie in die MessageBox-Datenbank veröffentlicht wird. xs:string Gibt den Speicherort (URI) an, an dem die Nachricht vom Handler empfangen wurde.
BTS. InboundTransportType Von der Nachrichten-Engine initiiert, nachdem eine Nachricht von einem Empfangsadapter empfangen wurde und bevor sie in die MessageBox-Datenbank veröffentlicht wird. xs:string Gibt den Adaptertyp an, der diese Nachricht empfangen und an den Server übermittelt hat: FILE, HTTP usw.
BTS. InterchangeSequenceNumber Befördert durch die Messaging-Engine, nachdem eine Nachricht vom Empfangsadapter empfangen wurde und bevor sie in die MessageBox-Datenbank veröffentlicht wird. xs:int Gibt die Sequenznummer des Dokuments im Austausch an. Wenn das Dokument nicht Teil eines Austauschs ist, der in einzelne Dokumente zerlegt wurde, ist dieser Wert 1. Die Eigenschaft kann in einem Orchestrationsprozess, in einer Sendepipeline und einem Sendeadapter gelesen werden.
BTS.IsDynamicSend Diese Eigenschaft kann für den Nachrichtenkontext festgelegt werden. Sie wird nicht höhergestuft, und sie wird nur auf Sendevorgänge angewendet. xs:boolean Es wird von der Messaging Engine mit dem Wert "true" in den Nachrichtenkontext eingetragen, wenn sich der Sendevorgang auf einem dynamischen Sendeport befindet. Wenn Sie Eigenschaften für statische Sendeports in den Sendepipelines dynamisch festlegen möchten, müssen Sie diesen Wert auf "true" festlegen.
BTS. MessageDestination Diese Eigenschaft kann in der Empfangspipeline durch eine Demontagepipelinekomponente festgelegt werden, wenn sie eine Nachricht von GetNext() zurückgibt. xs:string Wird hauptsächlich zur Unterstützung der Wiederherstellbaren Austauschverarbeitung in Disassemblern verwendet, steuert diese Eigenschaft, ob eine Nachricht im Meldungsfeld veröffentlicht oder in der Anhaltewarteschlange angehalten wird. Wenn eine Pipeline auf eine fehlerhafte Nachricht in einem Austausch stößt und diese Nachricht aussetzen und die Verarbeitung fortsetzen möchte, kann sie dies tun, indem sie MessageDestination = SuspendQueue setzt. Die Nachricht wird dann zurückgegeben, wenn die Engine GetNext() im Disassembler aufruft.

Gültige Werte:

-Vorgabe. Wenn die Eigenschaft nicht vorhanden ist, wird die Nachricht als korrekt betrachtet und im Nachrichtenfeld veröffentlicht.
- SuspendQueue. Leitet die Nachrichten-Engine an, um die Nachricht auszusetzen. Anmerkung: Die angehaltene Nachricht ist die Post-Pipeline/Mapping-Nachricht und nicht die Nachricht, die vom Adapter übermittelt wird (d. h. die Wire Message).
BTS.MessageType Verursacht durch die Komponenten der Disassembler-Pipeline während der Nachrichtenanalyse. xs:string Gibt den Typ der Nachricht an. Der Nachrichtentyp wird als Verkettung des Dokumentschemanamespaces und des Dokumentstammknotens definiert: http://<MyNamespace>#<MyRoot>.
BTS. OutboundTransportLocation Wenn diese Eigenschaft im Nachrichtenkontext festgelegt ist, wird sie von der Messaging-Engine hervorgehoben. Diese Eigenschaft wird implizit für einen Nachrichtenkontext festgelegt, wenn eine Orchestrierung eine Nachricht an einen Sendeport sendet. Diese Eigenschaft kann auch explizit in einer Orchestrierung oder in einer Pipeline festgelegt werden. xs:string Gibt die Ziel-URI an, an die die Nachricht gesendet wird. Der URI kann das Adapterpräfix enthalten, z. B. http://. Das Adapterpräfix wird vom Messagingmodul verwendet, um den Typ des Adapters zu bestimmen, der beim Senden der Nachricht verwendet werden soll. Wenn sowohl das Adapterpräfix als auch die Eigenschaft BTS.OutboundTransportType festgelegt sind, hat der Adaptertyp von BTS.OutboundTransportType immer Vorrang vor dem Adaptertyp, der aus dem Präfix bestimmt wird.

Gültige Werte:

BizTalk Message Queuing: DIRECT=, PRIVATE=, and PUBLIC=

DATEI: file://

FTP: FTP://

HTTP: http:// und https://

SMTP: mailto:

SOAP: SOAP://

SQL: SQL://
BTS.OutboundTransportType Wenn diese Eigenschaft für den Nachrichtenkontext festgelegt ist, wird sie von der Nachrichten-Engine gefördert. Diese Eigenschaft wird implizit für einen Kontext festgelegt, wenn eine Orchestrierung eine Nachricht an einen Sendeport sendet. Diese Eigenschaft kann auch explizit in einer Orchestrierung oder in einer Pipeline festgelegt werden. xs:string Gibt den Typ des Adapters an, der zum Senden der Nachricht verwendet wird. Die verfügbaren Adaptertypen sind FILE, FTP, HTTP, SMTP, SOAP und SQL.

Bei den Werten, die für diese Eigenschaft festgelegt sind, sowie Adapterpräfixe, die in der Adresse angegeben sind, ist die Groß- und Kleinschreibung nicht relevant.
BTS.PropertiesToUpdate Ein Adapter legt diese Eigenschaft fest, wenn einige der Eigenschaftswerte für eine fehlgeschlagene Nachricht beibehalten werden müssen, die erneut übermittelt oder angehalten wird.

Dies bedeutet, dass beim erneuten Senden oder Fortsetzen der Nachricht die angegebenen Eigenschaften im Kontext festgelegt sind.		 xs:string Enthält eine XML-Zeichenfolge mit Elementen, die Eigenschaftsnamen, Namespaces und Werte darstellen.
BTS.ReceivePortID Weitergeleitet von der Messaging-Engine, nachdem es eine Nachricht von einem Empfangsadapter erhalten hat und bevor es in der MessageBox-Datenbank veröffentlicht wird. xs:int Gibt den Empfangsport an, an dem die Nachricht empfangen wurde.
BTS.ReceivePortName Von der Nachrichten-Engine initiiert, nachdem eine Nachricht von einem Empfangsadapter empfangen wurde und bevor sie in die MessageBox-Datenbank veröffentlicht wird. xs:string Benutzerfreundlicher Name des Empfangsports, auf dem die Nachricht empfangen wurde.
BTS.RouteDirectToTP Unterstützt von der Nachrichten-Engine für Nachrichten zur Schleifenrückführung oder Anforderungsantwortdurchführung. Die Eigenschaft wird höhergestuft, bevor Nachrichten in die MessageBox-Datenbank übermittelt werden. xs:boolean Wird intern vom Messagingmodul verwendet, um Loopback- und Anforderungsantwortszenarien zu aktivieren.
BTS.SPGroupID Ausgelöst von der Messaging-Engine, wenn die Nachricht von der Orchestrierung zu einem Sendeport gesendet wird. xs:string Gibt die ID der Sendeportgruppe an.
BTS. SPID Ausgelöst von der Messaging-Engine, wenn eine Nachricht von der Orchestrierung an einen Sendeport gesendet wird. xs:string Gibt die ID des Sendeports an.
BTS.SPName Generiert von der Messaging-Engine beim Veröffentlichen einer Antwortnachricht von einem Solicit-Response Send Port. xs:string Wird zum Abonnieren der Antwortnachrichten von einem Solicit-Response Sendeport verwendet. Der Wert ist der Name des Sendeports.
BTS.SPTransportBackupID Ausgelöst von der Messaging-Engine, wenn eine Nachricht von einer Orchestrierung an einen Sendeport gesendet wird. xs:string Gibt die ID des Sicherungsadapters im Sendeport an.
BTS.SPTransportID Ausgelöst vom Nachrichtensystem, wenn eine Nachricht von einer Orchestrierung an einen Sendeport weitergegeben wird. xs:string Gibt die ID des primären Adapters im Sendeport an.
BTS.SuspendAsNonResumable Diese Eigenschaft kann von einem Adapter vor dem Aufrufen von SubmitMessage() oder in einer Orchestrierung festgelegt werden, bevor eine Nachricht an einen Sendeport gesendet wird. Anmerkung: SubmitRequestMessage() ignoriert diese Eigenschaft; Bidirektionale Nachrichten werden immer als nicht resumierbar angehalten. xs:boolean Steuert, ob die Nachrichten-Engine eine Nachricht bei Nachrichtenfehler als nicht reaktivierbar aussetzen soll. Nachrichten werden in der Regel als fortsetzungsfähig angehalten, aber es gibt Fälle, in denen dies unangemessen ist – z. B. würde das Fortsetzen einer Nachricht für einen geordneten Sende- oder Empfangsport die Nachrichtenreihenfolge unterbrechen.

Gültige Werte:

-FALSCH. Die Nachricht wird pausiert und kann fortgesetzt werden, das ist die Standardeinstellung.
-STIMMT. Die Nachricht ist als nicht reaktivierbar unterbrochen.
BTS.SuspendMessageOnRoutingFailure Von der Nachrichten-Engine initiiert, nachdem eine Nachricht von einem Empfangsadapter empfangen wurde und bevor sie in die MessageBox-Datenbank veröffentlicht wird. xs:boolean Gibt das Verhalten an, wenn ein Routingfehler mit einer eingehenden Nachricht auftritt.

Gültige Werte:

- Standard / Falsch. Wenn die Eigenschaft nicht vorhanden ist oder auf False festgelegt ist, benachrichtigt das Modul den Adapter des Fehlers, wenn ein Routingfehler auftritt.
-STIMMT. Das Routingmodul hält die Nachricht automatisch an, wenn ein Routingfehler auftritt. Anmerkung: Die angehaltene Nachricht ist die Post-Pipeline/Mapping-Nachricht und nicht die Nachricht, die vom Adapter übermittelt wird (d. h. die Wire Message).

Es gibt eine Reihe anderer Eigenschaften in diesem Namespace, die Informationen enthalten, die für einige BizTalk-Anwendungen nützlich sein können.

Eigentum Wann und Wo es beworben wird Typ BESCHREIBUNG
BTS. AckDescription Wird vom Messagingmodul festgelegt, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. xs:string Identifiziert die Fehlerbeschreibung, die den Ort und den Grund für die Aussetzung angibt.
BTS. EncryptionCert Nicht förderbar. xs:int Gibt den Fingerabdruck an, der dem Verschlüsselungszertifikat entspricht. Legen Sie diese Eigenschaft in einer Orchestrierungs- oder benutzerdefinierten Pipelinekomponente fest, die vor der MIME/SMIME Encoder-Pipelinekomponente in einer Pipeline platziert wird, um die Antwortverschlüsselung für einen Anforderungsantwortport auszuführen, der eine signierte und verschlüsselte Nachricht empfängt.
BTS. InterchangeID Wird vom Messagingmodul für jede Nachricht festgelegt, die auf dem Server eintrifft. xs:string Definiert die eindeutige ID, die zum Gruppieren der Dokumente verwendet wird, die aus derselben Austauschnachricht resultierten.
BTS. Loopback Wird von einem Adapter festgelegt, wenn die Anforderungsmeldung zur Zurückschleifen-Ausführung übermittelt wird. xs:boolean Definiert, ob die Nachricht für eine Rückschleifenverarbeitung an den Server übermittelt werden soll. Bei der Rückschleifenausführung wird die Anforderungsnachricht in die MessageBox-Datenbank veröffentlicht, wo sie direkt zum Empfangsadapater als Antwort weitergeleitet wird.
BTS. SignatureCertificate Wird von einigen Adaptern festgelegt, wenn eine Nachricht an den Server übermittelt wird. Diese Eigenschaft wird von der Pipelinekomponente "Party Resolution" verwendet. xs:string Gibt den Fingerabdruck des Signaturzertifikats an, das zum Signieren der nachricht verwendet wurde, die von BizTalk Server empfangen wurde.
BTS. SourcePartyID Wird von der Pipelinekomponente für die Parteiauflösung festgelegt, nachdem die Partei für die eingehende Nachricht identifiziert wurde. xs:string Die ID der BizTalk-Partei.
BTS.SSOTicket Wenn der Empfangsadapter diese Eigenschaft unterstützt, wird sie beim Veröffentlichen der Nachricht auf einem Server festgelegt. xs:string Ein Ticket enthält die verschlüsselte Domäne und den Benutzernamen des aktuellen Benutzers sowie die Ablaufzeit des Tickets. Das Ticket wird von SSO-aktivierten Adaptern verwendet, um die Anmeldeinformationen für den Benutzer beim Authentifizieren mit Zielendpunkten abzurufen.
BTS.WindowsUser Wird von einigen Adaptern festgelegt, wenn eine Nachricht an den Server übermittelt wird. Diese Eigenschaft wird von der Pipelinekomponente "Party Resolution" verwendet. xs:string Gibt das Konto eines Benutzers an, in dessen Namen die Nachricht an den Server übermittelt wird.

Weitere Informationen zu Eigenschaften und Eigenschaftenschemas, die Pipelinekomponenten und Adaptern zugeordnet sind, finden Sie unter:

Siehe auch

Informationen zu BizTalk-Nachrichtenkontexteigenschaften
Wie man Ausdrücke verwendet, um Werte dynamischen Ports zuzuweisen