Documentation – ทำงานกับรายการ Outlook

Java: การสร้างและบันทึกไฟล์ MSG

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

Aspose.Email รองรับการสร้างไฟล์ Outlook message (MSG) บทความนี้อธิบายวิธีทำ:

สร้างข้อความ MSG.
สร้างข้อความ MSG พร้อมไฟล์แนบ.
สร้างข้อความ MSG พร้อมเนื้อหา RTF.
บันทึกข้อความเป็นแบบร่าง.
ทำงานกับการบีบอัดเนื้อหา.

การสร้างและบันทึก Outlook Messages

นี้ MailMessage คลาสมี บันทึก เมธอดที่สามารถบันทึกไฟล์ Outlook MSG ลงดิสก์หรือสตรีม โค้ดสแนปเปิลด้านล่างสร้างอินสแตนซ์ของ MailMessage คลาส, ตั้งค่าคุณสมบัติเช่น from, to, subject และ body. The บันทึก เมธอดรับชื่อไฟล์เป็นอากิวเมนต์ นอกจากนี้ Outlook Messages สามารถสร้างด้วย เนื้อหา RTF ที่บีบอัด โดยใช้ MapiConversionOptions.

สร้างอินสแตนซ์ใหม่ของ MailMessage คลาสและตั้งค่าคุณสมบัติ From, To, Subject และ Body.
เรียกใช้ MapiMessage คลาส fromMailMessage เมธอดที่รับอ็อบเจกต์ของ MailMessage ประเภท. The fromMailMessage เมธอดแปลง MailMessage เป็น a MapiMessage (MSG).
เรียกใช้ MapiMessage.save เมธอดเพื่อบันทึกไฟล์ MSG.

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

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

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

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

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

สร้างไฟล์ MSG พร้อมไฟล์แนบ

ในตัวอย่างข้างต้น, เราได้สร้างไฟล์ MSG อย่างง่าย Aspose.Email ยังรองรับการบันทึกไฟล์ข้อความที่มีไฟล์แนบ สิ่งที่คุณต้องทำคือเพิ่มไฟล์แนบลงใน MailMessage อินสแตนซ์. เพิ่มไฟล์แนบโดยเรียกเมธอด addItem บน MailMessage.Attachments คอลเลกชัน.

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

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

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

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

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

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

สร้างไฟล์ MSG พร้อมเนื้อหา RTF

คุณยังสามารถสร้างไฟล์ Outlook Message (MSG) พร้อมเนื้อหา rich text (RTF) ด้วย Aspose.Email เนื้อหา RTF รองรับการจัดรูปแบบข้อความ สร้างโดยตั้งค่า MailMessage.HtmlBody คุณสมบัติ. เมื่อคุณแปลง a MailMessage อินสแตนซ์เป็น a MapiMessage ในกรณีนี้, ส่วน HTML จะถูกแปลงเป็น RTF วิธีนี้ทำให้การจัดรูปแบบของเนื้อหาอีเมลคงเดิม.

ตัวอย่างต่อไปนี้สร้างไฟล์ MSG พร้อมเนื้อหา RTF มีหัวข้อหนึ่งรายการพร้อมการจัดรูปแบบตัวหนาและขีดเส้นใต้ในส่วน HTML การจัดรูปแบบนี้จะคงไว้เมื่อ HTML ถูกแปลงเป็น RTF.

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

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

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

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

บันทึกข้อความในสถานะแบบร่าง

อีเมลจะถูกบันทึกเป็นแบบร่างเมื่อมีการเริ่มแก้ไขแต่ต้องการกลับมาทำต่อในภายหลัง Aspose.Email รองรับการบันทึกข้อความอีเมลในสถานะแบบร่างโดยการตั้งค่าสถานะแฟล็กของข้อความ ด้านล่างเป็นตัวอย่างโค้ดเพื่อบันทึกข้อความอีเมล Outlook (MSG) เป็นแบบร่าง.

โปรดทราบว่าในสถานะแบบร่าง Outlook จะไม่แสดงข้อมูลผู้ส่งใดๆ ที่กำหนดให้กับ MapiMessage หากต้องการแสดงข้อมูลผู้ส่งควรตั้งค่าแฟล็ก MSGFLAG_READ.

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

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

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

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

ผลกระทบของการบีบอัดเนื้อหา

วิธีการบีบอัดเนื้อหา RTF สามารถใช้เพื่อสร้าง MSG ที่มีขนาดเล็กลง อย่างไรก็ตามจะทำให้ความเร็วในการสร้างช้าลง เพื่อสร้างข้อความที่มีความเร็วดีขึ้นให้ตั้งค่าแฟล็กเป็น false แฟล็กนี้จะมีผลต่อ PST ที่สร้าง: ไฟล์ MSG เล็กลงทำให้ PST เล็กลง และไฟล์ MSG ใหญ่ทำให้การสร้าง PST ช้าลง.

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

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

Java: การโหลด ดู และแยกไฟล์ MSG

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

หัวข้อนี้อธิบายวิธีโหลดไฟล์ข้อความ Microsoft Outlook (*.msg) โดย MapiMessage คลาสนี้ใช้ในการโหลดไฟล์ MSG และให้ฟังก์ชันการโหลดแบบสแตติกหลายแบบสำหรับสถานการณ์ต่าง ๆ โค้ดสแนปต่อไปนี้แสดงวิธีโหลดไฟล์ MSG จากไฟล์หรือจากสตรีม

การโหลดไฟล์ MSG

โค้ดสแนปต่อไปนี้แสดงวิธีโหลดไฟล์ MSG.

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

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

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

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

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

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

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

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีใช้ MailMessage เพื่อโหลดข้อความในรูปแบบ MSG.

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

ควรทราบว่าข้อความที่ได้จะถูกแปลงเป็นรูปแบบ EML รวมถึงไฟล์แนบข้อความที่ฝังอยู่ ไม่ควรใช้วิธีการโหลดนี้หากต้องการคงคุณสมบัติดรูปแบบ msg เฉพาะของข้อความต้นฉบับ

เพื่อคงรูปแบบดั้งเดิมของไฟล์แนบข้อความที่ฝังอยู่ ให้ใช้ MsgLoadOptions.PreserveEmbeddedMessageFormat คุณสมบัติ.

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

การโหลดจากสตรีม

โค้ดสแนปต่อไปนี้แสดงวิธีโหลดไฟล์จากสตรีม

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

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

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

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

}

แปลง EML เป็น MSG พร้อมคงรูปแบบ EML ที่ฝังอยู่

ไฟล์ EML สามารถโหลดเข้าไปใน MapiMessage คลาสโดยการสร้าง MailMessage อ็อบเจ็กต์และส่งผ่านไปยัง MapiMessage.fromMailMessage เมธอด หากไฟล์ EML มีไฟล์ EML ฝังอยู่ ให้ใช้ MapiConversionOptions.setPreserveEmbeddedMessageFormat เพื่อรักษารูปแบบของไฟล์ EML ที่ฝังอยู่ โค้ดสแนปด้านล่างแสดงวิธีโหลดไฟล์ EML เข้าไปใน MapiMessage พร้อมคงรูปแบบของไฟล์ EML ที่ฝังอยู่

ลองใช้ดู!

แปลงอีเมลและคลังข้อความออนไลน์ด้วยเวอร์ชันฟรี แอปแปลง Aspose.Email.

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

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

MapiConversionOptions options = MapiConversionOptions.getUnicodeFormat();

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

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

Java: การจัดการไฟล์ข้อความด้วย Aspose.Email.Outlook

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

การแปลง MSG เป็นข้อความ MIME

Aspose.Email API มีความสามารถในการแปลงไฟล์ MSG เป็นข้อความ MIME โดยใช้ toMailMessage เมธอด.

// For complete examples and data files, please go to https://github.com/aspose-email/Aspose.Email-for-Java
MapiMessage msg = new MapiMessage(
                            "sender@test.com",
                            "recipient1@test.com; recipient2@test.com",
                            "Test Subject",
                            "This is a body of message.");
MailConversionOptions options = new MailConversionOptions();
options.setConvertAsTnef(true);
MailMessage mail = msg.toMailMessage(options);

การแปลง MSG เป็น EML โดยคงเนื้อหา RTF

API มีเมธอดต่อไปนี้เพื่อคงเนื้อหา RTF ขณะแปลง MSG เป็น EML:

MsgLoadOptions.PreserveRtfContent - รับหรือกำหนดค่าที่บ่งบอกว่าจะคงเนื้อหา rtf ใน MailMessage หรือไม่.
MailConversionOptions.PreserveRtfContent - รับหรือกำหนดค่าที่บ่งบอกว่าจะคงเนื้อหา rtf ใน MailMessage หรือไม่.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีคงเนื้อหา rtf ใน MailMessage:

