Monkeybread Software - MBS FileMaker Plugin: SendMail.AddAttachmentText

Topics All MacOS (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 9.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 10.6 Statistic FMM Blog

SendMail.AddAttachmentText

Adds an attachment to the email based on a text.

Component	Version	macOS	Windows	Linux	Server	FileMaker iOS SDK
SendMail	6.5	Yes	Yes	Yes	Yes	Yes

MBS( "SendMail.AddAttachmentText"; EmailID; Text; Encoding { ; Name; MimeType; InlineID; IsBase64 } ) 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. "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

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

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" )

Blog Entries

Release notes

Version 8.2
- Added IsBase64 parameter to SendMail.AddAttachmentText function.
- Added missing Base64 Encoding for SendMail.AddAttachmentText function.

Created 1st October 2016, last changed 5th May 2018

SendMail.AddAttachmentFile - SendMail.AddBCC

Feedback: Report problem or ask question.