EmailParser.Header

Queries a header entry.

Parameters

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"

Result

Returns text or error.

Description

Examples

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]
    Loop
        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
        #next
        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 ]
    Loop
        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

• EmailParser.Hash
• EmailParser.HasHeader
• EmailParser.HeaderCount
• EmailParser.HeaderValue
• EmailParser.Parse

Release notes

• Version 7.4
  • Added EmailParser.HasHeader and EmailParser.HeaderValue functions to make header queries easier.

Example Databases

• CURL/Email/Email Client
• CURL/Email/Email Parser and Preview
• CURL/Email/Email Parser
• CURL/Email/IMAP Email

This function is free to use.

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

EmailParser.Hash - EmailParser.HeaderCount