MailAttachment

Les objets pièces jointes permettent de référencer des fichiers dans un objet Email. Les objets Attachment (pièce jointe) sont créés à l'aide de la commande MAIL New attachment.

Objet Attachment

Les objets Attachment fournissent les propriétés et fonctions suivantes en lecture seule :

.cid : Text     ID de la pièce jointe
.disposition : Text    la valeur de l'en-tête Content-Disposition
.getContent() : 4D.Blob    renvoie le contenu de l'objet pièce jointe dans un objet 4D.Blob
.name : Text    le nom et l'extension de la pièce jointe
.path : Text    le chemin POSIX du fichier joint, s'il existe
.platformPath : Text    le chemin du fichier joint exprimé avec la syntaxe de la plate-forme courante
.size : Integer    la valeur de l'en-tête size du fichier joint
.type : Texte    le content-type du fichier joint

MAIL New attachment

Historique

Release	Modifications
19 R2	Accepte 4D.File, 4D.ZipFile, 4D.Blob

MAIL New attachment( file : 4D.File { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment
MAIL New attachment( zipFile : 4D.ZipFile { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment
MAIL New attachment( blob : 4D.Blob { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment
MAIL New attachment( path : Text { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment

Paramètres	Type		Description
file	4D.File	->	Fichier joint
zipFile	4D.ZipFile	->	Fichier Zip joint
blob	4D.Blob	->	Blob contenant la pièce jointe
path	Text	->	Chemin de la pièce jointe
name	Text	->	Nom + extension utilisés par le client de messagerie pour désigner la pièce jointe
cid	Text	->	ID de la pièce jointe (messages HTML uniquement) ou " " si aucun cid n'est requis
type	Text	->	Valeur de l'en-tête content-type
disposition	Text	->	Valeur de l'en-tête content-disposition : "inline" ou "attachment"
Résultat	4D.MailAttachment	<-	Objet pièce jointe

|

Description

La commande MAIL New attachment vous permet de créer un objet de type pièce jointe (attachment) que vous pouvez ajouter à un objet Email.

Pour définir l'objet attachment, vous pouvez utiliser :

• un file, en passant un objet 4D.File contenant le fichier joint.
• un zipfile, en passant un objet 4D.ZipFile contenant le fichier joint.
• un blob, en passant un objet 4D.Blob contenant la pièce jointe elle-même.
• un path, en passant une valeur de type text contenant le chemin d'accès du fichier joint, exprimé avec la syntaxe du système. Vous pouvez passer un nom de chemin complet ou un simple nom de fichier (auquel cas 4D recherchera le fichier dans le même répertoire que le fichier du projet).

Le paramètre facultatif name vous permet de passer le nom et l'extension à utiliser par le client de messagerie pour désigner la pièce jointe. Si le paramètre name est omis et que :

• vous avez passé un chemin d'accès au fichier, le nom et l'extension du fichier sont utilisés,
• vous avez passé un BLOB, un nom aléatoire sans extension est automatiquement généré.

Le paramètre facultatif cid vous permet de passer un ID interne pour la pièce jointe. Cet ID est la valeur de l'en-tête Content-Id et sera utilisé dans les messages HTML uniquement. Le cid associe la pièce jointe à une référence définie dans le corps du message à l'aide d'une balise HTML telle que \<img src="cid:ID">. Cela signifie que le contenu de la pièce jointe (par exemple, une image) doit être affiché dans le message sur le client de messagerie. Le résultat final peut varier en fonction du client de messagerie. Vous pouvez passer une chaîne vide dans cid si vous ne souhaitez pas utiliser ce paramètre.

Vous pouvez utiliser le paramètre optionnel type pour définir explicitement le content-type du fichier joint. Par exemple, vous pouvez passer une chaîne définissant un type MIME ("video/mpeg"). Cette valeur de content-type sera définie pour la pièce jointe, quelle que soit son extension. Pour plus d'informations sur les types MIME, veuillez vous référer à la page type MIME sur Wikipedia.

Par défaut, si le paramètre type est omis ou contient une chaîne vide, le content-type du fichier joint est basé sur son extension. Les règles suivantes sont appliquées pour les principaux types MIME :

Extension	Content Type
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

Le paramètre facultatif disposition vous permet de passer l'en-tête content-disposition de la pièce jointe. Vous pouvez passer l'une des constantes suivantes du thème de constantes "Mail" :

Constante	Valeur	Commentaire
mail disposition attachment	"attachment"	Définissez la valeur de l'en-tête Content-disposition sur "attachment", ce qui signifie que le fichier joint doit être fourni sous forme de lien dans le message.
mail disposition inline	"inline"	Définissez la valeur de l'en-tête Content-disposition sur "inline", ce qui signifie que la pièce jointe doit être rendue dans le contenu du message, à l'emplacement du "cid". Le rendu dépend du client de messagerie.

Par défaut, si le paramètre disposition est omis :

• si le paramètre cid est utilisé, l'en-tête Content-disposition est défini sur "inline",
• si le paramètre cid n'est pas passé ou est vide, l'en-tête Content-disposition est fixé à "attachment".

Exemple 1

Vous souhaitez envoyer un e-mail avec un fichier sélectionné par l'utilisateur comme pièce jointe et une image intégrée dans le corps HTML :

$doc:=Select document("";"*";"Please select a file to attach";0)
If (OK=1) //If a document was selected

C_OBJECT($email;$server;$transporter)

$server:=New object
$server.host:="smtp.mail.com"
$server.user:="test_user@mail.com"
$server.password:="p@ssw@rd"
$transporter:=SMTP New transporter($server)

$email:=New object
$email.from:="test_user@mail.com"
$email.to:="test_user@mail.com"
$email.subject:="This is a test message with attachments"

//add a link to download file
$email.attachments:=New collection(MAIL New attachment(Document))
//insert an inline picture (use a cid)
$email.attachments[1]:=MAIL New attachment("c:\\Pictures\\4D.jpg";"";"4D")

$email.htmlBody:="<html>"+\
"<body>Hello World!"+\
"<img src='cid:4D' >"+\
"</body>"+\
"</head>"+\
"</html>"

$transporter.send($email) //envoyer e-mail

End if

Exemple 2

Vous voulez envoyer un e-mail avec une zone 4D Write Pro en pièce jointe :

C_BLOB($blob)
WP EXPORT VARIABLE(WPArea;$blob;wk docx)

C_OBJECT($email;$server;$transporter)

$server:=New object
$server.host:="smtp.mail.com"
$server.user:="user@mail.com"
$server.password:="p@ssw@rd"
$transporter:=SMTP New transporter($server)

$email:=New object
$email.from:="user@mail.com"
$email.to:="customer@mail.com"
$email.subject:="New annual report"
$email.textBody:="Please find enclosed our latest annual report."
$email.attachments:=New collection(MAIL New attachment($blob;"Annual report.docx"))

$transporter.send($email)

4D.MailAttachment.new()

Historique

Release	Modifications
19 R2	Accepte 4D.File, 4D.ZipFile, 4D.Blob

4D.MailAttachment.new( file : 4D.File { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment
4D.MailAttachment.new( zipFile : 4D.ZipFile { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment
4D.MailAttachment.new( blob : 4D.Blob { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment
4D.MailAttachment.new( path : Text { ; name : Text {; cid : Text{ ; type : Text { ; disposition :Text } } } } ) : 4D.MailAttachment

Paramètres	Type		Description
file	4D.File	->	Fichier joint
zipFile	4D.ZipFile	->	Fichier Zip joint
blob	4D.Blob	->	Blob contenant la pièce jointe
path	Text	->	Chemin de la pièce jointe
name	Text	->	Nom + extension utilisés par le client de messagerie pour désigner la pièce jointe
cid	Text	->	ID de la pièce jointe (messages HTML uniquement) ou " " si aucun cid n'est requis
type	Text	->	Valeur de l'en-tête content-type
disposition	Text	->	Valeur de l'en-tête content-disposition : "inline" ou "attachment"
Résultat	4D.MailAttachment	<-	Objet pièce jointe

|

Description

La fonction 4D.MailAttachment.new() crée et renvoie un nouvel objet du type 4D.MailAttachment. Elle est identique à la commande (raccourci) MAIL New attachment.

.cid

.cid : Text

Description

La propriété .id contient l' ID de la pièce jointe. Cette propriété est utilisée uniquement dans les messages HTML. Si cette propriété est manquante, le fichier est géré comme une simple pièce jointe (lien).

.disposition

.disposition : Text

Description

La propriété .disposition contient la valeur de l'en-tête Content-Disposition. .

• "inline" : la pièce jointe est rendue dans le contenu du message, à l'emplacement "cid". Le rendu dépend du client de messagerie.
• "attachment" : la pièce jointe est fournie sous forme de lien dans le message.

.getContent()

.getContent() : 4D.Blob

Paramètres	Type		Description
Résultat	4D.Blob	<-	Contenu de la pièce jointe

|

Description

La fonction .getContent() renvoie le contenu de l'objet pièce jointe dans un objet 4D.Blob. Vous pouvez utiliser cette méthode avec les pièces jointes reçues par la commande MAIL Convert from MIME.

.name

.name : Text

Description

La propriété .name contient le nom et l'extension de la pièce jointe. Par défaut, c'est le nom du fichier, sauf si un autre nom a été indiqué dans la commande MAIL New attachment.

.path

.path : Text

Description

La propriété .path contient le chemin POSIX du fichier joint, s'il existe.

.platformPath

Historique

Release	Modifications
19	Ajout

.platformPath : Text

Description

La propriété .platformPath retourne le chemin du fichier joint exprimé avec la syntaxe de la plate-forme courante.

.size

.size : Integer

Description

La propriété .size contient la valeur de l'en-tête size du fichier joint. La propriété .size est renvoyée lorsque le message MIME définit un en-tête de taille dans la partie pièce jointe.

.type

.type : Texte

Description

La propriété .type contient le content-type du fichier joint. Si ce type n'est pas explicitement passé à la commande MAIL New attachment, le content-type est fondé sur son extension de fichier.