โดยใช้ MsgLoadOptions.PreserveRtfContent

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

โดยใช้ MailConversionOptions.PreserveRtfContent

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

การแปลง MSG เป็น MHTML โดยคงส่วนหัวประเภท

Aspose.Email API มีความสามารถในการเพิ่มส่วนหัวประเภทขณะแปลงข้อความเป็น MHTML ฟีเจอร์นี้กำหนดโดย MhtSaveOptions คลาสเป็นตัวเลือกเพิ่มเติมเมื่อบันทึก MailMessage เป็นรูปแบบ Mhtml.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างไฟล์ MHT (MHTML) จากวัตถุ MapiMessage ปรับแต่งรูปแบบและส่วนหัวของไฟล์ MHT ด้วย MhtSaveOptions ตั้งค่าประเภทสำหรับข้อความอีเมล แล้วแก้ไขแม่แบบรูปแบบและส่วนหัวการเรนเดอร์สำหรับไฟล์ MHT ก่อนบันทึก

 MapiMessage msg = new MapiMessage("from@aaa.com", "to@aaa.com", "subj", "body");

msg.setCategories(new String[] { "Urgently", "Important" });

MhtSaveOptions saveOptions = new MhtSaveOptions();

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

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

saveOptions.getRenderingHeaders().add(MhtTemplateName.CATEGORIES);

msg.save("fileName.mhtml", saveOptions);

การอ่านและเขียนไฟล์แม่แบบ Outlook (.OFT)

แม่แบบ Outlook มีประโยชน์มากเมื่อคุณต้องการส่งข้อความอีเมลที่คล้ายกันซ้ำๆ แทนการเตรียมข้อความตั้งแต่เริ่มต้นทุกครั้ง ให้เตรียมข้อความใน Outlook ก่อนแล้วบันทึกเป็นแม่แบบ Outlook (OFT) จากนั้นเมื่อใดก็ตามที่คุณต้องการส่งข้อความ คุณสามารถสร้างจากแม่แบบนั้นได้ ช่วยประหยัดเวลาในการพิมพ์ข้อความเดียวกันในเนื้อหาหรือหัวเรื่อง ตั้งค่าการจัดรูปแบบ เป็นต้น Aspose.Email MailMessage คลาสสามารถใช้เพื่อโหลดและอ่านไฟล์แม่แบบ Outlook (OFT) เมื่อโหลดแม่แบบ Outlook แล้วในอินสแตนซ์ของ MailMessage คลาส คุณสามารถอัปเดตผู้ส่ง, ผู้รับ, เนื้อหา, หัวข้อและคุณสมบัติอื่นๆ หลังจากอัปเดตคุณสมบัติแล้ว:

ส่งอีเมลโดยใช้ SmtpClient คลาสหรือ
บันทึกข้อความเป็น MSG และทำการอัปเดต/ตรวจสอบเพิ่มเติมโดยใช้ Microsoft Outlook.

ในตัวอย่างโค้ดด้านล่าง เรา:

โหลดแม่แบบโดยใช้ MailMessage คลาส.
อัปเดตคุณสมบัติบางอย่าง.
บันทึกข้อความในรูปแบบ MSG.

ส่วนโค้ดต่อไปนี้จะแสดงวิธีโหลดไฟล์ OFT, อัปเดตข้อความและบันทึกเป็นรูปแบบ MSG

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

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

// Set the sender and recipients information
String senderDisplayName = "John";
String senderEmailAddress = "john@abc.com";
String recipientDisplayName = "William";
String recipientEmailAddress = "william@xzy.com";

message.setSender(new MailAddress(senderEmailAddress, senderDisplayName));
message.getTo().addMailAddress(new MailAddress(recipientEmailAddress, recipientDisplayName));
message.setHtmlBody(message.getHtmlBody().replace("DisplayName", "<b>" + recipientDisplayName + "</b>"));

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

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

การบันทึกไฟล์ Outlook MSG เป็นแม่แบบ

ส่วนโค้ดต่อไปนี้จะแสดงวิธีบันทึกไฟล์ Outlook MSG เป็นแม่แบบ

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

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

การตั้งค่าประเภทสีสำหรับไฟล์ Outlook MSG

ประเภทสีทำเครื่องหมายข้อความอีเมลเพื่อบ่งบอกความสำคัญหรือประเภทบางอย่าง Microsoft Outlook ให้ผู้ใช้กำหนดประเภทสีเพื่อแยกแยะอีเมล เพื่อจัดการประเภทสี ให้ใช้ FollowUpManager. มีฟังก์ชันเช่น addCategory, removeCategory, clearCategories และ getCategories.

addCategory รับค่า MapiMessage และสตริงประเภทสี เช่น "Purple Category" หรือ "Red Category" เป็นอาร์กิวเมนต์.
removeCategory รับค่า MapiMessage และสตริงประเภทสีที่ต้องการลบออกจากข้อความ
clearCategories ใช้เพื่อลบประเภทสีทั้งหมดจากข้อความ.
getCategories ใช้เพื่อดึงประเภทสีทั้งหมดจากข้อความที่ระบุ.

ตัวอย่างต่อไปนี้ทำงานตามขั้นตอนที่ระบุด้านล่าง:

เพิ่มประเภทสี.
เพิ่มประเภทสีอื่น.
ดึงรายการของทุกประเภท.
ลบทุกประเภทออกทั้งหมด.

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

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

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

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

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

การเข้าถึงข้อมูลติดตามจากไฟล์ MSG

Aspose.Email API ให้ความสามารถในการเข้าถึงข้อมูลติดตามจากข้อความที่ส่งหรือรับ สามารถดึงข้อมูลการอ่าน การรับการจัดส่งและผลการโหวตจากไฟล์ข้อความได้

การดึงข้อมูลการรับและการยืนยันการจัดส่ง

ส่วนโค้ดต่อไปนี้จะแสดงให้คุณเห็นวิธีการเรียกคืนข้อมูลการรับและการยืนยันการจัดส่ง

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

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

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

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

การสร้างข้อความต่อและตอบกลับ

Aspose.Email API ให้ความสามารถในการสร้างและจัดรูปแบบข้อความต่อและตอบกลับ The ReplyMessageBuilder และ ForwardMessageBuilder คลาสของ API ใช้สร้างข้อความ Reply และ Forward ตามลำดับ ข้อความ Reply หรือ Forward สามารถกำหนดให้สร้างโดยใช้โหมดใดก็ได้ของ OriginalMessageAdditionMode enum. enum นี้มีค่าต่อไปนี้:

OriginalMessageAdditionMode.None - ข้อความต้นฉบับจะไม่ถูกรวมในข้อความตอบกลับ.
OriginalMessageAdditionMode.Attachment - ข้อความต้นฉบับจะรวมเป็นไฟล์แนบในข้อความตอบกลับ
OriginalMessageAdditionMode.Textpart - ข้อความต้นฉบับจะรวมเป็นข้อความในส่วนเนื้อหาของข้อความตอบกลับ

การสร้างข้อความตอบกลับ

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างข้อความตอบกลับ (reply).

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

การสร้างข้อความต่อ

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีสร้างข้อความต่อ (forward).

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

MapiMessage originalMsg = MapiMessage.fromFile(dataDir + "message1.msg");
ForwardMessageBuilder builder = new ForwardMessageBuilder();
builder.setAdditionMode(OriginalMessageAdditionMode.Textpart);
MapiMessage forwardMsg = builder.buildResponse(originalMsg);
forwardMsg.save(dataDir + "forward_out.msg");

รักษาวันที่ว่างเมื่อแปลงข้อความ

MapiConversionOptions.setPreserveEmptyDates(boolean) คุณสมบัติบ่งบอกว่าจำเป็นต้องรักษาวันที่ว่างเปล่าขณะแปลงข้อความหรือไม่ API นี้ปรากฏใน Aspose.Email 21.5 ตัวอย่างโค้ดต่อไปนี้แสดงวิธีรักษาวันที่ว่าง.

MailMessage mailMessage = MailMessage.load("message.eml");
System.out.println(mailMessage.getDate()); // zero date
MapiConversionOptions mco = MapiConversionOptions.getUnicodeFormat();
// keep empty dates when converting a message
mco.setPreserveEmptyDates(true);
MapiMessage mapiMessage = MapiMessage.fromMailMessage(mailMessage, mco);
System.out.println(mapiMessage.getClientSubmitTime()); // zero date
// check zero date
if (mapiMessage.getClientSubmitTime().equals(JavaHelper.ZERO_DATE))
    System.out.println("ZERO DATE");

Java: การทำงานกับตัวเลือกโหวตโดยใช้ MapiMessage

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

