Aller au contenu principal
Version: v20 R4 BETA

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    the value of the size header of the attachment file
.type : Texte    le content-type du fichier joint

MAIL New attachment

Historique
VersionModifications
v19 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 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 \&#060;img src="cid:ID"&#062;. 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) //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
VersionModifications
v19 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 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ètresTypeDescription
Résultat4D.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
VersionModifications
v19Ajout

.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

The .size property contains the value of the size header of the attachment file. The .size property is returned when the MIME message defines a size header in the attachment part.

.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.