Aspose.Words for Java 19.9 Release Notes

This page contains release notes for Aspose.Words for Java 19.9.

Major Features

Advanced typography based on HarfBuzz shaper.
Provided API to write and modify VBA macros.
Implemented ability to create repeating section structured document tags.
Simplified work with XML and CSV data sources for LINQ Reporting Engine.
Improved rendering of “Sitka Banner”, “Sitka Display”, “Sitka Heading”, “Sitka Small”, “Sitka Subheading”, “Sitka Text” and “Cambria Math” fonts.
Implemented OpenType number spacing.

Full List of Issues Covering all Changes in this Release

Key	Summary	Category
WORDSJAVA-2120	Advanced typography based on HarfBuzz shaper.	New Feature
WORDSJAVA-2178	XML Data Source on Java	New Feature
WORDSNET-19120	Add support for the Truncate Font Height compatibility option	New Feature
WORDSNET-18722	Simplify working with XML, JSON, and CSV data sources for LINQ Reporting Engine	New Feature
WORDSNET-12480	Provide the ability to manipulate VBA macro code (string changes)	New Feature
WORDSNET-12655	Provide code to programmatically create RepeatingSection SDT using Aspose.Words	New Feature
WORDSNET-18542	Improve macros extract from the document	New Feature
WORDSNET-1055	Implement the “match destination formatting” behaviour	New Feature
WORDSJAVA-2162	HTML to DOCX conversion issue with list numbering	Bug
WORDSJAVA-2166	java.lang.Exception: javax.imageio.IIOException is thrown while saving the document to HtmlFixed	Bug
WORDSJAVA-2183	DateTime time zone shift while working with XML Data Source on Java	Bug
WORDSNET-19039	System.InvalidOperationException is thrown while converting DOCX to PNG	Bug
WORDSNET-19011	RTF-DOCM-RTF roundtrip causes System.NullReferenceException	Bug
WORDSNET-18210	Incorrect number formatting in PDF	Bug
WORDSNET-18909	Empty field values on saving to PDF	Bug
WORDSNET-18605	Inline picture nested inside textframe in 2013 mode isn’t clipped	Bug
WORDSNET-18607	System.NullReferenceException is thrown while saving DOCX to PDF	Bug
WORDSNET-18912	MailMerge.Execute merges the Date field incorrectly	Bug
WORDSNET-19015	Footnotes missing when saving DOC to DOC	Bug
WORDSNET-18918	System.ArgumentException is thrown while saving DOCX to PDF	Bug
WORDSNET-18917	System.ArgumentException is thrown during converting DOCX to PDF/PNG	Bug
WORDSNET-18927	Implement clipping for nested inline/floating shapes/pictures/charts/diagrams/WordArts	Bug
WORDSNET-19016	DOCX is not imported into Aspose.Words' DOM	Bug
WORDSNET-18076	Nested tables inside row with exact height in inline table aren’t clipped	Bug
WORDSNET-18793	Incorrectly formatted pie charts in PDF	Bug
WORDSNET-18931	Image is converted to red cross in output PDF	Bug
WORDSNET-19050	TxtSaveOptions.PreserveTableLayout does not preserve cell alignme	Bug
WORDSNET-18754	System.InvalidOperationException is thrown by Document.PageCount	Bug
WORDSNET-18939	System.ArgumentNullException is thrown while saving DOCX to PDF	Bug
WORDSNET-19024	Fail to load an OLE from RTF	Bug
WORDSNET-11180	Shape is not visible after conversion from DOCX to PDF/HTML	Bug
WORDSNET-15341	Misplaced characters when saving as image or HTML	Bug
WORDSNET-19029	Aspose.Words.FileCorruptedException occurs upon loading a DOC	Bug
WORDSNET-18615	System.NullReferenceException occurs upon saving DOCX to PDF	Bug
WORDSNET-18794	Incorrectly formatted pie charts in PDF	Bug
WORDSNET-18795	Problem with pie charts format in PDF	Bug
WORDSNET-19056	The document is broken when setting ShowDataLabelsRange to true	Bug
WORDSNET-18943	After merging documents and updating the fields the TOC formatting changes to Normal style	Bug
WORDSNET-11652	Frame text overlapped by another frame’s inline shape shows in AW output	Bug
WORDSNET-18560	Chart’s text is overlapped after conversion from DOCX to PDF	Bug
WORDSNET-19092	DOCX with graphic to PDF conversion issue	Bug
WORDSNET-18697	Improve API to write and modify VBA macros	Bug
WORDSNET-18997	Shapes saved to DOC no longer editable/moveable	Bug
WORDSNET-18891	Incorrect scaling of the horizontal date axis after conversion to PDF	Bug
WORDSNET-19006	System.IO.EndOfStreamException is thrown while re-saving DOCX	Bug
WORDSNET-18101	Horizontal axis does not render correctly in output PDF	Bug
WORDSNET-18099	DOCX to PDF conversion issue with chart’s rendering	Bug
WORDSNET-18271	A character is not rendered in Word to PDF rendition correctly	Bug
WORDSNET-18365	Vietnamese text becomes number in PDF - PAGE field	Bug
WORDSNET-18981	Data label of the zero point of BarChart is not rendered after conversion to PDF	Bug
WORDSNET-19123	Aspose.Words.Shaping summaries are empty in CHM help file	Bug
WORDSNET-18798	UpdateFields behaves differently from MS Word update engine	Bug
WORDSNET-14756	Nested table not clipped by outer inline table	Bug
WORDSNET-18799	Exception when rendering Word document as HTML	Bug
WORDSNET-17963	Shapes are rendered improperly during DOCX to PDF conversion	Bug
WORDSNET-18183	Floating table content inside cell with vertical text orientation rotated with text	Bug
WORDSNET-18988	Advance field is lost after calling Document.UpdateFields method	Bug
WORDSNET-18824	The new line characters are missing when loading MHTML files	Bug
WORDSNET-18821	Empty Bookmark is removed before IF field is evaluated when RemoveEmptyParagraphs is used	Bug
WORDSNET-19014	Issue with inserting RTF document in text columns	Bug
WORDSNET-19044	Aspose.Words HTML generation failed due to line drawing	Bug
WORDSNET-19036	The document gets corrupted after saving the DOCX file	Bug
WORDSNET-17924	InvalidOperationException while resaving to PDF	Bug
WORDSNET-19003	The transparency and size of TextBox error after DOCX to ODT	Bug
WORDSNET-18953	Issues with particular font types after EMF to PDF conversion	Bug
WORDSNET-18955	Position of list number is changed after rendering Image to PDF	Bug
WORDSNET-18732	DOCX to HTMLFixed conversion fails in DOCKER container	Bug
WORDSNET-18919	System.ArgumentException is thrown while saving DOCX to PDF	Bug
WORDSNET-18963	Content missing in rendered PDF	Bug
WORDSNET-18934	Fix rendering of OfficeMath/EQ Fields/Ruby text	Bug
WORDSNET-18652	Incorrect rtl text wrapping on conversion to PDF	Bug
WORDSNET-18972	Check the first part of suspicious code found by PVS studio	Bug
WORDSNET-18660	Tables are overlapped after conversion from DOC to PDF	Bug
WORDSNET-18854	Header text is changed after performing mail merge and calling Unlink method	Bug
WORDSNET-18971	Check the second part of suspicious code found by PVS studio	Bug
WORDSNET-18867	Document.Compare generates revisions for same documents	Bug
WORDSNET-19063	Aspose.Words.FileCorruptedException occurs upon loading a DOCX	Bug
WORDSNET-19062	24bppRgb image is screwed up in .NET core	Bug
WORDSNET-18886	Value cannot be null exception occurs - DOCX to PDF	Bug
WORDSNET-19072	Texture background is black instead of white	Bug
WORDSNET-19075	Image is resized after conversion with ISO29500_2008_Transitional Compliance	Bug
WORDSNET-17260	Shape’s text is lost after conversion from DOCX to PDF	Bug
WORDSNET-17449	Document.RemoveAllChildren does not remove all nodes	Bug
WORDSNET-15429	Nested tables rendering issue	Bug
WORDSNET-18397	A line shifts in PDF output	Bug
WORDSNET-17182	Content position is changed in output PDF	Bug
WORDSNET-18478	Merge.Execute throws System.NullReferenceException	Bug
WORDSNET-10826	Saving HTML to PDF takes long time	Bug
WORDSNET-14198	When Word document is converted to PDF, Japanese characters are moved to the next row	Bug
WORDSNET-7478	Loading Aspose assemblies is slow on terminal server	Bug
WORDSNET-7545	System.OutOfMemoryException exception while getting Document.PageCount	Bug

