Features Overview Leave feedback

GroupDocs.Assembly for .NET is an API that allows you to generate documents in popular microsoft office and email file formats based upon template documents and data obtained from various sources including databases, XML, JSON, OData, objects of custom .NET types, external documents, and more. The following is the list of salient features which are offered by the GroupDocs.Assembly API:

• Multiple data formats support
• Use formulae & perform sequential data operations
• Apply upper, lower, capital, firstcap formatting to strings in template syntax
• Template syntax support formatting of ordinal, cardinal, alphabetic numeric nature
• Support template documents with custom variables & text comments within template syntax tags
• Dynamically insert out document content in report
• Dynamically configure background color of html documents & generate barcode in reports
• Dynamically insert hyperlinks in reports & apply attributes to email message body
• Dynamically attach email attachments
• Support of next field analogue of Microsoft Word
• Update fields during word processing document assembly
• Apply formula during spreadsheet assembly
• Template formatting for numeric, text, image, date-time, chart elements
• Conditional formatting of template text elements
• Linq-based template syntax
• Change format of assembled file using explicit specifications or file extension
• Auto-removal of empty paragraphs
• Generate various report types, e.g., charts, image, tables, lists and more
• Inline template syntax errors in generated documents instead of exception throwing.
• Load template documents from html with resources and save assembled Word, Excel, PowerPoint & emails to html with resources

Following is the detail given about how the features are offered with their usage and limits.

A new overload DocumentAssembler.AssembleDocument is added in the new release. Using this overload user can reference multiple data source objects and their members in the template. Overload accepts an array of data source names and an array of data sources. Learn more about support of multiple data sources in this article.

Word Processing Document formats including Microsoft Word Document and OpenOffice document formats are supported. For more details, please visit Support for Word Processing Document Formats.

Spreadsheet Document formats including Microsoft Excel Workbook and OpenOffice spreadsheet document formats are supported. For more details, please visit Support for Spreadsheet Document Formats.

Presentation Document formats including Microsoft PowerPoint Presentation and OpenOffice presentation document formats are supported. For more details, please visit Support for Presentation Document Formats.

Email Document formats is supported. For more details, please visit Support for Email Document Formats.

HTML and Plain Text document formats are supported by the GroupDocs.Assembly API. More Document formats including PDF, Epub and XPS document formats will be supported in the future releases. For more details, please visit Support for more Document Formats.

You can merge table cells with equal textual contents within your reports dynamically using cellMerge tag. For the detail, please visit Merging Table Cells Dynamically.

An optional comment providing a human-readable explanation ignored by the engine

<<tag_name [expression] –switch1 –switch2 ... // optional_comment >>

In-lining of syntax error messages into templates instead of exception throwing. For the detail, please visit Use of In-line Syntax Error Messages into Templates.

API provides a useful feature to format strings in template syntax. String formatting such as upper, lower, capital, etc.

Using GroupDocs.Assembly for .NET user can also do numeric formatting in template syntax. Numeric formatting such as ordinal, cardinal, alphabetic, etc.

API permits users to define variables in template documents as follows:

<<var [st = "Hello, "]>><<[st]>><<var[st = "World!"]>><<[st]>>

You can insert contents of outer documents to your reports dynamically.

Barcode images can be generated in reports dynamically.

This feature allows user to implement a new «next» tag. The tag should be supported only within data bands created by using «foreach» tag.

For HTML documents, a background color can not be set dynamically using the backColor tag

<<backColor ["red"]>>text with red background<</backColor>>

Aside this, you can use the HTML style attribute to achieve this.

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

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.

API permits users to update fields while assembling Word Processing documents.

API allows users to calculate formula while assembling Spreadsheet documents.

GroupDocs.Assembly provides a powerful feature to change the target file format of an assembled document using file extension or explicit specification.

Load template documents from html with resources and save assembled Word, Excel, PowerPoint & emails to html with resources. Please visit the following articles for the detail:

• Loading of template documents from HTML with resources
• Saving to HTML with External Resource Files

The GroupDocs.Assembly engine allows restart list numbering within your documents dynamically using «restartNum» tags. In particular, this feature is useful when working with a nested numbered list within a data band. Please visit this article for more details

The GroupDocs.Assembly.Metered public class has been added to provide metered licensing. This feature is supported in GroupDocs.Assembly for .NET 16.12.0.