Documentation – Робота з елементами Outlook

Java: Створення та збереження файлів MSG

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email підтримує створення файлів Outlook message (MSG). У цій статті пояснюється, як:

Створити повідомлення MSG.
Створити повідомлення MSG з вкладеннями.
Створити повідомлення MSG з тілом RTF.
Зберегти повідомлення як чернетку.
Робота зі стисканням тіла.

Створення та збереження повідомлень Outlook

The MailMessage клас має зберегти метод, який може зберігати файли Outlook MSG на диск або в потік. Наведені нижче фрагменти коду створюють екземпляр MailMessage клас, встановлює властивості, такі як from, to, subject і body. Метод зберегти метод приймає ім’я файлу як аргумент. Крім того, повідомлення Outlook можна створювати з стиснене тіло RTF використовуючи MapiConversionOptions.

Створіть новий екземпляр MailMessage класу та встановлює властивості From, To, Subject і Body.
Викличте MapiMessage клас fromMailMessage метод, який приймає об’єкт MailMessage тип. fromMailMessage метод конвертує MailMessage у MapiMessage (MSG).
Викличте MapiMessage.save метод для збереження файлу MSG.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Create an instance of the MailMessage class
MailMessage mailMsg = new MailMessage();

// Set from, to, subject and body properties
mailMsg.setFrom(MailAddress.to_MailAddress("sender@domain.com"));
mailMsg.setTo(MailAddressCollection.to_MailAddressCollection("receiver@domain.com"));
mailMsg.setSubject("This is test message");
mailMsg.setBody("This is test body");

// Create an instance of the MapiMessage class and pass MailMessage as argument
MapiMessage outlookMsg = MapiMessage.fromMailMessage(mailMsg);

// Save the message (MSG) file
String strMsgFile = "CreatingAndSavingOutlookMessages_out.msg";
outlookMsg.save(dataDir + strMsgFile);

Створення файлів MSG з вкладеннями

У наведеному вище прикладі, ми створили простий файл MSG. Aspose.Email також підтримує збереження файлів повідомлень з вкладеннями. Все, що потрібно зробити, це додати вкладення до MailMessage екземпляр. Додавайте вкладення, викликаючи метод addItem на MailMessage.Attachments колекція.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

String[] files = new String[2];
files[0] = "attachment.doc";
files[1] = "attachment.png";

// Create an instance of the MailMessage class
MailMessage mailMsg = new MailMessage();

// Set from, to, subject and body properties
mailMsg.setFrom(MailAddress.to_MailAddress("sender@domain.com"));
mailMsg.setTo(MailAddressCollection.to_MailAddressCollection("receiver@domain.com"));
mailMsg.setSubject("This is test message");
mailMsg.setBody("This is test body");

// Add the attachments
for (String strFileName : files)
{
    mailMsg.getAttachments().addItem(new Attachment(strFileName));
}

// Create an instance of MapiMessage class and pass MailMessage as argument
MapiMessage outlookMsg = MapiMessage.fromMailMessage(mailMsg);
String strMsgFile = "CreateMessagesWithAttachments.msg";
outlookMsg.save(dataDir + strMsgFile);

Створення файлів MSG з тілом RTF

Ви також можете створювати файли Outlook Message (MSG) з тілями у форматі RTF за допомогою Aspose.Email. Тіло RTF підтримує текстове форматування. Створіть його, встановивши MailMessage.HtmlBody властивість. Коли ви конвертуєте MailMessage екземпляр у MapiMessage у випадку, HTML‑тіло конвертується у RTF. Таким чином, форматування тіла листа зберігається.

Наступний приклад створює файл MSG з тілом у форматі RTF. У HTML‑тілі є один заголовок, застосовано форматування жирним та підкресленим. Це форматування зберігається під час конвертації HTML у RTF.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Create an instance of the MailMessage class
MailMessage mailMsg = new MailMessage();

// Set from, to, subject and body properties
mailMsg.setFrom(MailAddress.to_MailAddress("sender@domain.com"));
mailMsg.setTo(MailAddressCollection.to_MailAddressCollection("receiver@domain.com"));
mailMsg.setSubject("This is test message");
mailMsg.setHtmlBody("<h3>rtf example</h3><p>creating an <b><u>outlook message (msg)</u></b> file using Aspose.Email.</p>");

MapiMessage outlookMsg = MapiMessage.fromMailMessage(mailMsg);
outlookMsg.save(dataDir + "CreatingMSGFilesWithRTFBody_out.msg");

Збереження повідомлення у статусі чернетки

Листи зберігаються як чернетки, коли хтось розпочав їх редагування, але бажає повернутися до них, щоб завершити пізніше. Aspose.Email підтримує збереження повідомлень електронної пошти у стані чернетки шляхом встановлення прапорця повідомлення. Нижче наведено приклад коду для збереження Outlook листа (MSG) як чернетки.

Зверніть увагу, що у статусі чернетки Outlook не відображає жодної інформації про відправника, присвоєної MapiMessage. Якщо потрібно показати інформацію про відправника, слід встановити прапорець MSGFLAG_READ.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Change properties of an existing MSG file
String strExistingMsg = "message.msg";

// Load the existing file in MailMessage and Change the properties
MailMessage msg = MailMessage.load(dataDir + strExistingMsg, new MsgLoadOptions());
msg.setSubject(msg.getSubject() + " NEW SUBJECT (updated by Aspose.Email)");
msg.setHtmlBody(msg.getHtmlBody() + " NEW BODY (udpated by Aspose.Email)");

// Create an instance of type MapiMessage from MailMessage, Set message flag to un-sent (draft status) and Save it
MapiMessage mapiMsg = MapiMessage.fromMailMessage(msg);
mapiMsg.setMessageFlags(MapiMessageFlags.MSGFLAG_UNSENT);
mapiMsg.save(dataDir + "SavingMessageInDraftStatus_out.msg");

Наслідки стискання тіла

Метод стискання тіла RTF можна використати для створення MSG меншого розміру. Однак це призводить до більш повільної швидкості створення. Щоб створювати повідомлення швидше, встановіть прапорець у false. Цей прапорець, у свою чергу, впливає на створені PST: менші файли MSG дають менші PST, а великі файли MSG призводять до більш повільного створення PST.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String fileName = "outlook/test.msg";

MailMessage message = MailMessage.load(fileName);
MapiConversionOptions options = new MapiConversionOptions();
options.setUseBodyCompression(true);
MapiMessage ae_mapi = MapiMessage.fromMailMessage(message, options);

Java: Завантаження, перегляд та розбір файлу MSG

Mon, 01 Jan 0001 00:00:00 +0000

У цьому розділі пояснюється, як завантажити файл повідомлення Microsoft Outlook (*.msg). The MapiMessage клас використовується для завантаження файлів MSG і надає кілька статичних функцій завантаження для різних сценаріїв. Нижче наведено фрагмент коду, який показує, як завантажити файли MSG з файлу або з потоку.

Завантаження файлів MSG

Нижче наведено фрагмент коду, який показує, як завантажити файли MSG.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

// Create an instance of MapiMessage from file
MapiMessage msg = MapiMessage.fromFile(dataDir + "message.msg");

// Get subject
System.out.println("Subject:" + msg.getSubject());

// Get from address
System.out.println("From:" + msg.getSenderEmailAddress());

// Get body
System.out.println("Body" + msg.getBody());

// Get recipients information
System.out.println("Recipient: " + msg.getRecipients());

// Get attachments
for (MapiAttachment att : msg.getAttachments())
{
    System.out.println("Attachment Name: " + att.getFileName());
    System.out.println("Attachment Display Name: " + att.getDisplayName());
}

Нижче наведено приклад коду, який показує, як використати MailMessage для завантаження повідомлення у форматі MSG.

MailMessage eml = MailMessage.load("message.msg");

Слід зауважити, що результуюче повідомлення конвертується у формат EML, включаючи вбудовані вкладення повідомлень. Не використовуйте цей метод завантаження, якщо ви хочете зберегти деякі специфічні властивості формату msg оригінального повідомлення.

Щоб зберегти оригінальний формат вбудованих вкладень повідомлень, використайте MsgLoadOptions.PreserveEmbeddedMessageFormat властивість.

MsgLoadOptions msgLoadOptions = new MsgLoadOptions();
msgLoadOptions.setPreserveEmbeddedMessageFormat(true);
MailMessage msg = MailMessage.load(stream, msgLoadOptions);

Завантаження з потоку

Нижче наведено фрагмент коду, який показує, як завантажити файл із потоку.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Create an instance of MapiMessage from file
try (FileInputStream stream = new FileInputStream(dataDir + "message.msg"))
{
    // Create an instance of MapiMessage from file
    MapiMessage msg = MapiMessage.fromStream(stream);

    // Get subject
    System.out.println("Subject:" + msg.getSubject());

    // Get from address
    System.out.println("From:" + msg.getSenderEmailAddress());

    // Get body
    System.out.println("Body" + msg.getBody());

}

Конвертування EML у MSG з збереженням формату вбудованих EML

Файли EML можна завантажити в MapiMessage клас шляхом створення MailMessage об’єкт і передаючи його до MapiMessage.fromMailMessage метод. Якщо файл EML містить вбудовані файли EML, використовуйте MapiConversionOptions.setPreserveEmbeddedMessageFormat для збереження формату вбудованих файлів EML. Нижче наведено фрагмент коду, який показує, як завантажити файли EML у MapiMessage при збереженні формату вбудованих файлів EML.

Спробуйте!

Конвертуйте електронні листи та архіви повідомлень онлайн безкоштовно Додаток конвертації Aspose.Email.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String dataDir = RunExamples.getDataDir_Email();

MailMessage eml = MailMessage.load(dataDir + "sample.eml", new EmlLoadOptions());

MapiConversionOptions options = MapiConversionOptions.getUnicodeFormat();

//Preserve Embedded Message Format
options.setPreserveEmbeddedMessageFormat(true);

//Convert EML to MSG with Options
MapiMessage msg = MapiMessage.fromMailMessage(eml, options);

Java: Керування файлами повідомлень за допомогою Aspose.Email.Outlook

Mon, 01 Jan 0001 00:00:00 +0000

Конвертація MSG у MIME‑повідомлення

API Aspose.Email забезпечує можливість конвертування файлів MSG у MIME‑повідомлення за допомогою toMailMessage метод.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
MapiMessage msg = new MapiMessage(
                            "sender@test.com",
                            "recipient1@test.com; recipient2@test.com",
                            "Test Subject",
                            "This is a body of message.");
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[] { "Urgently", "Important" });

MhtSaveOptions saveOptions = new MhtSaveOptions();

saveOptions.getFormatTemplates().set_Item(MhtTemplateName.CATEGORIES,

    saveOptions.getFormatTemplates().get_Item(MhtTemplateName.CATEGORIES).replace("Categories", "Les catégories"));

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.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Load the Outlook template (OFT) file in MailMessage's instance
MailMessage message = MailMessage.load(dataDir + "sample.oft", new MsgLoadOptions());

// Set the sender and recipients information
String senderDisplayName = "John";
String senderEmailAddress = "john@abc.com";
String recipientDisplayName = "William";
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>"));

