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

Java: Създаване и запазване на MSG файлове

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

Aspose.Email поддържа създаването на Outlook съобщения (MSG) файлове. Тази статия обяснява как да:

Създайте MSG съобщения.
Създайте MSG съобщения с прикачени файлове.
Създайте MSG съобщение с RTF тяло.
Запазете съобщение като чернова.
Работа с компресиране на тялото.

Създаване и запазване на Outlook съобщения

Този 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 съобщения (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). Този 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 файлове.

Try it out!

Конвертирайте имейли и архиви от съобщения онлайн с безплатното Приложение за конвертиране на 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 съобщение

Aspose.Email API предоставя възможност за конвертиране на 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 със запазване на заглавката за категория

Aspose.Email API предоставя възможност за добавяне на заглавка за категория при конвертиране на съобщение към 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 class може да се използва за зареждане и четене на Outlook шаблон (OFT) файл. След като шаблонът е зареден в инстанция на 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 и низа на цветова категория, например "Purple Category" или "Red Category", като аргументи.
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 файл

Aspose.Email API предоставя възможност за достъп до информацията за проследяване от изпратено или получено съобщение. Тя може да извлича информация за разписка за прочитане, разписка за доставка и резултати от гласуване от файл със съобщение.

Извличане на информация за разписка за прочитане и доставка

Следният кодов фрагмент показва как да извлечете информация за разписка за прочитане и доставка.

// 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());
}

Създаване на съобщения за препращане и отговор

Aspose.Email API предоставя възможност за създаване и форматиране на съобщения за препращане и отговор. Методът ReplyMessageBuilder и ForwardMessageBuilder класовете на API се използват за създаване съответно на Reply и Forward съобщения. Reply или Forward съобщение може да бъде създадено, използвайки който и да е от режимите на OriginalMessageAdditionMode enum. Този enum има следните стойности:

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 за 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());
}

Try it out!

Парсирайте имейл файлове онлайн безплатно с Приложение за парсване Aspose.Email.

Получаване на тип елемент на 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 съобщение. Този FollowUpOptions клас предоставя 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. Съществуват няколко варианта, при които флагът за проследяване може да бъде зададен върху съобщение. Всички те се използват в примерния код по-долу:

Задай флаг за проследяване на съобщение
Добави дата за изпълнение и дата за напомняне към съобщение
Добави флаг към съобщението на получателя.
Маркирай като завършено.
Премахни флага.
Прочетете опциите за последващо действие.

Задаване на флаг FollowUp

Следният кодов фрагмент показва как да зададете флаг за последващо действие.

// 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");

Настройване на последващо действие за получатели

Следният кодов фрагмент показва как да зададете последващо действие за получателите.

// 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 като завършен

Следният кодов фрагмент показва как да маркирате флага за последващо действие като завършен.

// 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

Следният кодов фрагмент показва как да премахнете флага за последващо действие.

// 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");

Прочетете опциите за флага на последващо действие за съобщение

Следният кодов фрагмент показва как да прочетете опциите за флага на последващо действие за съобщение.

// 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 за 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.

Следният примерен код демонстрира как да се актуализират имената за показване на първия и втория прикачен файл в заредения MapiMessage:

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. Email1 (MapiContactElectronicAddress)
    1. Тип адрес
    2. Показвано име
    3. Имейл адрес
    4. Факс номер
  2. Email2
  3. Email3
  4. Домашен факс
  5. Основен факс
  6. Служебен факс
2. Събития (MapiContactEventPropertySet) Вижте по-долу пример как да зададете събития.
  1. Рожден ден
  2. Брачна годишнина
3. Информация за име (MapiContactNamePropertySet)
  1. Показвано име
  2. Представка пред името
  3. Категория
  4. ID за категоризиране
  5. Поколение
  6. Лично име
  7. Инициали
  8. Презиме
  9. Прякор
  10. Фамилно име
4. Лична информация (MapiContactPersonalInfoPropertySet)
  1. Акаунт
  2. Бизнес уеб страница
  3. Име на компютърна мрежа
  4. Клиентски ID
  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 към контакта.

|| | :- | |Figure: Контакт в Microsoft Outlook, кодиран с Aspose.Email|

Добавяне на информация за събитие към контакт в MapiContact

Microsoft Outlook позволява на потребителите да добавят информация за събитие към контакт. Събитието съдържа рождения ден и годишнината от брака. Aspose.Email предоставя MapiContactEventPropertySet клас за добавяне на тази информация към контакт. Това е разширено в следния пример.

Създаване, запазване и четене на Outlook контакти

