Dear GroupDocs users, we’re pleased to announce GroupDocs.Assembly for .NET 26.11. This release adds JSON Schema support, document preview and control of external resources, lets templates written for typed objects work on JSON, XML and CSV data, and adds a .NET Framework 4.8 build.
Please note before upgrading
External resources whose references come from data are no longer loaded by default. For example, <<image [item.PhotoUrl]>> where PhotoUrl is an http/https URI now gives an empty image. Resources referenced by the template itself and local file paths work as before. To allow trusted hosts:
LoadSaveOptions options = new LoadSaveOptions();
options.WhitelistedResources.Add("images.example.com"); // or: options.SkipExternalResources = false;
assembler.AssembleDocument("template.docx", "report.docx", options, new DataSourceInfo(data, "item"));
LoadSaveOptions.ExternalResourceHandler lets you see, allow, skip or provide every external resource.
What’s new
-
JSON Schema for
JsonDataSource. Members declared in the schema can be used even when they arenull, empty or missing in the data, and value types come from the schema. -
Document preview.
DocumentAssembler.GeneratePreviewrenders pages of templates and reports to PNG, JPEG or BMP, withPreviewOptions.Resolution. -
One template for typed objects and file data.
<<[o.Date.Month]>>,<<if [o.Paid]>>andWhere(x => x.Paid)work on JSON, XML and CSV data without.Valueor== true.GroupByandDistinctover nested objects merge equal objects, and$id/$refof Json.NET are supported. -
RemoveEmptyParagraphsfor spreadsheet and plain text templates. -
Templates: images in table cells and group shapes of presentations, relative image paths resolved against the template folder, hex colors (
"#FF0000") inbackColorand chart color tags. -
.NET Framework 4.8 build. Microsoft ends support for .NET Framework 4.6.2 on January 12, 2027. We will keep the
net462build for a few more months after that, so please plan the move to 4.8. -
Engines updated to 26.10 and
System.Security.Cryptography.Pkcsupdated to patched versions.
Fixes
-
Metered licensing (SetMeteredKey`) works again. -
Date-only values of JSON and CSV data no longer depend on the server time zone.
-
Text and HTML reports of ASCII-only templates keep non-Latin data (UTF-8).
-
Barcodes no longer fail when the font of their text box is not installed, e.g. on Linux.
-
No extra empty paragraph after HTML content inserted with
-html.
Resources
If you run into any issues or have questions after upgrading, please open a new topic and we’ll be happy to help. The full list of behaviour changes is in the “Backwards incompatible changes” section of the release notes.