Public API and Backward Incompatible Changes

This section lists public API changes that were introduced in Aspose.Words 19.9. It includes not only new and obsoleted public methods, but also a description of any changes in the behavior behind the scenes in Aspose.Words which may affect existing code. Any behavior introduced that could be seen as regression and modifies existing behavior is especially important and is documented here.

Simplified working with XML, JSON, and CSV data sources for LINQ Reporting Engine

Issue: WORDSNET-18722

The following sections of the engine’s documentation were updated/added to describe the changes:

“Building Reports” “Accessing XML Data” “Accessing JSON Data” “Accessing CSV Data”

WORDSNET-12655 - Implemented ability to create repeating section structured document tags

Now it is possible to create structured document tag nodes of the repeating section and repeating section item types. The new item has also been added into the SdtType enumeration type:

public enum SdtType
{
…
    /// <summary>
    /// The SDT represents repeating section item.
    /// </summary>
    /// <remarks>
    /// This is MS-specific feature available since Office 2013 and not supported by the ISO/IEC 29500 OOXML standard.
    /// </remarks>
    RepeatingSectionItem,
…
}

Use case to create a table repeating section mapped to a custom XML part:

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
CustomXmlPart xmlPart = doc.CustomXmlParts.Add("Books",
    "<books><book><title>Everyday Italian</title><author>Giada De Laurentiis</author></book>" +
    "<book><title>Harry Potter</title><author>J K. Rowling</author></book>" +
    "<book><title>Learning XML</title><author>Erik T. Ray</author></book></books>");
