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 |
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 retourne un nouvel objet de type 4D.MailAttachment. Elle est identique à la commande MAIL New attachment (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ètres | Type | Description | |
|---|---|---|---|
| Résultat | 4D.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, à moins qu'un autre nom n'ait été spécifié 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é 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 l'extension du fichier.