Documentation – کار با آیتم‌های Outlook

Java: ایجاد و ذخیرهٔ فایل‌های MSG

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

Aspose.Email از ایجاد فایل‌های پیام Outlook (MSG) پشتیبانی می‌کند. این مقاله توضیح می‌دهد چگونه:

ایجاد پیام‌های MSG.
ایجاد پیام‌های MSG با پیوست‌ها.
ایجاد پیام MSG با بدنهٔ RTF.
ذخیرهٔ پیام به‌عنوان پیش‌نویس.
کار با فشرده‌سازی بدنه.

ایجاد و ذخیرهٔ پیام‌های Outlook

این MailMessage کلاس دارای ذخیره متدی که می‌تواند فایل‌های Outlook MSG را روی دیسک یا استریم ذخیره کند. کدهای نمونه زیر یک نمونه از MailMessage کلاس، ویژگی‌هایی مانند from، to، subject و body را تنظیم کنید. این ذخیره متد نام فایل را به‌عنوان آرگومان می‌گیرد. علاوه بر این، پیام‌های Outlook می‌توانند با یک بدنهٔ RTF فشرده با استفاده از MapiConversionOptions.

یک نمونهٔ جدید از MailMessage کلاس را می‌گیرد و ویژگی‌های From، To، Subject و Body را تنظیم می‌کند.
متد را فراخوانی کنید MapiMessage کلاس fromMailMessage متد که شیء از نوع MailMessage نوع. این fromMailMessage متد … را تبدیل می‌کند MailMessage به یک MapiMessage (MSG).
متد را فراخوانی کنید MapiMessage.save متد برای ذخیرهٔ فایل MSG.

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

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

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

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

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

ایجاد فایل‌های MSG با پیوست‌ها

در مثال بالا، یک فایل MSG ساده ایجاد کردیم. Aspose.Email همچنین از ذخیرهٔ فایل‌های پیام با پیوست‌ها پشتیبانی می‌کند. تنها کاری که باید انجام دهید این است که پیوست‌ها را به MailMessage نمونه. با فراخوانی متد addItem بر روی MailMessage.Attachments مجموعه.

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

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

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

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

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

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

ایجاد فایل‌های MSG با بدنهٔ RTF

می‌توانید با Aspose.Email فایل‌های پیام Outlook (MSG) با بدنهٔ متن غنی (RTF) نیز ایجاد کنید. بدنه RTF از قالب‌بندی متن پشتیبانی می‌کند. برای ایجاد یک فایل، مقادیر مورد نیاز را تنظیم کنید. MailMessage.HtmlBody ویژگی. وقتی یک MailMessage نمونه به یک MapiMessage در این نمونه، بدنه HTML به RTF تبدیل می‌شود. به این ترتیب، قالب‌بندی بدنهٔ ایمیل حفظ می‌شود.

مثال زیر یک فایل MSG با بدنه RTF ایجاد می‌کند. یک سرعنوان وجود دارد که قالب‌بندی بولد و زیرخط در بدنه HTML اعمال شده است. این قالب‌بندی هنگام تبدیل HTML به RTF حفظ می‌شود.

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

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

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

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

ذخیرهٔ پیام در وضعیت پیش‌نویس

ایمیل‌ها به‌عنوان پیش‌نویس ذخیره می‌شوند زمانی که کاربری شروع به ویرایش آن‌ها کرده اما می‌خواهد برای تکمیل بعداً به آنها برگردد. Aspose.Email با تنظیم یک پرچم پیام، امکان ذخیرهٔ پیام‌های ایمیل در وضعیت پیش‌نویس را فراهم می‌کند. در زیر نمونه کدی برای ذخیرهٔ یک پیام ایمیل Outlook (MSG) به‌عنوان پیش‌نویس آورده شده است.

لطفاً توجه داشته باشید که در وضعیت پیش‌نویس، Outlook هیچ اطلاعات ارسال‌کننده‌ای که به MapiMessage اختصاص داده شده است را نمایش نمی‌دهد. اگر نیاز به نمایش اطلاعات ارسال‌کننده داشته باشیم باید پرچم MSGFLAG_READ را تنظیم کنیم.

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

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

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

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

پیامدهای فشرده‌سازی بدنه

متد فشرده‌سازی بدنه RTF می‌تواند برای تولید یک MSG با حجم کوچکتر استفاده شود. با این حال، این کار سرعت ایجاد را کاهش می‌دهد. برای ایجاد پیام‌ها با سرعت بهتر، پرچم را به false تنظیم کنید. این پرچم به نوبه‌ی خود بر PSTهای ایجاد شده تأثیر می‌گذارد: فایل‌های MSG کوچکتر منجر به PST کوچکتر می‌شوند، و فایل‌های MSG بزرگ منجر به ایجاد PST کندتر می‌شوند.

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

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

Java: بارگذاری، مشاهده و تجزیه فایل MSG

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

این موضوع توضیح می‌دهد چگونه یک فایل پیام Microsoft Outlook (*.msg) را بارگذاری کنیم. این MapiMessage کلاس برای بارگذاری فایل‌های MSG استفاده می‌شود و چندین تابع بارگذاری ایستاتیک برای سناریوهای مختلف فراهم می‌کند. قطعه کد زیر نشان می‌دهد چگونه فایل‌های MSG را از یک فایل یا از یک جریان بارگذاری کنید.

بارگذاری فایل‌های MSG

قطعه کد زیر نشان می‌دهد چگونه فایل‌های MSG را بارگذاری کنید.

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

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

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

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

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

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

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

مثال کد زیر نشان می‌دهد چگونه از MailMessage برای بارگذاری یک پیام در فرمت MSG استفاده کنید.

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

شایان ذکر است که پیام حاصل به فرمت EML تبدیل می‌شود، از جمله پیوست‌های پیام توکار. از این روش بارگذاری استفاده نکنید اگر می‌خواهید برخی از ویژگی‌های خاص فرمت msg پیام اصلی را حفظ کنید.

برای حفظ فرمت اصلی پیوست‌های پیام توکار، از … استفاده کنید. MsgLoadOptions.PreserveEmbeddedMessageFormat ویژگی.

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

بارگذاری از جریان

قطعه کد زیر نشان می‌دهد چگونه یک فایل را از یک جریان (stream) بارگذاری کنید.

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

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

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

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

}

تبدیل EML به MSG با حفظ فرمت EML توکار

فایل‌های EML می‌توانند به داخل … بارگذاری شوند MapiMessage کلاس با ایجاد یک MailMessage آبجکت و پاس دادن آن به MapiMessage.fromMailMessage متد. اگر فایل EML شامل فایل‌های EML توکار باشد، از … استفاده کنید. MapiConversionOptions.setPreserveEmbeddedMessageFormat برای حفظ فرمت فایل‌های EML توکار. قطعه کد زیر نشان می‌دهد چگونه فایل‌های EML را به داخل … بارگذاری کرد. MapiMessage در حالی که فرمت فایل‌های EML توکار حفظ می‌شود.

امتحان کنید!

ایمیل‌ها و آرشیو پیام‌ها را به‌صورت آنلاین با رایگان برنامه تبدیل Aspose.Email.

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

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

