Documentation – Làm việc với các mục Outlook

Java: Tạo và Lưu các Tệp MSG

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

Aspose.Email hỗ trợ tạo các tệp Outlook message (MSG). Bài viết này giải thích cách:

Tạo tin nhắn MSG.
Tạo tin nhắn MSG có đính kèm.
Tạo tin nhắn MSG với phần thân RTF.
Lưu tin nhắn dưới dạng bản nháp.
Làm việc với nén phần thân.

Tạo và Lưu Tin Nhắn Outlook

Cái MailMessage lớp có lưu phương thức có thể lưu các tệp Outlook MSG vào đĩa hoặc stream. Các đoạn mã dưới đây tạo một thể hiện của MailMessage lớp, thiết lập các thuộc tính như from, to, subject và body. Phương thức lưu phương thức nhận tên tệp làm đối số. Ngoài ra, các Tin nhắn Outlook có thể được tạo với một phần thân RTF nén sử dụng MapiConversionOptions.

Tạo một thể hiện mới của MailMessage lớp và thiết lập các thuộc tính From, To, Subject và Body.
Gọi MapiMessage lớp fromMailMessage phương thức nhận đối tượng của MailMessage kiểu. Phương thức fromMailMessage phương thức chuyển đổi MailMessage vào một MapiMessage (MSG).
Gọi MapiMessage.save phương thức để lưu tệp 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);

Tạo Tệp MSG với Đính Kèm

Trong ví dụ trên, chúng tôi đã tạo một tệp MSG đơn giản. Aspose.Email cũng hỗ trợ lưu các tệp tin nhắn kèm đính kèm. Tất cả những gì bạn cần làm là thêm các đính kèm vào MailMessage đối tượng. Thêm tệp đính kèm bằng cách gọi phương thức addItem trên MailMessage.Attachments bộ sưu tập.

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

Tạo Tệp MSG với Phần Thân RTF

Bạn cũng có thể tạo các tệp Outlook Message (MSG) với phần thân văn bản định dạng (RTF) bằng Aspose.Email. Phần thân RTF hỗ trợ định dạng văn bản. Tạo một bằng cách thiết lập MailMessage.HtmlBody thuộc tính. Khi bạn chuyển đổi một MailMessage đối tượng thành một MapiMessage trong trường hợp này, phần thân HTML được chuyển thành RTF. Cách này giúp định dạng của phần thân email được bảo tồn.

Ví dụ sau tạo một tệp MSG với phần thân RTF. Có một tiêu đề, định dạng in đậm và gạch dưới được áp dụng trong phần thân HTML. Định dạng này được giữ lại khi HTML được chuyển sang 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");

Lưu Tin Nhắn ở Trạng Thái Bản Nháp

Email được lưu dưới dạng bản nháp khi người dùng đã bắt đầu chỉnh sửa nhưng muốn quay lại để hoàn thành sau. Aspose.Email hỗ trợ lưu tin nhắn email ở trạng thái bản nháp bằng cách thiết lập cờ tin nhắn. Dưới đây là đoạn mã mẫu để lưu một tin nhắn email Outlook (MSG) dưới dạng bản nháp.

Lưu ý rằng ở trạng thái bản nháp, Outlook không hiển thị bất kỳ thông tin người gửi nào được gán cho MapiMessage. Nếu cần hiển thị thông tin Người gửi, chúng ta nên đặt cờ 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");

Hệ quả của Nén Phần Thân

Phương pháp nén phần thân RTF có thể được sử dụng để tạo MSG có kích thước nhỏ hơn. Tuy nhiên, điều này làm chậm tốc độ tạo. Để tạo tin nhắn nhanh hơn, đặt cờ thành false. Cờ này, ngược lại, ảnh hưởng đến các PST được tạo: các tệp MSG nhỏ hơn dẫn đến PST nhỏ hơn, và các tệp MSG lớn dẫn đến quá trình tạo PST chậm hơn.

// 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: Tải, Xem và Phân tích tệp MSG

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

Chủ đề này giải thích cách tải tệp tin Nhắn Microsoft Outlook (*.msg). MapiMessage lớp được sử dụng để tải các tệp MSG và cung cấp một số hàm tải tĩnh cho các kịch bản khác nhau. Đoạn mã sau đây cho bạn thấy cách tải các tệp MSG từ tệp hoặc từ luồng.

Tải các Tệp MSG

Đoạn mã sau đây cho bạn thấy cách tải các tệp 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());
}

Ví dụ mã sau đây cho thấy cách sử dụng MailMessage để tải một tin nhắn ở định dạng MSG.

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

Cần lưu ý rằng tin nhắn đầu ra sẽ được chuyển đổi sang định dạng EML, bao gồm các tệp đính kèm tin nhắn nhúng. Không sử dụng phương pháp tải này nếu bạn muốn giữ một số thuộc tính định dạng msg cụ thể của tin nhắn gốc.

Để giữ nguyên định dạng gốc của các tệp đính kèm tin nhắn nhúng, sử dụng MsgLoadOptions.PreserveEmbeddedMessageFormat thuộc tính.

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

Tải từ Luồng

Đoạn mã sau đây cho bạn thấy cách tải một tệp từ luồng.

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

}

Chuyển đổi EML sang MSG giữ Định dạng EML Nhúng

Các tệp EML có thể được tải vào MapiMessage lớp bằng cách khởi tạo một MailMessage đối tượng và truyền nó tới MapiMessage.fromMailMessage phương thức. Nếu tệp EML chứa các tệp EML nhúng, hãy sử dụng MapiConversionOptions.setPreserveEmbeddedMessageFormat để giữ nguyên định dạng của các tệp EML nhúng. Đoạn mã dưới đây cho thấy cách tải các tệp EML vào MapiMessage trong khi giữ nguyên định dạng của các tệp EML nhúng.

Try it out!

Chuyển đổi email & lưu trữ tin nhắn trực tuyến với phiên bản miễn phí Ứng dụng Chuyển đổi 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: Quản Lý Các Tệp Tin Nhắn với Aspose.Email.Outlook

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

Chuyển Đổi MSG sang Tin MIME

Aspose.Email API cung cấp khả năng chuyển đổi tệp MSG sang tin MIME bằng cách sử dụng toMailMessage phương thức.

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

Chuyển Đổi MSG sang EML Giữ Phần Thân RTF

API cung cấp các phương thức sau để giữ phần thân RTF khi chuyển đổi MSG sang EML:

MsgLoadOptions.PreserveRtfContent - Lấy hoặc đặt giá trị cho biết có giữ phần thân rtf trong MailMessage hay không.
MailConversionOptions.PreserveRtfContent - Lấy hoặc đặt giá trị cho biết có giữ phần thân rtf trong MailMessage hay không.

Các mẫu mã dưới đây minh họa cách giữ phần thân rtf trong MailMessage:

sử dụng MsgLoadOptions.PreserveRtfContent

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

sử dụng MailConversionOptions.PreserveRtfContent

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

