GroupDocs.Assembly for Java 18.12 Release Notes

Major Features

Supported document assembly of external documents being dynamically inserted for Word Processing and Email formats.

Full List of Features Covering all Changes in this Release

KeySummaryCategory
ASSEMBLYNET-94Support document assembly of external documents being dynamically inserted for Word Processing formats Feature 
ASSEMBLYNET-95 Support document assembly of external documents being dynamically inserted for Email formats Feature 
ASSEMBLYNET-96 An evaluation mark is added to a nested document being inserted dynamically Bug 

Public API and Backward Incompatible Changes

Support document assembly of external documents being dynamically inserted for Word Processing and Email Formats

You can insert contents of outer documents to your reports dynamically using doc tags. A doc tag denotes a placeholder within a template for a document to be inserted during runtime. The syntax of a doc tag is defined as follows.

<<doc [document_expression]>>

An expression declared within a doc tag is used by the engine to load a document to be inserted during runtime. The expression must return a value of one of the following types:

  • A byte array containing document data
  • An InputStream instance able to read document data
  • A string containing a document URI

While building a report, an expression declared within a doc tag is evaluated and its result is used to load a document which content replaces the doc tag then.

By default, a document being inserted is not checked against template syntax and is not populated with data. However, you can enable this by using a build switch as follows.

<<doc [document_expression] -build>>

When a build switch is used, the engine treats a document being inserted as a template that can access the following data available at the scope of a corresponding doc tag:

  • Data sources
  • Variables
  • A contextual object
  • Known external types