GroupDocs.Assembly for .NET 17.8.0 Release Notes

Major Features

Document assembly for email file formats is supported.

Full List of Issues Covering all Changes in this Release

KeySummaryCategory
ASSEMBLYNET-32Support document assembly for MHTML file formatsFeature
ASSEMBLYNET-33Support document assembly for MSG file formatsFeature
ASSEMBLYNET-34Support document assembly for EML file formatsFeature
ASSEMBLYNET-35Support document assembly for EMLX file formatsFeature
ASSEMBLYNET-40Support building of charts located in chart worksheetsFeature
ASSEMBLYNET-41Support building of charts with series names located in referenced cellsFeature

Public API and Backward Incompatible Changes

Supported Common Features for Email File Formats

All common textual and tabular template features such as expressions, variables, data bands, conditional blocks, and others are supported to the full extent.

Partially Supported or Not Supported Features for Email File Formats

The following table provides information on those GroupDocs.Assembly features that are partially supported or not supported at all for email file formats.

FeatureMSG with RTF BodyMSG, EML, MHTML with HTML Body Created Using Microsoft Outlook or Microsoft WordMSG, EML, EMLX, MHTML with HTML Body Created Outside Microsoft Outlook or Microsoft WordMSG, EML, EMLX, MHTML with Plain Text Body
Building Charts DynamicallySupported (outside loops and conditions)Supported (outside loops and conditions)Not supportedNot supported
Inserting Documents DynamicallySupportedSupportedTo be supportedNot supported
Inserting Images DynamicallyTo be supportedTo be supportedSupportedNot supported
Inserting Barcodes DynamicallyTo be supportedTo be supportedTo be supportedNot supported

Setting Email Message Attributes Dynamically

In addition to an email message body, you can use GroupDocs.Assembly to set the following email message attributes dynamically using the same template syntax:

  • Subject
  • From
  • To
  • CC
  • BCC

For example, given that recipients is an enumeration of strings "Named Recipient <named@example.com>" and "unnamed@example.com", you can use the following template to set the To attribute for an email message.

<<foreach [r in recipients]>><<[r]>>; <</foreach>>

During runtime, the To attribute is set to the following value then.

Named Recipient <named@example.com>; unnamed@example.com

Building Email Message Attachments Dynamically

GroupDocs.Assembly enables you to build contents of documents attached to email messages dynamically. To do this, attach template documents (of file formats supported by GroupDocs.Assembly) to your template email message. Then, while assembling the email message, the engine assembles the attached documents as well using the same data sources.