| Components | All | New | MacOS | Windows | Linux | iOS | ||||
| Examples | Mac & Win | Server | Client | Guides | Statistic | FMM | Blog | Deprecated | Old | |
SendMail.AddAttachmentText
Adds an attachment to the email based on a text.
| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
| SendMail | 6.5 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |
MBS( "SendMail.AddAttachmentText"; EmailID; Text; Encoding { ; Name; MimeType; InlineID; IsBase64; Method } ) More
Parameters
| Parameter | Description | Example | Flags |
|---|---|---|---|
| EmailID | The email reference number obtained using SendMail.CreateEmail function. | $EmailID | |
| Text | The text to use for the attachment. | "Hello World" | |
| Encoding | The text encoding for text parameter. Default is UTF-8. Possible encoding names: ANSI, ISO-8859-1, Latin1, Mac, Native, UTF-8, DOS, Hex, Base64 or Windows. More listed in the FAQ. |
"UTF8" | |
| Name | The name for the attachment. If empty, version 6.2 or newer uses file name from file path. |
"sample.txt" | Optional |
| MimeType | The mime type to use. e.g. "application/pdf" for PDF files. If missing, we use "application/octet-stream". Version 6.2 or newer detects mime type from file extension if needed. |
"application/octet-stream" | Optional |
| InlineID | Available in MBS FileMaker Plugin 7.3 or newer. The content ID for inline images (CID). Empty text or no parameter gives regular attachment. |
Optional | |
| IsBase64 | Available in MBS FileMaker Plugin 8.2 or newer. Whether text is already base64 encoded. Default is 0, so we encode it. Pass 1 if you already encoded the text yourself. |
0 | Optional |
| Method | The method for the content-type parameter. Currently only for sending calendar invitiations. |
"REQUEST" | Optional |
Result
Returns OK or error.
Description
Adds an attachment to the email based on a text.Attachments over 100 MB are not supported.
You can use Text.FileExtensionToMimeType to find the mime type for a file extension.
You can use AddAttachment several times to add several attachments.
Broken in 8.1 or older where you need to do Base64 encoding and fixed in 8.2 to work correctly.
Examples
Adds a text attachment:
MBS( "SendMail.AddAttachmentText"; $email; "Hello World"; "UTF-8"; "test.txt"; "text/plain" )
Add a XML file:
Set Variable [ $r ; Value: MBS( "SendMail.AddAttachmentText"; $email; $XML; "UTF-8"; "export.xml"; "application/xml") ]
See also
- SendMail.AddAttachmentContainer
- SendMail.AddAttachmentFile
- SendMail.AttachmentCount
- SendMail.CreateEmail
- Text.FileExtensionToMimeType
- WinSendMail.AddAttachmentFile
- WinSendMail.AddAttachmentText
Release notes
- Version 11.2
- Added optional ContentTypeMethod parameter for SendMail.AddAttachmentContainer, SendMail.AddAttachmentFile and SendMail.AddAttachmentText functions.
- Version 8.2
- Added IsBase64 parameter to SendMail.AddAttachmentText function.
- Added missing Base64 Encoding for SendMail.AddAttachmentText function.
Blog Entries
- Compress and Send
- MBS FileMaker Plugin, version 11.2pr1
- MBS FileMaker Plugin, version 8.2pr3
- MBS FileMaker Plugin, version 6.5pr1
- Sending emails in FileMaker with MBS Plugin
This function checks for a license.
Created 1st October 2016, last changed 4th July 2024