MapiConversionOptions options = MapiConversionOptions.getUnicodeFormat();

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

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

Java: مدیریت فایل‌های پیام با Aspose.Email.Outlook

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

تبدیل MSG به پیام MIME

API Aspose.Email امکان تبدیل فایل‌های MSG به پیام‌های MIME را با استفاده از toMailMessage متد.

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

تبدیل MSG به EML با حفظ بدنه RTF

API روش‌های زیر را برای حفظ بدنه RTF هنگام تبدیل MSG به EML فراهم می‌کند:

MsgLoadOptions.PreserveRtfContent - مقدار دریافت یا تنظیم می‌کند که آیا بدنه rtf در MailMessage نگه داشته شود یا نه.
MailConversionOptions.PreserveRtfContent - مقدار دریافت یا تنظیم می‌کند که آیا بدنه rtf در MailMessage نگه داشته شود یا نه.

نمونه‌های کد زیر نشان می‌دهند چگونه بدنه rtf را در MailMessage نگه دارید:

با استفاده از MsgLoadOptions.PreserveRtfContent

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

با استفاده از MailConversionOptions.PreserveRtfContent

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

تبدیل MSG به MHTML با حفظ هدر دسته

API Aspose.Email امکان افزودن هدر دسته هنگام تبدیل پیام به MHTML را فراهم می‌کند. این ویژگی توسط MhtSaveOptions کلاس به‌عنوان گزینه‌ای اضافی هنگام ذخیره MailMessage به قالب Mhtml.

نمونه کد زیر نشان می‌دهد چگونه یک فایل MHT (MHTML) را از یک شیء MapiMessage ایجاد کنید، قالب‌بندی و هدرهای فایل MHT را با استفاده از MhtSaveOptions سفارشی کنید، دسته‌ها را برای پیام ایمیل تنظیم کنید و سپس قالب‌های فرمت و هدرهای رندرینگ را برای فایل MHT قبل از ذخیره‌سازی تغییر دهید.

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

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

MhtSaveOptions saveOptions = new MhtSaveOptions();

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

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

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

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

خواندن و نوشتن فایل قالب آوتلوک (.OFT)

قالب‌های آوتلوک بسیار مفید هستند زمانی که می‌خواهید یک پیام ایمیل مشابه را بارها ارسال کنید. به جای تهیه پیام از صفر هر بار، ابتدا پیام را در آوتلوک آماده کرده و به‌عنوان قالب آوتلوک (OFT) ذخیره کنید. پس از آن، هر زمان که نیاز به ارسال پیام داشتید، می‌توانید آن را از قالب بسازید، باعث صرفه‌جویی در زمان نوشتن متن مشابه در بدنه یا موضوع، تنظیم فرمت و غیره می‌شود. Aspose.Email MailMessage کلاس می‌تواند برای بارگذاری و خواندن یک فایل قالب آوتلوک (OFT) استفاده شود. پس از بارگذاری قالب آوتلوک در یک نمونه از MailMessage کلاس، می‌توانید فرستنده، گیرنده، بدنه، موضوع و سایر ویژگی‌ها را به‌روزرسانی کنید. پس از به‌روزرسانی ویژگی‌ها:

ارسال ایمیل با استفاده از SmtpClient کلاس یا
ذخیره پیام به‌صورت MSG و انجام به‌روزرسانی‌ها/اعتبارسنجی‌های بیشتر با استفاده از Microsoft Outlook.

در نمونه‌های کد زیر، ما:

بارگذاری قالب با استفاده از MailMessage کلاس.
به‌روزرسانی برخی از ویژگی‌ها.
ذخیره پیام در قالب MSG.

قطعه کد زیر نشان می‌دهد چگونه فایل OFT را بارگذاری، پیام را به‌روزرسانی و در قالب MSG ذخیره کنید.

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

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

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

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

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

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

ذخیره فایل 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 = "outlook/";

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

تنظیم دسته رنگی برای فایل‌های MSG آوتلوک

یک دسته رنگی یک پیام ایمیل را برای نوعی اهمیت یا دسته‌بندی علامت‌گذاری می‌کند. Microsoft Outlook به کاربران اجازه می‌دهد تا دسته‌های رنگی را برای تمایز ایمیل‌ها اختصاص دهند. برای مدیریت دسته رنگی، از FollowUpManager. شامل توابعی مانند addCategory, removeCategory, clearCategories و getCategories.

addCategory می‌گیرد MapiMessage و رشته دسته رنگی، برای مثال "دسته بنفش" یا "دسته قرمز" به عنوان آرگومان.
removeCategory می‌گیرد MapiMessage و رشته دسته رنگی که باید از پیام حذف شود.
clearCategories برای حذف تمام دسته‌های رنگی از پیام استفاده می‌شود.
getCategories برای بازیابی تمام دسته‌های رنگی از یک پیام خاص استفاده می‌شود.

مثال زیر کارهای زیر را انجام می‌دهد:

اضافه کردن یک دسته رنگی.
اضافه کردن یک دسته رنگی دیگر.
دریافت لیست تمام دسته‌ها.
حذف تمام دسته‌ها.

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

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

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

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

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

دسترسی به اطلاعات پیگیری از فایل MSG

API Aspose.Email امکان دسترسی به اطلاعات پیگیری را از پیام ارسال‌شده یا دریافت‌شده فراهم می‌کند. می‌تواند اطلاعات دریافت، دریافت تحویل و نتایج نظرسنجی را از یک فایل پیام بازیابی کند.

بازیابی اطلاعات دریافت و تحویل رسید

قطعه کد زیر نشان می‌دهد چگونه اطلاعات دریافت و تحویل رسیدها را بازیابی کنید.

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

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

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

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

ایجاد پیام‌های Forward و Reply

API Aspose.Email امکان ایجاد و قالب‌بندی پیام‌های Forward و Reply را فراهم می‌کند. این ReplyMessageBuilder و ForwardMessageBuilder کلاس‌های این API به‌صورت جداگانه برای ایجاد پیام‌های Reply و Forward استفاده می‌شوند. یک پیام Reply یا Forward می‌تواند با استفاده از هر یک از حالت‌های OriginalMessageAdditionMode enum. این enum مقادیر زیر را دارد:

OriginalMessageAdditionMode.None - پیام اصلی در پیام پاسخ گنجانده نشده است.
OriginalMessageAdditionMode.Attachment - پیام اصلی به‌عنوان پیوست در پیام پاسخ گنجانده می‌شود
OriginalMessageAdditionMode.Textpart - پیام اصلی به‌عنوان متن در بدنهٔ پیام پاسخ گنجانده می‌شود

ایجاد پیام Reply

کد زیر نشان می‌دهد چگونه یک پیام 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

کد زیر نشان می‌دهد چگونه یک پیام 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: تجزیه فایل‌های پیام Outlook

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

با استفاده از Aspose.Email برای جاوا، توسعه‌دهندگان می‌توانند نه‌تنها فایل‌های MSG را بارگذاری بلکه محتویات آنها را تجزیه کنند.

برای بارگذاری فایل‌های MSG از دیسک، از MapiMessage کلاس ایستاتیک Load متد.
برای تجزیه محتویات فایل MSG، MapiMessage تعدادی متد را در اختیار می‌گذارد.