สร้างตัวเลือกโหวตโดยใช้ MapiMessage

Microsoft Outlook ให้ผู้ใช้สร้างโพลขณะเขียนข้อความใหม่ สามารถใส่ตัวเลือกโหวตเช่น ใช่, ไม่ใช่, อาจจะ เป็นต้น Aspose.Email รองรับเช่นเดียวกันเมื่อตั้งค่าข้อความ Outlook ใหม่ โดย FollowUpOptions class ให้ VotingButtons คุณสมบัติที่ใช้ตั้งค่า หรือดึงค่าตัวเลือกโหวต บทความนี้ให้ตัวอย่างโดยละเอียดของการสร้าง MapiMessage พร้อมตัวเลือกโหวตสำหรับสร้างโพล

สร้างโพลโดยใช้ MapiMessage

โค้ดสแนปต่อไปนี้แสดงวิธีสร้างโพล FollowUpManager คลาสนี้สามารถใช้ได้ตามที่แสดงในโค้ดสแนปต่อไปนี้

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

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

อ่านตัวเลือกโหวตจาก MapiMessage

โค้ดสแนปต่อไปนี้แสดงวิธีอ่านตัวเลือกโหวตจาก MapiMessage.

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

MapiMessage message = MapiMessage.fromFile(fileName);

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

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

อ่านเฉพาะปุ่มโหวต

โค้ดสแนปต่อไปนี้แสดงวิธีอ่านเฉพาะปุ่มโหวต

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

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

เพิ่มปุ่มโหวตลงในข้อความที่มีอยู่

โค้ดสแนปต่อไปนี้แสดงวิธีเพิ่มปุ่มโหวตลงในข้อความที่มีอยู่

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

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

ลบปุ่มโหวตจากข้อความ

โค้ดสแนปต่อไปนี้แสดงวิธีลบปุ่มโหวตออกจากข้อความ

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

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

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

อ่านข้อมูลผลลัพธ์การโหวต

โค้ดสแนปต่อไปนี้แสดงวิธีอ่านข้อมูลผลลัพธ์การโหวต

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

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

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

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

    System.out.println();
}

เมธอดตัวอย่างที่ใช้ในตัวอย่าง

โค้ดสแนปต่อไปนี้แสดงวิธีสร้างข้อความตัวอย่างที่ใช้ในตัวอย่าง

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

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

Java: การแยกไฟล์ข้อความ Outlook

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

โดยใช้ Aspose.Email สำหรับ Java นักพัฒนาสามารถโหลดและแยกเนื้อหาจากไฟล์ข้อความ Outlook ได้.

ในการโหลดไฟล์ MSG จากดิสก์ ให้ใช้ MapiMessage คลาสแบบ static Load เมธอด.
เพื่อแยกเนื้อหาไฟล์ MSG, MapiMessage เปิดเผยเมธอดหลายรายการ.

หัวข้อนี้แสดงวิธีโหลดและแยกไฟล์ MSG เพื่อแสดงเนื้อหา.

Aspose.Email for Java มี MapiMessage คลาสที่ใช้เปิดและแยกไฟล์ MSG เนื่องจากอาจมีผู้รับหลายคนในไฟล์ MSG, MapiMessage คลาสเปิดเผย getRecipients() เมธอดที่คืนค่า MapiRecipientCollection ซึ่งเป็นคอลเลกชันของ MapiRecipient อ็อบเจกต์. MapiRecipient อ็อบเจกต์ยังเปิดเผยเมธอดสำหรับทำงานกับแอตทริบิวต์ของผู้รับ.

ลำดับขั้นตอนต่อไปนี้ใช้เพื่อบรรลุเป้าหมาย:

สร้างอินสแตนซ์ของ MapiMessage คลาสเพื่อโหลดไฟล์ MSG จาก Load เมธอดสเตติก.
แสดงชื่อผู้ส่ง, หัวข้อ, และเนื้อหาจากไฟล์ MSG โดยใช้ getSenderName(), getSubject() และ getBody() เมธอด.
เรียกใช้ getRecipients() เมธอดที่เปิดเผยโดย MapiRecipient คลาสเพื่ออ้างอิงคอลเลกชันของ MapiRecipient อ็อบเจกต์ที่เชื่อมโยงกับไฟล์ MSG.
วนลูปผ่าน MapiRecipientCollection คอลเลกชันเพื่อแสดงเนื้อหาสำหรับแต่ละ MapiRecipient อ็อบเจกต์ผ่านเมธอดสาธารณะของมัน.

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

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

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

ลองใช้ดู!

แยกไฟล์อีเมลออนไลน์ได้ฟรี Aspose.Email Parser App.

รับประเภทรายการของข้อความ MAPI

Aspose.Email ให้บริการ a MapiItemType enum ที่แสดงประเภทของรายการ สามารถใช้สำหรับการแปลงข้อความเป็นอ็อบเจ็กต์ของคลาสที่สืบทอดจาก IMapiMessageItem อินเทอร์เฟซ การทำเช่นนี้ช่วยหลีกเลี่ยงไม่ให้ผู้ใช้ต้องตรวจสอบค่าคุณสมบัติ MessageClass ก่อนการแปลงข้อความ.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีวนผ่านข้อความในโฟลเดอร์และแปลงแต่ละข้อความ MAPI ให้เป็นประเภทรายการ MAPI ที่สอดคล้องกัน ขึ้นอยู่กับประเภทของข้อความ:

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

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

Java: ทำงานกับ Follow Up และ Due Date สำหรับไฟล์ Outlook MSG

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

การตั้งค่าการติดตามและวันที่ครบกำหนดสำหรับไฟล์ Outlook MSG

ธงติดตามทำเครื่องหมายข้อความอีเมลสำหรับการกระทำบางอย่าง Microsoft Outlook ทำให้ผู้ใช้สามารถตั้งธงข้อความและกำหนดวันที่ครบกำหนดสำหรับการติดตามได้ Microsoft Outlook ส่งการเตือนถึงผู้รับเพื่อกระตุ้นให้พวกเขาติดตามอีเมล การตั้งธงอีเมลและกำหนดวันที่ครบกำหนดโดยอัตโนมัติช่วยให้นักพัฒนาซอฟต์แวร์ทำงานอัตโนมัติสำหรับอีเมลบางประเภทและช่วยให้ผู้รับจำได้ว่าจะต้องดำเนินการ ตัวอย่างเช่น สามารถใช้เพื่อส่งข้อความรายเดือนไปยังทีมขายเพื่อเตือนให้พวกเขาตรวจสอบรายงานของตน; หรือส่งข้อความถึงพนักงานทั้งหมดเพื่อเตือนเกี่ยวกับการประชุมบริษัท Aspose.Email for Java รองรับการตั้งธงติดตามและวันที่ครบกำหนดสำหรับ MapiMessage อ็อบเจกต์ที่ใช้ FollowUpManager และ FollowUpOptions. มีหลายรูปแบบที่สามารถตั้งธงติดตามบนข้อความได้ทั้งหมดนี้ถูกใช้ในตัวอย่างโค้ดด้านล่าง:

ตั้งธงติดตามสำหรับข้อความ
เพิ่มวันที่ครบกำหนดและวันที่เตือนสำหรับข้อความ
เพิ่มธงให้กับข้อความของผู้รับ.
ทำเครื่องหมายว่าเสร็จแล้ว.
ลบธง.
อ่านตัวเลือกของ follow up.

ตั้งค่าแฟล็ก FollowUp

โค้ดตัวอย่างต่อไปนี้แสดงวิธีตั้งค่าแฟล็ก follow-up.

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

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

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

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

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

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

ตั้งค่า Follow Up สำหรับผู้รับ

โค้ดตัวอย่างต่อไปนี้แสดงวิธีตั้งค่า follow-up สำหรับผู้รับ.

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

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

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

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

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

ทำเครื่องหมายแฟล็ก FollowUp ว่าเสร็จ

โค้ดตัวอย่างต่อไปนี้แสดงวิธีทำเครื่องหมายว่าแฟล็ก follow-up เสร็จแล้ว.

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

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

การลบแฟล็ก FollowUp

โค้ดตัวอย่างต่อไปนี้แสดงวิธีลบแฟล็ก follow-up.

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

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

อ่านตัวเลือกแฟล็ก follow-up สำหรับข้อความ

โค้ดตัวอย่างต่อไปนี้แสดงวิธีอ่านตัวเลือกของแฟล็ก follow-up สำหรับข้อความ.

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

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

Java: ทำงานกับคุณสมบัติ MAPI

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

การตั้งค่าและเข้าถึงคุณสมบัติ Outlook MAPI

