MAIL New attachment

Home

4D v20 R7

Mail

MAIL New attachment


MAIL New attachment ( value {; name {; cid {; type {; disposition}}}} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
value	Text, BLOB, Objekt	Object (4D.File, 4D.ZipFile, 4D.Blob), or Path of the attachment file (text), or Blob containing the attachment (BLOB)
name	Text	Name + extension used by the mail client to designate the attachment
cid	Text	ID of attachment (HTML messages only), or " " if no cid is required
type	Text	Value of the content-type header
disposition	Text	Value of the content-disposition header: "inline" or "attachment".
Funktionsergebnis	Objekt	Attachment object

Beschreibung

Mit dem Befehl MAIL New attachment können Sie ein Objekt Anhang erstellen, das sie an ein Objekt mail anfügen können (siehe transporter.send( )).

In value übergeben Sie den Inhalt des Anhangs. Sie können folgendes übergeben:

ein Objekt der Klasse 4D.File, 4D.ZipFile oder 4D.Blob,
value als Text mit dem Pfad der Anhangdatei, in der Syntax des Systems. Sie können den kompletten Pfadnamen übergeben oder den Dateinamen (dann sucht 4D nach der Datei im gleichen Verzeichnis wie die Strukturdatei der Anwendung).
value als BLOB mit dem Anhang selbst.

Im optionalen Parameter name können Sie Name und Endung angeben, die der Mail Client für den Anhang verwenden soll. Wird name weggelassen und ist:

value ein Dateipfad, werden Name und Endung der Datei verwendet,
value ein BLOB, wird automatisch ein wilkürlicher Name ohne Endung generiert.

Im optionalen Parameter cid können Sie eine interne ID für den Anhang übergeben. Das ist der Wert des Header content-id, er wird nur in HTML Meldungen verwendet. cid koppelt den Anhang mit einer Referenz, die über ein HTML Tag wie z.B. <img src="cid:ID"> im Hauptteil der Meldung definiert wird. In diesem Fall soll der Inhalt des Anhangs, z.B. ein Bild, innerhalb der Meldung im Mail Client angezeigt werden. Das Endergebnis kann je nach dem Mail Client unterschiedlich sein. Wollen Sie diesen Parameter nicht verwenden, können Sie in cid einen leeren String übergeben.

Im optionalen Parameter type können Sie explizit den Content-Typ der Anhangdatei übergeben: z.B. ein String, der einen MIME Typ ("video/mpeg") definiert. Dieser Wert des Content-Typs wird für den Anhang gesetzt, unabhängig von seiner Endung. Weitere Informationen dazu finden Sie auf der Seite MIME in Wikipedia.
Standardmäßig, also wenn dieser Parameter weggelassen wird oder einen leeren String enthält, basiert der Content-Typ der Anhangdatei auf deren Endung. Für die wichtigsten MIME Typen gelten folgende Regeln:

Endung	Content.Typ
jpg, jpeg	image/jpeg
png	image/png
gif	image/gif
pdf	application/pdf
doc	application/msword
xls	application/vnd.ms-excel
ppt	application/vnd.ms-powerpoint
zip	application/zip
gz	application/gzip
json	application/json
js	application/javascript
ps	application/postscript
xml	application/xml
htm, html	text/html
mp3	audio/mpeg
other	application/octet-stream

Im optionalen Parameter disposition können Sie den Header content-disposition des Anhangs angeben. Sie können eine der folgenden Konstanten unter dem Thema Mail übergeben:

Konstante	Wert	Kommentar
mail disposition attachment	attachment	Setzt den Wert des Content-disposition Header auf "attachment", d.h. die Datei als Anhang muss als Link in der Meldung erscheinen.
mail disposition inline	inline	Setzt den Wert des Content-disposition Header auf "inline", d.h. der Anhang muss im Inhalt der Meldung gerendert werden. Das Rendern richtet sich nach dem Mail Client.

Ohne den Parameter disposition gilt standardmäßig:

Mit dem Parameter cid wird der Header content-disposition auf "inline" gesetzt,
Ist der Parameter cid nicht übergeben oder leer, wird der Header content-disposition auf "attachment" gesetzt.