Chuyển Đổi MSG sang MHTML Giữ Tiêu Đề Danh Mục

Aspose.Email API cung cấp khả năng thêm tiêu đề danh mục khi chuyển đổi tin nhắn sang MHTML. Tính năng này được xác định bởi MhtSaveOptions lớp như một tùy chọn bổ sung khi lưu MailMessage sang định dạng Mhtml.

Mẫu mã dưới đây minh họa cách tạo tệp MHT (MHTML) từ đối tượng MapiMessage, tùy chỉnh định dạng và tiêu đề của tệp MHT bằng MhtSaveOptions, đặt danh mục cho tin email và sau đó sửa đổi mẫu định dạng và tiêu đề hiển thị cho tệp MHT trước khi lưu.

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

Đọc và Ghi Tệp Mẫu Outlook (.OFT)

Mẫu Outlook rất hữu ích khi bạn muốn gửi một email tương tự lần lượt. Thay vì chuẩn bị tin nhắn từ đầu mỗi lần, đầu tiên, chuẩn bị tin nhắn trong Outlook và lưu dưới dạng Mẫu Outlook (OFT). Sau đó, khi cần gửi tin, bạn có thể tạo nó từ mẫu, tiết kiệm thời gian viết lại cùng nội dung trong phần thân hoặc tiêu đề, thiết lập định dạng, v.v. Aspose.Email MailMessage lớp có thể được sử dụng để tải và đọc tệp mẫu Outlook (OFT). Khi mẫu Outlook đã được tải trong một thể hiện của MailMessage lớp, bạn có thể cập nhật người gửi, người nhận, nội dung, tiêu đề và các thuộc tính khác. Sau khi cập nhật các thuộc tính:

Gửi email bằng cách sử dụng SmtpClient lớp hoặc
Lưu tin nhắn dưới dạng MSG và thực hiện các cập nhật/kiểm tra tiếp theo bằng Microsoft Outlook.

Trong các mẫu mã dưới đây, chúng tôi:

Tải mẫu bằng cách sử dụng MailMessage lớp.
Cập nhật một số thuộc tính.
Lưu tin nhắn ở định dạng MSG.

Đoạn mã dưới đây cho bạn thấy cách tải tệp OFT, cập nhật tin nhắn và lưu nó ở định dạng 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");

Lưu Tệp MSG Outlook dưới dạng Mẫu

Đoạn mã dưới đây cho bạn thấy cách lưu tệp MSG outlook dưới dạng mẫu.

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

Đặt Danh Mục Màu cho Tệp MSG Outlook

Một danh mục màu đánh dấu một tin email với một mức độ quan trọng hoặc loại nào đó. Microsoft Outlook cho phép người dùng gán các danh mục màu để phân biệt email. Để xử lý danh mục màu, sử dụng FollowUpManager. Nó chứa các hàm như addCategory, removeCategory, clearCategories và getCategories.

addCategory nhận MapiMessage và chuỗi danh mục màu, ví dụ "Purple Category" hoặc "Red Category" làm đối số.
removeCategory nhận MapiMessage và chuỗi danh mục màu cần xóa khỏi tin nhắn.
clearCategories được sử dụng để xóa tất cả các danh mục màu khỏi tin nhắn.
getCategories được sử dụng để lấy tất cả các danh mục màu từ một tin nhắn cụ thể.

Ví dụ dưới đây thực hiện các công việc như sau:

Thêm một danh mục màu.
Thêm một danh mục màu khác.
Lấy danh sách tất cả các danh mục.
Xóa tất cả các danh mục.

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

Truy Cập Thông Tin Theo Dõi từ Tệp MSG

Aspose.Email API cung cấp khả năng truy cập thông tin theo dõi từ một tin nhắn đã gửi hoặc đã nhận. Nó có thể lấy thông tin Đã Đọc, Biên Nhận Đã Giao và kết quả bỏ phiếu từ tệp tin tin nhắn.

Lấy Thông Tin Biên Nhận Đã Đọc và Đã Giao

Đoạn mã dưới đây cho bạn thấy cách lấy thông tin biên nhận đã đọc và đã giao.

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

Tạo Tin Nhắn Forward và Reply

Aspose.Email API cung cấp khả năng tạo và định dạng các tin nhắn forward và reply. Các ReplyMessageBuilder và ForwardMessageBuilder các lớp của API được sử dụng để tạo tin nhắn Reply và Forward tương ứng. Một tin nhắn Reply hoặc Forward có thể được chỉ định tạo bằng bất kỳ chế độ nào của OriginalMessageAdditionMode enum. Enum này có các giá trị sau:

OriginalMessageAdditionMode.None - Tin nhắn gốc không được đưa vào trong tin nhắn trả lời.
OriginalMessageAdditionMode.Attachment - Tin nhắn gốc được đưa vào dưới dạng đính kèm trong tin nhắn trả lời
OriginalMessageAdditionMode.Textpart - Tin nhắn gốc được đưa vào dưới dạng văn bản trong phần thân tin nhắn trả lời

Tạo Tin Nhắn Trả Lời

Đoạn mã dưới đây cho bạn cách tạo tin nhắn trả lời.

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

Tạo Tin Nhắn Chuyển Tiếp

Đoạn mã dưới đây cho bạn cách tạo tin nhắn chuyển tiếp.

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

Bảo Tồn Ngày Trống khi Chuyển Đổi Tin Nhắn

MapiConversionOptions.setPreserveEmptyDates(boolean) thuộc tính chỉ ra liệu cần giữ lại các ngày trống khi chuyển đổi tin nhắn hay không. API này xuất hiện trong Aspose.Email 21.5. Đoạn mã dưới đây cho bạn cách bảo tồn các ngày trống.

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: Làm việc với Tùy chọn Bỏ phiếu sử dụng MapiMessage

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

Tạo tùy chọn Bỏ phiếu bằng MapiMessage

Microsoft Outlook cho phép người dùng tạo một cuộc thăm dò khi soạn tin nhắn mới. Nó cho phép họ bao gồm các tùy chọn bỏ phiếu như Có, Không, Có thể, v.v. Aspose.Email cho phép điều tương tự khi tạo một tin Outlook mới. FollowUpOptions class cung cấp VotingButtons thuộc tính có thể được sử dụng để đặt hoặc lấy giá trị của các tùy chọn bỏ phiếu. Bài viết này cung cấp ví dụ chi tiết về việc tạo một MapiMessage với các tùy chọn bỏ phiếu để tạo một cuộc thăm dò.

Tạo một cuộc thăm dò bằng MapiMessage

Đoạn mã sau đây cho bạn thấy cách tạo một cuộc thăm dò, FollowUpManager lớp có thể được sử dụng như được chỉ ra trong đoạn mã sau.

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

Đọc Các Tùy chọn Bỏ phiếu từ MapiMessage

Đoạn mã sau đây cho bạn thấy cách Đọc các Tùy chọn Bỏ phiếu từ một 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();

Đọc Chỉ Các Nút Bỏ phiếu