این موضوع نشان می‌دهد چگونه یک فایل MSG را بارگذاری و سپس تجزیه کنید تا محتویات آن را نمایش دهید.

Aspose.Email برای 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 یک 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: کار با گزینه رأی‌گیری با استفاده از MapiMessage

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

ایجاد گزینه رأی‌گیری با استفاده از MapiMessage

Microsoft Outlook به کاربران اجازه می‌دهد هنگام ایجاد یک پیام جدید یک نظرسنجی ایجاد کنند. این امکان را می‌دهد تا گزینه‌های رأی‌گیری مانند بله، خیر، شاید و غیره را شامل شوند. Aspose.Email همین قابلیت را هنگام ایجاد یک پیام Outlook جدید فراهم می‌کند. این FollowUpOptions کلاس فراهم می‌کند VotingButtons ویژگی که می‌تواند برای تنظیم یا دریافت مقدار گزینه‌های رأی‌گیری استفاده شود. این مقاله مثال دقیقی از ایجاد یک MapiMessage با گزینه‌های رأی‌گیری برای ایجاد نظرسنجی.

ایجاد نظرسنجی با استفاده از MapiMessage

قطعه کد زیر نشان می‌دهد چگونه یک نظرسنجی ایجاد کنید، FollowUpManager کلاس می‌تواند همان‌طور که در قطعه کد زیر نشان داده شده است استفاده شود.

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

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

خواندن گزینه‌های رأی‌گیری از یک MapiMessage

قطعه کد زیر نشان می‌دهد چگونه گزینه‌های رأی‌گیری را از یک … بخوانید. MapiMessage.

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

MapiMessage message = MapiMessage.fromFile(fileName);

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

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

خواندن فقط دکمه‌های رأی‌گیری

قطعه کد زیر نشان می‌دهد چگونه فقط دکمه‌های رأی‌گیری را بخوانید.

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

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

افزودن دکمه رأی‌گیری به یک پیام موجود

قطعه کد زیر نشان می‌دهد چگونه یک دکمه رأی‌گیری به یک پیام موجود اضافه کنید.

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

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

حذف دکمه رأی‌گیری از یک پیام

قطعه کد زیر نشان می‌دهد چگونه یک دکمه رأی‌گیری را از یک پیام حذف کنید.

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

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

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

خواندن اطلاعات نتایج رأی‌گیری

قطعه کد زیر نشان می‌دهد چگونه اطلاعات نتایج رأی‌گیری را بخوانید.

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

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

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

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

    System.out.println();
}

متدهای نمونه استفاده شده در مثال‌ها

قطعه کد زیر نشان می‌دهد چگونه یک پیام نمونه که در مثال‌ها استفاده می‌شود را ایجاد کنید.

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

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

Java: کار با پیگیری و تاریخ مهلت برای فایل‌های MSG Outlook

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

تنظیم پیگیری و تاریخ سررسید برای فایل‌های MSG آوتلوک

یک پرچم پیگیری پیام ایمیل را برای انجام نوعی اقدام علامت‌گذاری می‌کند. مایکروسافت آوتلوک به کاربران امکان می‌دهد پیام‌ها را پرچم‌گذاری کنند و در تنظیم پرچم، تاریخ سررسید برای پیگیری را اختصاص دهند. مایکروسافت آوتلوک یادآوری‌ای به گیرنده می‌فرستد تا او را به پیگیری ایمیل تشویق کند. پرچم‌گذاری ایمیل‌ها و تنظیم تاریخ سررسید به‌صورت برنامه‌نویسی به توسعه‌دهندگان نرم‌افزار اجازه می‌دهد انواع خاصی از ایمیل‌ها را خودکار کنند و به گیرندگان کمک کنند تا اقدام لازم را به یاد داشته باشند. برای مثال، می‌تواند برای ارسال پیام‌های ماهانه به تیم فروش استفاده شود تا آن‌ها را به تکمیل گزارش‌هایشان یادآوری کند؛ یا برای ارسال پیام به تمام کارکنان به منظور یادآوری جلسه شرکت. Aspose.Email برای جاوا پشتیبانی می‌کند از تنظیم پرچم پیگیری و تاریخ سررسید برای MapiMessage اشیاء با استفاده از FollowUpManager و FollowUpOptions. چندین نوع مختلف وجود دارد که می‌توان پرچم پیگیری را روی یک پیام تنظیم کرد. همه آن‌ها در نمونه کد زیر استفاده شده‌اند:

تنظیم پرچم پیگیری برای پیام
افزودن تاریخ سررسید و تاریخ یادآوری به پیام
افزودن پرچم به پیام گیرنده.
علامت‌گذاری به‌عنوان تکمیل‌شده.
حذف پرچم.
خواندن گزینه‌های پیگیری.

تنظیم پرچم پیگیری

قطعه کد زیر نشان می‌دهد چطور یک پرچم پیگیری تنظیم کنید.

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

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

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

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

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

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

تنظیم پیگیری برای گیرندگان

قطعه کد زیر نشان می‌دهد چطور پیگیری را برای گیرندگان تنظیم کنید.

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

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

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

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

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

علامت‌گذاری پرچم پیگیری به‌عنوان تکمیل شده

قطعه کد زیر نشان می‌دهد چطور پرچم پیگیری را به عنوان تکمیل شده علامت‌گذاری کنید.

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

حذف پرچم پیگیری

قطعه کد زیر نشان می‌دهد چطور پرچم پیگیری را حذف کنید.

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

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

خواندن گزینه‌های پرچم پیگیری برای یک پیام

قطعه کد زیر نشان می‌دهد چطور گزینه‌های پرچم پیگیری را برای یک پیام بخوانید.

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

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

Java: کار با ویژگی‌های MAPI

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

تنظیم و دسترسی به ویژگی‌های MAPI Outlook

Aspose.Email برای Java ارائه می‌دهد MapiProperty کلاسی که یک ویژگی MAPI را نمایش می‌دهد:

نام: نام ویژگی.
برچسب: برچسب ویژگی.
داده: دادهٔ ویژگی.

این موضوع همچنین نحوه تنظیم و دسترسی به ویژگی‌های MAPI یک فایل پیام Outlook (MSG) را با استفاده از Aspose.Email برای Java بررسی می‌کند. علاوه بر این، نمونه کدی برای نحوه حذف ویژگی‌ها از MSGها و پیوست‌ها فراهم شده است.

خواندن ویژگی‌ها

برای خواندن داده‌های ویژگی‌های MAPI از یک فایل MSG:

یک نمونه از MapiMessage کلاس برای بارگذاری یک فایل MSG با استفاده از Load() متد استاتیک.
یک مرجع به MapiMessage شیء getProperties() متد برای دریافت MapiPropertyCollection.
دریافت MapiProperty شیء از MapiPropertyCollection توسط MapiPropertyTag کلیدها.
دادهٔ ویژگی را با استفاده از متد مناسب getXXX() دریافت کنید.

تنظیم ویژگی‌های اضافی

نمونه کد زیر می‌تواند برای تنظیم ویژگی‌های اضافی یک Outlook استفاده شود MapiMessage.

