Verwenden der Nachrichtenkontexteigenschaften
Systemeigenschaften werden in der Regel intern von der BizTalk-Messaging-Engine und dessen Komponenten verwendet. Im Allgemeinen sollten Sie nicht die Werte ändern, die von der Engine für diese Eigenschaften festgelegt werden, da sich dies auf die Ausführungslogik der Engine auswirken kann. Es gibt jedoch zahlreiche Eigenschaften, die geändert werden können.
In folgender Tabelle sind die Nachrichtenkontexteigenschaften aufgeführt, die durch die Messaging-Engine höher gestuft werden können. 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 weiteren Tabelle sind zusätzliche Eigenschaften aufgeführt, die zwar möglicherweise von verschiedenen BizTalk-Anwendungen verwendet werden, jedoch nicht höher gestuft werden können.
| Eigenschaft | Wann und von welcher Komponente sie höher gestuft wird | Typ | BESCHREIBUNG |
|---|---|---|---|
| BTS.AckFailureCategory | Wird von der Messaging-Engine höher gestuft, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. | xs:int | Gibt die ErrorCategory an, die den Ort und den Grund für die Unterbrechung angibt. |
| BTS.AckFailureCode | Wird von der Messaging-Engine höher gestuft, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. | xs:string | Gibt den ErrorCode an, der den Ort und den Grund für die Ansetzung angibt. |
| BTS.AckID | Wird von der Messaging-Engine höher gestuft, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. | xs:string | Identifiziert die MessageID der ursprünglichen Nachricht. |
| BTS.AckInboundTransportLocation | Wird von der Messaging-Engine höher gestuft, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. | xs:string | Identifiziert den InboundTransportLocation aus der ursprünglichen Nachricht. |
| BTS.AckOutboundTransportLocation | Wird von der Messaging-Engine höher gestuft, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. | xs:string | Identifiziert den OutboundTransportLocation-Wert aus der ursprünglichen Nachricht. |
| BTS.AckOwnerID | Wird von der Messaging-Engine höher gestuft, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. | xs:string | Identifiziert die instance-ID der ursprünglichen Nachricht. |
| BTS.AckReceivePortID | Wird von der Messaging-Engine höher gestuft, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. | xs:string | Identifiziert die ReceivePortID aus der ursprünglichen Nachricht. |
| BTS.AckReceivePortName | Wird von der Messaging-Engine für die Bestätigungsnachricht höher gestuft. | xs:string | Identifiziert den ReceivePortName aus der ursprünglichen Nachricht. |
| BTS.AckSendPortID | Wird von der Messaging-Engine höher gestuft, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. | xs:string | Identifiziert die SendPortID aus der ursprünglichen Nachricht. |
| BTS.AckSendPortName | Wird von der Messaging-Engine höher gestuft, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. | xs:string | Identifiziert den SendPortName aus der ursprünglichen Nachricht. |
| BTS.AckType | Wird von der Messaging-Engine höher gestuft, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. | 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 durch einen Adapter festgelegt werden, bevor die IBTTTransportBatch::SubmitMessage()-API zur Übermittlung der Nachricht an BizTalk aufgerufen wird. | xs:int | Steuert das Verhalten der Messaging-Engine, wenn ein Fehler in der Empfangspipeline auftritt. Üblicherweise werden fehlerhafte Nachrichten von der Messaging-Engine angehalten. Bestimmte Adapter (wie z. B. HTTP) melden den Fehler jedoch zurück an den Client, anstatt die Nachricht bei einem Fehler der Empfangspipeline anzuhalten. Gültige Werte: - Default. Wenn die Eigenschaft nicht schon vorhanden ist, versucht die Messaging-Engine automatisch, die Nachricht anzuhalten. - 0. Zeigt an, dass die Engine nicht automatisch von der Messaging-Engine angehalten werden sollte. Andere Werte sind für die zukünftige Verwendung reserviert. |
| BTS.CorrelationToken | Wenn diese Eigenschaft auf den Nachrichtenkontext festgelegt ist, wird sie von der Messaging-Engine höher gestuft. Diese Eigenschaft ist implizit auf einen Kontext festgelegt, wenn der Anforderungsantwortadapter oder eine Orchestrierung eine Anforderungsnachricht an die MessageBox-Datenbank übermittelt. | xs:string | Aktiviert das Routing von Antworten an Ports vom Typ "Anforderungsantwort" |
| BTS.EpmRRCorrelationToken | Wird von der Messaging-Engine zur Ausführung von Anforderungsantwortnachrichten höher gestuft. Die Eigenschaft wird höher gestuft, bevor Nachrichten an die MessageBox-Datenbank übermittelt werden. | xs:int | Interne Verwendung durch Messaging-Engine. Gibt den Servernamen, die Prozess-ID und eine eindeutige GUID für einen Nachrichtenstream vom Typ Anforderungsantwort an. |
| BTS.InboundTransportLocation | Höhergestuft von der Messaging-Engine nach dem Empfang einer Nachricht von einem Empfangsadapter und vor der Veröffentlichung in der MessageBox-Datenbank. | xs:string | Legt den Speicherort (URI) fest, an dem die Nachricht vom Handler empfangen wurde. |
| BTS.InboundTransportType | Höhergestuft von der Messaging-Engine nach dem Empfang einer Nachricht von einem Empfangsadapter und vor der Veröffentlichung in der MessageBox-Datenbank. | xs:string | Gibt den Adaptertyp an, der diese Nachricht empfangen und an den Server übermittelt hat: FILE, HTTP usw. |
| BTS.InterchangeSequenceNumber | Wird von der Messaging-Engine höher gestuft, nachdem eine Nachricht vom Empfangsadapter empfangen wurde und bevor sie in der MessageBox-Datenbank veröffentlicht wird. | xs:int | Gibt die Sequenznummer des an dem Austausch beteiligten Dokuments an. Wenn das Dokument nicht Teil eines Austauschs ist, der in einzelne Dokumente zerlegt wurde, ist dieser Wert 1. Die -Eigenschaft kann in einer Orchestrierung, einer Sendepipeline und einem Sendeadapter gelesen werden. |
| BTS.IsDynamicSend | Diese Eigenschaft kann im Nachrichtenkontext festgelegt werden, Sie wird nicht höher gestuft und gilt nur für Sendevorgänge. | xs:boolean | Wenn der Sendevorgang über einen dynamischen Sendeport ausgeführt wird, schreibt die Messaging-Engine diese Eigenschaft mit dem Wert WAHR in den Nachrichtenkontext. Wenn Eigenschaften für statische Sendports in den Sendepipelines dynamisch festgelegt werden sollen, müssen Sie diesen Wert auf WAHR festlegen. |
| BTS.MessageDestination | Diese Eigenschaft kann von einer Disassembler-Pipelinekomponente in der Empfangspipeline festgelegt werden, wenn sie aus GetNext() eine Nachricht zurückgibt. | xs:string | Diese Eigenschaft wird primär zur Unterstützung wiederherstellbarer Austauschverarbeitung in Disassemblern verwendet und legt fest, ob eine Nachricht in der MessageBox veröffentlicht oder in einer Warteschlange angehalten wird. Wenn eine Pipeline eine fehlerhafte Nachricht in einem Austausch entdeckt und die Nachricht angehalten und die Verarbeitung fortgesetzt werden soll, muss sie die MessageDestination = SuspendQueue festlegen und die Nachricht zurückgeben, wenn die Engine GetNext() auf dem Disassembler aufruft. Gültige Werte: - Default. Wenn die Eigenschaft nicht vorhanden ist, wird die Nachricht als nicht fehlerhaft eingestuft und in der MessageBox veröffentlicht. - SuspendQueue. Gibt der Messaging-Engine die Anweisung, die Nachricht anzuhalten. Hinweis: Die angehaltene Nachricht ist die Postpipeline-/Zuordnungsnachricht und nicht die vom Adapter übermittelte Nachricht (d. h. die Drahtnachricht). |
| BTS.MessageType | Wird während der Nachrichtenverarbeitung von den Disassembler-Pipelinekomponenten höher gestuft. | xs:string | Gibt den Nachrichtentyp an. Der Nachrichtentyp ist als Verkettung von Dokumentschemanamespace und Dokumentstammknoten definiert: http://<MyNamespace>#<MyRoot>. |
| BTS.OutboundTransportLocation | Wenn diese Eigenschaft auf den Nachrichtenkontext festgelegt ist, wird sie von der Messaging-Engine höher gestuft. Diese Eigenschaft wird implizit in einem 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 den Zielspeicherort (URI) an, an den die Nachricht gesendet wird. Der URI kann das Adapterpräfix enthalten, z. B. http://. Die Messaging-Engine verwendet das Adapterpräfix, um den Adaptertyp festzulegen, der die Nachricht sendet. Wenn sowohl das Adapterpräfix als auch das BTS. Die OutboundTransportType-Eigenschaft ist festgelegt, der Adaptertyp von BTS. OutboundTransportType hat immer Vorrang vor dem aus dem Präfix ermittelten Adaptertyp. Gültige Werte: BizTalk Message Queuing: DIRECT=, PRIVATE=und PUBLIC= DATEI: file:// FTP: FTP:// HTTP: http:// und https:// SMTP: mailto: SOAP: SOAP:// SQL: SQL:// |
| BTS.OutboundTransportType | Wenn diese Eigenschaft auf den Nachrichtenkontext festgelegt ist, wird sie von der Messaging-Engine höher gestuft. Diese Eigenschaft wird implizit in einem 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 Adaptertyp an, der die Nachricht sendet. Die verfügbaren Adaptertypen sind FILE, FTP, HTTP, SMTP, SOAP und SQL. Bei den in dieser Eigenschaft festgelegten Werten und bei Adapterpräfixen, die in der Adresse festgelegt sind, wird die Groß- und Kleinschreibung nicht berücksichtigt. |
| BTS.PropertiesToUpdate | Ein Adapter legt diese Eigenschaft fest, wenn einige Eigenschaftswerte einer fehlerhaften Nachricht beibehalten werden müssen, die erneut gesendet und angehalten wird. Das bedeutet, dass die spezifischen Eigenschaften bei der erneuten Übermittlung oder Fortsetzung der Nachricht im Kontext festgelegt werden. |
xs:string | Enthält eine XML-Zeichenfolge mit Elementen, die die Eigenschaftsnamen, -namespaces und -werte darstellen. |
| BTS.ReceivePortID | Wird von der Messaging-Engine nach dem Empfang einer Nachricht von einem Empfangsadapter und vor der Veröffentlichung in der MessageBox-Datenbank heraufgestuft. | xs:int | Identifiziert den Empfangsport, an dem die Nachricht empfangen wurde. |
| BTS.ReceivePortName | Wird von der Messaging-Engine nach dem Empfang einer Nachricht von einem Empfangsadapter und vor der Veröffentlichung in der MessageBox-Datenbank heraufgestuft. | xs:string | Benutzerfreundlicher Name des Empfangsports, an dem die Nachricht empfangen wurde. |
| BTS.RouteDirectToTP | Wird von der Messaging-Engine bei Nachrichten für Loopback- oder Anforderungsantwort-Ausführung höher gestuft. Die Eigenschaft wird höher gestuft, bevor Nachrichten an die MessageBox-Datenbank übermittelt werden. | xs:boolean | Wird von der Messaging-Engine zur Aktivierung von Loopback- und Anforderungsantwort-Szenarien intern verwendet. |
| BTS.SPGroupID | Wird von der Messaging-Engine höher gestuft, wenn die Nachricht von der Orchestrierung an einen Sendeport gesendet wird. | xs:string | Gibt die ID der Sendeportgruppe an. |
| BTS.SPID | Wird von der Messaging-Engine höher gestuft, wenn eine Nachricht von der Orchestrierung an einen Sendeport gesendet wird. | xs:string | Gibt die ID des Sendeports an. |
| BTS.SPName | Wird von der Messaging-Engine höher gestuft, wenn eine Antwortnachricht von einem Sendeport vom Typ „Antwort anfragen“ veröffentlicht wird. | xs:string | Dient zum Abonnieren der Antwortnachrichten von einem Sendeport vom Typ „Antwort anfragen“. Der Wert entspricht dem Namen des Sendeports. |
| BTS.SPTransportBackupID | Wird von der Messaging-Engine höher gestuft, wenn eine Nachricht von einer Orchestrierung an einen Sendeport gesendet wird. | xs:string | Gibt die ID des Sicherungsadapters im Sendeport an. |
| BTS.SPTransportID | Wird von der Messaging-Engine höher gestuft, wenn eine Nachricht von einer Orchestrierung an einen Sendeport gesendet wird. | xs:string | Gibt die ID des primären Adapters im Sendeport an. |
| BTS.SuspendAsNonResumable | Diese Eigenschaft kann von einem Adapter vor dem Aufruf von SubmitMessage() oder in einer Orchestrierung vor dem Senden einer Nachricht an einen Sendeport festgelegt werden. Hinweis: SubmitRequestMessage() ignoriert diese Eigenschaft; Bidirektionale Nachrichten werden immer als nicht fortsetzbar angehalten. | xs:boolean | Legt fest, ob die Messaging-Engine eine Nachricht bei einem Fehler als nicht fortsetzbar anhalten soll. Üblicherweise werden Nachrichten als fortsetzbar angehalten. In bestimmten Fällen ist dies jedoch nicht akzeptabel. Beispielsweise würde das Fortsetzen einer Nachricht bei geordneten Sende- oder Empfangsports die Nachrichtenreihenfolge nicht einhalten. Gültige Werte: -FALSE. Nachricht wird als fortsetzbar angehalten (Standardeinstellung). -STIMMT. Nachricht wird als nicht fortsetzbar angehalten. |
| BTS.SuspendMessageOnRoutingFailure | Wird von der Messaging-Engine nach dem Empfang einer Nachricht von einem Empfangsadapter und vor der Veröffentlichung in der MessageBox-Datenbank heraufgestuft. | xs:boolean | Legt das Verhalten bei Auftreten eines Routingfehlers in einer eingehenden Nachricht fest. Gültige Werte: - Default / False. Wenn die Eigenschaft nicht vorhanden oder auf Falsch festgelegt wurde, wird der Adapter beim Auftreten eines Routingfehlers von der Engine benachrichtigt. -STIMMT. Die Routing-Engine hält die Nachricht automatisch an, wenn ein Routingfehler auftritt. Hinweis: Die angehaltene Nachricht ist die Postpipeline-/Zuordnungsnachricht und nicht die vom Adapter übermittelte Nachricht (d. h. die Drahtnachricht). |
In diesem Namespace sind einige andere Eigenschaften vorhanden, die möglicherweise nützliche Informationen für einige BizTalk-Anwendungen enthalten.
| Eigenschaft | Wann und von welcher Komponente sie höher gestuft wird | Typ | BESCHREIBUNG |
|---|---|---|---|
| BTS.AckDescription | Wird von der Messaging-Engine festgelegt, bevor eine Bestätigungsnachricht in der MessageBox-Datenbank veröffentlicht wird. | xs:string | Gibt die ErrorDescription an, die den Ort und den Grund für die Unterbrechung angibt. |
| BTS.EncryptionCert | Nicht heraufstufbar. | xs:int | Identifiziert den Fingerabdruck, der dem Verschlüsselungszertifikat zugeordnet ist. Legen Sie diese Eigenschaft in einer Orchestrierung oder in einer benutzerdefinierten Pipelinekomponente fest, die in einer Pipeline vor der Pipelinekomponente des MIME/SMIME-Encoders steht, um auf einem Port vom Typ "Anforderungsantwort", der signierte und verschlüsselte Nachrichten empfängt, Antworten zu verschlüsseln. |
| BTS.InterchangeID | Wird von der Messaging-Engine für jede auf dem Server eingegangene Nachricht festgelegt. | xs:string | Legt die eindeutige ID fest, mit der die aus derselben Austauschnachricht resultierenden Dokumente gruppiert werden. |
| BTS.Loopback | Wird beim Übermitteln einer Anforderungsnachricht für die Loopback-Ausführung von einem Adapter festgelegt. | xs:boolean | Legt fest, ob die Nachricht an den Server übermittelt werden soll, um einen Loopback auszuführen. Bei der Loopback-Ausführung wird die Anforderungsnachricht in der MessageBox-Datenbank veröffentlicht, die sie direkt als Antwort an den Empfangsadapter weiterleitet. |
| BTS.SignatureCertificate | Wird beim Übermitteln der Nachricht an den Server von einigen Adaptern festgelegt. Diese Eigenschaft wird von der Pipelinekomponente zum Auflösen der Partei verwendet. | xs:string | Identifiziert den Fingerabdruck des Signaturzertifikats, das zum Signieren der von BizTalk Server empfangenen Nachricht verwendet wurde. |
| BTS.SourcePartyID | Wird von der Pipelinekomponente zum Auflösen der Partei festgelegt, nachdem für die eingehende Nachricht die Partei identifiziert wurde. | xs:string | Die ID der BizTalk-Partei. |
| BTS.SSOTicket | Wird beim Veröffentlichen der Nachricht auf einem Server festgelegt, wenn der Empfangsadapter diese Eigenschaft unterstützt. | xs:string | Ein Ticket enthält die verschlüsselte Domäne und den verschlüsselten Benutzernamen des aktuellen Benutzers sowie das Tickettimeout. Das Ticket wird von SSO-fähigen Adaptern verwendet, um die Anmeldeinformationen des Benutzers bei der Authentifizierung mit Zielendpunkten abzurufen. |
| BTS.WindowsUser | Wird beim Übermitteln der Nachricht an den Server von einigen Adaptern festgelegt. Diese Eigenschaft wird von der Pipelinekomponente zum Auflösen der Partei verwendet. | xs:string | Legt das Konto eines Benutzers fest, für den die Nachricht an den Server übermittelt wird. |
Weitere Informationen zu Eigenschaften und Eigenschaftsschemas, die Pipelinekomponenten und Adaptern zugeordnet sind, finden Sie in folgenden Themen:
Weitere Informationen
Info zu BizTalk-Nachrichtenkontexteigenschaften
Verwenden von Ausdrücken zum Zuweisen von Werten an dynamische Ports