Mail Message

Represents an attachment type for RFC822 and Outlook mail messages, enabling mail-centric processing, extraction, and integration in Grooper.

Remarks

The Mail Message class provides support for mail messages in RFC822 (.eml, .mht, message/rfc822) and Microsoft Outlook (.msg, application/vnd.ms-outlook) formats within Batch Folders. It enables Grooper to recognize, process, and manipulate mail messages as attachments, supporting downstream extraction, conversion, and export workflows.

Overview

• Mail Message is automatically selected for files with the .eml, .mht, or .msg extension, or with message/rfc822 or application/vnd.ms-outlook MIME types.
• Integrates with Batch Folders to enable document-centric workflows, including classification, extraction, and export of mail content and attachments.
• Parses mail content, headers, and body using robust mail parsing logic, supporting both plain text and HTML bodies.

Mail Message Handling

• Loads and parses mail messages as attachments to Batch Folders.
• Provides access to key mail properties (date, sender, recipients, subject, etc.) for downstream processing and extraction.
• Handles both standard RFC822 and proprietary Outlook formats, with automatic conversion as needed.

Available Commands

• ConvertToRFC822: Converts a proprietary Microsoft Outlook .msg file to a standard RFC822 .eml file.
  • Use when interoperability or standards compliance is required.
  • The converted .eml file replaces the current attachment and updates the MIME type.
• ExpandAttachments: Bursts out the individual components of a mail message (body, attachments, inline images) as child documents.
  • Configure BodyExpansion to control how the mail body is extracted (plain text, HTML, or both).
  • Use ShouldExpand to control whether attachments are extracted.
  • Use ExpandInlineImages to extract inline images embedded in the mail body.
  • Each extracted part is saved as a child document under the Batch Folder.

Usage Notes

• Use Mail Message to enable mail-aware processing in Grooper, including conversion, extraction, and export of mail content and attachments.
• Combine with Content Type and Data Model configuration to extract structured data from mail messages and their attachments.
• Suitable for processing email archives, correspondence, and other mail-based content in batch workflows.

Properties

Name	Type		Description
Date Sent	String		The date the mail message was sent.
From	String		The sender of the mail message.
To	String		The recipients of the mail message.
CC	String		The carbon copy recipients of the mail message.
Subject	String		The subject of the mail message.
Error Message	String		Error message.

Context Menu Commands

Command	Shortcut	Description
mail Convert To RFC822		Converts a proprietary Microsoft Outlook mail message (.msg) to an industry-standard RFC822 mail message (.eml).
mail Expand Attachments		Bursts out the individual components of a mail message and saves them as children of the mail message.