Aspose.Email for Java มี MapiProperty คลาสที่แสดงถึงคุณสมบัติ MAPI:

Name: ชื่อของคุณสมบัติ.
Tag: แท็กของคุณสมบัติ.
Data: ข้อมูลของคุณสมบัติ.

หัวข้อนี้ยังอธิบายวิธีตั้งค่าและเข้าถึงคุณสมบัติ MAPI ของไฟล์ Outlook Message (MSG) ด้วย Aspose.Email for Java. นอกจากนี้ยังมีตัวอย่างโค้ดเกี่ยวกับวิธีลบคุณสมบัติจาก MSG และไฟล์แนบ.

อ่านคุณสมบัติ

เพื่ออ่านข้อมูลของคุณสมบัติ MAPI จากไฟล์ MSG:

สร้างอินสแตนซ์ของ MapiMessage คลาสเพื่อโหลดไฟล์ MSG ด้วย Load() เมธอดสเตติก.
ตั้งค่าอ้างอิงไปยัง MapiMessage อ็อบเจ็กต์ getProperties() เมธอดเพื่อดึง MapiPropertyCollection.
รับ MapiProperty อ็อบเจ็กต์จาก MapiPropertyCollection โดย แท็กคุณสมบัติ Mapi คีย์.
รับข้อมูลคุณสมบัติด้วยเมธอด getXXX() ที่เหมาะสม.

ตั้งค่าคุณสมบัติเพิ่มเติม

ตัวอย่างโค้ดต่อไปนี้สามารถใช้ตั้งค่าคุณสมบัติเพิ่มเติมของ Outlook MapiMessage.

ลบคุณสมบัติ

อ่านคุณสมบัติ Mapi ที่ตั้งชื่อจากข้อความอีเมล

Microsoft Outlook รองรับการเพิ่มคุณสมบัติ MAPI ที่ตั้งชื่อลงในไฟล์ MSG. คุณสมบัติเหล่านี้เพิ่มโดยผู้ใช้. นักพัฒนาสามารถเพิ่มคุณสมบัติที่ตั้งชื่อ เช่น “MyProp”, ลงในไฟล์ MSG ด้วย Aspose.Email.

บทความนี้แสดงให้เห็น Aspose.Email MapiMessage getNamedProperties() คอลเลกชั่นเพื่ออ่านคุณสมบัติ MAPI ที่ตั้งชื่อจากไฟล์ MSG.

อ่านคุณสมบัติ MAPI ที่ตั้งชื่อ

อ่านคุณสมบัติ Mapi ที่ตั้งชื่อจากไฟล์แนบ

Java: ทำงานกับไฟล์แนบของข้อความ

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

การแยกและบันทึกไฟล์แนบ

ไฟล์ข้อความ Outlook อาจมีไฟล์แนบหนึ่งหรือหลายไฟล์ Aspose.Email ช่วยให้ผู้พัฒนาวนลูปไฟล์แนบในไฟล์ MSG และบันทึกลงดิสก์ หัวข้อนี้อธิบายกระบวนการและวิธีฝังไฟล์แนบ.

Aspose.Email MapiMessage คลาสใช้ในการโหลดไฟล์ MSG จากดิสก์และเปิดเผย getAttachments() เมธอดที่อ้างอิงถึง MapiAttachment คอลเลกชันอ็อบเจกต์ที่เชื่อมโยงกับไฟล์ MSG. The MapiAttachment อ็อบเจกต์ยังเปิดเผยเมธอดเพิ่มเติมที่ดำเนินการกับไฟล์แนบ.

เพื่อบันทึกไฟล์แนบในไฟล์ MSG ลงดิสก์โดยใช้ชื่อและส่วนขยายเดิม:

สร้างอินสแตนซ์ของ MapiMessage คลาสเพื่อโหลดไฟล์ MSG ด้วย Load() เมธอดสเตติก.
เรียกใช้ MapiRecipient คลาส getAttachments() เมธอดเพื่อรับอ้างอิงถึงคอลเลกชันของ MapiAttachment อ็อบเจกต์ที่เชื่อมโยงกับไฟล์ MSG.
วนลูปผ่าน MapiAttachmentCollection เพื่อแสดงเนื้อหาเกี่ยวกับแต่ละ MapiAttachment อ็อบเจกต์ผ่านเมธอดสาธารณะของมัน.
เรียกใช้ MapiAttachment คลาส save() เมธอดเพื่อบันทึกไฟล์แนบลงดิสก์.

ฝังข้อความเป็นไฟล์แนบ

ข้อความ Microsoft Outlook สามารถมีข้อความ Microsoft Outlook อื่นเป็นไฟล์แนบได้ ไม่ว่าจะเป็นข้อความปกติตามที่อธิบายข้างต้น หรือข้อความฝัง. The MapiAttachmentCollection ให้สมาชิก overloaded ของเมธอด add สำหรับสร้าง Outlook messages พร้อมไฟล์แนบทั้งสองประเภท ไฟล์ Outlook MSG ที่ฝังใน MSG มี PR_ATTACH_METHOD ค่า 5.

การอ่านข้อความฝังจากไฟล์แนบ

การแทรกและแทนที่ไฟล์แนบ MSG

Aspose.Email API ให้ความสามารถในการแทรกไฟล์แนบที่ตำแหน่งเฉพาะในข้อความพาเรนท์ นอกจากนี้ยังให้ความสะดวกในการแทนที่เนื้อหาของไฟล์แนบด้วยไฟล์แนบจากข้อความอื่น.

แทรกไฟล์แนบ MSG ที่ตำแหน่งเฉพาะ

Aspose.Email API ให้ความสามารถในการแทรกไฟล์แนบ MSG ไปยัง MSG พาเรนท์โดยใช้ MapiAttachmentCollection.Insert() เมธอด.

แทนที่เนื้อหาไฟล์แนบ MSG ที่ฝัง

สามารถใช้เพื่อแทนที่เนื้อหาไฟล์แนบที่ฝังด้วยไฟล์ใหม่โดยใช้ แทนที่ เมธอด. อย่างไรก็ตามไม่สามารถใช้เพื่อแทรกไฟล์แนบที่มี PR_ATTACH_NUM = 4 (ตัวอย่าง) ในคอลเลกชันที่มี collection.Count = 2.

บันทึกไฟล์แนบจากข้อความที่เซ็นดิจิทัล

Aspose.Email API ให้ความสามารถในการรับหรือกำหนดค่าที่บ่งชี้ว่าข้อความที่เซ็นชัดจะถูกถอดรหัสหรือไม่.

เปลี่ยนชื่อไฟล์แนบใน MapiMessage

Aspose.Email ทำให้สามารถแก้ไข ชื่อที่แสดง ค่าคุณสมบัติใน ไฟล์แนบของ MapiMessage.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีอัปเดตชื่อแสดงของไฟล์แนบแรกและที่สองภายใน Mapi message ที่โหลดมา:

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

ตรวจสอบว่าไฟล์แนบเป็น Inline หรือปกติ

ความแตกต่างระหว่างไฟล์แนบแบบ inline และปกติคือวิธีการแสดงภายในอีเมล ไฟล์แนบแบบ inline ฝังอยู่ในเนื้อหาอีเมลและสามารถดูได้โดยไม่ต้องเปิดไฟล์แยกหรือดาวน์โหลด ส่วนไฟล์แนบปกติเป็นไฟล์แยกที่แนบกับอีเมลแต่ไม่แสดงโดยตรงในเนื้อหาและต้องดาวน์โหลดและเปิดภายนอก. The MapiAttachment.IsInline คุณสมบัติของ MapiAttachment คลาสรับค่าที่บ่งชี้ว่าไฟล์แนบเป็น inline หรือปกติ.

ตัวอย่างโค้ดต่อไปนี้โหลดข้อความอีเมลจากไฟล์และดึงข้อมูลเกี่ยวกับไฟล์แนบ โดยเฉพาะการพิมพ์ชื่อแสดงของแต่ละไฟล์แนบและว่ามันเป็น inline ภายในข้อความหรือไม่:

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

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

Java: ทำงานกับรายชื่อ Outlook

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

สร้างผู้ติดต่อ Outlook

Aspose.Email for Java รองรับการสร้างผู้ติดต่อ Outlook (VCards) โดยใช้ MapiContact คลาส. MapiContact มีหลายเมธอด ซึ่งบางส่วนจะแสดงด้านล่างนี้.

MapiContactElectronicAddressPropertySet มีชุดของ MapiContactElectronicAddress.
MapiContactEventPropertySet
MapiContactNamePropertySet
MapiContactPersonalInfoPropertySet
MapiContactPhysicalAddressPropertySet มีชุดของ MapiContactPhysicalAddress.
MapiContactProfessionalPropertySet
MapiContactTelephonePropertySet