Đoạn mã sau đây cho bạn thấy cách chỉ đọc các nút bỏ phiếu.

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

Thêm nút bỏ phiếu vào Tin nhắn hiện có

Đoạn mã sau đây cho bạn thấy cách thêm nút bỏ phiếu vào một tin nhắn hiện có.

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

Xóa Nút Bỏ phiếu khỏi Tin nhắn

Đoạn mã sau đây cho bạn thấy cách xóa nút bỏ phiếu khỏi một tin nhắn.

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

Đọc Thông tin Kết quả Bỏ phiếu

Đoạn mã sau đây cho bạn thấy cách đọc thông tin kết quả bỏ phiếu.

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

Các Phương thức Mẫu Được Sử Dụng Trong Các Ví Dụ

Đoạn mã sau đây cho bạn thấy cách tạo một tin nhắn mẫu được sử dụng trong các ví dụ.

// 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: Phân Tích Tệp Tin Nhắn Outlook

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

Sử dụng Aspose.Email cho Java, các nhà phát triển không chỉ có thể tải mà còn phân tích nội dung từ tệp tin nhắn Outlook.

Để tải tệp MSG từ đĩa, sử dụng MapiMessage lớp tĩnh Load phương thức.
Để phân tích nội dung tệp MSG, MapiMessage phơi bày một số phương thức.

Chủ đề này cho thấy cách tải và sau đó phân tích tệp MSG để hiển thị nội dung của nó.

Aspose.Email cho Java cung cấp MapiMessage lớp được sử dụng để mở và phân tích tệp MSG. Vì có thể có nhiều người nhận trong một tệp MSG, thì MapiMessage lớp này cung cấp getRecipients() phương thức trả về một MapiRecipientCollection mà đại diện cho một bộ sưu tập của MapiRecipient các đối tượng. Các MapiRecipient đối tượng này còn phơi bày các phương thức để làm việc với thuộc tính người nhận.

Chuỗi các bước sau thực hiện mục đích này:

Tạo một đối tượng của MapiMessage lớp để tải tệp MSG từ Load phương thức tĩnh.
Hiển thị tên người gửi, tiêu đề và nội dung từ tệp MSG bằng cách sử dụng getSenderName(), getSubject() và getBody() các phương thức.
Gọi getRecipients() phương thức được cung cấp bởi MapiRecipient lớp để lấy tham chiếu đến bộ sưu tập của MapiRecipient đối tượng liên quan đến tệp MSG.
Lặp qua MapiRecipientCollection bộ sưu tập để hiển thị nội dung cho mỗi MapiRecipient đối tượng thông qua các phương thức công khai của nó.

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

Phân tích tệp email trực tuyến miễn phí Ứng dụng Phân tích Aspose.Email.

Lấy Kiểu Mục của Tin Nhắn MAPI

Aspose.Email cung cấp một MapiItemType enum đại diện cho một kiểu mục. Nó có thể được sử dụng để chuyển đổi tin nhắn thành một đối tượng của lớp tương ứng kế thừa từ IMapiMessageItem giao diện. Điều này giúp người dùng không phải kiểm tra giá trị thuộc tính MessageClass trước khi chuyển đổi tin nhắn.

Ví dụ mã sau cho thấy cách duyệt qua các tin nhắn trong một thư mục và chuyển đổi mỗi tin nhắn MAPI thành loại mục MAPI tương ứng, tùy thuộc vào loại của tin nhắn:

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: Làm việc với Follow Up và Ngày Hạn cho Tệp MSG của Outlook

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

Cài đặt Theo dõi và Ngày đến hạn cho Tệp Outlook MSG

Cờ theo dõi đánh dấu một email cho một loại hành động nào đó. Microsoft Outlook cho phép người dùng gắn cờ vào tin nhắn và trong phần thiết lập cờ, chỉ định ngày đến hạn cho việc theo dõi. Microsoft Outlook gửi lời nhắc tới người nhận để thúc đẩy họ theo dõi email. Việc gắn cờ cho email và thiết lập ngày đến hạn một cách lập trình giúp các nhà phát triển phần mềm tự động hoá một số loại email và giúp người nhận nhớ thực hiện hành động. Ví dụ, nó có thể được dùng để gửi tin nhắn hàng tháng cho đội bán hàng để nhắc họ hoàn thành báo cáo; hoặc gửi tin nhắn tới toàn bộ nhân viên để nhắc họ về cuộc họp công ty. Aspose.Email cho Java hỗ trợ thiết lập cờ theo dõi và ngày đến hạn cho MapiMessage các đối tượng sử dụng FollowUpManager và FollowUpOptions. Có một số biến thể mà cờ theo dõi có thể được đặt trên một tin nhắn. Tất cả chúng được sử dụng trong mẫu mã bên dưới:

Đặt cờ theo dõi cho một tin nhắn
Thêm ngày đến hạn và ngày nhắc nhở vào tin nhắn
Thêm một cờ vào tin nhắn của người nhận.
Đánh dấu là hoàn thành.
Xóa cờ.
Đọc các tùy chọn follow up.

Đặt cờ FollowUp

Đoạn mã dưới đây cho bạn thấy cách đặt cờ follow-up.

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

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

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

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

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

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

Đặt Follow Up cho Người Nhận

Đoạn mã dưới đây cho bạn thấy cách đặt follow-up cho người nhận.

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

Đánh dấu cờ FollowUp là Đã Hoàn Thành

Đoạn mã dưới đây cho bạn thấy cách đánh dấu cờ follow-up là đã hoàn thành.

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

Xóa cờ FollowUp

Đoạn mã dưới đây cho bạn thấy cách xóa cờ follow-up.

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

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

Đọc các tùy chọn cờ follow-up cho tin nhắn

Đoạn mã dưới đây cho bạn thấy cách đọc các tùy chọn cờ follow-up cho một tin nhắn.

// 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: Làm việc với các thuộc tính MAPI

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

Đặt và Truy cập các thuộc tính Outlook MAPI

Aspose.Email cho Java cung cấp MapiProperty lớp đại diện cho một thuộc tính MAPI:

Tên: tên thuộc tính.
Thẻ: thẻ thuộc tính.
Dữ liệu: dữ liệu thuộc tính.

Chủ đề này cũng thảo luận cách đặt và truy cập các thuộc tính MAPI của tệp Outlook Message (MSG) bằng Aspose.Email cho Java. Ngoài ra, đã cung cấp mã mẫu về cách xóa các thuộc tính khỏi MSG và các tệp đính kèm.

Đọc Thuộc tính

Để đọc dữ liệu các thuộc tính MAPI từ một tệp MSG:

Tạo một đối tượng của MapiMessage lớp để tải tệp MSG bằng cách sử dụng Load() phương thức tĩnh.
Đặt một tham chiếu tới MapiMessage đối tượng getProperties() phương thức để lấy MapiPropertyCollection.
Lấy MapiProperty đối tượng từ MapiPropertyCollection bởi MapiPropertyTag khóa.
Lấy dữ liệu thuộc tính bằng cách sử dụng phương thức getXXX() thích hợp.

