Управление файлами сообщений с помощью Aspose.Email.Outlook
Преобразование MSG в MIME-сообщение
API Aspose.Email предоставляет возможность преобразования файлов MSG в MIME-сообщения с помощью метода toMailMessage.
// Для полных примеров и файлов данных, пожалуйста, перейдите по ссылке https://github.com/aspose-email/Aspose.Email-for-Java MapiMessage msg = new MapiMessage( "sender@test.com", "recipient1@test.com; recipient2@test.com", "Тема теста", "Это тело сообщения."); MailConversionOptions options = new MailConversionOptions(); options.setConvertAsTnef(true); MailMessage mail = msg.toMailMessage(options); Преобразование MSG в EML с сохранением RTF-содержимого
API предоставляет следующие методы для сохранения RTF-содержимого при преобразовании MSG в EML:
- MsgLoadOptions.PreserveRtfContent - Получает или задает значение, указывающее, следует ли сохранять RTF-содержимое в MailMessage.
- MailConversionOptions.PreserveRtfContent - Получает или задает значение, указывающее, следует ли сохранять RTF-содержимое в MailMessage.
Следующие примеры кода демонстрируют, как сохранить RTF-содержимое в MailMessage:
- используя MsgLoadOptions.PreserveRtfContent
MsgLoadOptions options = new MsgLoadOptions(); options.setPreserveRtfContent(true); MailMessage message = MailMessage.load("fileName", options); - используя MailConversionOptions.PreserveRtfContent
MapiMessage mapi = MapiMessage.load("fileName"); MailConversionOptions options = new MailConversionOptions(); options.setPreserveRtfContent(true); MailMessage message = mapi.toMailMessage(options); Преобразование MSG в MHTML с сохранением заголовка категории
API Aspose.Email предоставляет возможность добавления заголовка категории при преобразовании сообщения в MHTML. Эта функция задается классом MhtSaveOptions в качестве дополнительной опции при сохранении MailMessage в формате Mhtml.
Следующий пример кода демонстрирует, как создать файл MHT (MHTML) из объекта MapiMessage, настроить форматирование и заголовки MHT файла с использованием MhtSaveOptions, установить категории для электронного сообщения и затем изменить шаблоны формата и заголовков рендеринга для MHT файла перед его сохранением.
MapiMessage msg = new MapiMessage("from@aaa.com", "to@aaa.com", "subj", "body"); msg.setCategories(new String[] { "Срочно", "Важно" }); MhtSaveOptions saveOptions = new MhtSaveOptions(); saveOptions.getFormatTemplates().set_Item(MhtTemplateName.CATEGORIES, saveOptions.getFormatTemplates().get_Item(MhtTemplateName.CATEGORIES).replace("Categories", "Категории")); saveOptions.getRenderingHeaders().add(MhtTemplateName.CATEGORIES); msg.save("fileName.mhtml", saveOptions); Чтение и запись файла шаблона Outlook (.OFT)
Шаблоны Outlook очень полезны, когда вы хотите постоянно отправлять аналогичные электронные сообщения. Вместо того чтобы каждый раз готовить сообщение с нуля, сначала подготовьте сообщение в Outlook и сохраните его как шаблон Outlook (OFT). После этого, когда вам нужно будет отправить сообщение, вы можете создать его из шаблона, экономя время на написание одного и того же текста в теле или строке темы, установке форматирования и так далее. Класс Aspose.Email MailMessage может использоваться для загрузки и чтения файла шаблона Outlook (OFT). После загрузки шаблона Outlook в экземпляр класса MailMessage вы можете обновить отправителя, получателя, тело, тему и другие свойства. После обновления свойств:
- Отправьте электронное письмо с использованием класса SmtpClient или
- Сохраните сообщение в формате MSG и выполните дальнейшие обновления/валидацию с помощью Microsoft Outlook.
В следующих примерах кода мы:
- Загружаем шаблон с использованием класса MailMessage.
- Обновляем некоторые свойства.
- Сохраняем сообщение в формате MSG.
Следующий фрагмент кода показывает, как загрузить файл OFT, обновить сообщение и сохранить его в формате MSG.
// Для полных примеров и файлов данных, пожалуйста, перейдите по ссылке https://github.com/aspose-email/Aspose.Email-for-Java // Путь к директории файлов. String dataDir = "outlook/"; // Загрузка файла шаблона Outlook (OFT) в экземпляре MailMessage MailMessage message = MailMessage.load(dataDir + "sample.oft", new MsgLoadOptions()); // Установка информации об отправителе и получателе String senderDisplayName = "Джон"; String senderEmailAddress = "john@abc.com"; String recipientDisplayName = "Уильям"; String recipientEmailAddress = "william@xzy.com"; message.setSender(new MailAddress(senderEmailAddress, senderDisplayName)); message.getTo().addMailAddress(new MailAddress(recipientEmailAddress, recipientDisplayName)); message.setHtmlBody(message.getHtmlBody().replace("DisplayName", "<b>" + recipientDisplayName + "</b>")); // Установка имени, места и времени в теле электронной почты String meetingLocation = "<u>" + "Зал 1, Конгресс-центр, Нью-Йорк, США" + "</u>"; String meetingTime = "<u>" + "Понедельник, 28 июня 2010 года" + "</u>"; message.setHtmlBody(message.getHtmlBody().replace("MeetingPlace", meetingLocation)); message.setHtmlBody(message.getHtmlBody().replace("MeetingTime", meetingTime)); // Сохранение сообщения в формате MSG и открытие в Office Outlook MapiMessage mapimessage = MapiMessage.fromMailMessage(message); mapimessage.setMessageFlags(MapiMessageFlags.MSGFLAG_UNSENT); mapimessage.save(dataDir + "ReadAndWritingOutlookTemplateFile_out.msg"); Сохранение файла Outlook MSG в качестве шаблона
Следующий фрагмент кода показывает, как сохранить файл Outlook MSG в качестве шаблона.
// Для полных примеров и файлов данных, пожалуйста, перейдите по ссылке https://github.com/aspose-email/Aspose.Email-for-Java // Путь к директории файлов. String dataDir = "outlook/"; try (MapiMessage mapi = new MapiMessage("test@from.to", "test@to.to", "тема шаблона", "Тело шаблона")) { mapi.saveAsTemplate(dataDir + "mapiToOft.msg"); } Установка цветовой категории для файлов Outlook MSG
Цветовая категория помечает электронное сообщение как важное или относящееся к определенной категории. Microsoft Outlook позволяет пользователям назначать цветовые категории для различения электронных писем. Для работы с цветовой категорией используйте FollowUpManager. Он содержит функции такие как addCategory, removeCategory, clearCategories и getCategories.
- addCategory принимает MapiMessage и строку цветовой категории, например, “Фиолетовая категория” или “Красная категория” в качестве аргументов.
- removeCategory принимает MapiMessage и строку цветовой категории, которую нужно удалить из сообщения.
- clearCategories используется для удаления всех цветовых категорий из сообщения.
- getCategories используется для извлечения всех цветовых категорий из конкретного сообщения.
Следующий пример выполняет указанные ниже задачи:
- Добавить цветовую категорию.
- Добавить другую цветовую категорию.
- Извлечь список всех категорий.
- Удалить все категории.
// Для полных примеров и файлов данных, пожалуйста, перейдите по ссылке https://github.com/aspose-email/Aspose.Email-for-Java // Путь к директории файлов. String dataDir = "outlook/"; MapiMessage msg = MapiMessage.fromFile(dataDir + "message.msg"); // Добавить две категории FollowUpManager.addCategory(msg, "Фиолетовая категория"); FollowUpManager.addCategory(msg, "Красная категория"); // Извлечь список доступных категорий IList categories = FollowUpManager.getCategories(msg); // Удалить указанную категорию, а затем очистить все категории FollowUpManager.removeCategory(msg, "Красная категория"); FollowUpManager.clearCategories(msg); Получение информации об отслеживании из файла MSG
API Aspose.Email предоставляет возможность доступа к информации об отслеживании из отправленного или полученного сообщения. Он может извлекать информацию о прочтении, подтверждении доставки и результатах голосования из файла сообщения.
Извлечение информации о прочтении и подтверждении доставки
Следующий фрагмент кода показывает, как извлечь информацию о прочтении и подтверждении доставки.
// Для полных примеров и файлов данных, пожалуйста, перейдите по ссылке https://github.com/aspose-email/Aspose.Email-for-Java // Путь к директории файлов. String dataDir = "outlook/"; MapiMessage msg = MapiMessage.fromFile(dataDir + "message.msg"); for (MapiRecipient recipient : msg.getRecipients()) { System.out.println("Получатель: " + recipient.getDisplayName()); // Получить свойство PR_RECIPIENT_TRACKSTATUS_TIME_DELIVERY System.out.println("Время доставки: " + recipient.getProperties().get_Item(MapiPropertyTag.PR_RECIPIENT_TRACKSTATUS_TIME_DELIVERY).getDateTime()); // Получить свойство PR_RECIPIENT_TRACKSTATUS_TIME_READ System.out.println("Время прочтения: " + recipient.getProperties().get_Item(MapiPropertyTag.PR_RECIPIENT_TRACKSTATUS_TIME_READ).getDateTime()); } Создание сообщений “Переслать” и “Ответить”
API Aspose.Email предоставляет возможность создания и форматирования сообщений “Переслать” и “Ответить”. Классы ReplyMessageBuilder и ForwardMessageBuilder API используются для создания сообщений “Ответ” и “Переслать”, соответственно. Сообщение “Ответ” или “Переслать” может быть указано на создание с использованием любого из режимов перечисления OriginalMessageAdditionMode. Это перечисление имеет следующие значения:
- OriginalMessageAdditionMode.None - Исходное сообщение не включается в ответное сообщение.
- OriginalMessageAdditionMode.Attachment - Исходное сообщение включается как вложение в ответное сообщение
- OriginalMessageAdditionMode.Textpart - Исходное сообщение включается как текст в теле ответного сообщения.
Создание сообщения “Ответ”
Следующий фрагмент кода показывает, как создать сообщение “Ответ”.
// Для полных примеров и файлов данных, пожалуйста, перейдите по ссылке https://github.com/aspose-email/Aspose.Email-for-Java // Путь к директории файлов. String dataDir = "outlook/"; MapiMessage originalMsg = MapiMessage.fromFile(dataDir + "message1.msg"); ReplyMessageBuilder builder = new ReplyMessageBuilder(); // Установка свойств ReplyMessageBuilder builder.setReplyAll(true); builder.setAdditionMode(OriginalMessageAdditionMode.Textpart); builder.setResponseText( "<p><b>Дорогой друг,</b></p> Я хочу представить моего соавтора и сослуживца. <p><a href=\"www.google.com\">Это первая ссылка</a></p><p><a href=\"www.google.com\">Это вторая ссылка</a></p>"); MapiMessage replyMsg = builder.buildResponse(originalMsg); replyMsg.save(dataDir + "reply_out.msg"); Создание сообщения “Переслать”
Следующий фрагмент кода показывает, как создать сообщение “Переслать”.
// Для полных примеров и файлов данных, пожалуйста, перейдите по ссылке https://github.com/aspose-email/Aspose.Email-for-Java // Путь к директории файлов. String dataDir = "outlook/"; MapiMessage originalMsg = MapiMessage.fromFile(dataDir + "message1.msg"); ForwardMessageBuilder builder = new ForwardMessageBuilder(); builder.setAdditionMode(OriginalMessageAdditionMode.Textpart); MapiMessage forwardMsg = builder.buildResponse(originalMsg); forwardMsg.save(dataDir + "forward_out.msg"); Сохранение пустых дат при преобразовании сообщения
Свойство MapiConversionOptions.setPreserveEmptyDates(boolean) указывает, необходимо ли сохранять пустые даты при преобразовании сообщения. Этот API появился в Aspose.Email 21.5. Следующий фрагмент кода показывает, как сохранить пустые даты.
MailMessage mailMessage = MailMessage.load("message.eml"); System.out.println(mailMessage.getDate()); // нулевая дата MapiConversionOptions mco = MapiConversionOptions.getUnicodeFormat(); // сохранить пустые даты при преобразовании сообщения mco.setPreserveEmptyDates(true); MapiMessage mapiMessage = MapiMessage.fromMailMessage(mailMessage, mco); System.out.println(mapiMessage.getClientSubmitTime()); // нулевая дата // проверка нулевой даты if (mapiMessage.getClientSubmitTime().equals(JavaHelper.ZERO_DATE)) System.out.println("НУЛЕВАЯ ДАТА");