Aller au contenu principal
Version: 20 R6 BETA

MailAttachment

Les objets Attachment (pièce jointe) permettent de référencer des fichiers dans un objet Email. Les objets Attachment 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
l'ID de la pièce jointe
.disposition : Text
la valeur de l'en-tête Content-Disposition
.getContent() : 4D.Blob
retourne 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é dans la syntaxe de la plate-forme courante
.size : Integer
la valeur de l'en-tête size du fichier de la pièce jointe
.type : Text
le content-type du fichier de la pièce jointe

MAIL New attachment

Historique
ReleaseModifications
19 R2Accepte 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ètresTypeDescription
file4D.File->Fichier joint
zipFile4D.ZipFile->Fichier Zip joint
blob4D.Blob->Blob contenant la pièce jointe
pathText->Chemin de la pièce jointe
nameText->Nom + extension utilisés par le client de messagerie pour désigner la pièce jointe
cidText->ID de la pièce jointe (messages HTML uniquement) ou " " si aucun cid n'est requis
typeText->Valeur de l'en-tête content-type
dispositionText->Valeur de l'en-tête content-disposition : "inline" ou "attachment"
Résultat4D.MailAttachment<-Objet pièce jointe

Description

La commande MAIL New attachment vous permet de créer un objet pièce jointe 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 :

ExtensionContent Type
jpg, jpegimage/jpeg
pngimage/png
gifimage/gif
pdfapplication/pdf
docapplication/msword
xlsapplication/vnd.ms-excel
pptapplication/vnd.ms-powerpoint
zipapplication/zip
gzapplication/gzip
jsonapplication/json
jsapplication/javascript
psapplication/postscript
xmlapplication/xml
htm, htmltext/html
mp3audio/mpeg
otherapplication/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" :

ConstanteValeurCommentaire
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) //send 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
ReleaseModifications
19 R2Accepte 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ètresTypeDescription
file4D.File->Fichier joint
zipFile4D.ZipFile->Fichier Zip joint
blob4D.Blob->Blob contenant la pièce jointe
pathText->Chemin de la pièce jointe
nameText->Nom + extension utilisés par le client de messagerie pour désigner la pièce jointe
cidText->ID de la pièce jointe (messages HTML uniquement) ou " " si aucun cid n'est requis
typeText->Valeur de l'en-tête content-type
dispositionText->Valeur de l'en-tête content-disposition : "inline" ou "attachment"
Résultat4D.MailAttachment<-Objet pièce jointe

Description

La fonction 4D.MailAttachment.new() crée et retourne un nouvel objet de type 4D.MailAttachment. Elle est identique à la commande MAIL Nouvelle pièce jointe (raccourci).

.cid

.cid : Text

Description

La propriété .cid 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ètresTypeDescription
Résultat4D.Blob<-Contenu de la pièce jointe

Description

La fonction .getContent() retourne le contenu de l'objet pièce jointe dans un objet 4D.Blob. Vous pouvez utiliser cette fonction avec les objets pièce jointe reçus 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
ReleaseModifications
19Ajout

.platformPath : Text

Description

La propriété .platformPath retourne le chemin du fichier joint exprimé dans 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 de la pièce jointe. 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 : Text

Description

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