Đặt các Thuộc tính Bổ sung

Mẫu mã sau có thể được sử dụng để đặt các thuộc tính bổ sung của một Outlook MapiMessage.

Xóa Thuộc tính

Đọc các Thuộc tính Mapi có tên từ Tin nhắn Email

Microsoft Outlook hỗ trợ thêm các thuộc tính MAPI có tên vào một tệp MSG. Các thuộc tính này được người dùng thêm vào. Các nhà phát triển có thể thêm một thuộc tính có tên, ví dụ “MyProp”, vào tệp MSG bằng Aspose.Email.

Bài viết này minh họa Aspose.Email MapiMessage getNamedProperties() bộ sưu tập để đọc các thuộc tính MAPI có tên từ một tệp MSG.

Đọc Thuộc tính MAPI có tên

Đọc Thuộc tính Mapi có tên từ Đính kèm

Java: Làm việc với Đính Kèm Tin Nhắn

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

Phân Tích và Lưu Đính Kèm

Các tệp tin nhắn Outlook có thể chứa một hoặc nhiều đính kèm. Aspose.Email cho phép các nhà phát triển lặp qua các đính kèm trong tệp MSG và lưu chúng vào đĩa. Chủ đề này mô tả quy trình. Nó cũng mô tả cách nhúng một đính kèm.

Aspose.Email MapiMessage lớp được sử dụng để tải tệp MSG từ đĩa và cung cấp getAttachments() phương thức tham chiếu tới MapiAttachment bộ sưu tập đối tượng liên quan đến tệp MSG. Các MapiAttachment đối tượng còn cung cấp các phương thức thực hiện các thao tác trên đính kèm.

Để lưu các đính kèm trong tệp MSG vào đĩa với tên và phần mở rộng gốc:

Tạo một đối tượng của MapiMessage lớp để tải tệp MSG bằng cách sử dụng Load() phương thức tĩnh.
Gọi MapiRecipient lớp getAttachments() phương thức để lấy tham chiếu tới bộ sưu tập của MapiAttachment đối tượng liên quan đến tệp MSG.
Lặp qua MapiAttachmentCollection để hiển thị nội dung liên quan tới mỗi MapiAttachment đối tượng thông qua các phương thức công khai của nó.
Gọi MapiAttachment lớp save() phương thức lưu đính kèm vào đĩa.

Nhúng Tin Nhắn dưới dạng Đính Kèm

Một tin nhắn Microsoft Outlook có thể chứa các tin nhắn Microsoft Outlook khác trong phần đính kèm, dưới dạng tin nhắn thông thường như đã mô tả ở trên, hoặc tin nhắn nhúng. Các MapiAttachmentCollection cung cấp các thành viên quá tải của phương thức add để tạo tin nhắn Outlook với cả hai loại đính kèm. Các tệp Outlook MSG được nhúng trong một tệp MSG chứa PR_ATTACH_METHOD với giá trị 5.

Đọc Tin Nhắn Nhúng từ Đính Kèm

Chèn và Thay Thế Đính Kèm MSG

Aspose.Email API cung cấp khả năng chèn đính kèm tại chỉ số cụ thể trong tin nhắn cha. Nó cũng cung cấp tiện ích để thay thế nội dung của một đính kèm bằng đính kèm của tin nhắn khác.

Chèn Đính Kèm MSG tại Vị Trí Cụ Thể

Aspose.Email API cung cấp khả năng chèn một đính kèm MSG vào MSG cha bằng cách sử dụng MapiAttachmentCollection.Insert() phương thức.

Thay Thế Nội Dung Đính Kèm MSG Nhúng

Điều này có thể được sử dụng để thay thế nội dung đính kèm nhúng bằng các nội dung mới bằng cách sử dụng Thay Thế phương thức. Tuy nhiên, nó không thể được sử dụng để chèn đính kèm với PR_ATTACH_NUM = 4 (ví dụ) vào bộ sưu tập có collection.Count = 2.

Lưu Đính Kèm từ Tin Nhắn Được Ký Số

Aspose.Email API cung cấp khả năng lấy hoặc đặt giá trị cho biết liệu tin nhắn được ký rõ sẽ được giải mã hay không.

Đổi Tên Đính Kèm trong MapiMessage

Aspose.Email cho phép chỉnh sửa Tên hiển thị giá trị thuộc tính trong đính kèm MapiMessage.

Đoạn mã mẫu dưới đây minh họa cách cập nhật tên hiển thị của đính kèm thứ nhất và thứ hai trong Mapi message đã tải:

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

Kiểm Tra Đính Kèm Có Phải Nội Tuyến Hay Thông Thường

Sự khác biệt giữa đính kèm nội tuyến và đính kèm thông thường là cách chúng được trình bày trong email. Đính kèm nội tuyến được nhúng trong phần thân email và có thể xem mà không cần mở tệp riêng hoặc tải xuống bất kỳ thứ gì. Đính kèm thông thường, ngược lại, là các tệp riêng biệt được đính kèm vào email nhưng không hiển thị trực tiếp trong phần thân tin nhắn và cần được tải xuống và mở bên ngoài. MapiAttachment.IsInline thuộc tính của MapiAttachment lớp nhận giá trị cho biết đính kèm là nội tuyến hay thông thường.

Đoạn mã mẫu dưới đây tải một tin nhắn email từ tệp và sau đó lấy thông tin về các đính kèm, cụ thể là in tên hiển thị của mỗi đính kèm và liệu nó có phải là nội tuyến trong tin nhắn hay không:

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

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

Java: Làm việc với Danh bạ Outlook

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

Tạo danh bạ Outlook

Aspose.Email cho Java hỗ trợ tạo danh bạ Outlook (VCards) bằng cách sử dụng MapiContact lớp. MapiContact chứa nhiều phương thức, trong đó một số được liệt kê dưới đây.

MapiContactElectronicAddressPropertySet chứa một tập hợp của MapiContactElectronicAddress.
MapiContactEventPropertySet
MapiContactNamePropertySet
MapiContactPersonalInfoPropertySet
MapiContactPhysicalAddressPropertySet chứa một tập hợp của MapiContactPhysicalAddress.
MapiContactProfessionalPropertySet
MapiContactTelephonePropertySet

Cấu trúc liên hệ trong Aspose.Email cho Java

Dưới đây là cấu trúc phân cấp được triển khai cho danh bạ trong Aspose.Email cho Java. Tên lớp tương ứng được đưa ra cho mỗi thuộc tính. Các liên kết siêu văn bản được cung cấp tới tài liệu trực tuyến để tham khảo thêm.

Contact (MapiContact)
1. Địa chỉ điện tử (MapiContactElectronicAddressPropertySet)
  1. Email1 (MapiContactElectronicAddress)
    1. Loại địa chỉ
    2. Tên hiển thị
    3. Địa chỉ Email
    4. Số Fax
  2. Email2
  3. Email3
  4. Fax nhà
  5. Fax chính
  6. Fax doanh nghiệp
