| 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.Release 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
- Version 12.0
- Fixed a problem in email parser, which didn't get multi part right on Linux for EmailParser.Parse, EmailParser.ParseContainer and EmailParser.ParseFile.
Blog Entries
- MBS Plugin Advent calendar: 23 - MailParser
- MBS FileMaker Plugin, version 11.6pr3
- MBS FileMaker Plugin, version 6.3pr2
This function is free to use.
Created 4th June 2016, last changed 23th May 2024
