GroupDocs.Assembly for .NET 19.11 Release Notes

Major Features

Supported dynamic insertion of links to internal document contents and extended the set of supported Markdown features.

Full List of Features Covering all Changes in this Release

KeySummaryCategory
ASSEMBLYNET-128 Support dynamic insertion of links to bookmarks for Word Processing documents Feature 
ASSEMBLYNET-129 Support dynamic insertion of links to cells for Spreadsheet documents Feature 
ASSEMBLYNET-130 Support dynamic insertion of links to slides for Presentation documents Feature 
ASSEMBLYNET-131 Support dynamic insertion of links to bookmarks for emails Feature 
ASSEMBLYNET-133 Support code blocks and spans for Markdown Feature 
ASSEMBLYNET-134 Support strikethrough text for Markdown Feature 
ASSEMBLYNET-132 Valid license files are not accepted Bug 

Public API and Backward Incompatible Changes 

Extended the set of supported Markdown features

From now on, the following Markdown features are supported when saving assembled Markdown documents to Word Processing formats and saving assembled Word Processing documents and emails to Markdown:

You can also insert links to bookmarks to your reports dynamically using link tags. The syntax of a link tag is defined as follows:

<<link [uri_or_bookmark_expression][display_text_expression]>>

Here, uri_or_bookmark_expression defines URI or the name of a bookmark within the same document for a hyperlink to be inserted dynamically. This expression is mandatory and must return a non-empty value.In turn, display_text_expression defines text to be displayed for the hyperlink. This expression is optional. If it is omitted or returns an empty value, then during runtime, a value of uri_or_bookmark_expression is used as display text as well.

For Spreadsheet documents, behavior of link tags is changed as follows. If an expression defined within a link tag is evaluated to a cell or cell range reference during runtime, then the tag is replaced with a link to the corresponding cell or cell range.

The following table describes supported formats of cell and cell range references.

DescriptionFormatExample
Reference to a cell within the same worksheetcell_nameA1
Reference to a cell in another worksheetworksheet_name!cell_nameSheet1!A1
Reference to a cell range within the same worksheetstart_cell_name:end_cell_nameA1:B2
Reference to a cell range in another worksheetworksheet_name!start_cell_name:end_cell_nameSheet1!A1:B2

Following is sample syntax, If the link to cell A1 is required to be inserted:

<<link ["A1"] ["Home"]>>

For Presentation documents, behavior of link tags is changed as follows. If an expression defined within a link tag is evaluated to a “SlideN” value, where N is a one-based index of a slide within the same Presentation document, then the tag is replaced with a link to the corresponding slide during runtime.

See the example of the syntax as follows:

<<link ["Slide1"] ["Home"]>>