Table table = builder.StartTable();
builder.InsertCell();
builder.Write("Title");
builder.InsertCell();
builder.Write("Author");
builder.EndRow();
builder.EndTable();
StructuredDocumentTag repeatingSectionSdt =
    new StructuredDocumentTag(doc, SdtType.RepeatingSection, MarkupLevel.Row);
repeatingSectionSdt.XmlMapping.SetMapping(xmlPart, "/books[1]/book", "");
table.AppendChild(repeatingSectionSdt);
StructuredDocumentTag repeatingSectionItemSdt =
    new StructuredDocumentTag(doc, SdtType.RepeatingSectionItem, MarkupLevel.Row);
repeatingSectionSdt.AppendChild(repeatingSectionItemSdt);
Row row = new Row(doc);
repeatingSectionItemSdt.AppendChild(row);
StructuredDocumentTag titleSdt =
    new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Cell);
titleSdt.XmlMapping.SetMapping(xmlPart, "/books[1]/book[1]/title[1]", "");
row.AppendChild(titleSdt);
StructuredDocumentTag authorSdt =
    new StructuredDocumentTag(doc, SdtType.PlainText, MarkupLevel.Cell);
authorSdt.XmlMapping.SetMapping(xmlPart, "/books[1]/book[1]/author[1]", "");
row.AppendChild(authorSdt);
doc.Save(dir + "Document.docx");

WORDSNET-17449 - Implemented SavePictureBullet option for Word 97, which cannot work correctly with PictureBullet data

A new public option has been added to the DocSaveOptions class:

/// <summary>
/// When <c>false</c>, PictureBullet data is not saved to output document.
/// Default value is <b>true</b>.
/// </summary>
/// <remarks>
/// <para>This option is provided for Word 97, which cannot work correctly with PictureBullet data.
/// To remove PictureBullet data, set the option to "false".</para>
/// </remarks>
public bool SavePictureBullet