Aspose.Email позволява на разработчиците да създават Microsoft Outlook контакти, както и имейл съобщения. Този MapiContact клас предоставя всички свойства на контакт, необходими за създаване на Outlook контакт. Тази статия показва как да създадете, запазите и прочетете Outlook контакт, използвайки MapiContact клас.

Създаване и запазване на MapiContact

Следните стъпки могат да се използват за създаване и запазване на контакт на диск:

Инстанцирайте нов обект от MapiContact клас.
Въведете информация, свързана с различни свойства на контакта.
Добавете данни за снимка към контакта, ако има.
Запазете контакта във формат MSG или VCard.

Запазване на контакт във формат VCF версия 3

За да запазите контакта във формат VCF версия 3, използвайте VCardVersion изброим за задаване на VCardSaveOptions.Version свойство. Следният примерен код демонстрира използването на VCardVersion изброим за запазване на контакта във VCF версия 3 формат.

Четене на MapiContact

Този 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, използвайки Aspose.Email API. Този пример показва как VCard се зарежда в MapiContact и след това конвертиран в MHTML с помощта на MailMessage API.

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

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

Създаване, запазване и четене на задачи в Outlook

Aspose.Email за Java позволява на разработчиците да създават Outlook задачи и да ги запазват във формат MSG. The MapiTask класът предоставя редица свойства като PercentComplete, EstimatedEffort, ActualEffort, History, LastUpdate, и др., за да се съобрази и зададат информацията, необходима за Outlook задача. Тази статия показва как да се създаде, запази и прочете MapiTask от диск.

Създаване и запазване на MapiTask

Следните стъпки могат да се използват за създаване и запазване на задача на диск.

Инстанцирайте нов обект от MapiTask клас.
Въведете информация за различните свойства на задачата.
Запазете задачата на диск във формат MSG.

Прочетете MapiTask

Този MapiTask обект от клас се използва за привеждане на MapiMessage обект, който зарежда задача от диска във формат MSG.

Прочетете VToDo задача

Google Tasks, експортирани във формат iCalendar като VToDo събития, могат да се заредят чрез MapiTask клас, както е показан в следния пример с код.

Добавяне на информация за напомняне към MapiTask

Подобно на Microsoft Outlook, Aspose.Email може да добави информация за напомняне към MapiTask. Следният фрагмент от код показва как да добавите информация за напомняне към MapiTask.

Добавяне на прикачен файл към MapiTask

Следният фрагмент от код показва как да добавите прикачени файлове към MapiTask.

Конвертиране на Outlook задача в MHT

Aspose.Email може да генерира MapiMessage подобно на изход по време на конвертиране на MapiTask към MHT.

Java: Работа с Outlook бележки

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

Създаване, запазване и четене на Outlook бележки

Aspose.Email предоставя възможност за създаване на Outlook бележки и запазването им на диск във MSG формат. Този MapiNote клас предоставя свойства и методи за задаване на желаната информация за бележка. Тази статия показва как да се създаде, запази и прочете MapiNote от диска.

Създаване и запазване на Outlook бележка

Следните стъпки могат да се използват за създаване и запазване на бележка на диск.

Инстанцирайте обект от MapiNote клас.
Задайте различни свойства, както желаете.
Запазете бележката на диск като MSG файл.

Четене на MapiNote

Този MapiNote обект от клас се използва за привеждане на MapiMessage обект, който зарежда бележка от диск във MSG формат.

Java: Управление на цифрово подписани съобщения

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

Aspose.Email реализира пълния алгоритъм за S/MIME имейл обекти. Това дава на API пълната възможност да добавя цифрови подписи към имейл съобщения, да ги запазва при конвертиране между формати, да ги премахва и др.

Прикрепяне на подпис към имейл

Този 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

Работа с 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

Този 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 обект изрично, като предефинира поведението по подразбиране. 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

Възможно е да създадете списък за разпращане (Distribution list) с помощта на 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 файл

Този void save(String fileName, MapiDistributionListSaveOptions options) методът позволява да запазите Mapi Distribution List в определено име на файл, използвайки предоставените опции за запазване. Можете да предоставите името на файла и инстанция на the 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. Периодът или 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

// 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);

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

Aspose.Email API предоставя възможност за генериране на модел на повтаряне от правило за повтаряне (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));

Добавяне на прикачени файлове към повтарящи се събития в календара

Aspose.Email API предоставя възможност за добавяне на прикачени файлове към повтарящи се събития в календара.

// 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);
}

Задаване на часовата зона за събитие в календара

Aspose.Email API предоставя възможност за задаване на часовата зона в календара:

информация за часовата зона за начална/крайна дата
информация за часовата зона за повтаряща се среща
информация за часовата зона, която описва как да конвертирате датата и часа на среща в повтаряща се серия към и от 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);