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


Queries a header entry.

Component Version macOS Windows Linux Server iOS SDK
EmailParser 5.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "EmailParser.Header"; EmailID; Index; Selector )   More


Parameter Description Example
EmailID The ID fo the email parser. $Email
Index The index from 0 to EmailParser.HeaderCount-1. 0
Selector Which value to return. Can be "name" or "value". "name"


Returns text or error.


Queries a header entry.
Common header values include Date, Subject, From and X-Mailer.


Query first header entry:

$name = MBS( "EmailParser.Header"; $EmailID; 0; "name" )
$value = MBS( "EmailParser.Header"; $EmailID; 0; "value" )

Find a header value by name:

Set Variable [$i; Value:0]
Set Variable [$c; Value:MBS("EmailParser.HeaderCount"; $email)]
If [$c > 0]
        Set Variable [$HeaderName; Value:MBS("EmailParser.Header"; $email; $i; "name")]
        If [$HeaderName = "X-Mailer"]
            Set Variable [$HeaderValue; Value:MBS("EmailParser.Header"; $email; $i; "value")]
            Set Field [Email Parser::Mailer; $HeaderValue]
        End If
        Set Variable [$i; Value:$i + 1]
        Exit Loop If [$i = $c]
    End Loop
End If

Copy all headers into records:

Set Variable [ $i ; Value: 0 ]
Set Variable [ $c ; Value: MBS("EmailParser.HeaderCount"; $email) ]
If [ $c > 0 ]
        Set Variable [ $HeaderName ; Value: MBS("EmailParser.Header"; $email; $i; "name") ]
        Set Variable [ $HeaderValue ; Value: MBS("EmailParser.Header"; $email; $i; "value") ]
        New Record/Request
        Set Field [ EmailHeaders::EmailID ; $EmailRecordID ]
        Set Field [ EmailHeaders::HeaderName ; $HeaderName ]
        Set Field [ EmailHeaders::HeaderValue ; $HeaderValue ]
        Commit Records/Requests [ With dialog: Off ]
        # next
        Set Variable [ $i ; Value: $i + 1 ]
        Exit Loop If [ $i = $c ]
    End Loop
End If

See also

Release notes

Example Databases

This function is free to use.

Created 24th September 2015, last changed 9th June 2017

EmailParser.Hash - EmailParser.HeaderCount