حذف ویژگی‌ها

خواندن ویژگی‌های نام‌گذاری‌شده Mapi از پیام‌های ایمیل

Microsoft Outlook از افزودن ویژگی‌های نام‌گذاری‌شده MAPI به یک فایل MSG پشتیبانی می‌کند. این ویژگی‌ها توسط کاربر اضافه می‌شوند. توسعه‌دهندگان می‌توانند یک ویژگی نام‌گذاری‌شده، برای مثال “MyProp”، را به یک فایل MSG با استفاده از Aspose.Email اضافه کنند.

این مقاله Aspose.Email را نشان می‌دهد MapiMessage getNamedProperties() مجموعه‌ای برای خواندن ویژگی‌های نام‌گذاری‌شده MAPI از یک فایل MSG.

خواندن ویژگی نام‌گذاری‌شده MAPI

خواندن ویژگی نام‌گذاری‌شده Mapi از پیوست

Java: کار با پیوست‌های پیام

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

تحلیل و ذخیرهٔ پیوست‌ها

فایل‌های پیام Outlook ممکن است یک یا چند پیوست داشته باشند. Aspose.Email به توسعه‌دهندگان امکان می‌دهد تا از طریق حلقه بر روی پیوست‌های یک فایل MSG عبور کرده و آن‌ها را بر روی دیسک ذخیره کنند. این موضوع فرایند را توضیح می‌دهد و همچنین نحوهٔ ضمیمه کردن یک پیوست را شرح می‌دهد.

Aspose.Email MapiMessage کلاس برای بارگذاری یک فایل MSG از دیسک استفاده می‌شود و getAttachments() متدی که به MapiAttachment مجموعهٔ اشیاء مرتبط با فایل MSG. این MapiAttachment شیء متدهای بیشتری را که اعمالی بر پیوست انجام می‌دهند، در دسترس می‌گذارد.

برای ذخیرهٔ پیوست‌ها در یک فایل MSG به دیسک با نام و پسوند اصلی:

یک نمونه از MapiMessage کلاس برای بارگذاری یک فایل MSG با استفاده از Load() متد استاتیک.
متد را فراخوانی کنید MapiRecipient کلاس getAttachments() متد برای دریافت مرجع به مجموعهٔ MapiAttachment اشیاء مرتبط با فایل MSG.
در حلقه بگردید در MapiAttachmentCollection برای نمایش محتوای مربوط به هر MapiAttachment شیء از طریق متدهای عمومی آن.
متد را فراخوانی کنید MapiAttachment کلاس save() متد برای ذخیرهٔ پیوست بر روی دیسک.

ضمایم شدن پیام‌ها به‌عنوان پیوست‌ها

یک پیام Microsoft Outlook می‌تواند پیام‌های دیگر Microsoft Outlook را به‌عنوان پیوست داشته باشد، چه به‌صورت پیام‌های معمولی که در بالا شرح داده شد و چه به‌صورت پیام‌های تعبیه‌شده. این MapiAttachmentCollection متد add نسخه‌های بیش‌بارگذاری شده‌ای را برای ایجاد پیام‌های Outlook با هر دو نوع پیوست فراهم می‌کند. فایل‌های MSG Outlook که در داخل یک فایل MSG تعبیه شده‌اند، شامل PR_ATTACH_METHOD با مقدار 5 هستند.

خواندن پیام تعبیه‌شده از یک پیوست

درج و جایگزینی پیوست‌های MSG

API Aspose.Email امکان درج پیوست‌ها در ایندکس خاص داخل پیام والد را فراهم می‌کند. همچنین امکان جایگزینی محتوای یک پیوست با پیوست پیام دیگری را فراهم می‌آورد.

درج پیوست MSG در مکان مشخص

API Aspose.Email امکان درج یک پیوست MSG به یک MSG والد را با استفاده از MapiAttachmentCollection.Insert() متد.

جایگزینی محتوای پیوست MSG تعبیه‌شده

این می‌تواند برای جایگزینی محتوای پیوست تعبیه‌شده با موارد جدید با استفاده از جایگزین کردن متد. با این حال، نمی‌تواند برای درج پیوست با PR_ATTACH_NUM = 4 (به‌عنوان مثال) در مجموعه‌ای که collection.Count = 2 است، استفاده شود.

ذخیرهٔ پیوست‌ها از پیام‌های دیجیتالی امضا شده

API Aspose.Email امکان دریافت یا تنظیم مقداری را فراهم می‌کند که نشان می‌دهد آیا پیام با امضای واضح رمزگشایی خواهد شد یا نه.

تغییر نام یک پیوست در MapiMessage

Aspose.Email امکان ویرایش را فراهم می‌کند نام نمایشی مقدار ویژگی در پیوست‌های MapiMessage.

کد نمونه زیر نشان می‌دهد چگونه نام‌های نمایشی اولین و دومین پیوست در پیام Mapi بارگذاری شده را به‌روز کنید:

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

بررسی اینکه آیا پیوست Inline است یا Regular

تفاوت بین پیوست‌های inline و معمولی در نحوهٔ نمایش آن‌ها در ایمیل است. پیوست‌های inline در بدنهٔ ایمیل تعبیه می‌شوند و می‌توانند بدون باز کردن فایل جداگانه یا دانلود چیزی مشاهده شوند. پیوست‌های معمولی، فایل‌های جداگانه‌ای هستند که به ایمیل پیوست می‌شوند اما مستقیمً در بدنهٔ پیام نمایش داده نمی‌شوند و برای مشاهده باید دانلود و به‌صورت خارجی باز شوند. MapiAttachment.IsInline ویژگی MapiAttachment کلاس مقداری را دریافت می‌کند که نشان می‌دهد پیوست به‌صورت inline است یا معمولی.

کد نمونه زیر یک پیام ایمیل را از فایل بارگذاری کرده و سپس اطلاعات مربوط به پیوست‌ها را به‌دست می‌آورد، به‌طور خاص نام نمایش هر پیوست و اینکه آیا داخل پیام به‌صورت inline است یا خیر را چاپ می‌کند:

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

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

Java: کار با مخاطبان آوتلوک

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

ایجاد مخاطب Outlook

Aspose.Email برای Java از ایجاد مخاطبین Outlook (VCards) با استفاده از MapiContact کلاس. MapiContact شامل بسیاری از متدها است که برخی از آنها در زیر آمده‌اند.

MapiContactElectronicAddressPropertySet شامل یک مجموعه از MapiContactElectronicAddress.
MapiContactEventPropertySet
MapiContactNamePropertySet
MapiContactPersonalInfoPropertySet
MapiContactPhysicalAddressPropertySet شامل یک مجموعه از MapiContactPhysicalAddress.
MapiContactProfessionalPropertySet
MapiContactTelephonePropertySet

ساختار مخاطب در Aspose.Email برای Java

در زیر سلسله‌مراتبی که برای مخاطبین در Aspose.Email برای Java پیاده‌سازی شده است آورده شده است. نام کلاس مربوطه در مقابل هر ویژگی ذکر شده است. برای مرجع بیشتر، پیوندهای آنلاین به مستندات ارائه شده است.