โครงสร้างผู้ติดต่อใน Aspose.Email for Java

ด้านล่างเป็นลำดับชั้นที่นำไปใช้สำหรับผู้ติดต่อใน Aspose.Email for Java ชื่อคลาสที่เกี่ยวข้องจะระบุไว้ข้างแต่ละคุณสมบัติ มีลิงก์ไปยังเอกสารออนไลน์สำหรับอ้างอิงเพิ่มเติม.

รายชื่อ (MapiContact)
1. ที่อยู่อิเล็กทรอนิกส์ (MapiContactElectronicAddressPropertySet)
  1. Email1 (MapiContactElectronicAddress)
    1. ประเภทที่อยู่
    2. ชื่อที่แสดง
    3. ที่อยู่อีเมล
    4. หมายเลขแฟกซ์
  2. Email2
  3. Email3
  4. แฟกซ์บ้าน
  5. แฟกซ์หลัก
  6. แฟกซ์ธุรกิจ
2. เหตุการณ์ (MapiContactEventPropertySet) ดูด้านล่างเป็นตัวอย่างวิธีการตั้งค่าเหตุการณ์.
  1. วันเกิด
  2. วันครบรอบการแต่งงาน
3. ข้อมูลชื่อ (MapiContactNamePropertySet)
  1. ชื่อที่แสดง
  2. คำนำหน้าชื่อที่แสดง
  3. ไฟล์ภายใต้
  4. ไฟล์ภายใต้ ID
  5. รุ่น
  6. ชื่อจริง
  7. อักษรย่อ
  8. ชื่อกลาง
  9. ชื่อเล่น
  10. นามสกุล
4. ข้อมูลส่วนบุคคล (MapiContactPersonalInfoPropertySet)
  1. บัญชี
  2. หน้าโฮมเพจธุรกิจ
  3. ชื่อเครือข่ายคอมพิวเตอร์
  4. รหัสลูกค้า
  5. ที่ตั้งธุรกิจฟรี
  6. ไซต์ FTP
  7. เพศ
  8. หมายเลขบัตรประจำตัวรัฐบาล
  9. งานอดิเรก
  10. HTML
  11. ที่อยู่ข้อความทันที
  12. ภาษา
  13. สถานที่
  14. หมายเหตุ
  15. หมายเลขประจำตัวองค์กร
  16. หน้าโฮมเพจส่วนบุคคล
  17. ชื่อผู้แนะนำ
  18. ชื่อคู่สมรส
5. ที่อยู่ทางกายภาพ (MapiContactPhysicalAddressPropertySet)
  1. ที่อยู่บ้าน (MapiContactPhysicalAddress)
    1. ที่อยู่
    2. เมือง
    3. ประเทศ
    4. รหัสประเทศ
    5. รหัสไปรษณีย์
    6. ตู้ไปรษณีย์
    7. รัฐหรือจังหวัด
  2. ที่อยู่อื่น
  3. ที่อยู่ทำงาน
6. ข้อมูลทางอาชีพ
  1. ผู้ช่วย
  2. ชื่อบริษัท
  3. ชื่อแผนก
  4. ชื่อผู้จัดการ
  5. สถานที่ทำงาน
  6. อาชีพ
  7. ตำแหน่ง
7. โทรศัพท์ (MapiContactTelephonePropertySet)
  1. หมายเลขโทรศัพท์ผู้ช่วย
  2. หมายเลขโทรศัพท์ธุรกิจ2
  3. หมายเลขโทรศัพท์ธุรกิจ
  4. หมายเลขโทรศัพท์ Callback
  5. หมายเลขโทรศัพท์รถยนต์
  6. หมายเลขโทรศัพท์หลักของบริษัท
  7. หมายเลขโทรศัพท์บ้าน2
  8. หมายเลขโทรศัพท์บ้าน
  9. หมายเลข ISDN
  10. หมายเลขโทรศัพท์มือถือ
  11. หมายเลขโทรศัพท์อื่น
  12. หมายเลขโทรศัพท์เพจเจอร์
  13. หมายเลขโทรศัพท์หลัก
  14. หมายเลขโทรศัพท์วิทยุ
  15. หมายเลขเทเล็กซ์
  16. หมายเลขโทรศัพท์ TTY/TDD

โค้ดต่อไปนี้ใช้ Aspose.Email เพื่อสร้างรายชื่อ Outlook และเติมข้อมูลด้วยชื่อ, คุณสมบัติด้านอาชีพ, ที่อยู่ทางกายภาพ, และอีเมล นอกจากนี้ยังแสดงการเพิ่ม MapiContactEventPropertySet ถึงรายชื่อ.

|| | :- | |รูปภาพ: รายชื่อ Microsoft Outlook ที่เขียนโดยใช้ Aspose.Email|

เพิ่มข้อมูลเหตุการณ์ผู้ติดต่อลงใน MapiContact

Microsoft Outlook อนุญาตให้ผู้ใช้เพิ่มข้อมูลเหตุการณ์ลงในผู้ติดต่อ เหตุการณ์นี้รวมวันเกิดและวันครบรอบแต่งงาน Aspose.Email มีให้ MapiContactEventPropertySet คลาสสำหรับเพิ่มข้อมูลนี้ลงในผู้ติดต่อ รายละเอียดเพิ่มเติมอยู่ในตัวอย่างต่อไปนี้.

สร้าง บันทึก และอ่านผู้ติดต่อ Outlook

Aspose.Email อนุญาตให้นักพัฒนาสร้างผู้ติดต่อ Microsoft Outlook รวมถึงข้อความอีเมลด้วย MapiContact คลาสนี้ให้คุณสมบัติผู้ติดต่อทั้งหมดที่จำเป็นสำหรับการสร้างผู้ติดต่อ Outlook บทความนี้แสดงวิธีสร้าง บันทึก และอ่านผู้ติดต่อ Outlook ด้วย MapiContact คลาส.

สร้างและบันทึก MapiContact

ขั้นตอนต่อไปนี้สามารถใช้เพื่อสร้างและบันทึกผู้ติดต่อลงดิสก์:

สร้างวัตถุใหม่ของ MapiContact คลาส.
ป้อนข้อมูลที่เกี่ยวข้องกับคุณสมบัติต่าง ๆ ของผู้ติดต่อ.
เพิ่มข้อมูลรูปภาพให้ผู้ติดต่อ หากมี.
บันทึกผู้ติดต่อเป็นรูปแบบ MSG หรือ VCard.

บันทึกผู้ติดต่อในรูปแบบ VCF เวอร์ชัน 3

เพื่อบันทึกผู้ติดต่อในรูปแบบ VCF เวอร์ชัน 3 ให้ใช้ VCardVersion นามธรรมเพื่อกำหนด VCardSaveOptions.Version คุณสมบัติ ตัวอย่างโค้ดต่อไปนี้แสดงการใช้ VCardVersion นามธรรมเพื่อบันทึกผู้ติดต่อในรูปแบบ VCF เวอร์ชัน 3.

อ่าน MapiContact

นี้ MapiContact คลาสนี้สามารถใช้โหลดไฟล์ MSG ของ Microsoft Outlook รวมถึงผู้ติดต่อรูปแบบ VCard ตัวอย่างโค้ดต่อไปนี้แสดงวิธีโหลดผู้ติดต่อ Outlook ที่บันทึกเป็น MSG และ VCF เข้าไปใน MapiContact.

โหลดผู้ติดต่อจาก MSG

โหลดผู้ติดต่อจาก VCard

โค้ดต่อไปนี้แสดงวิธีสร้าง MapiContact โดยโหลดข้อมูลจากไฟล์ VCard ด้วย VCardLoadOptions:

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

โหลดผู้ติดต่อ VCard ด้วย Encoding ที่ระบุ

เมธอดที่รองรับ: MapiContact.fromVCard(String, Encoding)

เรนเดอร์ข้อมูลผู้ติดต่อเป็น MHTML

ผู้ติดต่อ Outlook สามารถแปลงเป็น MHTML ได้โดยใช้ Aspose.Email API ตัวอย่างนี้แสดงวิธีโหลด VCard ไปยัง MapiContact และจากนั้นแปลงเป็น MHTML ด้วยความช่วยเหลือของ MailMessage API.

Java: ทำงานกับงาน Outlook

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

การสร้าง, บันทึกและอ่านงาน Outlook

Aspose.Email for Java อนุญาตให้ผู้พัฒนาสร้างงาน Outlook และบันทึกเป็นรูปแบบ MSG. The MapiTask คลาสนี้ให้คุณสมบัติจำนวนหนึ่งเช่น PercentComplete, EstimatedEffort, ActualEffort, History, LastUpdate, เป็นต้น, เพื่อจัดการและตั้งค่าข้อมูลที่จำเป็นสำหรับงาน Outlook. บทความนี้แสดงวิธีสร้าง, บันทึกและอ่าน MapiTask จากดิสก์.