2. Sự kiện (MapiContactEventPropertySet) Xem bên dưới ví dụ về cách thiết lập sự kiện.
  1. Ngày sinh nhật
  2. Ngày kỷ niệm cưới
3. Thông tin tên (MapiContactNamePropertySet)
  1. Tên hiển thị
  2. Tiền tố tên hiển thị
  3. Lưu trữ dưới
  4. ID để lưu trữ
  5. Thế hệ
  6. Tên gọi
  7. Tên viết tắt
  8. Tên đệm
  9. Biệt danh
  10. Họ
4. Thông tin cá nhân (MapiContactPersonalInfoPropertySet)
  1. Tài khoản
  2. Trang chủ doanh nghiệp
  3. Tên mạng máy tính
  4. ID khách hàng
  5. Vị trí kinh doanh miễn phí
  6. Trang FTP
  7. Giới tính
  8. Số ID chính phủ
  9. Sở thích
  10. HTML
  11. Địa chỉ tin nhắn nhanh
  12. Ngôn ngữ
  13. Địa điểm
  14. Ghi chú
  15. Số ID tổ chức
  16. Trang cá nhân
  17. Tên người giới thiệu
  18. Tên vợ/chồng
5. Địa chỉ thực (MapiContactPhysicalAddressPropertySet)
  1. Địa chỉ nhà (MapiContactPhysicalAddress)
    1. Địa chỉ
    2. Thành phố
    3. Quốc gia
    4. Mã quốc gia
    5. Mã bưu chính
    6. Hộp thư bưu điện
    7. Tiểu bang hoặc Tỉnh
  2. Địa chỉ khác
  3. Địa chỉ công việc
6. Thông tin chuyên nghiệp
  1. Trợ lý
  2. Tên công ty
  3. Tên phòng ban
  4. Tên quản lý
  5. Vị trí văn phòng
  6. Nghề nghiệp
  7. Chức danh
7. Điện thoại (MapiContactTelephonePropertySet)
  1. Số điện thoại trợ lý
  2. Số điện thoại công việc 2
  3. Số điện thoại công việc
  4. Số điện thoại gọi lại
  5. Số điện thoại ô tô
  6. Số điện thoại chính của công ty
  7. Số điện thoại nhà 2
  8. Số điện thoại nhà riêng
  9. Số ISDN
  10. Số điện thoại di động
  11. Số điện thoại khác
  12. Số điện thoại máy nhắn tin
  13. Số điện thoại chính
  14. Số điện thoại vô tuyến
  15. Số Telex
  16. Số điện thoại TTY/TDD

Mã sau sử dụng Aspose.Email để tạo một danh bạ Outlook và điền vào tên, các thuộc tính chuyên nghiệp, địa chỉ vật lý và email. Nó cũng cho thấy cách thêm MapiContactEventPropertySet vào danh bạ.

|| | :- | |Hình: Một liên hệ Microsoft Outlook được mã hóa bằng Aspose.Email|

Thêm thông tin sự kiện liên hệ vào MapiContact

Microsoft Outlook cho phép người dùng thêm thông tin sự kiện vào danh bạ. Sự kiện chứa ngày sinh và ngày kỷ niệm cưới. Aspose.Email cung cấp MapiContactEventPropertySet lớp để thêm thông tin này vào một danh bạ. Điều này được trình bày chi tiết trong ví dụ sau.

Tạo, Lưu và Đọc danh bạ Outlook

Aspose.Email cho phép các nhà phát triển tạo danh bạ Microsoft Outlook cũng như tin nhắn email. Các MapiContact lớp cung cấp tất cả các thuộc tính liên hệ cần thiết để tạo một danh bạ Outlook. Bài viết này chỉ ra cách tạo, lưu và đọc một danh bạ Outlook bằng cách sử dụng MapiContact lớp.

Tạo và Lưu một MapiContact

Các bước sau có thể được sử dụng để tạo và lưu một danh bạ lên đĩa:

Khởi tạo một đối tượng mới của MapiContact lớp.
Nhập thông tin liên quan đến các thuộc tính khác nhau của danh bạ.
Thêm dữ liệu ảnh vào danh bạ, nếu có.
Lưu danh bạ dưới dạng MSG hoặc VCard.

Lưu danh bạ ở Định dạng VCF Phiên bản 3

Để lưu danh bạ ở định dạng VCF phiên bản 3, sử dụng VCardVersion liệt kê để thiết lập VCardSaveOptions.Version thuộc tính. Đoạn mã mẫu sau đây minh họa cách sử dụng VCardVersion liệt kê để lưu danh bạ ở định dạng VCF phiên bản 3.

Đọc một MapiContact

Cái MapiContact lớp có thể được sử dụng để tải cả tệp MSG của Microsoft Outlook và các danh bạ định dạng VCard. Các đoạn mã sau đây cho thấy cách tải danh bạ Outlook được lưu dưới dạng MSG và VCF vào MapiContact.

Tải một danh bạ từ MSG

Tải một danh bạ từ VCard

Đoạn mã sau đây cho thấy cách tạo một MapiContact bằng cách tải dữ liệu từ tệp VCard sử dụng VCardLoadOptions:

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

Tải danh bạ VCard với mã hóa được chỉ định

Phương pháp được hỗ trợ: MapiContact.fromVCard(String, Encoding)

Kết xuất thông tin danh bạ sang MHTML

Danh bạ Outlook có thể được chuyển đổi sang MHTML bằng cách sử dụng API Aspose.Email. Ví dụ này cho thấy cách một VCard được tải vào MapiContact và sau đó được chuyển đổi sang MHTML với sự trợ giúp của MailMessage API.

Java: Làm việc với Nhiệm vụ Outlook

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

Tạo, Lưu và Đọc Nhiệm vụ Outlook

Aspose.Email cho Java cho phép các nhà phát triển tạo nhiệm vụ Outlook và lưu chúng ở định dạng MSG. The MapiTask lớp cung cấp một số thuộc tính như PercentComplete, EstimatedEffort, ActualEffort, History, LastUpdate, v.v., để đáp ứng và đặt thông tin cần thiết cho một nhiệm vụ Outlook. Bài viết này cho thấy cách tạo, lưu và đọc một MapiTask từ đĩa.

Tạo và Lưu một MapiTask

Các bước sau có thể được sử dụng để tạo và lưu một Nhiệm vụ vào đĩa.

Khởi tạo một đối tượng mới của MapiTask lớp.
Nhập thông tin cho nhiệm vụ các thuộc tính khác nhau.
Lưu nhiệm vụ vào đĩa ở định dạng MSG.

Đọc một MapiTask

Cái MapiTask đối tượng lớp được sử dụng để ép kiểu MapiMessage đối tượng tải một nhiệm vụ từ đĩa ở định dạng MSG.

Đọc một Nhiệm vụ VToDo

Các tác vụ Google xuất ra định dạng iCalendar dưới dạng sự kiện VToDo có thể được tải bằng MapiTask lớp như được hiển thị trong mẫu mã sau.