Contact (MapiContact)
1. آدرس‌های الکترونیکی (MapiContactElectronicAddressPropertySet)
  1. ایمیل ۱ (MapiContactElectronicAddress)
    1. نوع آدرس
    2. نام نمایشی
    3. آدرس ایمیل
    4. شماره فکس
  2. ایمیل ۲
  3. ایمیل ۳
  4. فکس منزل
  5. فکس اصلی
  6. فکس تجاری
2. رویدادها (MapiContactEventPropertySet) برای مثال نحوه تنظیم رویدادها را در زیر ببینید.
  1. تاریخ تولد
  2. سالگرد عروسی
3. اطلاعات نام (MapiContactNamePropertySet)
  1. نام نمایشی
  2. پیشوند نام نمایشی
  3. دسته‌بندی زیر
  4. شناسه دسته‌بندی
  5. نسل
  6. نام
  7. حروف اولیه
  8. نام میانی
  9. لقب
  10. نام خانوادگی
4. اطلاعات شخصی (MapiContactPersonalInfoPropertySet)
  1. حساب
  2. صفحه اصلی تجاری
  3. نام شبکه کامپیوتری
  4. شناسه مشتری
  5. محل کسب‌وکار رایگان
  6. سایت FTP
  7. جنسیت
  8. شماره شناسنامه دولتی
  9. سرگرمی‌ها
  10. HTML
  11. آدرس پیام‌رسان فوری
  12. زبان
  13. مکان
  14. یادداشت‌ها
  15. شماره شناسایی سازمانی
  16. صفحه خانگی شخصی
  17. نام ارجاع‌دهنده
  18. نام همسر
5. آدرس فیزیکی (MapiContactPhysicalAddressPropertySet)
  1. آدرس منزل (MapiContactPhysicalAddress)
    1. آدرس
    2. شهر
    3. کشور
    4. کد کشور
    5. کد پستی
    6. صندوق پست
    7. ایالت یا استان
  2. آدرس دیگر
  3. آدرس کاری
6. اطلاعات حرفه‌ای
  1. دستیار
  2. نام شرکت
  3. نام بخش
  4. نام مدیر
  5. موقعیت دفتر
  6. حرفه
  7. عنوان
7. تلفن‌ها (MapiContactTelephonePropertySet)
  1. شماره تلفن دستیار
  2. شماره تلفن تجاری ۲
  3. شماره تلفن تجاری
  4. شماره تلفن تماس برگشت
  5. شماره تلفن خودرو
  6. شماره تلفن اصلی شرکت
  7. شماره تلفن منزل ۲
  8. شماره تلفن منزل
  9. شماره ISDN
  10. شماره تلفن همراه
  11. شماره تلفن دیگر
  12. شماره تلفن پیجر
  13. شماره تلفن اصلی
  14. شماره تلفن رادیویی
  15. شماره تِلِکس
  16. شماره تلفن TTY/TDD

کد زیر از Aspose.Email برای ایجاد یک مخاطب آوتلوک استفاده می‌کند و آن را با نام، خصوصیات حرفه‌ای، آدرس فیزیکی و ایمیل پر می‌کند. همچنین افزودن را نشان می‌دهد MapiContactEventPropertySet به مخاطب.

|| | :- | |شکل: یک مخاطب مایکروسافت آوتلوک که با Aspose.Email کدگذاری شده است|

افزودن اطلاعات رویداد تماس به یک MapiContact

Microsoft Outlook به کاربران اجازه می‌دهد اطلاعات رویداد را به یک مخاطب اضافه کنند. این رویداد شامل تولد و سالگرد ازدواج است. Aspose.Email این امکان را فراهم می‌کند MapiContactEventPropertySet کلاس برای افزودن این اطلاعات به یک مخاطب. این موضوع در مثال زیر توضیح داده شده است.

ایجاد، ذخیره و خواندن مخاطبین Outlook

Aspose.Email به توسعه‌دهندگان اجازه می‌دهد تا مخاطبین Microsoft Outlook و همچنین پیام‌های ایمیل ایجاد کنند. این MapiContact کلاس تمام ویژگی‌های تماس مورد نیاز برای ایجاد یک مخاطب Outlook را فراهم می‌کند. این مقاله نشان می‌دهد چگونه یک مخاطب Outlook را با استفاده از … ایجاد، ذخیره و بخوانید. MapiContact کلاس.

ایجاد و ذخیره یک MapiContact

مراحل زیر می‌توانند برای ایجاد و ذخیره یک مخاطب بر روی دیسک استفاده شوند:

یک شیء جدید از MapiContact کلاس.
اطلاعات مرتبط با ویژگی‌های مختلف مخاطب را وارد کنید.
در صورت وجود، داده‌های عکس را به مخاطب اضافه کنید.
مخاطب را به صورت فرمت MSG یا VCard ذخیره کنید.

ذخیره مخاطب در فرمت VCF نسخه 3

برای ذخیره مخاطب در فرمت VCF نسخه 3، از … استفاده کنید. VCardVersion قابل شمارش برای تنظیم VCardSaveOptions.Version ویژگی. کد نمونه زیر نحوه استفاده از را نشان می‌دهد VCardVersion قابل شمارش برای ذخیره مخاطب در فرمت VCF نسخه 3.

خواندن یک MapiContact

این MapiContact کلاس می‌تواند برای بارگذاری هر دو فایل پیام Microsoft Outlook MSG و همچنین مخاطبین فرمت VCard استفاده شود. نمونه‌های کد زیر نشان می‌دهند چگونه مخاطبین Outlook ذخیره‌شده به صورت MSG و VCF را به داخل … بارگذاری کنید. MapiContact.

بارگذاری یک مخاطب از MSG

بارگذاری یک مخاطب از VCard

کد زیر نشان می‌دهد چگونه یک … ایجاد کرد MapiContact با بارگذاری داده‌ها از یک فایل VCard با استفاده از VCardLoadOptions:

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

بارگذاری مخاطب VCard با رمزگذاری مشخص شده

روش‌های پشتیبانی شده: MapiContact.fromVCard(String, Encoding)

رندر اطلاعات مخاطب به MHTML

مخاطب Outlook می‌تواند با استفاده از Aspose.Email API به MHTML تبدیل شود. این مثال نشان می‌دهد چگونه یک VCard به داخل … بارگذاری می‌شود. MapiContact و سپس با کمک … به MHTML تبدیل می‌شود MailMessage API.

Java: کار با وظایف Outlook

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

ایجاد، ذخیره و خواندن وظایف Outlook

Aspose.Email برای Java به توسعه‌دهندگان اجازه می‌دهد وظایف Outlook را ایجاد کرده و به فرمت MSG ذخیره کنند. این MapiTask کلاس تعدادی ویژگی مانند را فراهم می‌کند PercentComplete, EstimatedEffort, ActualEffort, History, LastUpdate، و غیره، برای تطبیق و تنظیم اطلاعات مورد نیاز برای یک وظیفه Outlook. این مقاله نشان می‌دهد چگونه یک MapiTask از دیسک.

ایجاد و ذخیرهٔ MapiTask

مراحل زیر می‌تواند برای ایجاد و ذخیرهٔ یک وظیفه در دیسک استفاده شود.