สร้างและบันทึก MapiTask

ขั้นตอนต่อไปนี้สามารถใช้สร้างและบันทึกงานลงดิสก์ได้.

สร้างวัตถุใหม่ของ MapiTask คลาส.
กรอกข้อมูลสำหรับงานและคุณสมบัติต่าง ๆ.
บันทึกงานลงดิสก์ในรูปแบบ MSG.

อ่าน MapiTask

นี้ MapiTask อ็อบเจ็กต์ของคลาสนี้ใช้เพื่อแคสท์ MapiMessage อ็อบเจกต์ที่โหลดงานจากดิสก์ในรูปแบบ MSG.

อ่านงาน VToDo

Google Tasks ที่ส่งออกในรูปแบบ iCalendar เป็นเหตุการณ์ VToDo สามารถโหลดได้โดยใช้ MapiTask คลาสตามที่แสดงในตัวอย่างโค้ดต่อไปนี้.

เพิ่มข้อมูลการเตือนให้กับ MapiTask

คล้ายกับ Microsoft Outlook, Aspose.Email สามารถเพิ่มข้อมูลการเตือนให้กับ MapiTask. โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีการเพิ่มข้อมูลการเตือนให้กับ MapiTask.

เพิ่มไฟล์แนบให้กับ MapiTask

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีการเพิ่มไฟล์แนบให้กับ MapiTask.

แปลงงาน Outlook เป็น MHT

Aspose.Email สามารถสร้าง MapiMessage เช่นผลลัพธ์ระหว่างการแปลงของ MapiTask เป็น MHT.

Java: การจัดการข้อความที่มีลายเซ็นดิจิทัล

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

Aspose.Email ดำเนินการอัลกอริทึมอ็อบเจกต์อีเมล S/MIME อย่างครบถ้วน ทำให้ API มีความสามารถเต็มที่ในการเพิ่มลายเซ็นดิจิทัลให้กับข้อความอีเมล, คงลายเซ็นขณะแปลงรูปแบบข้อความระหว่างกัน, ลบลายเซ็น ฯลฯ.

แนบลายเซ็นให้กับอีเมล

นี้ SecureEmailManager.attachSignature เมธอดนี้อนุญาตให้คุณแนบลายเซ็นดิจิทัลไปยังข้อความอีเมล หลังจากแนบลายเซ็น ให้ตรวจสอบผลลัพธ์ผ่านคุณสมบัติเช่น IsSigned, MessageClass, และรายละเอียดการแนบ.

คุณสามารถระบุ MailMessage หรือ MapiMessage, ใบรับรองส่วนตัว, และตัวเลือกลายเซ็นเพื่อปรับแต่งกระบวนการแนบลายเซ็นด้วย SignatureOptions คลาสที่ให้ผู้ใช้ระบุตัวเลือกต่างๆ สำหรับการแนบลายเซ็น รวมถึงลายเซ็นแบบแยกหรือไม่แยก.

ตัวอย่างโค้ดต่อไปนี้จะแสดงวิธีโหลดข้อความจากไฟล์, แนบลายเซ็นดิจิทัลแบบแยกและไม่แยกโดยใช้ใบรับรองส่วนตัว, แล้วตรวจสอบว่าการแนบลายเซ็นสำเร็จหรือไม่.

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

MapiMessage msg = MapiMessage.load(fileName);

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

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

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

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

คงลายเซ็นขณะแปลงจาก EML เป็น MSG

Aspose.Email คงลายเซ็นดิจิทัลขณะแปลงจาก EML เป็น MSG ส่วนโค้ดต่อไปนี้แสดงวิธีแปลงจาก EML ไปยัง MSG.

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

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

ลบลายเซ็นจากไฟล์ข้อความ Outlook

หากคุณต้องการลบลายเซ็นจากข้อความในรูปแบบ MAPI เช่น เพื่อความเข้ากันได้ Aspose.Email มี MapiMessage.removeSignature เมธอดและ MapiMessage.isSigned คุณสมบัติ.

ส่วนโค้ดต่อไปนี้แสดงวิธีโหลดข้อความ MAPI จากไฟล์, ตรวจสอบว่ามีลายเซ็นดิจิทัลหรือไม่, และถ้ามี สร้างข้อความใหม่โดยไม่มีลายเซ็นดิจิทัล:

MapiMessage msg = MapiMessage.load(fileName);

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

การแปลงข้อความ S/MIME จาก MSG เป็น EML

Aspose.Email คงลายเซ็นดิจิทัลขณะแปลงจาก MSG เป็น EML ตามที่แสดงในส่วนโค้ดต่อไปนี้.

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

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

ถอดรหัสไฟล์ MSG ด้วยใบรับรอง

หากคุณมีข้อความ MAPI ที่เข้ารหัสและต้องการถอดรหัสด้วยคีย์ส่วนตัวที่เก็บในใบรับรอง คุณลักษณะของ Aspose.Email ต่อไปนี้อาจเป็นประโยชน์:

MapiMessage.isEncrypted - รับค่าที่แสดงว่าข้อความถูกเข้ารหัสหรือไม่.
MapiMessage.decrypt() - ถอดรหัสข้อความนี้ (เมธอดจะค้นหาในที่เก็บ My ของผู้ใช้และคอมพิวเตอร์ปัจจุบันเพื่อหาใบรับรองและคีย์ส่วนตัวที่เหมาะสม).
MapiMessage.decrypt(X509Certificate2 certificate) - ถอดรหัสข้อความนี้ด้วยใบรับรอง.

ส่วนโค้ดต่อไปนี้แสดงวิธีทำงานกับข้อความ MAPI ที่เข้ารหัส:

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

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

Java: ทำงานกับโน้ต Outlook

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

สร้าง บันทึก และอ่านโน้ต Outlook

Aspose.Email มีฟังก์ชันสร้างโน้ต Outlook และบันทึกลงดิสก์ในรูปแบบ MSG โดย MapiNote คลาสนี้ให้คุณสมบัติและเมธอดเพื่อกำหนดข้อมูลที่ต้องการสำหรับโน้ต บทความนี้แสดงวิธีสร้าง บันทึก และอ่าน MapiNote จากดิสก์.

สร้างและบันทึกโน้ต Outlook

ขั้นตอนต่อไปนี้สามารถใช้เพื่อสร้างและบันทึกโน้ตลงดิสก์.

สร้างออบเจ็กต์ของ MapiNote คลาส.
ตั้งค่าคุณสมบัติต่าง ๆ ตามต้องการ.
บันทึกโน้ตลงดิสก์เป็นไฟล์ MSG.

อ่าน MapiNote

นี้ MapiNote อ็อบเจ็กต์ของคลาสนี้ใช้เพื่อแคสท์ MapiMessage อ็อบเจ็กต์ที่โหลดโน้ตจากดิสก์ในรูปแบบ MSG.

Java: ทำงานกับรายการปฏิทิน Outlook

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

ทำงานกับ MapiCalendar

ของ Aspose.Email MapiCalendar คลาสนี้ให้เมธอดและแอตทริบิวต์เพื่อกำหนดคุณสมบัติต่าง ๆ ของรายการปฏิทิน. บทความนี้มีตัวอย่างโค้ดสำหรับ:

การสร้างและบันทึกรายการปฏิทิน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีสร้างและบันทึกรายการปฏิทินในรูปแบบ ICS.

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

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

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

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

บันทึกรายการปฏิทินเป็นไฟล์ MSG

โค้ดตัวอย่างต่อไปนี้แสดงวิธีบันทึกรายการปฏิทินเป็นไฟล์ MSG.

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

ตั้งค่า ID ผลิตภัณฑ์เมื่อบันทึกรายการปฏิทินเป็นไฟล์ ICS

นี้ ProductIdentifier คุณสมบัติของ MapiCalendarIcsSaveOptions คลาสนี้ใช้เพื่อบันทึกรายการปฏิทิน MAPI ลงในไฟล์ iCalendar (ICS) โดยคงข้อมูลวันและเวลาต้นฉบับไว้รวมถึงตัวระบุผลิตภัณฑ์ที่กำหนดเอง. คุณสมบัตินี้ระบุรหัสของผลิตภัณฑ์ที่สร้างอ็อบเจ็กต์ iCalendar.

ตัวอย่างโค้ดต่อไปนี้แสดงวิธีทำงานกับข้อมูล iCalendar (ICS) ภายในอ็อบเจ็กต์ปฏิทิน MAPI:

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

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