Thêm Thông tin Nhắc nhở vào MapiTask

Tương tự như Microsoft Outlook, Aspose.Email có thể thêm thông tin nhắc nhở vào một MapiTask. Đoạn mã sau đây cho bạn thấy cách thêm thông tin nhắc nhở vào một MapiTask.

Thêm Tệp đính kèm vào MapiTask

Đoạn mã sau đây cho bạn thấy cách thêm tệp đính kèm vào một MapiTask.

Chuyển đổi Nhiệm vụ Outlook sang MHT

Aspose.Email có thể tạo MapiMessage giống như đầu ra trong quá trình chuyển đổi một MapiTask đến MHT.

Java: Làm việc với Ghi chú Outlook

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

Tạo, Lưu và Đọc Ghi chú Outlook

Aspose.Email cung cấp khả năng tạo ghi chú Outlook và lưu vào đĩa ở định dạng MSG. MapiNote lớp cung cấp các thuộc tính và phương thức để đặt thông tin mong muốn cho một ghi chú. Bài viết này chỉ ra cách tạo, lưu và đọc một MapiNote từ đĩa.

Tạo và Lưu Ghi chú Outlook

Các bước sau có thể được sử dụng để tạo và lưu một ghi chú vào đĩa.

Khởi tạo một đối tượng của MapiNote lớp.
Đặt các thuộc tính khác nhau theo mong muốn.
Lưu ghi chú vào đĩa dưới dạng tệp MSG.

Đọc một MapiNote

Cái MapiNote đối tượng lớp được sử dụng để ép kiểu MapiMessage đối tượng tải một ghi chú từ đĩa ở định dạng MSG.

Java: Quản Lý Các Tin Nhắn Được Ký Số

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

Aspose.Email triển khai thuật toán đối tượng email S/MIME đầy đủ. Điều này cho API khả năng toàn diện để thêm chữ ký số vào email, giữ chúng khi chuyển đổi giữa các định dạng, xóa chúng, v.v.

Đính Kèm Chữ Ký vào Email

Cái SecureEmailManager.attachSignature phương thức cho phép bạn đính kèm chữ ký số vào email. Sau khi đính kèm chữ ký, xác thực kết quả qua các thuộc tính như IsSigned, MessageClass, và chi tiết đính kèm.

Bạn có thể cung cấp MailMessage hoặc MapiMessage, một chứng chỉ riêng, và các tùy chọn chữ ký để tùy chỉnh quá trình đính kèm chữ ký với SignatureOptions lớp cho phép người dùng chỉ định các tùy chọn khác nhau cho việc đính kèm chữ ký, bao gồm chữ ký rời hoặc không rời.

Mẫu mã dưới đây sẽ cho bạn thấy cách tải tin từ tệp, đính kèm chữ ký số rời và không rời bằng chứng chỉ riêng, và sau đó kiểm tra xem các chữ ký đã được đính kèm thành công hay chưa.

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.");
}

Giữ Chữ Ký khi Chuyển Đổi từ EML sang MSG

Aspose.Email giữ lại chữ ký số khi chuyển đổi từ EML sang MSG. Đoạn mã dưới đây cho bạn thấy cách chuyển đổi từ EML sang 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());

Xóa Chữ Ký khỏi Tệp Tin Nhắn Outlook

Nếu bạn cần loại bỏ chữ ký khỏi một tin trong định dạng MAPI, ví dụ vì mục đích tương thích, Aspose.Email cung cấp MapiMessage.removeSignature phương thức và MapiMessage.isSigned thuộc tính.

Đoạn mã dưới đây cho thấy cách tải tin MAPI từ tệp, kiểm tra xem nó có được ký số hay không, và nếu có, tạo một tin mới không có chữ ký số:

MapiMessage msg = MapiMessage.load(fileName);

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

Chuyển Đổi Tin Nhắn S/MIME từ MSG sang EML

Aspose.Email giữ lại chữ ký số khi chuyển đổi từ MSG sang EML như trong đoạn mã dưới đây.

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

Giải Mã Tệp MSG bằng Chứng Chỉ

Nếu bạn có các tin nhắn MAPI được mã hoá và cần giải mã chúng bằng khóa riêng lưu trong chứng chỉ, các tính năng sau của Aspose.Email có thể hữu ích:

MapiMessage.isEncrypted - Lấy giá trị cho biết liệu tin nhắn có được mã hóa hay không.
MapiMessage.decrypt() - Giải mã tin nhắn này (phương thức tìm kiếm trong các kho lưu My của người dùng hiện tại và máy tính để tìm chứng chỉ và khóa riêng thích hợp).
MapiMessage.decrypt(X509Certificate2 certificate) - Giải mã tin nhắn này bằng chứng chỉ.

Đoạn mã dưới đây cho thấy cách làm việc với các tin nhắn MAPI được mã hoá:

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: Làm việc với các mục Lịch Outlook

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

Làm việc với MapiCalendar

Aspose.Email MapiCalendar lớp cung cấp các phương thức và thuộc tính để đặt các thuộc tính khác nhau của một mục lịch. Bài viết này cung cấp các mẫu mã cho:

Tạo và Lưu các mục Lịch

Đoạn mã mẫu dưới đây cho bạn thấy cách tạo và lưu một mục lịch ở định dạng 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);

Lưu mục Lịch dưới dạng MSG

Đoạn mã mẫu dưới đây cho bạn thấy cách lưu mục lịch dưới dạng 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);

Đặt ID sản phẩm khi lưu mục Lịch sang ICS

Cái ProductIdentifier thuộc tính của MapiCalendarIcsSaveOptions lớp được sử dụng để lưu một mục lịch MAPI vào tệp iCalendar (ICS) giữ lại thông tin ngày và giờ gốc cũng như một định danh sản phẩm tùy chỉnh. Thuộc tính này chỉ định định danh cho sản phẩm đã tạo đối tượng iCalendar.

Mẫu mã dưới đây cho thấy cách làm việc với dữ liệu iCalendar (ICS) trong một đối tượng lịch MAPI:

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

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

Thêm lời nhắc hiển thị vào lịch

Đoạn mã mẫu dưới đây cho bạn thấy cách thêm lời nhắc hiển thị vào lịch.

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

Thêm lời nhắc âm thanh vào lịch

Đoạn mã mẫu dưới đây cho bạn thấy cách thêm lời nhắc âm thanh vào lịch.

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

Thêm/Lấy tệp đính kèm từ các tệp lịch

Đoạn mã mẫu dưới đây cho bạn thấy cách thêm/lấy các tệp đính kèm từ các tệp lịch.

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

Trạng thái người nhận từ yêu cầu họp

Đoạn mã mẫu dưới đây cho bạn thấy cách lấy trạng thái của người nhận từ yêu cầu họp.

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

Đặt trạng thái cuộc hẹn Lịch một cách rõ ràng