// Set the name, location and time in email body
String meetingLocation = "<u>" + "Hall 1, Convention Center, New York, USA" + "</u>";
String meetingTime = "<u>" + "Monday, June 28, 2010" + "</u>";
message.setHtmlBody(message.getHtmlBody().replace("MeetingPlace", meetingLocation));
message.setHtmlBody(message.getHtmlBody().replace("MeetingTime", meetingTime));

// Save the message in MSG format and open in Office Outlook
MapiMessage mapimessage = MapiMessage.fromMailMessage(message);
mapimessage.setMessageFlags(MapiMessageFlags.MSGFLAG_UNSENT);
mapimessage.save(dataDir + "ReadAndWritingOutlookTemplateFile_out.msg");

Збереження файлу Outlook MSG як шаблону

У наведеному фрагменті коду показано, як зберегти файл Outlook MSG як шаблон.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

try (MapiMessage mapi = new MapiMessage("test@from.to", "test@to.to", "template subject", "Template body")) {
    mapi.saveAsTemplate(dataDir + "mapiToOft.msg");
}

Встановлення кольорової категорії для файлів Outlook MSG

Кольорова категорія позначає електронне повідомлення певною важливістю або типом. Microsoft Outlook дозволяє користувачам призначати кольорові категорії для розрізнення листів. Щоб працювати з кольоровою категорією, використовуйте FollowUpManager. Містить такі функції, як addCategory, removeCategory, clearCategories і getCategories.

addCategory приймає MapiMessage та рядок назви кольорової категорії, наприклад, "Фіолетова категорія" або "Червона категорія", як аргументи.
removeCategory приймає MapiMessage та рядок назви кольорової категорії, яку потрібно видалити з повідомлення.
clearCategories використовується для видалення всіх кольорових категорій з повідомлення.
getCategories використовується для отримання всіх кольорових категорій із певного повідомлення.

У наведеному прикладі виконуються наступні завдання:

Додати кольорову категорію.
Додати іншу кольорову категорію.
Отримати список усіх категорій.
Видалити всі категорії.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage msg = MapiMessage.fromFile(dataDir + "message.msg");

// Add Two category
FollowUpManager.addCategory(msg, "Purple Category");
FollowUpManager.addCategory(msg, "Red Category");

// Retrieve the list of available categories
IList categories = FollowUpManager.getCategories(msg);

// Remove the specified category and then Clear all categories
FollowUpManager.removeCategory(msg, "Red Category");
FollowUpManager.clearCategories(msg);

Доступ до інформації про подальші дії з файлу MSG

API Aspose.Email забезпечує можливість доступу до інформації про подальші дії у надісланих або отриманих повідомленнях. Воно може отримати інформацію про підтвердження прочитання, доставки та результати голосування з файлу повідомлення.

Отримання інформації про підтвердження прочитання та доставки

У наведеному фрагменті коду показано, як отримати інформацію про підтвердження прочитання та доставки.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage msg = MapiMessage.fromFile(dataDir + "message.msg");
for (MapiRecipient recipient : msg.getRecipients()) {
    System.out.println("Recipient: " + recipient.getDisplayName());

    // Get the PR_RECIPIENT_TRACKSTATUS_TIME_DELIVERY property
    System.out.println("Delivery time: " + recipient.getProperties().get_Item(MapiPropertyTag.PR_RECIPIENT_TRACKSTATUS_TIME_DELIVERY).getDateTime());

    // Get the PR_RECIPIENT_TRACKSTATUS_TIME_READ property
    System.out.println("Read time" + recipient.getProperties().get_Item(MapiPropertyTag.PR_RECIPIENT_TRACKSTATUS_TIME_READ).getDateTime());
}

Створення листів Forward та Reply

Aspose.Email API надає можливість створювати та форматувати листи Forward та Reply. Метод ReplyMessageBuilder і ForwardMessageBuilder класи API використовуються для створення відповідних листів Reply та Forward. Лист Reply або Forward можна створити, використовуючи будь‑який з режимів OriginalMessageAdditionMode перелічення. Це перелічення має наступні значення:

OriginalMessageAdditionMode.None – Оригінальний лист не включений у лист‑відповідь.
OriginalMessageAdditionMode.Attachment – Оригінальний лист включений як вкладення у лист‑відповідь
OriginalMessageAdditionMode.Textpart – Оригінальний лист включений як текст у тіло відповіді

Створення листа‑відповіді

Наведений фрагмент коду показує, як створити лист‑відповідь.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage originalMsg = MapiMessage.fromFile(dataDir + "message1.msg");
ReplyMessageBuilder builder = new ReplyMessageBuilder();

// Set ReplyMessageBuilder Properties
builder.setReplyAll(true);
builder.setAdditionMode(OriginalMessageAdditionMode.Textpart);
builder.setResponseText(
        "<p><b>Dear Friend,</b></p> I want to do is introduce my co-author and co-teacher. <p><a href=\"www.google.com\">This is a first link</a></p><p><a href=\"www.google.com\">This is a second link</a></p>");

MapiMessage replyMsg = builder.buildResponse(originalMsg);
replyMsg.save(dataDir + "reply_out.msg");

Створення листа‑перенаправлення

Наведений фрагмент коду показує, як створити лист‑перенаправлення.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
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()); // zero date
MapiConversionOptions mco = MapiConversionOptions.getUnicodeFormat();
// keep empty dates when converting a message
mco.setPreserveEmptyDates(true);
MapiMessage mapiMessage = MapiMessage.fromMailMessage(mailMessage, mco);
System.out.println(mapiMessage.getClientSubmitTime()); // zero date
// check zero date
if (mapiMessage.getClientSubmitTime().equals(JavaHelper.ZERO_DATE))
    System.out.println("ZERO DATE");

Java: Аналіз файлів повідомлень Outlook

Mon, 01 Jan 0001 00:00:00 +0000

Використовуючи Aspose.Email для Java, розробники можуть не лише завантажувати, а й аналізувати вміст файлів повідомлень Outlook.

Щоб завантажити файли MSG з диска, використовуйте MapiMessage статичний клас Load метод.
Для аналізу вмісту файлу MSG, MapiMessage надає ряд методів.

У цьому розділі показано, як завантажити та проаналізувати файл MSG для відображення його вмісту.

Aspose.Email for Java надає MapiMessage клас, який використовується для відкриття та парсингу файлу MSG. Оскільки у файлі MSG може бути багато одержувачів, MapiMessage клас надає getRecipients() метод, який повертає MapiRecipientCollection яка представляє колекцію MapiRecipient об’єкти. The MapiRecipient об’єкт також надає методи для роботи з атрибутами одержувачів.

Наступна послідовність кроків виконує цю задачу:

Створіть екземпляр MapiMessage клас для завантаження файлу MSG з Load статичний метод.
Відобразіть ім’я відправника, тему та тіло з файлу MSG, використовуючи getSenderName(), getSubject() і getBody() методи.
Викличте getRecipients() метод, представлений MapiRecipient клас для отримання посилання на колекцію MapiRecipient об’єктів, пов’язаних з файлом MSG.
Перебрати MapiRecipientCollection колекція для відображення вмісту кожного MapiRecipient об’єкт через його публічні методи.

// The path to the resource directory.
String dataDir = Utils.getSharedDataDir(ParsingOutlookMessageFiles.class) + "outlook/";

//Instantiate an MSG file to load an MSG file from disk
MapiMessage outlookMessageFile = MapiMessage.fromFile(dataDir + "message.msg");
//Display sender's name
System.out.println("Sender Name : " + outlookMessageFile.getSenderName());
//Display Subject
System.out.println("Subject : " + outlookMessageFile.getSubject());
//Display Body
System.out.println("Body : " + outlookMessageFile.getBody());
//Display Recipient's info
System.out.println("Recipients : \n");

//Loop through the recipients collection associated with the MapiMessage object
for (int i = 0; i < outlookMessageFile.getRecipients().size(); i++) {
	//Set a reference to the MapiRecipient object
	MapiRecipient rcp = (MapiRecipient) outlookMessageFile.getRecipients().get_Item(i);
	//Display recipient email address
	System.out.println("Email : " + rcp.getEmailAddress());
	//Display recipient name
	System.out.println("Name : " + rcp.getDisplayName());
	//Display recipient type
	System.out.println("Recipient Type : " + rcp.getRecipientType());
}

Спробуйте!

Парсинг електронних файлів онлайн безкоштовно Додаток Aspose.Email Parser.

Отримати тип елементу MAPI повідомлення

Aspose.Email пропонує MapiItemType перелік, який представляє тип елементу. Його можна використовувати для конвертації повідомлення в об’єкт відповідного класу, що успадкований від IMapiMessageItem інтерфейс. Це запобігає користувачам перевіряти значення властивості MessageClass перед конвертацією повідомлення.

Наступний зразок коду демонструє, як ітерувати повідомлення у папці та конвертувати кожне повідомлення MAPI у відповідний тип елементу MAPI, залежно від типу повідомлення:

for (MessageInfo messageInfo : folder.enumerateMessages()) {
    MapiMessage msg = pst.extractMessage(messageInfo);

    switch (msg.getSupportedType()) {
        // Non-supported type. MapiMessage cannot be converted to an appropriate item type.
        // Just use in MSG format.
        case MapiItemType.None:
            break;
        // An email message. Conversion isn't required.
        case MapiItemType.Message:
            break;
        // A contact item. Can be converted to MapiContact.
        case MapiItemType.Contact:
            MapiContact contact = (MapiContact) msg.toMapiMessageItem();
            break;
        // A calendar item. Can be converted to MapiCalendar.
        case MapiItemType.Calendar:
            MapiCalendar calendar = (MapiCalendar) msg.toMapiMessageItem();
            break;
        // A distribution list. Can be converted to MapiDistributionList.
        case MapiItemType.DistList:
            MapiDistributionList dl = (MapiDistributionList) msg.toMapiMessageItem();
            break;
        // A Journal entry. Can be converted to MapiJournal.
        case MapiItemType.Journal:
            MapiJournal journal = (MapiJournal) msg.toMapiMessageItem();
            break;
        // A StickyNote. Can be converted to MapiNote.
        case MapiItemType.Note:
            MapiNote note = (MapiNote) msg.toMapiMessageItem();
            break;
        // A Task item. Can be converted to MapiTask.
        case MapiItemType.Task:
            MapiTask task = (MapiTask) msg.toMapiMessageItem();
            break;
    }
}

Java: Робота з опцією голосування за допомогою MapiMessage

Mon, 01 Jan 0001 00:00:00 +0000

Створення параметра голосування за допомогою MapiMessage

Microsoft Outlook дозволяє користувачам створювати опитування під час написання нового повідомлення. Вони можуть включати параметри голосування, такі як Так, Ні, Можливо тощо. Aspose.Email дозволяє те ж саме при створенні нового повідомлення Outlook. The FollowUpOptions class надає VotingButtons властивість, яку можна використати для встановлення або отримання значення параметрів голосування. У цій статті наведено докладний приклад створення MapiMessage з параметрами голосування для створення опитування.

Створення опитування за допомогою MapiMessage

Нижче наведено фрагмент коду, який показує, як створити опитування, FollowUpManager клас можна використати, як показано у наведеному нижче прикладі коду.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String address = "firstname.lastname@aspose.com";
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");
MailMessage message = createTestMessage(address);