เพิ่มการเตือนแบบแสดงผลในปฏิทิน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีเพิ่มการเตือนแบบแสดงผลในปฏิทิน.

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

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

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

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

เพิ่มการเตือนด้วยเสียงในปฏิทิน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีเพิ่มการเตือนด้วยเสียงในปฏิทิน.

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

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

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

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

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

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

เพิ่ม/ดึงไฟล์แนบจากไฟล์ปฏิทิน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีเพิ่ม/ดึงไฟล์แนบจากไฟล์ปฏิทิน.

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

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

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

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

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

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

สถานะของผู้รับจากคำขอการประชุม

โค้ดตัวอย่างต่อไปนี้แสดงวิธีดึงสถานะของผู้รับจากคำขอการประชุม.

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

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

ตั้งค่าสถานะการนัดหมายปฏิทินโดยตรง

Aspose.Email อนุญาตให้คุณตั้งค่าสถานะของ MapiCalendar ออบเจ็กต์โดยชัดเจน, ทำให้การทำงานตามค่าเริ่มต้นถูกแทนที่. ตัว setStateForced วิธีการนี้ให้การควบคุมที่ดีกว่าเกี่ยวกับสถานะเหตุการณ์ปฏิทิน, โดยเฉพาะเมื่อจัดการคำขอการประชุมที่ได้รับ. โดยค่าเริ่มต้น, เมื่อสร้างการประชุม, สถานะของมันคือ MapiCalendarState.Meeting. เมื่อได้รับในกล่องจดหมายของผู้รับ, มันจะเปลี่ยนเป็นโดยอัตโนมัติเป็น MapiCalendarState.Received, และคลาสข้อความของมันถูกอัปเดตเป็น IPM.Schedule.Meeting.Request. ใช้ SetStateForced อนุญาตให้ตั้งค่าสถานะเป็น Received ด้วยตนเอง, ซึ่งอาจเป็นประโยชน์ในการรักษาข้อมูลผู้จัดเมื่อบันทึกปฏิทินเป็นไฟล์ MSG. อย่างไรก็ตาม, สิ่งนี้อาจทำให้ไม่สามารถส่งต่อหรือส่งซ้ำการประชุมได้อย่างเหมาะสม.

ตัวอย่างโค้ดต่อไปนี้จะช่วยคุณในการใช้งานคุณลักษณะนี้:

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

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

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

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

สร้าง MapiCalendarTimeZone จากเขตเวลาแบบมาตรฐาน

โค้ดตัวอย่างต่อไปนี้แสดงวิธีสร้าง MapiCalendarTimeZone จากเขตเวลามาตรฐาน.

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

ตั้งการเตือนด้วยการนัดหมายที่สร้างขึ้น

สามารถเพิ่มการเตือนเมื่อสร้างการนัดหมายได้ การเตือนเหล่านี้สามารถทำงานตามเกณฑ์ต่าง ๆ เช่น ก่อนเริ่มกำหนดเวลา n นาที, ทำซ้ำ n ครั้งที่ช่วงเวลา n. สามารถใช้แท็กต่าง ๆ เพื่อสร้างการกระตุ้นเหล่านี้ในสคริปต์ที่อยู่ระหว่าง BEGIN:VALARM และ END:VALARM ภายในการนัดหมาย. มีรูปแบบหลายแบบที่สามารถตั้งการเตือนบนการนัดหมายได้.

ตั้งการเตือนโดยเพิ่มแท็ก

โค้ดตัวอย่างต่อไปนี้แสดงวิธีตั้งการเตือนโดยเพิ่มแท็ก.

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

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

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

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


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

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

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

แปลง Appointment EML เป็น MSG ด้วยเนื้อหา HTML

ตั้งแต่เวอร์ชัน 19.3, Aspose.Email มีความสามารถในการแปลง Appointment EML เป็น MSG พร้อมคงเนื้อหา HTML ของการนัดหมายไว้. Aspose.Email มี MapiConversionOptions.ForcedRtfBodyForAppointment คุณสมบัติที่มีค่าเริ่มต้นเป็น true. เมื่อค่าของ MapiConversionOptions.ForcedRtfBodyForAppointment หากตั้งค่าเป็น true, เนื้อหาการนัดหมายจะถูกแปลงเป็นรูปแบบ RTF. เพื่อคงรูปแบบเนื้อหาการนัดหมายในรูปแบบ HTML, ตั้งค่าของ MapiConversionOptions.ForcedRtfBodyForAppointment เป็น false.

ตัวอย่างต่อไปนี้แสดงการใช้งานของ MapiConversionOptions.ForcedRtfBodyForAppointment คุณสมบัติสำหรับคงรูปแบบเนื้อหาการนัดหมายในรูปแบบ HTML.

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

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

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

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

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

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

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

Java: ทำงานกับรายการแจกจ่าย

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

สามารถสร้างรายการกระจาย (Distribution list) ด้วย Aspose.Email API ซึ่งเป็นการรวบรวมหลายรายชื่อผู้ติดต่อได้ รายการกระจายสามารถบันทึกลงดิสก์ในรูปแบบ Outlook MSG และสามารถดู/แก้ไขได้โดยการเปิดใน MS Outlook.

สร้างและบันทึกรายการแจกจ่าย

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีสร้างและบันทึกรายการแจกจ่าย.

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

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

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

String strEntryId1;
String strEntryId2;

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

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

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

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

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

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

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

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

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

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

บันทึกรายการแจกจ่าย Mapi ไปยังไฟล์ VCF หลายคอนแทคท์หนึ่งไฟล์

นี้ void save(String fileName, MapiDistributionListSaveOptions options) เมธอดอนุญาตให้คุณบันทึกรายการแจกจ่าย Mapi ไปยังชื่อไฟล์ที่กำหนดโดยใช้ตัวเลือกการบันทึกที่ให้ไว้. คุณสามารถระบุชื่อไฟล์และอินสแตนซ์ของ MapiDistributionListSaveOptions คลาสเป็นพารามิเตอร์. The MapiDistributionListSaveOptions คลาสนี้มีตัวเลือกสำหรับบันทึกรายการแจกจ่าย Mapi. ในกรณีนี้คุณสามารถระบุรูปแบบการบันทึกเป็น VCard (ContactSaveFormat.VCard) เพื่อบันทึกรายการแจกจ่ายเป็นไฟล์ VCF หลายคอนแทคท์.

โค้ดตัวอย่างต่อไปนี้สาธิตวิธีบันทึกรายการแจกจ่ายเป็นไฟล์ VCF หลายคอนแทคท์:

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

อ่านรายการแจกจ่ายจาก PST

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีอ่านรายการแจกจ่ายจากไฟล์ PST.

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

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

Java: ทำงานกับการทำซ้ำ

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

ทำงานกับการทำซ้ำรายวัน

Aspose.Email รองรับการสร้างการทำซ้ำรายวันโดยใช้ MapiCalendarDailyRecurrencePattern. สามชนิดของการสิ้นสุดการทำซ้ำปฏิทิน Mapi ที่สามารถใช้ได้รวมถึง EndAfterNOccurrences, EndAfterDate และ NeverEnd. ส่วนนี้แสดงการสร้างรูปแบบการทำซ้ำรายวันที่แตกต่างกัน.

การทำซ้ำรายวัน: ชนิด EndAfterNOccurrence

ในชนิดการทำซ้ำนี้ จำนวนครั้งของการทำซ้ำต้องตั้งค่าพร้อมกับข้อมูลอื่น ๆ ดังต่อไปนี้:

กำหนดวันที่เริ่ม, สิ้นสุด และกำหนดส่ง.
สร้าง MapiTask.
ตั้งค่าสถานะงานเป็น NotAssigned.
สร้างออบเจกต์การทำซ้ำรายวันโดยกำหนดคุณสมบัติเช่น PatternType, Period, WeekStartDay, EndType และ OccurenceCount.
ตั้งค่าคุณสมบัติ MapiTask.setRecurrence ให้เป็นออบเจกต์การทำซ้ำรายวันนี้.
บันทึกข้อความนี้ลงดิสก์.

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีสร้างงานที่มีชนิดการสิ้นสุดการทำซ้ำเป็น EndAfterNOccurrence.

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

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

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

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

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

ฟังก์ชันต่อไปนี้สามารถใช้คำนวนจำนวนเหตุการณ์ระหว่างสองวันที่:

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

ตั้งค่าจำนวนครั้งของการทำซ้ำ

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีตั้งค่าค่าจำนวนครั้งของการทำซ้ำ.

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

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

การทำซ้ำรายวัน: ชนิด EndAfterDate

การทำซ้ำรายวัน: การตั้งค่า Every Day

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีตั้งค่าค่า period เป็น 1 และค่า INTERVAL เป็น 1 ในสตริง RRULE ด้วย.

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

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

