GroupDocs.Conversion for Java 21.1 Release Notes

Major Features

There are 20+ features, improvements and bug-fixes in this release, most notable are:

• Conversions to Dif
• Conversions from/to SXC
• Conversions from AI
• Conversions from/to Emz
• Conversions from/to Wmz
• Conversions from/to Svgz
• Conversions from LOG file format
• Extended meta data for word processing documents with TableOfContent
• Extended meta data for pdf documents with TableOfContent
• Fixed conversions from XLSX to PNG
• Fixed conversions from DWG to DOCX
• Properly detect email type even if file extension is incorrect
• Conversions from Mhtml
• Improved page extraction when converting from wordprocessing documents
• Improved csv/ods pagination

Full List of Issues Covering all Changes in this Release

Public API and Backward Incompatible Changes

1. Introduced new property in class WatermarkOptions

   /**
   * Watermark font if text watermark is applied
   * @return font
   */ 
   public Font getWatermarkFont();
       
   /**
   * Sets Watermark font if text watermark is applied
   *
   * @param watermarkFont font
   */
   public void setWatermarkFont(Font watermarkFont);
   
   

2. Following properties are marked as obsolete

   • GroupDocs.Conversion.Options.Convert.WatermarkOptions property getFont() / setFont() - will be removed in v21.3. Property getWatermarkFont() / setWatermarkFont must be used instead.

3. Following properties are removed

   • From GroupDocs.Conversion.ConverterSettings property getDefaultFont() / setDefaultFont()
   • From GroupDocs.Conversion.Options.Load.EmailLoadOptions property isConvertAttachments() / setConvertAttachments()

4. Introduced new property in class WordprocessingDocumentInfo

   /**
   * Table of contents
   */
   public List<TableOfContentsItem> getTableOfContents()
   

5. Introduced new property in class PdfDocumentInfo

   /**
   * Table of contents
   */
   public IEnumerable<TableOfContentsItem> getTableOfContents();
   

6. Introduced new class GroupDocs.Conversion.Contracts.TableOfContentsItem

   /**
   * Contains Table of contents item metadata
   */
   public class TableOfContentsItem {
       /**
       * Bookmark title
       */
       public string getTitle();
       /**
       * Bookmark page
       */
       public int getPage();
   }
   

   Usage

   String source = "sample-toc.docx";
   Converter converter = new Converter(source);
   try {
       WordprocessingDocumentInfo documentInfo = (WordprocessingDocumentInfo) converter.getDocumentInfo();
       for (TableOfContentsItem tocItem : documentInfo.getTableOfContents()) {
           System.out.println(tocItem.getTitle() + ": " + tocItem.getPage());
       }
   } finaly {
       converter.dispose();
   }
   

7. Introduced new property in class SpreadsheetLoadOptions

   /**
   * Whether check restriction of excel file when user modify cells related objects.
   * For example, excel does not allow inputting string value longer than 32K.
   * When you input a value longer than 32K, if this property is true, you will get an Exception.
   * If this property is false, we will accept your input string value as the cell's value so that later
   * you can output the complete string value for other file formats such as CSV.
   * However, if you have set such kind of value that is invalid for excel file format, you should not save
   * the workbook as excel file format later. Otherwise there may be unexpected error for the generated excel file.
   */
   public boolean isCheckExcelRestriction();
       
   public boolean setCheckExcelRestriction();