// Set FollowUpOptions Buttons
FollowUpOptions options = new FollowUpOptions();
options.setVotingButtons("Yes;No;Maybe;Exactly!");
client.send(message, options);

Читання параметрів голосування з MapiMessage

Нижче наведено фрагмент коду, який показує, як читати параметри голосування з MapiMessage.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String fileName = "outlook/message.msg";

MapiMessage message = MapiMessage.fromFile(fileName);

// This method can be useful when except voting buttons it is necessary to get other parameters (ex. a category)
FollowUpOptions options = FollowUpManager.getOptions(message);

// Voting buttons will be introduced as a string with semi-column as a separator
String votingButtons = options.getVotingButtons();

Читання лише кнопок голосування

Нижче наведено фрагмент коду, який показує, як читати лише кнопки голосування.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
InputStream ms = new FileInputStream(dataDir + "MapiMsgWithPoll_out.msg");
MapiMessage testMsg = MapiMessage.fromStream(ms);

// This method can be useful when it is necessary to read only voting buttons
// Voting buttons will be introduced as a collection of string values
IList buttons = FollowUpManager.getVotingButtons(testMsg);

Додавання кнопки голосування до існуючого повідомлення

Нижче наведено фрагмент коду, який показує, як додати кнопку голосування до існуючого повідомлення.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage mapi = MapiMessage.fromFile(dataDir + "message.msg");
FollowUpManager.addVotingButton(mapi, "Indeed!");
mapi.save(dataDir + "AddVotingButtonToExistingMessage_out.msg");

Видалення кнопки голосування з повідомлення

Нижче наведено фрагмент коду, який показує, як видалити кнопку голосування з повідомлення.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Create New Message and set FollowUpOptions, FollowUpManager properties
MapiMessage msg = createTestMessage(false);

FollowUpOptions options = new FollowUpOptions();
options.setVotingButtons("Yes;No;Maybe;Exactly!");
FollowUpManager.setOptions(msg, options);
msg.save(dataDir + "MapiMsgWithPoll.msg");
FollowUpManager.removeVotingButton(msg, "Exactly!"); // Deleting a single button OR
FollowUpManager.clearVotingButtons(msg); // Deleting all buttons from a MapiMessage
msg.save(dataDir + "MapiMsgWithPoll.msg");

Прочитати інформацію про результати голосування

Нижче наведено фрагмент коду, який показує, як прочитати інформацію про результати голосування.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage msg = MapiMessage.fromFile(dataDir + "AddVotingButtonToExistingMessage.msg");
for (MapiRecipient recipient : msg.getRecipients()) {
    System.out.println("Recipient: " + recipient.getDisplayName());

    // Get the PR_RECIPIENT_AUTORESPONSE_PROP_RESPONSE property
    System.out.println("Response: " + recipient.getProperties().get_Item(MapiPropertyTag.PR_RECIPIENT_AUTORESPONSE_PROP_RESPONSE).getString());

    // Get the PR_RECIPIENT_TRACKSTATUS_TIME property
    System.out.println("Response time: " + recipient.getProperties().get_Item(MapiPropertyTag.PR_RECIPIENT_TRACKSTATUS_TIME).getDateTime());

    System.out.println();
}

Зразкові методи, використані у прикладах

Нижче наведено фрагмент коду, який показує, як створити зразкове повідомлення, використане в прикладах.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
public static MapiMessage createTestMessage(boolean draft) {
    MapiMessage msg = new MapiMessage("from@test.com", "to@test.com", "Flagged message",
            "Make it nice and short, but descriptive. The description may appear in search engines' search results pages...");

    if (!draft) {
        msg.setMessageFlags(msg.getFlags() ^ MapiMessageFlags.MSGFLAG_UNSENT);
    }
    return msg;
}

Java: Робота з нагадуванням і датою виконання для файлів Outlook MSG

Mon, 01 Jan 0001 00:00:00 +0000

Налаштування подальших дій та дати виконання для Outlook MSG файлів

Мітка для подальших дій позначає електронний лист як такий, що потребує певної дії. Microsoft Outlook дозволяє користувачам ставити мітки повідомленням і в налаштуваннях мітки встановлювати дату виконання. Microsoft Outlook надсилає одержувачу нагадування, щоб спонукати його здійснити подальші дії з листом. Програмне встановлення міток електронних листів та дат виконання дозволяє розробникам автоматизувати певні типи листів і допомагати одержувачам пам’ятати про необхідність дій. Наприклад, це можна використовувати для надсилання щомісячних повідомлень команді продажів з нагадуванням завершити їх звіти; або для надсилання повідомлення всім співробітникам з нагадуванням про збірку компанії. Aspose.Email for Java підтримує встановлення мітки для подальших дій та дати виконання для MapiMessage об’єкти, що використовуються FollowUpManager і FollowUpOptions. Існує кілька варіантів, у яких мітка для подальших дій може бути встановлена на повідомленні. Вони всі використані у наведеному нижче прикладі коду:

Встановити мітку для подальших дій до повідомлення
Додати дату виконання та дату нагадування до повідомлення
Додати мітку до повідомлення одержувача.
Позначити як завершене.
Видалити мітку.
Прочитати параметри follow up.

Встановлення прапорця FollowUp

Наступний фрагмент коду показує, як встановити прапорець follow-up.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MailMessage mailMsg = new MailMessage();
mailMsg.setSender(new MailAddress("AETest12@gmail.com"));
mailMsg.getTo().addMailAddress(new MailAddress("receiver@gmail.com"));
mailMsg.setBody("This message will test if follow up options can be added to a new mapi message.");
MapiMessage mapi = MapiMessage.fromMailMessage(mailMsg);

Calendar calendar = Calendar.getInstance();
calendar.set(2013, Calendar.MAY, 23, 14, 40, 0);
Date dtStartDate = calendar.getTime();

calendar.set(2013, Calendar.MAY, 23, 16, 40, 0);
Date dtReminderDate = calendar.getTime();

calendar.add(Calendar.DATE, 1);
Date dtDueDate = calendar.getTime();

FollowUpOptions options = new FollowUpOptions("Follow Up", dtStartDate, dtDueDate, dtReminderDate);
FollowUpManager.setOptions(mapi, options);
mapi.save(dataDir + "SetFollowUpflag_out.msg");

Встановлення Follow Up для отримувачів

Наступний фрагмент коду показує, як встановити follow-up для отримувачів.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MailMessage mailMsg = new MailMessage();
mailMsg.setSender(new MailAddress("AETest12@gmail.com"));
mailMsg.getTo().addMailAddress(new MailAddress("receiver@gmail.com"));
mailMsg.setBody("This message will test if follow up options can be added to a new mapi message.");

MapiMessage mapi = MapiMessage.fromMailMessage(mailMsg);
mapi.setMessageFlags(MapiMessageFlags.MSGFLAG_UNSENT); // mark this message as draft

Calendar calendar = Calendar.getInstance();
calendar.set(2013, Calendar.MAY, 23, 16, 40, 0);
Date dtReminderDate = calendar.getTime();

// Add the follow up flag for recipient now
FollowUpManager.setFlagForRecipients(mapi, "Follow up", dtReminderDate);
mapi.save(dataDir + "SetFollowUpForRecipients_out.msg");

Позначення прапорця FollowUp як завершеного

Наступний фрагмент коду показує, як позначити прапорець follow-up як завершений.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage mapi = MapiMessage.fromFile(dataDir + "message.msg");
FollowUpManager.markAsCompleted(mapi);
mapi.save(dataDir + "MarkedCompleted_out.msg");

Видалення прапорця FollowUp

Наступний фрагмент коду показує, як видалити прапорець follow-up.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage mapi = MapiMessage.fromFile(dataDir + "message.msg");
FollowUpManager.clearFlag(mapi);
mapi.save(dataDir + "FollowUpFlagRemoved_out.msg");

Прочитати параметри прапорця follow-up для повідомлення

Наступний фрагмент коду показує, як прочитати параметри прапорця follow-up для повідомлення.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MapiMessage mapi = MapiMessage.fromFile(dataDir + "message.msg");
FollowUpOptions options = FollowUpManager.getOptions(mapi);

Java: Робота з властивостями MAPI

Mon, 01 Jan 0001 00:00:00 +0000

Встановлення та доступ до властивостей Outlook MAPI

Aspose.Email for Java надає MapiProperty клас, який представляє властивість MAPI:

Name: ім’я властивості.
Tag: тег властивості.
Data: дані властивості.

У цій темі також обговорюється, як встановити і отримати доступ до властивостей MAPI файлу Outlook Message (MSG) за допомогою Aspose.Email для Java. Крім того, надано приклад коду, який демонструє, як видаляти властивості з MSG та вкладень.

Читання властивостей

Щоб прочитати дані властивостей MAPI з файлу MSG:

Створіть екземпляр MapiMessage клас для завантаження файлу MSG за допомогою Load() статичний метод.
Встановити посилання на MapiMessage об’єкт getProperties() метод для отримання MapiPropertyCollection.
Отримати MapiProperty об’єкт з MapiPropertyCollection за MapiPropertyTag ключі.
Отримайте дані властивості за допомогою відповідного методу getXXX().

Встановити додаткові властивості

Наведений приклад коду можна використати для встановлення додаткових властивостей Outlook MapiMessage.

Видалити властивості

Читання іменованих властивостей MAPI з електронних листів

Microsoft Outlook підтримує додавання іменованих властивостей MAPI до файлу MSG. Ці властивості додаються користувачем. Розробники можуть додати іменовану властивість, наприклад “MyProp”, до файлу MSG за допомогою Aspose.Email.

У цій статті ілюструється Aspose.Email MapiMessage getNamedProperties() колекція для читання іменованих властивостей MAPI з файлу MSG.

Читання іменованої властивості MAPI

Читання іменованої властивості MAPI з вкладення

Java: Робота з вкладеннями повідомлень

Mon, 01 Jan 0001 00:00:00 +0000

Розпарсинг та збереження вкладень

Файли повідомлень Outlook можуть містити одне або кілька вкладень. Aspose.Email дозволяє розробникам перебирати вкладення у файлі MSG і зберігати їх на диск. У цьому розділі описується процес. Також описано, як вбудувати вкладення.

Aspose.Email MapiMessage клас використовується для завантаження файлу MSG з диска і надає getAttachments() метод, який посилається на MapiAttachment колекція об’єктів, пов’язана з файлом MSG. Метод MapiAttachment об’єкт додатково надає методи, які виконують дії над вкладенням.

Щоб зберегти вкладення у файлі MSG на диск із оригінальною назвою та розширенням:

Створіть екземпляр MapiMessage клас для завантаження файлу MSG за допомогою Load() статичний метод.
Викличте MapiRecipient клас getAttachments() метод для отримання посилання на колекцію MapiAttachment об’єктів, пов’язаних з файлом MSG.
Перебрати MapiAttachmentCollection для відображення вмісту щодо кожного MapiAttachment об’єкт через його публічні методи.
Викличте MapiAttachment клас save() метод для збереження вкладення на диск.

Вбудовування повідомлень як вкладень

