Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

EmailParser.ParseFile

Parses an email from a file.

Component Version macOS Windows Linux Server iOS SDK
EmailParser 5.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "EmailParser.ParseFile"; Path )   More

Parameters

Parameter Description Example
Path Native file path. "C:\Documents\Test.eml"

Result

Returns Reference number or error.

Description

Parses an email from a file.
This is for emails stored as text file with eml file name extension.
If no error occurs, the parser will separate subject, html and plain text, attachments and inline graphics, all addresses and header entries. You can then use other functions to query values.

If you have EMLX files, please use Text.ReadEMLXFile function first to unpack them and pass the email source to EmailParser.Parse function.

This functionality needs libiconv. On macOS, iOS and Linux we try to load the library coming with the OS. If you use Windows or like to use a custom library, please use Plugin.LoadIconvLibrary function to load it before calling this function.
Without iconv library, only a minimum functionality is done by plugin directly to keep basic functionality working.

If you need to parse msg files from Outlook, please check the msg-extractor python tool. It can be run via Shell functions to unpack msg files:
https://github.com/TeamMsgExtractor/msg-extractor

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.

See also

Release notes

Example Databases

Blog Entries

This function is free to use.

Created 24th September 2015, last changed 21st August 2024


EmailParser.ParseContainer - EmailParser.PlainText