ค่าของ Every Day สามารถตั้งค่าเป็นค่าที่เหมาะสมใด ๆ ตามที่แสดงในตัวอย่างต่อไปนี้:

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

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

การทำซ้ำรายวัน: ชนิด NeverEnd

สามารถตั้งค่าชนิดการสิ้นสุดโดยใช้ MapiCalendarRecurrenceEndType.NeverEnd. Period หรือ INTERVAL สามารถตั้งค่าเป็นค่าที่ต้องการ เช่น 1 ในตัวอย่างต่อไปนี้.

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

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

ทำงานกับการทำซ้ำรายสัปดาห์

Aspose.Email มีคุณลักษณะที่หลากหลายสำหรับการสร้างการทำซ้ำรายสัปดาห์โดยใช้ MapiCalendarWeeklyRecurrencePattern. สามชนิดของการสิ้นสุดการทำซ้ำปฏิทิน Mapi ที่สามารถใช้ได้รวมถึง EndAfterNOccurrences, EndAfterDate และ NeverEnd. ส่วนนี้แสดงการสร้างรูปแบบการทำซ้ำรายสัปดาห์ที่แตกต่างกัน.

การทำซ้ำรายสัปดาห์: ชนิด EndAfterNOccurrences

กำหนดวันที่เริ่ม, สิ้นสุด และกำหนดส่ง.
สร้าง MapiTask.
ตั้งค่าสถานะงานเป็น NotAssigned.
สร้างออบเจกต์การทำซ้ำรายสัปดาห์โดยกำหนดคุณสมบัติเช่น PatternType, Period, WeekStartDay, EndType และ OccurenceCount.
ตั้งค่าคุณสมบัติ MapiTask.setRecurrence ให้เป็นออบเจกต์การทำซ้ำรายสัปดาห์นี้.
บันทึกข้อความนี้ลงดิสก์.

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

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

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

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

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

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

ฟังก์ชันต่อไปนี้สามารถใช้คำนวนจำนวนเหตุการณ์ระหว่างสองวันที่:

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

การเลือกหลายวันในสัปดาห์

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีเลือกหลายวันในสัปดาห์.

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

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

การเลือกหลายวันในสัปดาห์และการตั้งค่าช่วงเวลา

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีเลือกหลายวันในสัปดาห์และตั้งค่าช่วงเวลา.

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

การทำซ้ำรายสัปดาห์: ชนิด EndAfterDate

การทำซ้ำรายสัปดาห์: การตั้งค่า Every Day

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

ค่าของ Every Day สามารถตั้งค่าเป็นค่าที่เหมาะสมใด ๆ และสามารถเลือกหลายวันได้ตามที่แสดงในตัวอย่างต่อไปนี้:

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

การทำซ้ำรายสัปดาห์: ชนิด NeverEnd

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

ทำงานกับการทำซ้ำรายเดือน

Aspose.Email รองรับการสร้างการทำซ้ำรายเดือนโดยใช้ MapiCalendarMonthlyRecurrencePattern. สามชนิดของการสิ้นสุดการทำซ้ำปฏิทิน Mapi ที่สามารถใช้ได้รวมถึง EndAfterNOccurrences, EndAfterDate และ NeverEnd. ส่วนนี้แสดงการสร้างรูปแบบการทำซ้ำรายเดือนที่แตกต่างกัน.

การทำซ้ำรายเดือน: ชนิด EndAfterNOccurrences

กำหนดวันที่เริ่ม, สิ้นสุด และกำหนดส่ง.
สร้าง MapiTask.
ตั้งค่าสถานะงานเป็น NotAssigned.
สร้างออบเจกต์การทำซ้ำรายเดือนโดยกำหนดคุณสมบัติเช่น PatternType, Period, WeekStartDay, EndType และ OccurenceCount.
ตั้งค่าคุณสมบัติ MapiTask.setRecurrence ให้เป็นออบเจกต์การทำซ้ำรายเดือนนี้.
บันทึกข้อความนี้ลงดิสก์.

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

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

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

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

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

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

ฟังก์ชันต่อไปนี้สามารถใช้คำนวนจำนวนเหตุการณ์ระหว่างสองวันที่:

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

ตั้งค่าจำนวนครั้งที่แน่นอน

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีตั้งค่าจำนวนครั้งที่แน่นอน.

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

การทำซ้ำรายเดือน: ชนิด EndAfterDate

"End By" ใน Mapi Task ทำได้โดยกำหนดคุณสมบัติ OccurrenceCount ที่คำนวนโดยฟังก์ชัน getOccurrenceCount() ฟังก์ชันนี้รับวันที่เริ่ม, วันที่สิ้นสุด และสตริง RRULE. โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีสร้างการทำซ้ำในวันที่ 15 ของทุกเดือนระหว่างวันที่เริ่มและสิ้นสุดตามวันที่.

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

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

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

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

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

การทำซ้ำรายเดือน: ชนิด NeverEnd

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีตั้งค่าชนิดการสิ้นสุดโดยใช้ MapiCalendarRecurrenceEndType.NeverEnd.

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

ทำงานกับการทำซ้ำประจำปี

Aspose.Email รองรับการสร้างการทำซ้ำประจำปีโดยใช้ MapiCalendarMonthlyRecurrencePattern. โดยการตั้งค่าคุณสมบัติ period เป็น 12 เราสามารถทำรูปแบบการทำซ้ำประจำปีได้. สามชนิดของการสิ้นสุดการทำซ้ำปฏิทิน Mapi ที่สามารถใช้ได้รวมถึง EndAfterNOccurrences, EndAfterDate และ NeverEnd. ส่วนนี้แสดงการสร้างรูปแบบการทำซ้ำประจำปีที่แตกต่างกัน.

การทำซ้ำประจำปี: ชนิด EndAfterNOccurrences

กำหนดวันที่เริ่ม, สิ้นสุด และกำหนดส่ง.
สร้าง MapiTask.
ตั้งค่าสถานะงานเป็น NotAssigned.
สร้างออบเจกต์การทำซ้ำรายเดือนโดยกำหนดคุณสมบัติเช่น PatternType, Period, WeekStartDay, EndType และ OccurenceCount.
ตั้งค่าคุณสมบัติ MapiTask.setRecurrence ให้เป็นออบเจกต์การทำซ้ำรายเดือนนี้เพื่อให้ได้การทำซ้ำประจำปี.
บันทึกข้อความนี้ลงดิสก์.

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

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

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

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

การทำซ้ำประจำปี: ชนิด EndAfterDate

"End By" ตัวเลือกใน Mapi Task ทำได้โดยกำหนดคุณสมบัติ OccurrenceCount ที่คำนวนโดยฟังก์ชัน getOccurrenceCount() ฟังก์ชันนี้รับวันที่เริ่มต้น, วันที่สิ้นสุด และสตริง RRULE. โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีสร้างการทำซ้ำในวันที่ 15 ของทุกเดือนที่ 7 ระหว่างวันที่เริ่มและสิ้นสุดตามวันที่.

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

การทำซ้ำประจำปี: ชนิด NeverEnd

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

สร้างการทำซ้ำจากกฎการทำซ้ำ

Aspose.Email API มีความสามารถในการสร้างรูปแบบการทำซ้ำจากกฎการทำซ้ำ (RRULE) โดยจะวิเคราะห์ข้อมูลจาก RRULE ตามสเปค RFC 5545 iCal และสร้างรูปแบบการทำซ้ำโดยใช้เมธอด MapiCalendarRecurrencePatternFactory.fromString. โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีการสร้างรูปแบบการทำซ้ำจากกฎการทำซ้ำ.

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

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

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

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

เพิ่มไฟล์แนบให้กับเหตุการณ์ปฏิทินที่ทำซ้ำ

Aspose.Email API มีความสามารถในการเพิ่มไฟล์แนบให้กับเหตุการณ์ปฏิทินที่ทำซ้ำ.

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

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

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

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

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

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

ตั้งค่าเขตเวลาเหตุการณ์ปฏิทิน

Aspose.Email API มีความสามารถในการกำหนดเขตเวลาปฏิทิน:

ข้อมูลเขตเวลาสำหรับวันเริ่มต้น/สิ้นสุด
ข้อมูลเขตเวลาสำหรับการประชุมที่ทำซ้ำ
ข้อมูลเขตเวลาอธิบายวิธีแปลงวันที่และเวลาในการประชุมของชุดซ้ำจากและไปยัง UTC

โค้ดตัวอย่างต่อไปนี้จะแสดงวิธีการกำหนดข้อมูลเขตเวลาปฏิทิน:

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

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

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