Повідомлення Microsoft Outlook може містити інші повідомлення Microsoft Outlook у вигляді вкладень, як звичайні повідомлення, описані вище, так і вбудовані повідомлення. Методи MapiAttachmentCollection надає перевантажені варіанти методу add для створення повідомлень Outlook з обох типів вкладень. Outlook MSG файли, вбудовані у MSG файл, містять PR_ATTACH_METHOD зі значенням 5.

Читання вбудованого повідомлення з вкладення

Вставка та заміна MSG вкладень

Aspose.Email API надає можливість вставляти вкладення у вказаний індекс батьківського повідомлення. Він також забезпечує можливість заміняти вміст вкладення іншим повідомлення‑вкладенням.

Вставка MSG вкладення у вказане місце

Aspose.Email API надає можливість вставити MSG вкладення у батьківський MSG за допомогою MapiAttachmentCollection.Insert() метод.

Замінити вбудований вміст MSG вкладення

Це можна використати для заміни вбудованого вмісту вкладення новим за допомогою Замінити метод. Проте його не можна використати для вставки вкладення з PR_ATTACH_NUM = 4 (наприклад) у колекцію, у якої collection.Count = 2.

Зберегти вкладення з цифрово підписаного повідомлення

Aspose.Email API надає можливість отримати або встановити значення, що вказує, чи буде декодовано чисто підписане повідомлення.

Перейменувати вкладення у MapiMessage

Aspose.Email робить можливим редагування НазваВідображення значення властивості в Вкладення MapiMessage.

Наведений приклад коду демонструє, як оновити назви першого та другого вкладень у завантаженому Mapi‑повідомленні:

MapiMessage msg = MapiMessage.load(fileName);
msg.getAttachments().get_Item(0).setDisplayName("New display name 1");
msg.getAttachments().get_Item(1).setDisplayName("New display name 2");

Перевірити, чи є вкладення вбудованим чи звичайним

Різниця між вбудованими та звичайними вкладеннями полягає у їхньому представлення у листі. Вбудовані вкладення вбудовані в тіло листа і їх можна переглянути без відкриття окремого файлу чи завантаження. Звичайні вкладення є окремими файлами, які прикріплені до листа, але не відображаються безпосередньо в тілі повідомлення і їх треба завантажувати та відкривати окремо. MapiAttachment.IsInline властивість MapiAttachment клас отримує значення, що вказує, чи є вкладення вбудованим чи звичайним.

Наведений приклад коду завантажує електронний лист з файлу та отримує інформацію про вкладення, зокрема виводить назву кожного вкладення та чи є воно вбудованим у повідомлення.

MapiMessage message = MapiMessage.load("fileName");

for (MapiAttachment attach : message.getAttachments()) {
    System.out.println(attach.getDisplayName() + ": " + attach.isInline());
}

Java: Робота з контактами Outlook

Mon, 01 Jan 0001 00:00:00 +0000

Створити контакт Outlook

Aspose.Email для Java підтримує створення контактів Outlook (VCards) за допомогою MapiContact клас. MapiContact містить багато методів, деякі з яких наведено нижче.

MapiContactElectronicAddressPropertySet містить набір MapiContactElectronicAddress.
MapiContactEventPropertySet
MapiContactNamePropertySet
MapiContactPersonalInfoPropertySet
MapiContactPhysicalAddressPropertySet містить набір MapiContactPhysicalAddress.
MapiContactProfessionalPropertySet
MapiContactTelephonePropertySet

Структура контакту в Aspose.Email для Java

Нижче наведено ієрархію, реалізовану для контактів у Aspose.Email для Java. Відповідна назва класу вказана поруч з кожною властивістю. Гіперпосилання на онлайн-документацію надаються для подальшого ознайомлення.

Contact (MapiContact)
1. Електронні адреси (MapiContactElectronicAddressPropertySet)
  1. Електронна пошта 1 (MapiContactElectronicAddress)
    1. Тип адреси
    2. Відображуване ім’я
    3. Адреса електронної пошти
    4. Номер факсу
  2. Електронна пошта 2
  3. Електронна пошта 3
  4. Домашній факс
  5. Первинний факс
  6. Діловий факс
2. Події (MapiContactEventPropertySet) Нижче наведено приклад, як встановлювати події.
  1. День народження
  2. Річниця весілля
3. Інформація про ім’я (MapiContactNamePropertySet)
  1. Відображуване ім’я
  2. Префікс відображуваного імені
  3. Файл під
  4. Ідентифікатор файлу під
  5. Покоління
  6. Ім’я
  7. Ініціали
  8. По-батькові
  9. Псевдонім
  10. Прізвище
4. Персональна інформація (MapiContactPersonalInfoPropertySet)
  1. Обліковий запис
  2. Бізнес-домашня сторінка
  3. Назва комп’ютерної мережі
  4. Ідентифікатор клієнта
  5. Безкоштовне розташування бізнесу
  6. FTP-сайт
  7. Стать
  8. Урядовий ідентифікаційний номер
  9. Хобі
  10. HTML
  11. Адреса миттєвих повідомлень
  12. Мова
  13. Місце
  14. Примітки
  15. Організаційний ідентифікаційний номер
  16. Персональна домашня сторінка
  17. Ім’я особи, що порекомендувала
  18. Ім’я подружжя
5. Фізична адреса (MapiContactPhysicalAddressPropertySet)
  1. Домашня адреса (MapiContactPhysicalAddress)
    1. Адреса
    2. Місто
    3. Країна
    4. Код країни
    5. Поштовий індекс
    6. Абонентське відділення
    7. Штат або провінція
  2. Інша адреса
  3. Робоча адреса
6. Професійна інформація
  1. Помічник
  2. Назва компанії
  3. Назва підрозділу
  4. Ім’я менеджера
  5. Місце офісу
  6. Професія
  7. Титул
7. Телефони (MapiContactTelephonePropertySet)
  1. Номер телефону помічника
  2. Діловий номер телефону 2
  3. Діловий номер телефону
  4. Номер зворотного дзвінка
  5. Номер телефону автомобіля
  6. Головний номер телефону компанії
  7. Домашній номер телефону 2
  8. Домашній номер телефону
  9. Номер ISDN
  10. Мобільний номер телефону
  11. Інший номер телефону
  12. Номер пейджера
  13. Первинний номер телефону
  14. Номер радіотелефону
  15. Номер телексу
  16. Номер телефону TTY/TDD

Наступний код використовує Aspose.Email для створення контакту Outlook і заповнює його ім’ям, професійними властивостями, фізичною адресою та електронною поштою. Він також демонструє додавання MapiContactEventPropertySet до контакту.

|| | :- | |Рисунок: Контакт Microsoft Outlook, закодований за допомогою Aspose.Email|

Додавання інформації про події контакту до MapiContact

Microsoft Outlook дозволяє користувачам додавати інформацію про події до контакту. Подія містить дату народження та дату весільної річниці. Aspose.Email надає MapiContactEventPropertySet клас для додавання цієї інформації до контакту. Це докладно описано у наступному прикладі.

Створення, збереження та читання контактів Outlook

Aspose.Email дозволяє розробникам створювати контакти Microsoft Outlook, а також електронні листи. The MapiContact клас забезпечує всі властивості контакту, необхідні для створення контакту Outlook. У цій статті показано, як створити, зберегти та прочитати контакт Outlook за допомогою MapiContact клас.

Створити та зберегти MapiContact

Наступні кроки можна використати для створення та збереження контакту на диск:

Створіть новий об’єкт MapiContact клас.
Введіть інформацію, пов’язану з різними властивостями контакту.
Додайте дані фото до контакту, якщо є.
Збережіть контакт у форматі MSG або VCard.

Зберегти контакт у форматі VCF версії 3

Щоб зберегти контакт у форматі VCF версії 3, використайте VCardVersion перелік для встановлення VCardSaveOptions.Version властивість. Нижче наведено приклад коду, який демонструє використання VCardVersion перелік для збереження контакту у форматі VCF версії 3.

Прочитати MapiContact

The MapiContact клас можна використати для завантаження як файлів Microsoft Outlook MSG, так і контактів у форматі VCard. Нижче наведено приклади коду, які показують, як завантажити контакти Outlook, збережені у форматах MSG та VCF, у MapiContact.

Завантажити контакт з MSG

Завантажити контакт з VCard

Нижче наведено код, який показує, як створити MapiContact завантажуючи дані з файлу VCard за допомогою VCardLoadOptions:

MapiContact mapiContact = MapiContact.fromVCard("contact.vcf", new VCardLoadOptions());
System.out.println(mapiContact.getNameInfo().getDisplayName());

Завантажити контакт VCard із вказаною кодуванням

Підтримуваний метод: MapiContact.fromVCard(String, Encoding)

Рендеринг інформації про контакт у MHTML

Контакт Outlook можна конвертувати у MHTML за допомогою API Aspose.Email. Цей приклад показує, як VCard завантажується у MapiContact а потім конвертовано у MHTML за допомогою MailMessage API.

Java: Робота з задачами Outlook

Mon, 01 Jan 0001 00:00:00 +0000

Створення, збереження та читання завдань Outlook

Aspose.Email for Java дозволяє розробникам створювати задачі Outlook і зберігати їх у форматі MSG. The MapiTask клас надає ряд властивостей, таких як PercentComplete, EstimatedEffort, ActualEffort, History, LastUpdate, тощо, щоб задовольнити та встановити інформацію, потрібну для задачі Outlook. У цій статті показано, як створити, зберегти та прочитати MapiTask з диска.

Створити та зберегти MapiTask

Наступними кроками можна створити і зберегти задачу на диску.

Створіть новий об’єкт MapiTask клас.
Введіть інформацію про задачу та різні її властивості.
Збережіть задачу на диск у форматі MSG.

Читання MapiTask

The MapiTask об’єкт класу використовується для приведення MapiMessage об’єкт, який завантажує завдання з диска у форматі MSG.

Читання завдання VToDo

Завдання Google, експортовані у формат iCalendar як події VToDo, можна завантажити за допомогою MapiTask клас, як показано у наведеному прикладі коду.

Додати інформацію про нагадування до MapiTask

Подібно до Microsoft Outlook, Aspose.Email може додати інформацію про нагадування до MapiTask. Наведений фрагмент коду показує, як додати інформацію про нагадування до MapiTask.

Додати вкладення до MapiTask

Наведений фрагмент коду показує, як додати вкладення до MapiTask.

Конвертування завдання Outlook у MHT

Aspose.Email може генерувати MapiMessage наприклад вихід під час конвертації MapiTask у MHT.

Java: Керування цифрово підписаними повідомленнями

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email реалізує повний алгоритм об’єкта електронної пошти S/MIME. Це дає API повний контроль над додаванням цифрових підписів до листів, їх збереженням під час конвертації між форматами, видаленням тощо.

Приєднання підпису до електронного листа

The SecureEmailManager.attachSignature метод дозволяє приєднувати цифрові підписи до електронних листів. Після приєднання підпису перевірте результати за допомогою властивостей, таких як IsSigned, MessageClass, а також деталі прикріплення.

Ви можете надати MailMessage або MapiMessage, приватний сертифікат та параметри підпису, щоб налаштувати процес приєднання підпису за допомогою SignatureOptions клас, який дозволяє користувачам задавати різні параметри приєднання підпису, включаючи відокремлені та не відокремлені підписи.