یک شیء جدید از MapiTask کلاس.
اطلاعات مربوط به ویژگی‌های مختلف وظیفه را وارد کنید.
ذخیرهٔ وظیفه در دیسک با فرمت MSG.

خواندن یک MapiTask

این MapiTask آبجکت کلاس برای تبدیل … استفاده می‌شود. MapiMessage شیئی که یک وظیفه را از دیسک با فرمت MSG بارگذاری می‌کند.

خواندن یک وظیفه VToDo

وظایف Google که به فرمت iCalendar به عنوان رویدادهای VToDo صادر شده‌اند می‌توانند با استفاده از MapiTask کلاسی که در نمونه کد زیر نشان داده شده است.

افزودن اطلاعات یادآوری به یک MapiTask

مشابه Microsoft Outlook، Aspose.Email می‌تواند اطلاعات یادآوری را به یک MapiTask. کد نمونه زیر نشان می‌دهد چگونه اطلاعات یادآوری را به یک MapiTask.

افزودن پیوست به یک MapiTask

کد نمونه زیر نشان می‌دهد چگونه پیوست‌ها را به یک MapiTask.

تبدیل وظیفه Outlook به MHT

Aspose.Email می‌تواند تولید کند MapiMessage مانند خروجی هنگام تبدیل یک MapiTask به MHT.

Java: کار با یادداشت‌های Outlook

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

ایجاد، ذخیره و خواندن یادداشت‌های Outlook

Aspose.Email امکان ایجاد یادداشت‌های Outlook و ذخیره آن‌ها بر روی دیسک به فرمت MSG را فراهم می‌کند. این MapiNote کلاس ویژگی‌ها و متدهایی را برای تنظیم اطلاعات دلخواه یک یادداشت فراهم می‌کند. این مقاله نشان می‌دهد چگونه یک … ایجاد، ذخیره و بخوانید. MapiNote از دیسک.

ایجاد و ذخیره یادداشت Outlook

مراحل زیر می‌توانند برای ایجاد و ذخیره یک یادداشت بر روی دیسک استفاده شوند.

یک شیء از MapiNote کلاس.
ویژگی‌های مختلف را به دلخواه تنظیم کنید.
یادداشت را به عنوان فایل MSG بر روی دیسک ذخیره کنید.

خواندن یک MapiNote

این MapiNote آبجکت کلاس برای تبدیل … استفاده می‌شود. MapiMessage شیئی که یک یادداشت را از دیسک در فرمت MSG بارگذاری می‌کند.

Java: مدیریت پیام‌های امضای دیجیتال

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

Aspose.Email الگوریتم کامل شیء ایمیل S/MIME را پیاده‌سازی می‌کند. این به API توان کامل برای افزودن امضاهای دیجیتال به پیام‌های ایمیل، حفظ آن‌ها هنگام تبدیل پیام‌ها بین فرمت‌ها، حذف آن‌ها و غیره می‌دهد.

پیوست یک امضا به ایمیل

این SecureEmailManager.attachSignature متد به شما امکان می‌دهد امضاهای دیجیتالی را به پیام‌های ایمیل پیوست کنید. پس از پیوست امضا، نتایج را از طریق ویژگی‌هایی مانند IsSigned, MessageClass، و جزئیات پیوست.

شما می‌توانید یک MailMessage یا MapiMessage، یک گواهی‌نامه خصوصی، و گزینه‌های امضا را برای سفارشی‌سازی فرآیند ضمیمه‌کردن امضا همراه با SignatureOptions کلاس که به کاربران امکان می‌دهد گزینه‌های مختلفی را برای ضمیمه کردن امضا مشخص کنند، از جمله امضاهای جداشدنی یا غیرجداشده.

نمونه کد زیر نشان می‌دهد چگونه یک پیام را از فایل بارگذاری کنید، امضای دیجیتالی جداشدنی و غیرجداشده را با استفاده از یک گواهی‌نامه خصوصی ضمیمه کنید، و سپس بررسی کنید آیا امضاها به‌طور موفقیت‌آمیز ضمیمه شدند یا نه.

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

MapiMessage msg = MapiMessage.load(fileName);

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

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

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

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

حفظ امضا هنگام تبدیل از EML به MSG

Aspose.Email امضای دیجیتال را هنگام تبدیل از EML به MSG حفظ می‌کند. قطعه کد زیر نشان می‌دهد چگونه از EML به MSG تبدیل کنید.

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

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

حذف امضا از فایل پیام Outlook

اگر مجبور به حذف امضا از پیام در قالب MAPI هستید، برای مثال به دلایل سازگاری، Aspose.Email پیشنهاد می‌کند MapiMessage.removeSignature متد و MapiMessage.isSigned ویژگی.

قطعه کد زیر نشان می‌دهد چگونه یک پیام MAPI را از فایل بارگذاری کنید، بررسی کنید آیا امضای دیجیتالی دارد یا نه، و اگر دارد، پیام جدیدی بدون امضای دیجیتالی ایجاد کنید:

MapiMessage msg = MapiMessage.load(fileName);

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

تبدیل پیام‌های S/MIME از MSG به EML

Aspose.Email امضای دیجیتال را هنگام تبدیل از MSG به EML حفظ می‌کند همان‌طور که در قطعه کد زیر نشان داده شده است.

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

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

رمزگشایی یک فایل MSG با گواهی‌نامه

اگر پیام‌های MAPI رمزگذاری شده دارید و نیاز به رمزگشایی آن‌ها با کلید خصوصی ذخیره‌شده در یک گواهی‌نامه دارید، ویژگی‌های زیر Aspose.Email می‌توانند مفید باشند:

MapiMessage.isEncrypted - مقدار نشان‌دهنده این که آیا پیام رمزنگاری شده است یا خیر را برمی‌گرداند.
MapiMessage.decrypt() - این پیام را رمزگشایی می‌کند (متد، فروشگاه‌های My کاربر و کامپیوتر فعلی را برای یافتن گواهی‌نامه و کلید خصوصی مناسب جستجو می‌کند).
MapiMessage.decrypt(X509Certificate2 certificate) - این پیام را با گواهی‌نامه رمزگشایی می‌کند.

قطعه کد زیر نشان می‌دهد چگونه با پیام‌های MAPI رمزگذاری شده کار کنید:

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

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

Java: کار با موارد تقویم Outlook

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

کار با MapiCalendar

Aspose.Email MapiCalendar کلاس متدها و ویژگی‌هایی را برای تنظیم ویژگی‌های مختلف یک مورد تقویم فراهم می‌کند. این مقاله نمونه کدهایی را برای موارد زیر ارائه می‌دهد:

ایجاد و ذخیرهٔ موارد تقویم

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید یک مورد تقویم را در قالب ICS ایجاد و ذخیره کنید.

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

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

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

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

ذخیرهٔ مورد تقویم به صورت MSG

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید مورد تقویم را به صورت MSG ذخیره کنید.

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

تنظیم شناسه محصول هنگام ذخیرهٔ یک مورد تقویم به فرمت ICS

