Aspose.Email for Java 21.10 Release Notes

All Changes

KeySummaryCategory
EMAILNET-40441Add support for saving appointments to MSG formatFeature
EMAILNET-40449MSG file body with emoji is changed after Load/SaveEnhancement
EMAILNET-40440Optional attendees are not displayed in the mht header outputEnhancement
EMAILNET-40446Incorrect ClientSubmitTime when converting EML to MSGBug
EMAILNET-40455EmlLoadOptions.PrefferedTextEncoding option works differently for different EML filesBug
EMAILNET-40436New unique custom message flags are detected as existingBug
EMAILNET-40425Event appears only in one day, but should repeat every yearBug
EMAILJAVA-34961GraphMessageInfo.getSize() method always returns -1Enhancement
EMAILJAVA-34954IGraphClient NextPageEnhancement
EMAILJAVA-34957GraphClient.listFolders does not return full list of foldersBug

New Features

Saving appointments to MSG format

It’s now possible to save appointments directly to .msg files. The following public classes have been added to the API:

  • AppointmentMsgSaveOptions

    class with additional options to save appointments in msg format.

  • AppointmentIcsSaveOptions

    class with additional options to save appointment in ics format. It was added to replace the obsolete IcsSaveOptions.

Code example

Appointment appointment = Appointment.load("fileName");
appointment.save("fileName.ics", new AppointmentIcsSaveOptions());
appointment.save("fileName.msg", new AppointmentMsgSaveOptions());

Preserving RTF body when converting MapiMessage to MailMesage

Changes in public API

  • MsgLoadOptions.PreserveRtfContent

    Gets or sets a value indicating whether to keep the rtf body in MailMessage.

  • MailConversionOptions.PreserveRtfContent

    Gets or sets a value indicating whether to keep the rtf body in MailMessage.

Code example

The MsgLoadOptions example

MsgLoadOptions options = new MsgLoadOptions();
options.setPreserveRtfContent(true);
MailMessage message = MailMessage.load("fileName", options);

The MailConversionOptions example

MapiMessage mapi = MapiMessage.load("fileName");
MailConversionOptions options = new MailConversionOptions();
options.setPreserveRtfContent(true);
MailMessage message = mapi.toMailMessage(options);

Displaying the optional attendees in the mht header output

Changes in public API

  • MhtTemplateName.OPTIONAL_ATTENDEES

    Optional attendees header name.

Code example

MhtSaveOptions options = new MhtSaveOptions();
options.setMhtFormatOptions(MhtFormatOptions.RenderCalendarEvent | MhtFormatOptions.WriteHeader);

MapiMessage message = MapiMessage.load("fileName");
message.save("fileName.mhtml", options);

//if you need to skip OPTIONAL_ATTENDEES in mhtml file you can clear format template for OPTIONAL_ATTENDEES
options.getFormatTemplates().set_Item(MhtTemplateName.OPTIONAL_ATTENDEES, "");
message.save("fileName2.mhtml", options);