У наведеному прикладі коду показано, як завантажити повідомлення з файлу, приєднати відокремлений та не відокремлений цифровий підпис за допомогою приватного сертифіката, а потім перевірити, чи підписи були успішно приєднані.

String fileName = "message.msg";
String privateCertFile = "certFile.pfx";
X509Certificate2 privateCert = new X509Certificate2(privateCertFile, "password");

MapiMessage msg = MapiMessage.load(fileName);

SignatureOptions opt = new SignatureOptions();
opt.setDetached(true);
MapiMessage signedDetached = new SecureEmailManager().attachSignature(msg, privateCert, opt);

if (signedDetached.isSigned()) {
    System.out.println("Detached Signature Attached Successfully.");
}

opt.setDetached(false);
MapiMessage signedNonDetached = new SecureEmailManager().attachSignature(msg, privateCert, opt);

if (signedNonDetached.isSigned()) {
    System.out.println("Non-Detached Signature Attached Successfully.");
}

Збереження підпису під час конвертації з EML у MSG

Aspose.Email зберігає цифровий підпис під час конвертації з EML у MSG. У наведеному фрагменті коду показано, як здійснити конвертацію з EML у MSG.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

// Load mail message
MailMessage message = MailMessage.load(dataDir + "Message.eml", new EmlLoadOptions());
// Save as MSG
message.save(dataDir + "ConvertEMLToMSG_out.msg", SaveOptions.getDefaultMsgUnicode());

Видалення підпису з файлу повідомлення Outlook

Якщо вам потрібно видалити підпис з повідомлення у форматі MAPI, наприклад, з метою сумісності, Aspose.Email пропонує MapiMessage.removeSignature метод і MapiMessage.isSigned властивість.

У наведеному фрагменті коду показано, як завантажити повідомлення MAPI з файлу, перевірити, чи воно цифрово підписане, і в разі підтвердження створити нове повідомлення без цифрового підпису:

MapiMessage msg = MapiMessage.load(fileName);

if (msg.isSigned()) {
    MapiMessage unsignedMsg = msg.removeSignature();
}

Конвертація S/MIME повідомлень з MSG у EML

Aspose.Email зберігає цифровий підпис під час конвертації з MSG у EML, як показано у наведеному фрагменті коду.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MailMessage msg = MailMessage.load(dataDir + "message.eml");
MapiMessage mapi = MapiMessage.fromMailMessage(msg, new MapiConversionOptions(OutlookMessageFormat.Unicode));
// Save File to disk
mapi.save(dataDir + "ConvertMIMEMessagesFromMSGToEML_out.msg");

Розшифрування файлу MSG за допомогою сертифіката

Якщо у вас є зашифровані повідомлення MAPI і потрібно розшифрувати їх за допомогою приватного ключа, збереженого у сертифікаті, наступні можливості Aspose.Email можуть бути корисними:

MapiMessage.isEncrypted - Повертає значення, що вказує, чи зашифровано повідомлення.
MapiMessage.decrypt() - Розшифровує це повідомлення (метод шукає відповідний сертифікат і приватний ключ у сховищах My поточного користувача та комп’ютера).
MapiMessage.decrypt(X509Certificate2 certificate) - Розшифровує це повідомлення за допомогою сертифіката.

У наведеному фрагменті коду показано, як працювати з зашифрованими повідомленнями MAPI:

X509Certificate2 privateCert = new X509Certificate2("privateCertFile", "password");
MapiMessage msg = MapiMessage.load("encrypted.msg");

if (msg.isEncrypted()) {
    MapiMessage decryptedMsg = msg.decrypt(privateCert);
    //MapiMessage decryptedMsg = msg.decrypt(/*byte[]*/rawPrivateCert, "password");
}

Java: Робота з нотатками Outlook

Mon, 01 Jan 0001 00:00:00 +0000

Створити, зберегти та прочитати нотатки Outlook

Aspose.Email надає можливість створювати нотатки Outlook та зберігати їх на диск у форматі MSG. The MapiNote клас забезпечує властивості та методи для встановлення потрібної інформації для нотатки. У цій статті показано, як створити, зберегти та прочитати MapiNote з диска.

Створити та зберегти нотатку Outlook

Наступні кроки можна використати для створення та збереження нотатки на диск.

Створіть об’єкт MapiNote клас.
Встановіть різні властивості за потреби.
Збережіть нотатку на диск у вигляді файлу MSG.

Прочитати MapiNote

The MapiNote об’єкт класу використовується для приведення MapiMessage об’єкт, який завантажує нотатку з диска у форматі MSG.

Java: Робота з пунктами календаря Outlook

Mon, 01 Jan 0001 00:00:00 +0000

Робота з MapiCalendar

Aspose.Email MapiCalendar клас надає методи та атрибути для встановлення різних властивостей елементу календаря. У цій статті наведені приклади коду для:

Створення та збереження елементів календаря

У наведеному фрагменті коду показано, як створити і зберегти елемент календаря у форматі ICS.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

Calendar cal = Calendar.getInstance();
cal.set(2012, Calendar.OCTOBER, 2, 13, 0, 0);
Date startDate = cal.getTime();
cal.set(2012, Calendar.OCTOBER, 2, 14, 0, 0);
Date endDate = cal.getTime();

MapiCalendar calendar = new MapiCalendar("LAKE ARGYLE WA 6743", 
                                         "Appointment", 
                                         "This is a very important meeting :)", 
                                         startDate, 
                                         endDate);

calendar.save(dataDir + "CalendarItem_out.ics", AppointmentSaveFormat.Ics);

Збереження елементу календаря у форматі MSG

У наведеному фрагменті коду показано, як зберегти елемент календаря у форматі MSG.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
calendar.save(dataDir + "CalendarItemAsMSG_out.Msg", AppointmentSaveFormat.Msg);

Встановлення ідентифікатора продукту під час збереження елементу календаря у форматі ICS

The ProductIdentifier властивість MapiCalendarIcsSaveOptions клас використовується для збереження елементу календаря MAPI у файл iCalendar (ICS), зберігаючи оригінальну дату і час, а також користувацький ідентифікатор продукту. Властивість вказує ідентифікатор продукту, який створив об’єкт iCalendar.

Наведений приклад коду показує, як працювати з даними iCalendar (ICS) у об’єкті MAPI календаря:

MapiCalendarIcsSaveOptions icsSaveOptions = new MapiCalendarIcsSaveOptions();
icsSaveOptions.setKeepOriginalDateTimeStamp(true);
icsSaveOptions.setProductIdentifier("Foo Ltd");

mapiCalendar.save("my.ics", icsSaveOptions);

Додавання візуального нагадування до календаря

У наведеному фрагменті коду показано, як додати візуальне нагадування до календаря.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";
Calendar jCalendar = Calendar.getInstance();
jCalendar.add(Calendar.HOUR, 1);
Date startDate = jCalendar.getTime();
Date endDate = jCalendar.getTime();

MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("attendee@domain.com", "Attendee"));
// Create Appointment
Appointment app = new Appointment("Home", 
                                  startDate, 
                                  endDate, 
                                  new MailAddress("organizer@domain.com", "Organizer"), 
                                  attendees);
MailMessage msg = new MailMessage();
msg.addAlternateView(app.requestApointment());
MapiMessage mapi = MapiMessage.fromMailMessage(msg);
MapiCalendar calendar = (MapiCalendar) mapi.toMapiMessageItem();

// Set calendar Properties
calendar.setReminderSet(true);
calendar.setReminderDelta(5); // 45 min before start of event

String savedFile = (dataDir + "calendarWithDisplayReminder.ics");
calendar.save(savedFile, AppointmentSaveFormat.Ics);

Додавання аудіо нагадування до календаря

У наведеному фрагменті коду показано, як додати аудіо нагадування до календаря.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";
Calendar jCalendar = Calendar.getInstance();
jCalendar.add(Calendar.HOUR, 1);
Date startDate = jCalendar.getTime();
Date endDate = jCalendar.getTime();

MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("attendee@domain.com", "Attendee"));

Appointment app = new Appointment("Home", 
                                  startDate, 
                                  endDate, 
                                  new MailAddress("organizer@domain.com", "Organizer"), 
                                  attendees);

MailMessage msg = new MailMessage();
msg.addAlternateView(app.requestApointment());
MapiMessage mapi = MapiMessage.fromMailMessage(msg);
MapiCalendar cal = (MapiCalendar) mapi.toMapiMessageItem();

cal.setReminderSet(true);
cal.setReminderDelta(58); // 58 min before start of event
cal.setReminderFileParameter(dataDir + "Alarm01.wav");

String savedFile = dataDir + "calendarWithAudioReminder_out.ics";
cal.save(savedFile, AppointmentSaveFormat.Ics);

Додати/отримати вкладення з файлів календаря

У наведеному фрагменті коду показано, як додати/отримати вкладення з файлів календаря.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";
Calendar jCalendar = Calendar.getInstance();
jCalendar.add(Calendar.HOUR, 1);
Date startDate = jCalendar.getTime();
Date endDate = jCalendar.getTime();

String[] files = new String[3];
files[0] = "attachment_1.doc";
files[1] = "download.png";
files[2] = "Desert.jpg";

MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("attendee@domain.com", "Attendee"));

Appointment app1 = new Appointment("Home", 
                                   startDate, 
                                   endDate, 
                                   new MailAddress("organizer@domain.com", "Organizer"), 
                                   attendees);
for (String file : files) {
    app1.getAttachments().addItem(new Attachment(dataDir + file));
}

app1.save(dataDir + "appWithAttachments_out.ics", AppointmentSaveFormat.Ics);

Appointment app2 = Appointment.load(dataDir + "appWithAttachments_out.ics");
System.out.println(app2.getAttachments().size());
for (Attachment att : app2.getAttachments())
    System.out.println(att.getName());

Статус одержувачів із запиту на зустріч

У наведеному фрагменті коду показано, як отримати статус одержувачів із запиту на зустріч.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String fileName = "outlook/test.msg";

MapiMessage message = MapiMessage.fromFile(fileName);
for (MapiRecipient recipient : message.getRecipients()) {
    System.out.println(recipient.getRecipientTrackStatus());
}

Явно встановити стан календарної зустрічі

Aspose.Email дозволяє встановити стан MapiCalendar об’єкт явно, перевизначаючи поведінку за замовчуванням. The setStateForced метод забезпечує кращий контроль над станами подій календаря, особливо при обробці отриманих запитів на зустрічі. За замовчуванням, коли зустріч створюється, її стан є MapiCalendarState.Meeting. Коли отримано у вхідні повідомлення отримувача, він автоматично змінюється на MapiCalendarState.Received, і його клас повідомлення оновлюється до IPM.Schedule.Meeting.Request. Використовуючи SetStateForced дозволяє вручну встановлювати стан Received, що може бути корисним для збереження інформації про організатора при збереженні календаря у файлі MSG. Однак це може перешкоджати правильному пересиленню або повторному надсиланню зустрічі.

Наведений приклад коду допоможе вам реалізувати цю функцію:

Calendar c = Calendar.getInstance();
c.set(2024, Calendar.MAY, 10, 12, 30, 0);
Date startDate = c.getTime();
c.set(2024, Calendar.MAY, 10, 13, 30, 0);
Date endDate = c.getTime();
MapiCalendar appointment = new MapiCalendar(
        "LAKE ARGYLE WA 6743",
        "Appointment",
        "This is a very important meeting :)",
        startDate,
        endDate);

MapiElectronicAddress organizer = new MapiElectronicAddress();
organizer.setEmailAddress("test@aaa.com");
organizer.setDisplayName("test display Name");
appointment.setOrganizer(organizer);

appointment.setStateForced(MapiCalendarState.Meeting | MapiCalendarState.Received);

appointment.save("appointment.msg", AppointmentSaveFormat.Msg);

Створити MapiCalendarTimeZone зі стандартного часового поясу

У наведеному фрагменті коду показано, як створити MapiCalendarTimeZone з стандартного часовому поясу.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
MapiCalendarTimeZone timeZone = new MapiCalendarTimeZone("Eastern Standard Time");

Встановлення нагадування за допомогою створеної зустрічі

Нагадування можна додати під час створення зустрічі. Ці сигнали можуть спрацьовувати за різними критерями, наприклад, за n хвилин до початку розкладу, повторюватися n разів з інтервалом n. Різні теги можна використовувати для створення цих тригерів у скрипті, що знаходиться між BEGIN:VALARM і END:VALARM у межах зустрічі. Існує кілька варіантів, у яких можна встановити нагадування для зустрічі.

Встановлення нагадування шляхом додавання тегів

У наведеному фрагменті коду показано, як встановити нагадування, додаючи теги.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();
long MIN_MS = 60 * 1000;
long HR_MS = 60 * MIN_MS;
long DAY_MS = 24 * HR_MS;

String location = "Meeting Location: Room 5";
Date startDate = getDate(1997, 3, 18, 18, 30, 00);
Date endDate = getDate(1997, 3, 18, 19, 30, 00);
MailAddress organizer = new MailAddress("aaa@amail.com", "Organizer");
MailAddressCollection attendees = new MailAddressCollection();
attendees.addItem(new MailAddress("bbb@bmail.com", "First attendee"));

Appointment target = new Appointment(location, startDate, endDate, organizer, attendees);

// Audio alarm that will sound at a precise time and
// Repeat 4 more times at 15 minute intervals:
AppointmentReminder audioReminder = new AppointmentReminder();
audioReminder.setTrigger(new ReminderTrigger(getDate(1997, 3, 17, 13, 30, 0)));
audioReminder.setRepeat(4);
audioReminder.setDuration(new ReminderDuration(15 * MIN_MS));
audioReminder.setAction(ReminderAction.Audio);
ReminderAttachment attach = new ReminderAttachment(new URI("ftp://Host.com/pub/sounds/bell-01.aud"));
audioReminder.getAttachments().addItem(attach);
target.getReminders().addItem(audioReminder);


// Display alarm that will trigger 30 minutes before the
// Scheduled start of the event it is
// Associated with and will repeat 2 more times at 15 minute intervals:
AppointmentReminder displayReminder = new AppointmentReminder();
ReminderDuration dur = new ReminderDuration(-30 * MIN_MS);
displayReminder.setTrigger(new ReminderTrigger(dur, ReminderRelated.Start));
displayReminder.setRepeat(2);
displayReminder.setDuration(new ReminderDuration(15 * MIN_MS));
displayReminder.setAction(ReminderAction.Display);
displayReminder.setDescription("Breakfast meeting with executive team at 8:30 AM EST");
target.getReminders().addItem(displayReminder);

// Email alarm that will trigger 2 days before the
// Scheduled due date/time. It does not
// Repeat. The email has a subject, body and attachment link.
AppointmentReminder emailReminder = new AppointmentReminder();
ReminderDuration dur1 = new ReminderDuration(-2 * DAY_MS);
emailReminder.setTrigger(new ReminderTrigger(dur1, ReminderRelated.Start));
ReminderAttendee attendee = new ReminderAttendee("john_doe@host.com");
emailReminder.getAttendees().addItem(attendee);
emailReminder.setAction(ReminderAction.Email);
emailReminder.setSummary("REMINDER: SEND AGENDA FOR WEEKLY STAFF MEETING");
emailReminder.setDescription("A draft agenda needs to be sent out to the attendees to the weekly managers meeting (MGR-LIST). Attached is a pointer the document template for the agenda file.");
ReminderAttachment attach1 = new ReminderAttachment(new URI("http://Host.com/templates/agenda.doc"));
emailReminder.getAttachments().addItem(attach1);
target.getReminders().addItem(emailReminder);

// Procedural alarm that will trigger at a precise date/time
// And will repeat 23 more times at one hour intervals. The alarm will
// Invoke a procedure file.
AppointmentReminder procReminder = new AppointmentReminder();
procReminder.setTrigger(new ReminderTrigger(getDate(1998, 1, 1, 5, 0, 0)));
procReminder.setRepeat(23);
procReminder.setDuration(new ReminderDuration(1 * DAY_MS));
procReminder.setAction(ReminderAction.Procedure);
ReminderAttachment attach2 = new ReminderAttachment(new URI("ftp://Host.com/novo-procs/felizano.exe"));
procReminder.getAttachments().addItem(attach2);
target.getReminders().addItem(procReminder);
target.save(dataDir + "savedFile_out.ics");

Конвертувати Appointment EML у MSG з HTML‑тілом

Починаючи з версії 19.3, Aspose.Email надає можливість конвертувати Appointment EML у MSG, зберігаючи HTML‑тіло зустрічі. Aspose.Email надає MapiConversionOptions.ForcedRtfBodyForAppointment властивості, яка має значення за замовчуванням true. Коли значення MapiConversionOptions.ForcedRtfBodyForAppointment встановлено на true, тіло зустрічі конвертується у формат RTF. Щоб зберегти формат тіла зустрічі у форматі HTML, встановіть значення MapiConversionOptions.ForcedRtfBodyForAppointment на false.

У наведеному прикладі демонструється використання MapiConversionOptions.ForcedRtfBodyForAppointment властивість, яка зберігає формат тіла зустрічі у форматі HTML.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

MailMessage mailMessage = MailMessage.load(dataDir + "TestAppointment.eml");

MapiConversionOptions conversionOptions = new MapiConversionOptions();
conversionOptions.setFormat(OutlookMessageFormat.Unicode);

// default value for ForcedRtfBodyForAppointment is true
conversionOptions.setForcedRtfBodyForAppointment(false);

MapiMessage mapiMessage = MapiMessage.fromMailMessage(mailMessage, conversionOptions);

if (mapiMessage.getBodyType() == BodyContentType.Html) {
    System.out.println("Body Type: Html");
} else if (mapiMessage.getBodyType() == BodyContentType.Rtf) {
    System.out.println("Body Type: Rtf");
}

mapiMessage.save(dataDir + "TestAppointment_out.msg");

Java: Робота зі списками розповсюдження

Mon, 01 Jan 0001 00:00:00 +0000

Можна створити список розсилки за допомогою Aspose.Email API, який є колекцією декількох контактів. Список розсилки можна зберегти на диск у форматі Outlook MSG та переглядати/маніпулювати, відкривши його у MS Outlook.

Створення та збереження списків розповсюдження

Наведений фрагмент коду показує, як створити та зберегти список розповсюдження.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = "outlook/";

String displayName1 = "Sebastian Wright";
String email1 = "SebastianWright@dayrep.com";

String displayName2 = "Wichert Kroos";
String email2 = "WichertKroos@teleworm.us";

String strEntryId1;
String strEntryId2;

// Create distribution list from contacts
try (PersonalStorage personalStorage = PersonalStorage.create(dataDir + "CreateDistributionListInPST_out.pst", FileFormatVersion.Unicode)) {
    // Add the contact folder to pst
    FolderInfo contactFolder = personalStorage.createPredefinedFolder("Contacts", StandardIpmFolder.Contacts);

    // Create contacts
    strEntryId1 = contactFolder.addMapiMessageItem(new MapiContact(displayName1, email1));
    strEntryId2 = contactFolder.addMapiMessageItem(new MapiContact(displayName2, email2));

    // Create distribution list on the base of the created contacts
    MapiDistributionListMember member1 = new MapiDistributionListMember(displayName1, email1);
    member1.setEntryIdType(MapiDistributionListEntryIdType.Contact);
    member1.setEntryId(Base64.getDecoder().decode(strEntryId1));

    MapiDistributionListMember member2 = new MapiDistributionListMember(displayName2, email2);
    member2.setEntryIdType(MapiDistributionListEntryIdType.Contact);
    member2.setEntryId(Base64.getDecoder().decode(strEntryId2));

    MapiDistributionListMemberCollection members = new MapiDistributionListMemberCollection();
    members.add(member1);
    members.add(member2);

    MapiDistributionList distributionList = new MapiDistributionList("Contact list", members);
    distributionList.setBody("Distribution List Body");
    distributionList.setSubject("Sample Distribution List using Aspose.Email");

    // Add distribution list to PST
    contactFolder.addMapiMessageItem(distributionList);
}

// Create one-off distribution list members (for which no separate contacts were created)
try (PersonalStorage personalStorage = PersonalStorage.create(dataDir + "CreateDistributionListInPST_OneOffmembers_out.pst", FileFormatVersion.Unicode)) {
    // Add the contact folder to pst
    FolderInfo contactFolder = personalStorage.createPredefinedFolder("Contacts", StandardIpmFolder.Contacts);

    MapiDistributionListMemberCollection oneOffmembers = new MapiDistributionListMemberCollection();
    oneOffmembers.add(new MapiDistributionListMember("John R. Patrick", "JohnRPatrick@armyspy.com"));
    oneOffmembers.add(new MapiDistributionListMember("Tilly Bates", "TillyBates@armyspy.com"));

    MapiDistributionList oneOffMembersList = new MapiDistributionList("Simple list", oneOffmembers);
    contactFolder.addMapiMessageItem(oneOffMembersList);
}

Зберегти Mapi Distribution List у один файл VCF з декількома контактами

The void save(String fileName, MapiDistributionListSaveOptions options) метод дозволяє зберегти Mapi Distribution List у вказане ім’я файлу, використовуючи надані параметри збереження. Ви можете вказати ім’я файлу та екземпляр MapiDistributionListSaveOptions клас як параметри. The MapiDistributionListSaveOptions клас містить параметри для збереження Mapi Distribution List. У цьому випадку можна вказати формат збереження як VCard (ContactSaveFormat.VCard), щоб зберегти список розповсюдження у файл VCF з декількома контактами.

Наведений фрагмент коду демонструє, як зберегти список розповсюдження у файл VCF з декількома контактами:

MapiDistributionList dlist = (MapiDistributionList)msg.toMapiMessageItem();
MapiDistributionListSaveOptions options = new MapiDistributionListSaveOptions(ContactSaveFormat.VCard);
dlist.save("distribution_list.vcf", options);

Читання списку розповсюдження з PST

Наведений фрагмент коду показує, як прочитати список розповсюдження з PST‑файлу.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String fileName = "outlook/message.msg";

MapiMessage message = MapiMessage.fromFile(fileName);
MapiDistributionList dlist = (MapiDistributionList)message.toMapiMessageItem();

Java: Робота з повтореннями

Mon, 01 Jan 0001 00:00:00 +0000

