Published

A procurement team receives an exported Outlook message containing an approval note, a contract PDF, and a forwarded message. A preview of the visible email body can be useful, but can it show which contract was attached and preserve the forwarded message's context? Keep the native message and its derived views connected.
Microsoft's MSG format specification covers individual messages, appointments, contacts, and other Outlook items. Its message structure includes properties, recipient objects, attachments, and embedded messages. A filename ending in .msg does not establish that a processor handled all of those parts.
Retain original bytes, source context, a version reference, and a receipt checksum.
Parse message parts, scan extracted files, and record warnings and failures.
Expose approved previews, searchable fields, and attachments under the applicable access rules.
Store the original bytes, filename, detected file type, ingestion source, receipt time, and checksum. Keep the source restricted while security checks and processing run. Normalising headers or removing unsupported properties should create a derivative rather than overwrite the native object.
A checksum identifies bytes; it does not authenticate the sender or prove that a particular transformation produced a preview. Record the source version, source and output checksums, processor version, configuration, and processing time together. Parsed sender and timestamp properties are also not, by themselves, proof of identity or delivery.
| Representation | Purpose and control |
|---|---|
| Native MSG | Preservation, export, and reprocessing. Retain the source version and checksum under the record's access and retention rules. |
| Rendered view | Browser review. Retain the renderer version, source reference, and any omissions; sanitize active content and block remote resources. |
| Extracted text and metadata | Search and routing. Retain field mappings, extraction status, and source references, with access controls for indexed content. |
In the procurement example, the preview should make the contract attachment discoverable and identify any forwarded message that was not rendered. A successful body preview must not silently imply that every attachment and property was processed.
When a business attachment needs independent search, review, or retention, create a related document record. Preserve its original name, detected type, size, position, checksum, and source-message relationship. Inline images can remain supporting rendering assets where separate business records are unnecessary.
Scan extracted files independently. Nested messages need limits on depth, attachment count, expanded size, and processing time. Microsoft's embedded-message structure allows further attachments and recipients, so processing should account for more than one level.
Define permissions for the source, attachments, previews, and indexed content. If an audience may not see one attachment, allowing it to download the native MSG can expose that attachment despite a restricted preview. Include native-download access in the review.
Record the parser and renderer versions, fields handled, warnings, and unsupported content. Encrypted items, malformed properties, unsupported encodings, and nested-message limits should produce explicit states such as partial extraction or review required. Keep retry and operator actions visible.
Follow defensive file-upload practices: validate content types, isolate untrusted processing, enforce resource limits, and use appropriate scanning. Safe HTML previews must block scripts and remote tracking. Apply OCR only to supported image or rendered-document inputs; use an MSG-aware parser for the native message.
For search, map useful fields such as subject, sender, recipients, message dates, body text, and attachment names. Retain original values alongside normalised ones where needed. Search coverage and permissions must reflect partial extraction, so a missing match is not mistaken for proof that the message contains nothing relevant.
A useful MSG workflow preserves the native object while making its contents safe to review and search. Link every derivative to its source, show processing gaps, and test access to the original as carefully as access to the preview.
The open-source foundation — API-first, deployable into your own AWS account, and free to use. Right for architecture validation and early implementation.
Production-ready editions for departments and complex workflows. Start with a Proof-of-Value deployment or go straight to production.
For governance-heavy environments with residency, sovereignty, assurance, and multi-jurisdiction requirements. Talk to us about the right deployment model.