Attachments 

Verwendung

Ein Attachment besteht aus beliebigen Daten (zum Beispiel Text, Grafiken), die an eine Message angehängt werden können. Im Prinzip können Sie beliebig viele Attachments an eine Output-Message eines Client- oder Server-Proxy (im synchronen Fall) über das MessageSpecifier-Objekt anhängen.

Beachten Sie, dass nicht alle Empfänger einer Message Attachments verstehen können und daher gegebenenfalls ignorieren. Die Proxy-Laufzeit (ABAP/Java) kann Attachments verarbeiten, die meisten Adapter wiederum nicht.

Funktionsumfang

Ein Attachment-Objekt kann über Methoden des MessageSpecifier-Interface erzeugt werden. Attachment-Objekte sind Instanzen der Klasse MessageAttachment mit dem vollqualifizierenden Namen com.sap.aii.proxy.xiruntime.core.MessageAttachment.

Aktivitäten

·      Um Attachments zu erzeugen und an die Output-Message zu hängen, greifen Sie vor dem Proxy-Aufruf auf das MessageSpecifier-Interface zu. Mit dessen Methode createAttachment() können Sie Attachment-Objekte erzeugen und danach mit der Methode addAttachment() an das Proxy-Objekt hängen, bevor die Message versendet wird.

·      Um Attachments beim Empfänger abzufragen, holen Sie sich das MessageSpecifier-Interface und fragen die Attachments mit der Methode getAttachment() beziehungsweise getAttachments() ab.

Achten Sie bei synchroner Kommunikation darauf, dass empfangene Attachments an den Sender zurückgeschickt werden, wenn sie nicht gelöscht werden. Ist dies nicht erwünscht, können Sie einzelne Attachments mit der Methode removeAttachment() oder alle mit der Methode clearAttachments() löschen.