Monkeybread Software - MBS FileMaker Plugin: SendMail.AddAttachmentFile

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: 11.1 11.2 11.3 11.4 11.5 12.0 12.1 12.2 12.3 12.4 Statistic FMM Blog

SendMail.AddAttachmentFile

Adds an attachment to the email based on a file path.

Component	Version	macOS	Windows	Linux	Server	iOS SDK
SendMail	4.3	✅ Yes	✅ Yes	✅ Yes	✅ Yes	✅ Yes

MBS( "SendMail.AddAttachmentFile"; EmailID; Path { ; Name; MimeType; InlineID; Method } ) More

Parameters

Parameter Description Example Flags

EmailID The email reference number obtained using SendMail.CreateEmail function. $EmailID

Path The native file path to the file to include as attachment. "/Users/cs/Desktop/sample.pdf"

Name The name for the attachment.
If empty, version 6.2 or newer uses file name from file path. "sample.pdf" 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 The content ID for inline images (CID).
Empty text or no parameter gives regular attachment. "test.png@3C111B0E.81ED.478A.912C.4B64F538003C" Optional

Method The method for the content-type parameter.
Currently only for sending calendar invitiations. "REQUEST" Optional

Parameter	Description	Example	Flags
EmailID	The email reference number obtained using SendMail.CreateEmail function.	$EmailID
Path	The native file path to the file to include as attachment.	"/Users/cs/Desktop/sample.pdf"
Name	The name for the attachment. If empty, version 6.2 or newer uses file name from file path.	"sample.pdf"	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	The content ID for inline images (CID). Empty text or no parameter gives regular attachment.	"test.png@3C111B0E.81ED.478A.912C.4B64F538003C"	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 file path.
Attachments over 100 MB are not supported.
Version 5 of MBS Plugin can encode file name for preserving non ASCII characters. Still for compatibility it is recommended to use simply ASCII names.
You can use Text.FileExtensionToMimeType to find the mime type for a file extension.
You can use AddAttachment several times to add several attachments.

This function requires a native path. Use Path.FileMakerPathToNativePath to convert a FileMaker path to a native path if required. If you like to have the user choose the path, you can use FileDialog functions.
For Server be aware that server has limited permissions and may not be able to access all files on a computer.

Examples

Add attachment:

Set Variable [$r; Value:MBS("SendMail.AddAttachmentFile"; $EmailID; Attachment::Path; Attachment::Name; Attachment::Type)]

Recursive custom function to add a list of files:

MBSAttachment(EmailID, FilePathList, Flag_inline)

// e.g. $r=MBSattachment ( $EmailID ; MyTable::FilePathList; 1 ) ;

Case(
ValueCount (FilePathList ) > 0;
Let(
[
§element =
ValueCount (FilePathList ) ;
§Line =
GetValue( FilePathList; §element );
§InlineID=
MBS( "Path.LastPathComponent"; §line ) ;
§r=
MBS(
"SendMail.AddAttachmentFile";
EmailID;
§Line;
""; /* file name from path automatically */
""; /* mime name from file name automatically */
Case(
Flag_inline = 1;
§InlineID ;
""
)
)
];

// call recursive for next file:
MBSattachment(
EmailID;
Trim(
Substitute(
"¶" & FilePathList;
"¶" & §Line ;
""
));
Flag_inline
)
);
""
)