Die WS-Adressierungsheaderdaten können in die Baumstruktur der lokalen Umgebung gestellt werden, wo sie für einen Nachrichtenfluss sichtbar sind. Die WS-Adressierungsheaderdaten werden nur von den SOAP-Knoten verarbeitet.
Eingehende Informationen werden nur vom SOAP-Knoten in die lokale Umgebung gestellt, wenn die Adressierung auf dem Knoten festgelegt ist und Sie die Eigenschaft WS-Adressierungsheader in LocalEnviroment ablegen auf dem Knoten SOAPInput, SOAPAsyncResponse oder SOAPRequest auswählen.
In der folgenden Tabelle werden die knotenspezifischen WS-Adressierungsdaten in der Baumstruktur der lokalen Umgebung beschrieben.
Knoten | Füllt Eigenschaft der lokalen Umgebung |
---|---|
SOAPInput | LocalEnvironment.SOAP.Input.WSA.type |
SOAPAsyncResponse | LocalEnvironment.SOAP.Response.WSA.type |
SOAPRequest | LocalEnvironment.SOAP.Request.WSA.type |
Dabei steht type für die Struktur des Teilbereichs des XML-WS-Adressierungsschemas für die lokale Umgebung. Ausführliche Informationen dazu, wie type den WS-Adressierungseigenschaften, die durch die WS-Adressierungsspezifikation definiert sind, zugeordnet wird, finden Sie im Abschnitt Eigenschaft type der lokalen Umgebung dieses Themas.
Die Informationen in der lokalen Umgebung für eingehende Nachrichten dienen lediglich der Information. Wenn Sie die Adressierung auf dem Knoten festlegen und die Eigenschaft WS-Adressierungsheader in LocalEnviroment ablegen auf dem Knoten auswählen, stehen Ihnen WS-Adressierungsdaten zur Verfügung, die Sie aufrufen und in Ihrem Nachrichtenfluss verwenden können. Die WS-Adressierungseigenschaften werden nach der Verarbeitung durch den Knoten in die lokale Umgebung gestellt. Beachten Sie, dass der WS-Adressierungsordner und alle seine untergeordneten Elemente einem XMLNSC-Parser gehören, d. h. Sie können Elemente direkt in jede andere Baumstruktur kopieren, die einem XMLNSC-Parser gehört. Seien Sie sich jedoch bewusst, dass die Informationen in der Baumstruktur gelöscht werden, wenn Sie diesen Ordner (oder einen seiner untergeordneten Ordner) in eine Baumstruktur kopieren, die nicht einem XMLNSC-Parser gehört - es sei denn, Sie erstellen zuerst einen XMLNSC-Parser in der Zielbaumstruktur. Dieses Verhalten ist möglich, wenn Sie beispielsweise Daten aus der Baumstruktur InputLocalEnvironment in die Baumstruktur OutputLocalEnvironment kopieren.
Sie können abgehende WS-Adressierungsheaderdaten in die lokale Umgebung stellen. Dies ist jedoch nur erforderlich, wenn die automatisch vom Knoten generierten Standardwerte überschrieben werden sollen. Abgehende Adressierungsheader werden nur erstellt, wenn auf dem Knoten WS-Adressierung aktiviert ist.
In der folgenden Tabelle werden die knotenspezifischen WS-Adressierungsdaten in der Baumstruktur der lokalen Umgebung beschrieben, die zum Überschreiben der Standardwerte für abgehende Nachrichten verwendet werden können.
Knoten | Füllt Eigenschaft der lokalen Umgebung |
---|---|
SOAPReply | LocalEnvironment.Destination.SOAP.Reply.WSA.type |
SOAPRequest | LocalEnvironment.Destination.SOAP.Request.WSA.type |
SOAPAsyncRequest | LocalEnvironment.Destination.SOAP.Request.WSA.type |
Dabei steht type für die Struktur des Teilbereichs des XML-WS-Adressierungsschemas für die lokale Umgebung. Ausführliche Informationen dazu, wie type den WS-Adressierungseigenschaften, die durch die WS-Adressierungsspezifikation definiert sind, zugeordnet wird, finden Sie im Abschnitt Eigenschaft type der lokalen Umgebung dieses Themas.
Sie können Informationen in der lokalen Umgebung für abgehende Nachrichten ändern. Von den SOAPReply-, SOAPRequest- und SOAPAsyncRequest-Knoten werden standardmäßige Einstellungen in der lokalen Umgebung generiert, die Sie überschreiben können. Zu dieser Tabelle gibt es eine Ausnahme: Versuche, die WS-Adressierungsadresse ReplyTo auf dem SOAPAsyncRequest-Knoten zu überschreiben, werden ignoriert.
SET OutputRoot = InputRoot;
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.To.Address = 'jms:jndi:INPUTQ';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.ReplyTo.Address = 'jms:jndi:RESPONSEQ?jndiConnectionFactoryName=QCF&
jndiInitialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory&
jndiURL=file://C:/SOAPJNDIBindings';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.From.Address = 'jms:jndi:INPUTQ';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.FaultTo.Address = 'jms:jndi:RESPONSEQ?jndiConnectionFactoryName=QCF&
jndiInitialContextFactory=com.sun.jndi.fscontext.RefFSContextFactory&
jndiURL=file://C:/SOAPJNDIBindings';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.Action = 'http://WMB_BankImport/NewOperation';
SET OutputLocalEnvironment.Destination.SOAP.Request.WSA.MessageID = 'test:my:msg:ID:1234578';
Element | Entspricht dem abstrakten WS-Addressing-MAP-Namen |
---|---|
To | [destination endpoint] (Zielendpunkt) |
From | [source endpoint] (Quellenendpunkt) |
ReplyTo | [reply endpoint] (Antwortendpunkt) |
FaultTo | [fault endpoint] (Fehlerendpunkt) |
Action | [action] (Aktion) |
MessageId | [message id] (Nachrichten-ID) |
RelatesTo | [relationship] (Beziehung) |
ReferenceParameters | [reference parameters] (Referenzparameter) |
Version | Dieses Element ist keinem MAP zugehörig, wird aber zur Identifizierung der Version der WS-Adressierung verwendet. Die beiden Hauptversionen der WS-Adressierung heißen 'Submission' (Übergabe) und 'Final' (Endgültig). Standardmäßig wird von allen Knoten die Version 'Final' verwendet. Legen Sie dieses Element nur für abgehende Nachrichten fest, wenn Sie die Version 'Submission' verwenden möchten. Bei eingehenden Nachrichten wird dieses Element automatisch mit der Version der WS-Adressierungsheader belegt, die von der eingehenden Nachricht verwendet wird. |
Weitere Informationen zu den Eigenschaften der Nachrichtenadressierung, die durch die WS-Addressing-Spezifikation definiert werden, finden Sie im Abschnitt WS-Addressing.
Für abgehendes WS-Addressing können Sie eine zusätzliche lokale Umgebungseigenschaft festlegen.
Element | Beschreibung |
---|---|
AddMustUnderstandAttribute | Dieses Element stellt das SOAP-Attribut mustUnderstand vor dem Senden der Nachricht in alle WS-Addressing-Header. |