Übersicht
Mit dieser Action kann das Einfügen von Attachments direkt gesteuert werden. Dabei ist es möglich mehrere Attachments zu versenden. Die Attachments können dabei als Text aus einer Extension bzw. dem MessageContext geladen werden. Binäre Dateien wie pdf Dateien können nur aus dem MessageContext geladen werden. Beim Laden aus einer Extension muss diese ohne Provider und Version abgespeichert sein.
Technische Beschreibung
Klassenpfad: org.b2bbp.runtime.actions.internal.AddAttachmentsAction
Einrichtung
Die Action muss in der Administration wie in den folgenden Screenshots angelegt werden:
Konfigurationsmöglichkeiten
Action Properties:
| Name | Eigenschaft | Wert | Beschreibung |
| B3P_ATTACHMENT_EXTENSION oder B3P_ATTACHMENT_CONTEXT | required | Name der zu ladeneden Extension oder Variable im MessageContext. | Benennung des Ortes wo sich das Attachment befindet. B3P_ATTACHMENT_EXTENSION wird zum Laden aus der Extension und B3P_ATTACHMENT_CONTEXT zum Laden aus dem MessageContext verwendet. |
| B3P_OVERWRITE_ATTACHMENTS | optional | true / false (default) | Bei true wird eine neue Liste mit Attachments erzeugt. Evtl. bestehende Attachments im MessageContext werden gelöscht. Bei "False" wird an die bestehenden Attachments ein zusätzliches angehangen. |
| B3P_ATTACHMENT_NAME | required | Filenamen des Attachments. | Zum Beispiel: Invoic.xml |
| B3P_CONTENT_TYPE | recommended | Übersicht über mögliche MIME-Types | Gibt den Content-Type an. Zum Beispiel: application/xml oder text/xml |
| B3P_STOP_IF_EXTENSION_NOT_FOUND | optional | true (default) / false | Bei true, wird die Action gestoppt, wenn der Content nicht gesetzt oder gefunden wurde. |
| B3P_IS_BINARY_ATTACHMENT | optional | true / false (default) | Gibt an ob das Attachment eine binäre Datei ist. Wird zum Beispiel für PDF-Dokumente benötigt. |
| B3P_ENCODING | optional | Canonical Name for java.nio API / System Encoding (default) | Sollte ein Attachment ein gesondertes Encoding benötigen so kann dieses hier eingestellt werden. |
Beispiel
Es soll ein pdf Dokument und eine XML-Datei versendet werden. Alle zu versendeten Inhalte sind im Message Context enthalten. Hier wird empfohlen in der Channel Konfiguration wie folgt vorzugehen.
- org.b2bbp.runtime.actions.internal.OutboundMailHandler
- - Ohne Service Aufruf B3P_USED_SERVICE_ID
- - Um die volle Kontrolle über den Aufbau der Attachments zu erhalten B3P_IS_BINARY_MESSAGE = false setzen.
- - Am besten hier ausschließlich Absender, Empfänger etc. setzen
- org.b2bbp.runtime.actions.internal.AddAttachmentsAction für XML
- - B3P_ATTACHMENT_CONTEXT = XML_PAYLOAD
- - B3P_ATTACHMENT_NAME = payload.xml
- - B3P_CONTENT_TYPE = application/xml
- - B3P_OVERWRITE_ATTACHMENTS = true
- org.b2bbp.runtime.actions.internal.AddAttachmentsAction für 2. Attachment dem PDF mit abschließenden Aufruf eines MailOutboundServices
- - B3P_ATTACHMENT_CONTEXT = PDF_PAYLOAD
- - B3P_ATTACHMENT_NAME = dokument.pdf
- - B3P_CONTENT_TYPE = application/pdf
- - B3P_IS_BINARY_ATTACHMENT = true
- - B3P_USED_SERVICE_ID = 100