Use Case. Explains how to remove PictureBullet data from the saving DOC-file:

Document doc = new Document("in.doc");
DocSaveOptions so = (DocSaveOptions)SaveOptions.CreateSaveOptions(SaveFormat.Doc);
so.SavePictureBullet = false;
doc.Save("out.doc", so);

WORDSNET-18210 - Incorrect number formatting in PDF

New elements added to public enumeration Aspose.Words.Shaping.FontFeature.

Currently, these font features are processed and correctly provided to the external shapers.

/// <summary>
/// Replaces figure glyphs set on uniform (tabular) widths with corresponding glyphs set on glyph-specific (proportional) widths.
/// https://docs.microsoft.com/en-us/typography/opentype/spec/features_pt#tag-pnum
/// Equivalent OpenType tag: 'pnum'
/// </summary>
ProportionalFigures,
/// <summary>
/// Replaces figure glyphs set on proportional widths with corresponding glyphs set on uniform (tabular) widths.
/// Tabular widths will generally be the default, but this cannot be safely assumed.
/// Of course this feature would not be present in monospaced designs.
/// https://docs.microsoft.com/en-us/typography/opentype/spec/features_pt#tag-tnum
/// Equivalent OpenType tag: 'tnum'
/// </summary>
TabularFigures,
/// <summary>
/// This feature changes selected non-lining figures to lining figures.
/// https://docs.microsoft.com/en-us/typography/opentype/spec/features_ko#lnum
/// Equivalent OpenType tag: 'lnum'
/// </summary>
LiningFigures,
/// <summary>
/// This feature changes selected figures from the default or lining style to oldstyle form.
/// https://docs.microsoft.com/en-us/typography/opentype/spec/features_ko#onum
/// Equivalent OpenType tag: 'onum'
/// </summary>
OldstyleFigures

WORDSNET-18369 - Remove License.IsLicensed property

The License.IsLicensed obsolete property has been removed in order to increase anti-hacking resistance. Moreover, this property was useless because of the License.SetLicense(…) throws an exception in case of a wrong license key.

WORDSNET-18697 - Provide API to write and modify VBA macros

A new public setter has been added to the VbaModule.SourceCode property:

/// <summary>
/// Gets or sets VBA project module source code.
/// </summary>
public string SourceCode

Use Case. Explains how to modify macro source code:

Document doc = new Document(@"test.docm");
VbaProject project = doc.VbaProject;
const string newSourceCode = "Test change source code";

// Choose a module, and set a new source code.
project.Modules[0].SourceCode = newSourceCode;

WORDSNET-19103 - Add feature to link CustomDocumentProperty to Bookmark

A new public method has been added: CustomDocumentProperties.AddLinkToContent(string, string)

/// <summary>
/// Creates a new linked to content custom document property.
/// </summary>
/// <param name="name">The name of the property.</param>
/// <param name="linkSource">The source of the property.</param>
/// <returns>The newly created property object or null when the linkSource is invalid.</returns>
public DocumentProperty AddLinkToContent(string name, string linkSource)

A new public properties has been added: DocumentProperty.LinkSource, DocumentProperty.IsLinkToContent

/// <summary>
/// Gets the source of a linked custom document property.
/// </summary>
public string LinkSource

/// <summary>
/// Shows whether this property is linked to content or not.
/// </summary>
public bool IsLinkToContent

Use Case. Configuring “Link to content” Custom Property:

Document doc = new Document(@"test.docx");

// Retrieve a list of all custom document properties from the file.
CustomDocumentProperties customProperties = doc.CustomDocumentProperties;

// Add linked to content property.
DocumentProperty customProperty = customProperties.AddLinkToContent("PropertyName", "BookmarkName");

// Also, accessing the custom document property can be performed by using the property name.
customProperty = customProperties["PropertyName"];

// Check whether the property is linked to content.
bool isLinkedToContent = customProperty.IsLinkToContent;

// Get the source of the property.
string source = customProperty.LinkSource;

// Get the value of the property.
string value = customProperty.Value;

19.10 Release Notes 19.8 Release Notes