Робота з щоденними повтореннями

Aspose.Email підтримує створення щоденних повторень за допомогою MapiCalendarDailyRecurrencePattern. Можна використовувати три різних типи завершення повторення календаря Mapi, включаючи EndAfterNOccurrences, EndAfterDate та NeverEnd. У цьому розділі демонструється створення різних шаблонів щоденного повторення.

Щоденні повторення: тип EndAfterNOccurrence

У цьому типі повторення кількість повторень слід встановити разом з іншою інформацією наступним чином:

Встановіть дату початку, завершення та виконання.
Створіть MapiTask.
Встановіть стан завдання як NotAssigned.
Створіть об’єкт щоденного повторення, встановивши властивості, такі як PatternType, Period, WeekStartDay, EndType та OccurenceCount.
Встановіть властивість MapiTask.setRecurrence у цей об’єкт щоденного повторення.
Збережіть це повідомлення на диск.

Наведений фрагмент коду показує, як створити завдання з типом завершення повторення EndAfterNOccurrence.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = getDate(2015, 7, 16);
Date dueDate = getDate(2015, 7, 16);
Date endByDate = getDate(2015, 8, 1);
 
MapiTask task = new MapiTask("This is test task", "Sample Body", startDate, dueDate);
task.setState(MapiTaskState.NotAssigned);

// Set the Daily recurrence
MapiCalendarDailyRecurrencePattern rec = new MapiCalendarDailyRecurrencePattern();
rec.setPatternType(MapiCalendarRecurrencePatternType.Day);
rec.setPeriod(1);
rec.setWeekStartDay(DayOfWeek.Sunday);
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=DAILY"));

if (rec.getOccurrenceCount() == 0)
{
    rec.setOccurrenceCount(1);
}

task.setRecurrence(rec);
task.save(dataDir + "Daily_out.msg", TaskSaveFormat.Msg);

Наступну функцію можна використати для обчислення кількості подій між двома датами:

private static long getOccurrenceCount(Date start, Date endBy, String rrule)
{
    DateFormat formatter = new SimpleDateFormat("yyyyMMdd");
    CalendarRecurrence pattern = new CalendarRecurrence("DTSTART:" + formatter.format(start) + "\r\nRRULE:" + rrule);
    DateCollection dates = pattern.generateOccurrences(start, endBy);
    return dates.size();
}

Встановлення значення кількості повторень

Наведений фрагмент коду показує, як встановити значення кількості повторень.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Daily recurrence
MapiCalendarDailyRecurrencePattern record = new MapiCalendarDailyRecurrencePattern();

record.setPatternType(MapiCalendarRecurrencePatternType.Day);
record.setPeriod(1);
record.setWeekStartDay(DayOfWeek.Sunday);
record.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
record.setOccurrenceCount(5);
task.setRecurrence(record);

Щоденні повторення: тип EndAfterDate

Щоденні повторення: встановлення значення Every Day

Наведений фрагмент коду показує, як встановити значення period у 1 та значення INTERVAL у 1 у рядку RRULE.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Daily recurrence
MapiCalendarDailyRecurrencePattern record = new MapiCalendarDailyRecurrencePattern();

record.setPatternType(MapiCalendarRecurrencePatternType.Day);
record.setPeriod(1);
record.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
record.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=DAILY;INTERVAL=1"));
record.setEndDate(endByDate);

Значення Every Day можна встановити у будь‑яке підходяще значення, як показано у наведеному прикладі:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Daily recurrence
MapiCalendarDailyRecurrencePattern record = new MapiCalendarDailyRecurrencePattern();

record.setPatternType(MapiCalendarRecurrencePatternType.Day);
record.setPeriod(2);
record.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
record.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=DAILY;INTERVAL=2"));

Щоденні повторення: тип NeverEnd

Тип завершення можна встановити, використовуючи MapiCalendarRecurrenceEndType.NeverEnd. Параметр Period або INTERVAL можна встановити в потрібне значення, наприклад 1, у наведеному прикладі.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Daily recurrence
MapiCalendarDailyRecurrencePattern record = new MapiCalendarDailyRecurrencePattern();

record.setPatternType(MapiCalendarRecurrencePatternType.Day);
record.setPeriod(1);
record.setEndType(MapiCalendarRecurrenceEndType.NeverEnd);

Робота з щотижневими повтореннями

Aspose.Email надає широкий спектр можливостей для створення щотижневих повторень за допомогою MapiCalendarWeeklyRecurrencePattern. Можна використовувати три різних типи завершення повторення календаря Mapi, включаючи EndAfterNOccurrences, EndAfterDate та NeverEnd. У цьому розділі демонструється створення різних шаблонів щотижневого повторення.

Щотижневі повторення: тип EndAfterNOccurrences

У цьому типі повторення кількість повторень слід встановити разом з іншою інформацією наступним чином:

Встановіть дату початку, завершення та виконання.
Створіть MapiTask.
Встановіть стан завдання як NotAssigned.
Створіть об’єкт щотижневого повторення, встановивши властивості, такі як PatternType, Period, WeekStartDay, EndType та OccurenceCount.
Встановіть властивість MapiTask.setRecurrence у цей об’єкт щотижневого повторення.
Збережіть це повідомлення на диск.

Наведений фрагмент коду показує, як створити завдання з типом завершення повторення EndAfterNOccurrence.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = getDate(2015, 7, 16);
Date dueDate = getDate(2015, 7, 16);
Date endByDate = getDate(2015, 9, 1);

MapiTask task = new MapiTask("This is test task", "Sample Body", startDate, dueDate);
task.setState(MapiTaskState.NotAssigned);

// Set the weekly recurrence
MapiCalendarWeeklyRecurrencePattern rec = new MapiCalendarWeeklyRecurrencePattern();
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
rec.setPatternType(MapiCalendarRecurrencePatternType.Week);
rec.setPeriod(1);
rec.setWeekStartDay(DayOfWeek.Sunday);
rec.setDayOfWeek(MapiCalendarDayOfWeek.Friday);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR"));

if (rec.getOccurrenceCount() == 0)
{
    rec.setOccurrenceCount(1);
}

task.setRecurrence(rec);
task.save(dataDir + "Weekly_out.msg", TaskSaveFormat.Msg);

Наступну функцію можна використати для обчислення кількості подій між двома датами:

private static long getOccurrenceCount(Date start, Date endBy, String rrule)
{
    DateFormat formatter = new SimpleDateFormat("yyyyMMdd");
    CalendarRecurrence pattern = new CalendarRecurrence("DTSTART:" + formatter.format(start) + "\r\nRRULE:" + rrule);
    DateCollection dates = pattern.generateOccurrences(start, endBy);
    return dates.size();
}

Вибір кількох днів у тижні

Наведений фрагмент коду показує, як вибрати кілька днів у тижні.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the weekly recurrence
MapiCalendarWeeklyRecurrencePattern rec = new MapiCalendarWeeklyRecurrencePattern();

rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
rec.setPatternType(MapiCalendarRecurrencePatternType.Week);
rec.setPeriod(1);
rec.setWeekStartDay(DayOfWeek.Sunday);
rec.setDayOfWeek(MapiCalendarDayOfWeek.Friday | MapiCalendarDayOfWeek.Monday);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR,MO"));

Вибір кількох днів у тижні та встановлення інтервалів

Наведений фрагмент коду показує, як вибрати кілька днів тижня та встановити інтервали.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the weekly recurrence
MapiCalendarWeeklyRecurrencePattern rec = new MapiCalendarWeeklyRecurrencePattern();
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
rec.setPatternType(MapiCalendarRecurrencePatternType.Week);
rec.setPeriod(2);
rec.setWeekStartDay(DayOfWeek.Sunday);
rec.setDayOfWeek(MapiCalendarDayOfWeek.Friday | MapiCalendarDayOfWeek.Monday);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR,MO;INTERVAL=2"));

Щотижневі повторення: тип EndAfterDate

Щотижневі повторення: встановлення значення Every Day

Наведений фрагмент коду показує, як встановити значення period у 1 та значення INTERVAL у 1 у рядку RRULE.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the weekly recurrence
MapiCalendarWeeklyRecurrencePattern rec = new MapiCalendarWeeklyRecurrencePattern();
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
rec.setPatternType(MapiCalendarRecurrencePatternType.Week);
rec.setPeriod(1);
rec.setWeekStartDay(DayOfWeek.Sunday);
rec.setDayOfWeek(MapiCalendarDayOfWeek.Friday);
rec.setEndDate(endByDate);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR;INTERVAL=1"));

Значення Every Day можна встановити у будь‑яке підходяще значення, а кілька днів можна вибрати, як показано у наведеному прикладі:

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
MapiCalendarWeeklyRecurrencePattern record = new MapiCalendarWeeklyRecurrencePattern();
record.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
record.setPatternType(MapiCalendarRecurrencePatternType.Week);
record.setPeriod(2);
record.setWeekStartDay(DayOfWeek.Sunday);
record.setEndDate(endByDate);
record.setDayOfWeek(MapiCalendarDayOfWeek.Friday | MapiCalendarDayOfWeek.Monday);
record.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR,MO;INTERVAL=2"));

Щотижневі повторення: тип NeverEnd

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the weekly recurrence
MapiCalendarWeeklyRecurrencePattern recurrence = new MapiCalendarWeeklyRecurrencePattern();
recurrence.setEndType(MapiCalendarRecurrenceEndType.NeverEnd);
recurrence.setPatternType(MapiCalendarRecurrencePatternType.Week);
recurrence.setPeriod(1);
recurrence.setWeekStartDay(DayOfWeek.Sunday);
recurrence.setDayOfWeek(MapiCalendarDayOfWeek.Friday);
recurrence.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=WEEKLY;BYDAY=FR"));

Робота з місячними повтореннями

Aspose.Email підтримує створення місячних повторень за допомогою MapiCalendarMonthlyRecurrencePattern. Можна використовувати три різних типи завершення повторення календаря Mapi, включаючи EndAfterNOccurrences, EndAfterDate та NeverEnd. У цьому розділі демонструється створення різних шаблонів місячного повторення.

Місячні повторення: тип EndAfterNOccurrences

У цьому типі повторення кількість повторень слід встановити разом з іншою інформацією наступним чином:

Встановіть дату початку, завершення та виконання.
Створіть MapiTask.
Встановіть стан завдання як NotAssigned.
Створіть об’єкт щомісячного повторення, встановивши властивості, такі як PatternType, Period, WeekStartDay, EndType та OccurenceCount.
Встановіть властивість MapiTask.setRecurrence у цей об’єкт щомісячного повторення.
Збережіть це повідомлення на диск.

Наведений фрагмент коду показує, як створити завдання з типом завершення повторення EndAfterNOccurrence.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-.NET
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = getDate(2015, 7, 16);
Date DueDate = getDate(2015, 7, 16);
Date endByDate = getDate(2015, 12, 31);

MapiTask task = new MapiTask("This is test task", "Sample Body", startDate, dueDate);
task.setState(MapiTaskState.NotAssigned);