این ProductIdentifier ویژگی MapiCalendarIcsSaveOptions کلاس برای ذخیره یک مورد تقویم MAPI به فایل iCalendar (ICS) استفاده می‌شود به‌طوری که اطلاعات تاریخ و زمان اصلی و همچنین شناسهٔ محصول سفارشی حفظ شود. این ویژگی شناسهٔ محصولی که شیء iCalendar را ایجاد کرده است را مشخص می‌کند.

نمونه کد زیر نشان می‌دهد چگونه با داده‌های iCalendar (ICS) درون یک شیء تقویم MAPI کار کنید:

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

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

افزودن یادآوری نمایش به تقویم

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید یک یادآوری نمایش به تقویم اضافه کنید.

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

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

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

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

افزودن یادآوری صوتی به تقویم

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید یک یادآوری صوتی به تقویم اضافه کنید.

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

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

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

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

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

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

افزودن/بازخوانی پیوست‌ها از فایل‌های تقویم

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید پیوست‌ها را به فایل‌های تقویم اضافه/بازخوانی کنید.

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

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

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

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

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

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

وضعیت دریافت‌کنندگان از یک درخواست جلسه

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید وضعیت دریافت‌کنندگان را از یک درخواست جلسه دریافت کنید.

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

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

تنظیم صریح وضعیت قرار ملاقات تقویم

Aspose.Email به شما امکان می‌دهد وضعیت یک MapiCalendar شیء به‌وضوح، که رفتار پیش‌فرض را نادیده می‌گیرد. این setStateForced روش کنترل بهتری بر وضعیت رویدادهای تقویم فراهم می‌کند، به‌ویژه هنگام پردازش درخواست‌های جلسه دریافت‌شده. به‌صورت پیش‌فرض، وقتی یک جلسه ایجاد می‌شود، وضعیت آن MapiCalendarState.Meeting. وقتی در صندوق ورودی گیرنده دریافت می‌شود، به‌صورت خودکار تغییر می‌یابد به MapiCalendarState.Received، و کلاس پیام آن به‌روزرسانی می‌شود به IPM.Schedule.Meeting.Request. با استفاده از SetStateForced اجازه می‌دهد حالت را به صورت دستی به Received تنظیم کنید، که می‌تواند برای حفظ اطلاعات برگزارکننده هنگام ذخیره تقویم به عنوان فایل MSG مفید باشد. با این حال، ممکن است ارسال مجدد یا فوروارد صحیح جلسه را مانع شود.

نمونه کد زیر به شما کمک می‌کند این ویژگی را پیاده‌سازی کنید:

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

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

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

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

ایجاد MapiCalendarTimeZone از منطقه زمانی استاندارد

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید MapiCalendarTimeZone از منطقه زمان استاندارد.

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

تنظیم یادآوری با قرار ملاقات ایجاد شده

یک یادآوری می‌تواند هنگام ایجاد یک قرار ملاقات اضافه شود. این هشدارها می‌توانند بر اساس معیارهای مختلف مانند n دقیقه قبل از شروع برنامه، تکرار n بار با فواصل n فعال شوند. می‌توان از برچسب‌های متفاوت برای ایجاد این فعال‌کننده‌ها در اسکریپتی که بین BEGIN:VALARM و END:VALARM در یک قرار ملاقات قرار می‌گیرد، استفاده کرد. انواع مختلفی برای تنظیم یادآوری روی یک قرار ملاقات وجود دارد.

تنظیم یک یادآوری با افزودن برچسب‌ها

کد نمونهٔ زیر نشان می‌دهد چگونه می‌توانید یادآوری را با افزودن برچسب‌ها تنظیم کنید.

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

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

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

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


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

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

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

تبدیل Appointment EML به MSG با بدنهٔ HTML

از نسخهٔ 19.3 به بعد، Aspose.Email امکان تبدیل Appointment EML به MSG را فراهم می‌کند در حالی که بدنهٔ HTML قرار ملاقات حفظ می‌شود. Aspose.Email یک MapiConversionOptions.ForcedRtfBodyForAppointment خاصیتی که مقدار پیش‌فرض آن true. است. وقتی مقدار MapiConversionOptions.ForcedRtfBodyForAppointment اگر به true تنظیم شود، بدنهٔ قرار ملاقات به قالب RTF تبدیل می‌شود. برای حفظ قالب بدنهٔ قرار ملاقات به فرمت HTML، مقدار MapiConversionOptions.ForcedRtfBodyForAppointment به false.

مثال زیر نحوه استفاده از MapiConversionOptions.ForcedRtfBodyForAppointment خاصیتی برای حفظ قالب بدنه قرار ملاقات به فرمت HTML.

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

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

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

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

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

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

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

Java: کار با لیست‌های توزیعی

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

با استفاده از Aspose.Email API می‌توان لیست توزیع (Distribution list) ایجاد کرد که مجموعه‌ای از چندین مخاطب است. یک لیست توزیع می‌تواند در قالب 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 کلاس به‌عنوان پارامترها. 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

"End By" گزینه در Mapi Task با تنظیم ویژگی OccurrenceCount که توسط تابع getOccurrenceCount() محاسبه می‌شود، به‌دست می‌آید. این تابع تاریخ شروع، تاریخ پایان و رشته RRULE را می‌گیرد.

تکرارهای روزانه: تنظیم مقدار Every Day

کد نمونه زیر نشان می‌دهد چگونه مقدار period را به 1 و مقدار INTERVAL را نیز در رشته RRULE به 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.EndAfterDate);
record.setOccurrenceCount(getOccurrenceCount(startDate, endByDate, "FREQ=DAILY;INTERVAL=1"));
record.setEndDate(endByDate);

مقدار Every Day می‌تواند به هر مقدار مناسب تنظیم شود همان‌طور که در مثال زیر نشان داده شده است:

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

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

تکرارهای روزانه: نوع NeverEnd

نوع پایان می‌تواند با استفاده از MapiCalendarRecurrenceEndType.NeverEnd تنظیم شود. Period یا INTERVAL می‌تواند به مقدار مورد نیاز، مثلاً 1، در مثال زیر تنظیم گردد.

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

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

کار با تکرارهای هفتگی

Aspose.Email امکانات غنی برای ایجاد تکرارهای هفتگی با استفاده از فراهم می‌کند MapiCalendarWeeklyRecurrencePattern. می‌توان از سه نوع مختلف پایان تکرار تقویم Mapi استفاده کرد شامل EndAfterNOccurrences، EndAfterDate و NeverEnd. این بخش ایجاد الگوهای مختلف تکرار هفتگی را نشان می‌دهد.

تکرارهای هفتگی: نوع EndAfterNOccurrences

در این نوع تکرار، تعداد تکرارها به همراه سایر اطلاعات به شرح زیر تنظیم می‌شود:

تاریخ شروع، پایان و موعد را تنظیم کنید.
ایجاد یک MapiTask.
وضعیت وظیفه را به NotAssigned تنظیم کنید.
شیء تکرار هفتگی را با تنظیم ویژگی‌هایی مانند PatternType، Period، WeekStartDay، EndType و OccurenceCount ایجاد کنید.
ویژگی MapiTask.setRecurrence را به این شیء تکرار هفتگی تنظیم کنید.
این پیام را بر روی دیسک ذخیره کنید.