Aspose.Email cho phép bạn đặt trạng thái của một MapiCalendar đối tượng một cách rõ ràng, ghi đè hành vi mặc định. The setStateForced phương pháp cung cấp kiểm soát tốt hơn đối với trạng thái sự kiện lịch, đặc biệt khi xử lý các yêu cầu họp đã nhận. Mặc định, khi một cuộc họp được tạo, trạng thái của nó là MapiCalendarState.Meeting. Khi được nhận trong hộp thư đến của người nhận, nó tự động chuyển thành MapiCalendarState.Received, và lớp tin nhắn của nó được cập nhật thành IPM.Schedule.Meeting.Request. Sử dụng SetStateForced cho phép đặt thủ công trạng thái thành Received, điều này có thể hữu ích để giữ thông tin người tổ chức khi lưu lịch dưới dạng tệp MSG. Tuy nhiên, điều này có thể ngăn việc chuyển tiếp hoặc gửi lại cuộc họp một cách đúng đắn.

Mẫu mã sau sẽ giúp bạn triển khai tính năng này:

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

Tạo MapiCalendarTimeZone từ Múi giờ chuẩn

Đoạn mã mẫu dưới đây cho bạn thấy cách tạo MapiCalendarTimeZone từ Múi giờ chuẩn.

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

Đặt lời nhắc với Cuộc hẹn đã tạo

Một lời nhắc có thể được thêm vào khi tạo một cuộc hẹn. Các báo động này có thể kích hoạt dựa trên các tiêu chí khác nhau như n phút trước khi lịch bắt đầu, lặp lại n lần với khoảng thời gian n. Các thẻ khác nhau có thể được sử dụng để tạo các trình kích hoạt này trong đoạn script được bao quanh bởi BEGIN:VALARM và END:VALARM trong một cuộc hẹn. Có nhiều biến thể để đặt lời nhắc cho một cuộc hẹn.

Đặt lời nhắc bằng cách thêm thẻ

Đoạn mã mẫu dưới đây cho bạn thấy cách đặt lời nhắc bằng cách thêm thẻ.

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

Chuyển đổi Appointment EML sang MSG với thân HTML

Kể từ phiên bản 19.3, Aspose.Email cung cấp khả năng chuyển đổi Appointment EML sang MSG đồng thời giữ lại phần thân HTML của cuộc hẹn. Aspose.Email cung cấp một MapiConversionOptions.ForcedRtfBodyForAppointment thuộc tính có giá trị mặc định là true. Khi giá trị của MapiConversionOptions.ForcedRtfBodyForAppointment được đặt thành true, nội dung cuộc hẹn sẽ được chuyển sang định dạng RTF. Để giữ định dạng nội dung cuộc hẹn ở dạng HTML, đặt giá trị của MapiConversionOptions.ForcedRtfBodyForAppointment thành false.

Ví dụ sau đây minh họa việc sử dụng MapiConversionOptions.ForcedRtfBodyForAppointment thuộc tính để giữ định dạng nội dung cuộc hẹn ở dạng 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: Làm việc với Danh sách Phân phối

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

Có thể tạo một danh sách Phân phối bằng Aspose.Email API, đây là một tập hợp của nhiều liên hệ. Danh sách phân phối có thể được lưu vào đĩa ở định dạng Outlook MSG và có thể được xem/điều chỉnh bằng cách mở nó trong MS Outlook.

Tạo và Lưu Danh sách Phân phối

Đoạn mã sau đây cho bạn thấy cách tạo và lưu một danh sách phân phối.

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

Lưu Mapi Distribution List vào một Tệp VCF Đa Liên hệ Đơn

Cái void save(String fileName, MapiDistributionListSaveOptions options) phương thức cho phép bạn lưu Mapi Distribution List vào một tên tệp đã chỉ định bằng cách sử dụng các tùy chọn lưu được cung cấp. Bạn có thể cung cấp tên tệp và một thể hiện của MapiDistributionListSaveOptions lớp như các tham số. The MapiDistributionListSaveOptions lớp chứa các tùy chọn để lưu Mapi Distribution List. Trong trường hợp này, bạn có thể chỉ định định dạng lưu là VCard (ContactSaveFormat.VCard) để lưu danh sách phân phối dưới dạng tệp VCF đa liên hệ.

Đoạn mã sau đây minh họa cách lưu một danh sách phân phối vào tệp VCF đa liên hệ:

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

Đọc Danh sách Phân phối từ PST

Đoạn mã sau đây cho bạn thấy cách đọc một danh sách phân phối từ tệp 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: Làm việc với Các Định kỳ

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

Làm việc với Định kỳ Hàng ngày

Aspose.Email hỗ trợ tạo định kỳ hàng ngày bằng cách sử dụng MapiCalendarDailyRecurrencePattern. Ba loại kết thúc định kỳ lịch Mapi khác nhau có thể được sử dụng bao gồm EndAfterNOccurrences, EndAfterDate và NeverEnd. Phần này trình bày cách tạo các mẫu định kỳ hàng ngày khác nhau.

Định kỳ Hàng ngày: Loại EndAfterNOccurrence

Trong loại định kỳ này, số lần lặp lại cần được đặt cùng với các thông tin khác như sau:

Đặt ngày bắt đầu, kết thúc và ngày đến hạn.
Tạo một MapiTask.
Đặt trạng thái nhiệm vụ thành NotAssigned.
Tạo đối tượng định kỳ hàng ngày bằng cách đặt các thuộc tính như PatternType, Period, WeekStartDay, EndType và OccurenceCount.
Đặt thuộc tính MapiTask.setRecurrence thành đối tượng định kỳ hàng ngày này.
Lưu tin nhắn này vào đĩa.

Đoạn mã sau đây cho bạn thấy cách tạo một nhiệm vụ với loại kết thúc định kỳ là 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);

Hàm sau có thể được sử dụng để tính số sự kiện giữa hai ngày:

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

Đặt Giá trị Số Lần Xuất Hiện

Đoạn mã sau đây cho bạn thấy cách đặt giá trị số lần xuất hiện.

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

Định kỳ Hàng ngày: Loại EndAfterDate

Định kỳ Hàng ngày: Đặt Giá trị Every Day

Đoạn mã sau đây cho bạn thấy cách đặt giá trị period là 1 và giá trị INTERVAL là 1 trong chuỗi 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);

Giá trị Every Day có thể được đặt thành bất kỳ giá trị thích hợp nào như trong ví dụ sau:

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

Định kỳ Hàng ngày: Loại NeverEnd

Loại kết thúc có thể được đặt bằng cách sử dụng MapiCalendarRecurrenceEndType.NeverEnd. Period hoặc INTERVAL có thể được đặt thành giá trị yêu cầu, ví dụ 1 trong ví dụ sau.

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

Làm việc với Định kỳ Hàng tuần

Aspose.Email cung cấp các tính năng phong phú để tạo định kỳ hàng tuần bằng cách sử dụng MapiCalendarWeeklyRecurrencePattern. Ba loại kết thúc định kỳ lịch Mapi khác nhau có thể được sử dụng bao gồm EndAfterNOccurrences, EndAfterDate và NeverEnd. Phần này trình bày cách tạo các mẫu định kỳ hàng tuần khác nhau.