// Set the Monthly recurrence
MapiCalendarMonthlyRecurrencePattern rec = new MapiCalendarMonthlyRecurrencePattern();
rec.setDay(15);
rec.setPeriod(1);
rec.setPatternType(MapiCalendarRecurrencePatternType.Month);
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=MONTHLY;BYMONTHDAY=15;INTERVAL=1"));
rec.setWeekStartDay(DayOfWeek.Monday);

if (rec.getOccurrenceCount() == 0)
{
    rec.setOccurrenceCount(1);
}

task.setRecurrence(rec);
task.save(dataDir + "Monthly_out.msg", TaskSaveFormat.Msg);

Наступну функцію можна використати для обчислення кількості подій між двома датами:

private static long getOccurrenceCount(Date start, Date endBy, String rrule)
{
    DateFormat formatter = new SimpleDateFormat("yyyyMMdd");
    CalendarRecurrence pattern = new CalendarRecurrence("DTSTART:" + formatter.format(start) + "\r\nRRULE:" + rrule);
    DateCollection dates = pattern.generateOccurrences(start, endBy);
    return dates.size();
}

Встановити фіксовану кількість повторень

Наведений фрагмент коду показує, як встановити фіксовану кількість повторень.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Monthly recurrence
MapiCalendarMonthlyRecurrencePattern records = new MapiCalendarMonthlyRecurrencePattern();
records.setDay(15);
records.setPeriod(1);
records.setPatternType(MapiCalendarRecurrencePatternType.Month);
records.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
records.setOccurrenceCount(5);
records.setWeekStartDay(DayOfWeek.Monday);

Місячні повторення: тип EndAfterDate

"Опція "End By" у Mapi Task досягається встановленням властивості OccurrenceCount, обчисленої функцією getOccurrenceCount(). Ця функція приймає дату початку, дату завершення та рядок RRULE. Наведений фрагмент коду показує, як створити повторення 15‑го числа кожного місяця між датами початку та завершення.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = getDate(2015, 7, 1);
Date dueDate = getDate(2015, 7, 1);
Date endByDate = getDate(2015, 12, 31);

MapiTask task = new MapiTask("This is test task", "Sample Body", startDate, dueDate);
task.setState(MapiTaskState.NotAssigned);

// Set the Monthly recurrence
MapiCalendarMonthlyRecurrencePattern recurrence = new MapiCalendarMonthlyRecurrencePattern();
recurrence.setDay(15);
recurrence.setPeriod(1);
recurrence.setPatternType(MapiCalendarRecurrencePatternType.Month);
recurrence.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
recurrence.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=MONTHLY;BYMONTHDAY=15;INTERVAL=1"));
recurrence.setWeekStartDay(DayOfWeek.Monday);
recurrence.setEndDate(endByDate);

task.setRecurrence(recurrence);
task.save(dataDir + "SetMonthlyEndAfterDateRecurrence_out.msg", TaskSaveFormat.Msg);

Місячні повторення: тип NeverEnd

Наведений фрагмент коду показує, як можна встановити тип завершення, використовуючи MapiCalendarRecurrenceEndType.NeverEnd.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
MapiCalendarMonthlyRecurrencePattern recurrence = new MapiCalendarMonthlyRecurrencePattern();
recurrence.setDay(15);
recurrence.setPeriod(1);
recurrence.setPatternType(MapiCalendarRecurrencePatternType.Month);
recurrence.setEndType(MapiCalendarRecurrenceEndType.NeverEnd);
recurrence.setWeekStartDay(DayOfWeek.Monday);

Робота з щорічними повтореннями

Aspose.Email підтримує створення щорічних повторень за допомогою MapiCalendarMonthlyRecurrencePattern. Встановивши властивість period у значення 12, ми можемо отримати щорічний шаблон повторення. Можна використовувати три різних типи завершення повторення календаря Mapi, включаючи EndAfterNOccurrences, EndAfterDate та NeverEnd. У цьому розділі демонструється створення різних щорічних шаблонів повторення.

Щорічні повторення: тип EndAfterNOccurrences

У цьому типі повторення кількість повторень слід встановити разом з іншою інформацією наступним чином:

Встановіть дату початку, завершення та виконання.
Створіть MapiTask.
Встановіть стан завдання як NotAssigned.
Створіть об’єкт щомісячного повторення, встановивши властивості, такі як PatternType, Period, WeekStartDay, EndType та OccurenceCount.
Встановіть властивість MapiTask.setRecurrence у цей об’єкт щомісячного повторення, щоб отримати щорічне повторення.
Збережіть це повідомлення на диск.

Наведений фрагмент коду показує, як створити завдання з типом завершення повторення EndAfterNOccurrence.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
Date startDate = getDate(2015, 7, 1);
Date dueDate = getDate(2015, 7, 1);

MapiTask task = new MapiTask("This is test task", "Sample Body", startDate, dueDate);
task.setState(MapiTaskState.NotAssigned);

// Set the Yearly recurrence
MapiCalendarMonthlyRecurrencePattern recurrence = new MapiCalendarMonthlyRecurrencePattern();
recurrence.setDay(15);
recurrence.setPeriod(12);
recurrence.setPatternType(MapiCalendarRecurrencePatternType.Month);
recurrence.setEndType(MapiCalendarRecurrenceEndType.EndAfterNOccurrences);
recurrence.setOccurrenceCount(3);

task.setRecurrence(recurrence);
task.save("Yearly.msg", TaskSaveFormat.Msg);

Щорічні повторення: тип EndAfterDate

"Опція "End By" у Mapi Task досягається встановленням властивості OccurrenceCount, обчисленої функцією getOccurrenceCount(). Ця функція приймає дату початку, дату завершення та рядок RRULE. Наведений фрагмент коду показує, як створити повторення 15-го числа кожного 7‑го місяця між датами початку та завершення.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Yearly recurrence
MapiCalendarMonthlyRecurrencePattern rec = new MapiCalendarMonthlyRecurrencePattern();
rec.setDay(15);
rec.setPeriod(12);
rec.setPatternType(MapiCalendarRecurrencePatternType.Month);
rec.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
rec.setEndDate(endByDate);
rec.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=YEARLY;BYMONTHDAY=15;BYMONTH=7;INTERVAL=1"));

Щорічні повторення: тип NeverEnd

Наведений фрагмент коду показує, як можна встановити тип завершення, використовуючи MapiCalendarRecurrenceEndType.NeverEnd.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// Set the Yearly recurrence
MapiCalendarMonthlyRecurrencePattern recurrence = new MapiCalendarMonthlyRecurrencePattern();
recurrence.setDay(15);
recurrence.setPeriod(12);
recurrence.setPatternType(MapiCalendarRecurrencePatternType.Month);
recurrence.setEndType(MapiCalendarRecurrenceEndType.NeverEnd);

Створити повторення з правила повторення

API Aspose.Email надає можливість створювати шаблон повторення з правила повторення (RRULE). Він аналізує інформацію з RRULE відповідно до специфікації RFC 5545 iCal та генерує шаблон повторення за допомогою методу MapiCalendarRecurrencePatternFactory.fromString. Наведений фрагмент коду показує, як створити шаблон повторення з правила повторення.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
// The path to the File directory.
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = getDate(2015, 7, 16);
Date endDate = getDate(2015, 8, 1);
MapiCalendar app1 = new MapiCalendar("test location", "test summary", "test description", startDate, endDate);

app1.setStartDate(startDate);
app1.setEndDate(endDate);

String pattern = "DTSTART;TZID=Europe/London:20150831T080000\r\nDTEND;TZID=Europe/London:20150831T083000\r\nRRULE:FREQ=DAILY;INTERVAL=1;COUNT=7\r\nEXDATE:20150831T070000Z,20150904T070000Z";
app1.getRecurrence().setRecurrencePattern(MapiCalendarRecurrencePatternFactory.fromString(pattern));

Додати вкладення до повторюваних подій календаря

API Aspose.Email надає можливість додавати вкладення до повторюваних подій календаря.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
String dataDir = RunExamples.getDataDir_Outlook();

Date startDate = addHours(getDate(2018, 7, 19), 12);
MapiCalendar calendar = new MapiCalendar("location1", "summary1", "description1", startDate, addHours(startDate, 1));

MapiCalendarEventRecurrence recurrence = new MapiCalendarEventRecurrence();
MapiCalendarRecurrencePattern pattern = new MapiCalendarDailyRecurrencePattern();
recurrence.setRecurrencePattern(pattern);
pattern.setPatternType(MapiCalendarRecurrencePatternType.Day);
pattern.setPeriod(1);
pattern.setEndType(MapiCalendarRecurrenceEndType.NeverEnd);

Date exceptionDate = addDays(startDate, 3);
MapiCalendarExceptionInfo exception = new MapiCalendarExceptionInfo();
exception.setLocation("exceptionLoc");
exception.setSubject("exceptionSubj");
exception.setBody("exceptionBody");
exception.setOriginalStartDate(exceptionDate);
exception.setStartDateTime(exceptionDate);
exception.setEndDateTime(addHours(exceptionDate, 5));
exception.setAttachments(new MapiAttachmentCollection(calendar));
exception.getAttachments().add("file.txt", "hello, world!".getBytes());

pattern.getExceptions().addItem(exception);
pattern.getModifiedInstanceDates().addItem(exceptionDate);
pattern.getDeletedInstanceDates().addItem(exceptionDate);
calendar.setRecurrence(recurrence);

try (PersonalStorage newPst = PersonalStorage.create(dataDir + "AddAttachmentToMapiExceptionInfo.pst", FileFormatVersion.Unicode))
{
    FolderInfo newFolder = newPst.createPredefinedFolder("Calendar", StandardIpmFolder.Appointments);
    newFolder.addMapiMessageItem(calendar);
}

Встановити часовий пояс події календаря

API Aspose.Email надає можливість встановлювати часовий пояс календаря:

інформація про часовий пояс для дати початку/закінчення
інформація про часовий пояс для повторюваної зустрічі
інформація про часовий пояс, яка описує, як конвертувати дату та час зустрічі у повторюваній серії до і від UTC

Наведений фрагмент коду показує, як встановити інформацію про часовий пояс календаря:

MapiCalendar event = new MapiCalendar("location", "summary", "description", startDate, endDate);
// UTC time zone
MapiCalendarTimeZone utcTimeZone = new MapiCalendarTimeZone("UTC");
event.setStartDateTimeZone(utcTimeZone);
event.setEndDateTimeZone(utcTimeZone);

MapiCalendarDailyRecurrencePattern pattern = new MapiCalendarDailyRecurrencePattern();
pattern.setPeriod(1);
pattern.setStartDate(startDate);
pattern.setEndDate(untilDate);
pattern.setEndType(MapiCalendarRecurrenceEndType.EndAfterDate);
pattern.setPatternType(MapiCalendarRecurrencePatternType.Day);
pattern.setDayOfWeek(DayOfWeek.Monday);

MapiCalendarEventRecurrence r = new MapiCalendarEventRecurrence();
r.setRecurrencePattern(pattern);
r.setClipStart(startDate);
r.setClipEnd(pattern.getEndDate());
//https://docs.microsoft.com/en-us/office/client-developer/outlook/mapi/pidlidappointmenttimezonedefinitionrecur-canonical-property
r.setAppointmentTimeZoneDefinitionRecur(utcTimeZone); // <---
r.setTimeZoneStruct(utcTimeZone); // <---
event.setRecurrence(r);