GroupDocs.Viewer for .NET 18.9 Release Notes

Major Features

There are 12 features, improvements, and fixes in this regular monthly release. The most notable are:

  •  Added following file formats support
    • Computer Graphics Metafile (CGM)
    • Microsoft Outlook Personal Storage Table (PST)
    • Microsoft Outlook Offline Storage Table (OST)
  • Added support of rendering colored CAD drawings
  • Added support of rendering Microsoft Project documents as HTML with embedded resources

Full List of Issues Covering all Changes in this Release

KeySummaryCategory
VIEWERNET-1709Add CGM (Computer Graphics Metafile) file format supportNew Feature
VIEWERNET-1676Add support for rendering PST file formatNew Feature
VIEWERNET-1675Add support for rendering OST file formatNew Feature
VIEWERNET-1674Obtaining start and end dates from MS Project documentNew Feature
VIEWERNET-1729Extend support for HtmlOptions.ExcludeFonts setting when rendering MS Project documents as HTMLImprovement
VIEWERNET-1710Cleanup FileDescription and DocumentInfoContainer classesImprovement
VIEWERNET-1706Include Photoshop file format (PSD) into the list of supported file formatsImprovement
VIEWERNET-1705Implement rendering color CAD drawingsImprovement
VIEWERNET-1673Improve output for printable HTMLImprovement
VIEWERNET-1200Extend support of HtmlOptions.IsResourceEmbedded option for Microsoft Project documentsImprovement
VIEWERNET-1715Exception: CAD document rendering failedBug
VIEWERNET-1640Issue when rendering email message having attachments with same nameBug

Public API and Backward Incompatible Changes

Obtaining start and end dates from MS Project document

MS Project documents can be of the various length. In some cases, it might be convenient to render Projects by dividing into parts with the equal period of time. Since the version 18.9 GroupDocs.Viewer API allows achieving that. First by obtaining the document overall length and then by splitting rendering with specified start and end date options.

How to get overall length of MS Project document

The overall length of MS Project document can be determined by the start and end date values returned from GetDocumentInfo of the ViewerHandler class as shown in the example below. 

Obtaining the overall length of MS Project document

// Setup GroupDocs.Viewer config
ViewerConfig config = new ViewerConfig();
config.StoragePath = @"C:\storage";
config.UseCache = true;
  
// Create image handler
ViewerImageHandler imageHandler = new ViewerImageHandler(config);
string guid = "verylongdocument.mpp";
  
ProjectDocumentInfoContainer documentInfo = (ProjectDocumentInfoContainer) imageHandler.GetDocumentInfo(guid);
 
// Output document start and end dates
Console.WriteLine("Project start date: {0}", documentInfo.StartDate);
Console.WriteLine("Project end date: {0}", documentInfo.EndDate);

List of Changes in v18.9

In the version 18.9, following public class members were added, marked as obsolete, removed or replaced.

GroupDocs.Viewer.Converter.Options.RenderOptions

Public OutlookOptions OutlookOptions property added

Use this property to set rendering options for Outlook Data File format (PST/OST) as shown in examples below:

Rendering Outlook Data File documents with limit of items

// Setup GroupDocs.Viewer config
ViewerConfig config = new ViewerConfig();
config.StoragePath = @"C:\storage";
  
// Create HTML handler
ViewerHtmlHandler htmlHandler = new ViewerHtmlHandler(config);
string guid = "sample.pst";
  
// Set Outlook options to render content with a specified limit.
HtmlOptions options = new HtmlOptions();
options.OutlookOptions.MaxItemsInFolder = 1000;
 
// Get pages 
List<PageHtml> pages = htmlHandler.GetPages(guid, options);
  
foreach (PageHtml page in pages)
 Console.WriteLine("Page number: {0}", page.HtmlContent); 

Get PDF representation of Outlook documents with specified limit of items

// Setup GroupDocs.Viewer config
ViewerConfig config = new ViewerConfig();
config.StoragePath = @"C:\storage";
  
// Create image handler
ViewerImageHandler imageHandler = new ViewerImageHandler(config);
string guid = "sample.pst";
  
// Set Project options to render content with a specified size and time unit.
PdfFileOptions options = new PdfFileOptions();
options.OutlookOptions.MaxItemsInFolder = 1000;
 
// Get PDF file 
FileContainer fileContainer = imageHandler.GetPdfFile(guid, options);
 
// Access PDF file stream.
Stream pdfFileStream = fileContainer.Stream;

GroupDocs.Viewer.Domain.CachedDocumentDescription

Public OutlookOptions OutlookOptions property added

This property is used for setting Outlook Data File document (PST/OST) rendering options.

GroupDocs.Viewer.Domain.CachedPageDescription

Public OutlookOptions OutlookOptions property added

This property is used for setting Outlook Data File document (PST/OST) rendering options.

GroupDocs.Viewer.Domain.Containers.DocumentInfoContainer

string FileFormat { get; } property added

Gets the file format e.g. “Microsoft Word”.

string DocumentType { get; } property marked as obsolete

This property is obsolete and will be removed after v18.11. Use FileFormat property instead.

string FileType { get; } property marked as obsolete

This property is obsolete and will be removed after v18.11. Use FileFormat property instead.

string DocumentTypeFormat { get; } property marked as obsolete

This property is obsolete and will be removed after v18.11. Use FileFormat property instead.

GroupDocs.Viewer.Domain.Containers.ProjectDocumentInfoContainer

GroupDocs.Viewer.Domain.Containers.ProjectDocumentInfoContainer class has been added

This class represents a container for MS Project document description.

GroupDocs.Viewer.Domain.FileDescription

string FileFormat { get; } property added

Gets the file format e.g. “Microsoft Word”.

string BaseName { get; } property marked as obsolete

This property is obsolete and will be removed after v18.11. To get base name use following code: System.IO.Path.GetFileNameWithoutExtension(fileDescription.Name).

string DocumentType { get; } property marked as obsolete

This property is obsolete and will be removed after v18.11. Use FileFormat property instead.

string FileType { get; } property marked as obsolete

This property is obsolete and will be removed after v18.11. Use FileFormat property instead.

GroupDocs.Viewer.Domain.Html.HtmlResource

Public OutlookOptions OutlookOptions property added

This property is used for setting Outlook Data File document (PST/OST) rendering options.

GroupDocs.Viewer.Domain.Options.DocumentInfoOptions

Public OutlookOptions OutlookOptions property added

This property is used for setting Outlook Data File document (PST/OST) rendering options.

GroupDocs.Viewer.Domain.Options.PdfFileOptions

Public OutlookOptions OutlookOptions property added

This property is used for setting Outlook Data File document (PST/OST) rendering options.

GroupDocs.Viewer.Domain.ProjectFileData

GroupDocs.Viewer.Domain.ProjectFileData class has been added

This class extends FileData class and contains properties specific to MS Project documents.