Định kỳ Hàng tuần: Loại EndAfterNOccurrences

Trong loại định kỳ này, số lần lặp lại cần được đặt cùng với các thông tin khác như sau:

Đặt ngày bắt đầu, kết thúc và ngày đến hạn.
Tạo một MapiTask.
Đặt trạng thái nhiệm vụ thành NotAssigned.
Tạo đối tượng định kỳ hàng tuần bằng cách đặt các thuộc tính như PatternType, Period, WeekStartDay, EndType và OccurenceCount.
Đặt thuộc tính MapiTask.setRecurrence thành đối tượng định kỳ hàng tuần này.
Lưu tin nhắn này vào đĩa.

Đoạn mã sau đây cho bạn thấy cách tạo một nhiệm vụ với loại kết thúc định kỳ là 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);

Hàm sau có thể được sử dụng để tính số sự kiện giữa hai ngày:

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

Chọn Nhiều Ngày trong Một Tuần

Đoạn mã sau đây cho bạn thấy cách chọn nhiều ngày trong một tuần.

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

Chọn Nhiều Ngày trong Một Tuần và Đặt Khoảng Thời gian

Đoạn mã sau đây cho bạn thấy cách chọn nhiều ngày trong một tuần và đặt khoảng thời gian.

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

Định kỳ Hàng tuần: Loại EndAfterDate

Định kỳ Hàng tuần: Đặt Giá trị Every Day

Đoạn mã sau đây cho bạn thấy cách đặt giá trị period là 1 và giá trị INTERVAL là 1 trong chuỗi 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"));

Giá trị Every Day có thể được đặt thành bất kỳ giá trị thích hợp nào và có thể chọn nhiều ngày như trong ví dụ sau:

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

Định kỳ Hàng tuần: Loại 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"));

Làm việc với Định kỳ Hàng tháng

Aspose.Email hỗ trợ tạo định kỳ hàng tháng bằng cách sử dụng MapiCalendarMonthlyRecurrencePattern. Ba loại kết thúc định kỳ lịch Mapi khác nhau có thể được sử dụng bao gồm EndAfterNOccurrences, EndAfterDate và NeverEnd. Phần này trình bày cách tạo các mẫu định kỳ hàng tháng khác nhau.

Định kỳ Hàng tháng: Loại EndAfterNOccurrences

Trong loại định kỳ này, số lần lặp lại cần được đặt cùng với các thông tin khác như sau:

Đặt ngày bắt đầu, kết thúc và ngày đến hạn.
Tạo một MapiTask.
Đặt trạng thái nhiệm vụ thành NotAssigned.
Tạo đối tượng định kỳ hàng tháng bằng cách đặt các thuộc tính như PatternType, Period, WeekStartDay, EndType và OccurenceCount.
Đặt thuộc tính MapiTask.setRecurrence thành đối tượng định kỳ hàng tháng này.
Lưu tin nhắn này vào đĩa.

Đoạn mã sau đây cho bạn thấy cách tạo một nhiệm vụ với loại kết thúc định kỳ là 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);

Hàm sau có thể được sử dụng để tính số sự kiện giữa hai ngày:

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

Đặt Số Lần Xảy Ra Cố Định

Đoạn mã sau đây cho bạn thấy cách đặt một số lượng cố định các lần xuất hiện.

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

Định kỳ Hàng tháng: Loại EndAfterDate

"End By" tuỳ chọn trong Mapi Task được thực hiện bằng cách đặt thuộc tính OccurrenceCount được tính bởi hàm getOccurrenceCount(). Hàm này nhận ngày bắt đầu, ngày kết thúc và chuỗi RRULE. Đoạn mã sau đây cho bạn thấy cách tạo một định kỳ vào ngày 15 của mỗi tháng giữa ngày bắt đầu và kết thúc.

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

Định kỳ Hàng tháng: Loại NeverEnd

Đoạn mã sau đây cho bạn thấy cách đặt loại kết thúc bằng cách sử dụng 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);

Làm việc với Định kỳ Hàng năm

Aspose.Email hỗ trợ tạo định kỳ hàng năm bằng cách sử dụng MapiCalendarMonthlyRecurrencePattern. Bằng cách đặt thuộc tính period là 12, chúng ta có thể đạt được mẫu định kỳ hàng năm. Ba loại kết thúc định kỳ lịch Mapi khác nhau có thể được sử dụng bao gồm EndAfterNOccurrences, EndAfterDate và NeverEnd. Phần này trình bày cách tạo các mẫu định kỳ hàng năm khác nhau.

Định kỳ Hàng năm: Loại EndAfterNOccurrences

Trong loại định kỳ này, số lần lặp lại cần được đặt cùng với các thông tin khác như sau:

Đặt ngày bắt đầu, kết thúc và ngày đến hạn.
Tạo một MapiTask.
Đặt trạng thái nhiệm vụ thành NotAssigned.
Tạo đối tượng định kỳ hàng tháng bằng cách đặt các thuộc tính như PatternType, Period, WeekStartDay, EndType và OccurenceCount.
Đặt thuộc tính MapiTask.setRecurrence thành đối tượng định kỳ hàng tháng này để đạt được định kỳ hàng năm.
Lưu tin nhắn này vào đĩa.

Đoạn mã sau đây cho bạn thấy cách tạo một nhiệm vụ với loại kết thúc định kỳ là 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);

Định kỳ Hàng năm: Loại EndAfterDate

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

Định kỳ Hàng năm: Loại NeverEnd

Đoạn mã sau đây cho bạn thấy cách đặt loại kết thúc bằng cách sử dụng MapiCalendarRecurrenceEndType.NeverEnd.

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

Tạo Định kỳ từ Quy tắc Định kỳ

API Aspose.Email cung cấp khả năng tạo Mẫu Định kỳ từ Quy tắc Định kỳ (RRULE). Nó phân tích thông tin từ RRULE theo chuẩn RFC 5545 iCal và tạo mẫu định kỳ bằng phương thức MapiCalendarRecurrencePatternFactory.fromString. Đoạn mã sau đây cho bạn thấy cách tạo mẫu định kỳ từ quy tắc định kỳ.

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

Thêm Tệp đính kèm vào Các Sự kiện Lịch Định kỳ

API Aspose.Email cung cấp khả năng thêm tệp đính kèm vào các sự kiện lịch định kỳ.

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

Đặt Múi giờ Sự kiện Lịch

API Aspose.Email cung cấp khả năng đặt múi giờ lịch:

thông tin múi giờ cho ngày bắt đầu/kết thúc
thông tin múi giờ cho một cuộc họp định kỳ
thông tin múi giờ mô tả cách chuyển đổi ngày và giờ họp trong một chuỗi định kỳ tới và từ UTC

Đoạn mã sau đây cho bạn thấy cách đặt thông tin múi giờ lịch:

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