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

EmailParser.ParseContainer

Parses an email stored in container.

Component Version macOS Windows Linux Server iOS SDK
EmailParser 6.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "EmailParser.ParseContainer"; EmailSource )   More

Parameters

Parameter Description Example
EmailSource The container field that holds the EML file to be parsed.

The container value, which embeds the email text as FILE data.
e.g. you imported the eml file into the container with our plugin or Filemaker's import script step.
MyTable::myContainer

Result

Returns reference number or error.

Description

Parses an email stored in container.
Parses an email file stored in container and returns a reference that can be used by other EmailParser functions to extract specific data elements (e.g. EmailParser.Subject to extract the email subject).

This function applies only to EML files. For EMLX files, please use the Text.ReadEMLXFile function to extract the source of the email file and then use the EmailParser.Parse function to get a reference for further parsing).

Be sure to use EmailParser.Free to release the reference once you have finished processing the email file. This frees up memory that is holding the parsed email.

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 EmailParser functions to query values.

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.

See also

Release notes

Blog Entries

This function is free to use.

Created 4th June 2016, last changed 9th November 2021


EmailParser.Parse - EmailParser.ParseFile