کد نمونه زیر نشان می‌دهد چگونه یک وظیفه با نوع پایان تکرار EndAfterNOccurrence ایجاد کنیم.

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

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

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

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

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

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

تابع زیر می‌تواند برای محاسبه تعداد رویدادها بین دو تاریخ استفاده شود:

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

انتخاب چندین روز در یک هفته

کد نمونه زیر نشان می‌دهد چگونه چندین روز در یک هفته انتخاب کنید.

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

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

انتخاب چندین روز در یک هفته و تنظیم بازه‌ها

کد نمونه زیر نشان می‌دهد چگونه چندین روز در یک هفته را انتخاب کرده و بازه‌ها را تنظیم کنید.

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

تکرارهای هفتگی: نوع EndAfterDate

تکرارهای هفتگی: تنظیم مقدار Every Day

کد نمونه زیر نشان می‌دهد چگونه مقدار period را به 1 و مقدار INTERVAL را نیز در رشته RRULE به 1 تنظیم کنیم.

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

مقدار Every Day می‌تواند به هر مقدار مناسب تنظیم شود و می‌توان چندین روز را همان‌طور که در مثال زیر نشان داده شده است انتخاب کرد:

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

تکرارهای هفتگی: نوع NeverEnd

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

کار با تکرارهای ماهانه

Aspose.Email از ایجاد تکرارهای ماهانه با استفاده از پشتیبانی می‌کند MapiCalendarMonthlyRecurrencePattern. می‌توان از سه نوع مختلف پایان تکرار تقویم Mapi استفاده کرد شامل EndAfterNOccurrences، EndAfterDate و NeverEnd. این بخش ایجاد الگوهای مختلف تکرار ماهانه را نشان می‌دهد.

تکرارهای ماهانه: نوع EndAfterNOccurrences

در این نوع تکرار، تعداد تکرارها به همراه سایر اطلاعات به شرح زیر تنظیم می‌شود:

تاریخ شروع، پایان و موعد را تنظیم کنید.
ایجاد یک MapiTask.
وضعیت وظیفه را به NotAssigned تنظیم کنید.
شیء تکرار ماهانه را با تنظیم ویژگی‌هایی مانند PatternType، Period، WeekStartDay، EndType و OccurenceCount ایجاد کنید.
ویژگی MapiTask.setRecurrence را به این شیء تکرار ماهانه تنظیم کنید.
این پیام را بر روی دیسک ذخیره کنید.

کد نمونه زیر نشان می‌دهد چگونه یک وظیفه با نوع پایان تکرار EndAfterNOccurrence ایجاد کنیم.

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

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

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

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

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

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

تابع زیر می‌تواند برای محاسبه تعداد رویدادها بین دو تاریخ استفاده شود:

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

تنظیم عدد ثابت تکرارها

کد نمونه زیر نشان می‌دهد چگونه یک عدد ثابت از تکرارها را تنظیم کنید.

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

تکرارهای ماهانه: نوع EndAfterDate

"End By" گزینه در Mapi Task با تنظیم ویژگی OccurrenceCount که توسط تابع getOccurrenceCount() محاسبه می‌شود، حاصل می‌شود. این تابع تاریخ شروع، تاریخ پایان و رشته RRULE را می‌گیرد. کد نمونه زیر نشان می‌دهد چگونه یک تکرار در روز 15 هر ماه بین تاریخ شروع و پایان ایجاد کنیم.

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

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

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

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

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

تکرارهای ماهانه: نوع NeverEnd

کد نمونه زیر نشان می‌دهد چگونه می‌توان نوع پایان را با استفاده از MapiCalendarRecurrenceEndType.NeverEnd تنظیم کرد.

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

کار با تکرارهای سالانه

Aspose.Email از ایجاد تکرارهای سالانه با استفاده از پشتیبانی می‌کند MapiCalendarMonthlyRecurrencePattern. با تنظیم ویژگی period به 12، می‌توانیم الگوی تکرار سالانه را به دست آوریم. سه نوع مختلف پایان تکرار تقویم Mapi می‌توانند استفاده شوند شامل EndAfterNOccurrences، EndAfterDate و NeverEnd. این بخش ایجاد الگوهای مختلف تکرار سالانه را نشان می‌دهد.

تکرارهای سالانه: نوع EndAfterNOccurrences

در این نوع تکرار، تعداد تکرارها به همراه سایر اطلاعات به شرح زیر تنظیم می‌شود:

تاریخ شروع، پایان و موعد را تنظیم کنید.
ایجاد یک MapiTask.
وضعیت وظیفه را به NotAssigned تنظیم کنید.
شیء تکرار ماهانه را با تنظیم ویژگی‌هایی مانند PatternType، Period، WeekStartDay، EndType و OccurenceCount ایجاد کنید.
ویژگی MapiTask.setRecurrence را به این شیء تکرار ماهانه تنظیم کنید تا تکرار سالانه حاصل شود.
این پیام را بر روی دیسک ذخیره کنید.

کد نمونه زیر نشان می‌دهد چگونه یک وظیفه با نوع پایان تکرار EndAfterNOccurrence ایجاد کنیم.

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

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

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

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

تکرارهای سالانه: نوع EndAfterDate

"End By" گزینه در Mapi Task با تنظیم ویژگی OccurrenceCount که توسط تابع getOccurrenceCount() محاسبه می‌شود، حاصل می‌شود. این تابع تاریخ شروع، تاریخ پایان و رشته RRULE را می‌گیرد. کد نمونه زیر نشان می‌دهد چگونه یک تکرار در روز 15 هر هفتمین ماه بین تاریخ شروع و پایان ایجاد کنیم.

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

تکرارهای سالانه: نوع NeverEnd

کد نمونه زیر نشان می‌دهد چگونه می‌توان نوع پایان را با استفاده از MapiCalendarRecurrenceEndType.NeverEnd تنظیم کرد.

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

تولید تکرار از قاعده تکرار

API Aspose.Email قابلیت تولید الگوی تکرار از قاعده تکرار (RRULE) را فراهم می‌کند. این API اطلاعات را از RRULE طبق مشخصات RFC 5545 iCal تجزیه می‌کند و الگوی تکرار را با استفاده از متد MapiCalendarRecurrencePatternFactory.fromString تولید می‌نماید. کد نمونه زیر نشان می‌دهد چگونه الگوی تکرار را از قاعده تکرار تولید کنید.

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

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

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

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

افزودن پیوست به رویدادهای تقویم تکراری

API Aspose.Email قابلیت افزودن پیوست‌ها به رویدادهای تقویم تکراری را فراهم می‌کند.

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

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

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

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

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

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

تنظیم منطقه زمانی رویداد تقویم

API Aspose.Email قابلیت تنظیم منطقه زمانی تقویم را فراهم می‌کند:

اطلاعات منطقه زمانی برای تاریخ شروع/پایان
اطلاعات منطقه زمانی برای یک جلسه تکراری
اطلاعات منطقه زمانی که توصیف می‌کند چگونه تاریخ و زمان جلسه را در یک سری تکراری به UTC و از آن تبدیل کنیم

کد نمونه زیر نشان می‌دهد چگونه اطلاعات منطقه زمانی تقویم را تنظیم کنید:

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

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

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