Skip to end of metadata
Go to start of metadata

Data Sources

Data Formats


Support in GroupDocs.Assembly for .NET


Supported (using DataSet, DataTable, etc.)


Supported (using DataSet.ReadXml or XML deserialization of custom objects)


Supported (using deserialization of custom objects through WCF or third-party .NET libraries


Supported (using a third-party component like Json.NET on DataSet or custom objects in .NET

Custom .NET Objects


Ability to use Spreadsheet as Table of Data


Ability to use Word processing Table as Table of Data


Data Manipulation Capabilities


Support in GroupDocs.Assembly for .NET


Supported (using C# syntax subset)

Sequential Data Operations (filtering, ordering, grouping, aggregating, etc.)

Supported (through LINQ syntax for data sources of all types)

Type Member Invocation


Built-In Data Relation Support


Data Processing Customization

Supported (using external .NET types)

External Document Import


Explicit Support for Multiple Data Sources

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.

Template Formats, Elements and Syntax

Template Document Formats

Word Processing Document Formats

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

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

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

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

More 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.

Template Elements


Support in GroupDocs.Assembly for .NET

Formatted Text Blocks


HTML Blocks


Repeated Blocks (including list items and table rows)


Conditional Blocks

Supported (including list items and table rows)

Pivot Tables

To be supported





Barcodes (through barcode fonts)


Bound Form Controls

To be supported


Supported (using HTML and "a" tags for all template formats or HYPERLINK fields for Word templates only.) Improvements planned in future releases

Template Syntax Formats for Expression Results

Specifying String Formats

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

String Format



Converts a string to lower case ("the string")


Converts a string to upper case ("THE STRING")


Capitalizes a first letter of every word in a string ("The String")


Capitalizes the first letter of the first word in a string ("The string")

Specifying Numeric Formats

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

Number Format



Formats an integer number as an upper-case letter (A, B, C, ...)


Formats an integer number as an upper-case Roman numeral (I, II, III, ...)


Appends an ordinal suffix to an integer number (1st, 2nd, 3rd, ...)


Converts an integer number to its ordinal text representation (First, Second, Third, ...)


Converts an integer number to its text representation (One, Two, Three, ...)


Formats an integer number as hexadecimal (8, 9, A, B, C, D, E, F, 10, 11, ...)


Encloses an integer number with dashes (- 1 -, - 2 -, - 3 -, ...)

Variables in Template Documents

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

Support for Outer Document Insertion

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

Barcode Image Generation

Barcode images can be generated in reports dynamically.

Support for Analogue of Microsoft Word NEXT Field

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

Setting Background Color Dynamically

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

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

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 <>" and "", you can use the following template to set the To attribute for an email message.

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

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.

Ability to Update Fields

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

Ability to Calculate Formulas

API allows users to calculate formula while assembling Spreadsheet documents.

Template Elements Formatting


Support in GroupDocs.Assembly for .NET

Numeric/Date-Time Value Formatting


Text Formatting


Conditional Text Formatting

Supported (only through conditional blocks)

Image Formatting

Supported (WYSIWYG)

Chart Formatting

Supported (WYSIWYG)

Template Syntax


Support in GroupDocs.Assembly for .NET




To be supported

Changing Output File Format 

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

Metered Licensing

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.

  • No labels