کار با قرارها (Appointments)
بارگذاری و ذخیره یک قرار ملاقات در قالب ICS
این Appointment کلاس در Aspose.Email برای Java میتواند برای بارگذاری یک قرار ملاقات در قالب ICS و همچنین برای ایجاد یک قرار ملاقات جدید و ذخیره آن بر روی دیسک در قالب ICS استفاده شود. در این مقاله ابتدا یک قرار ملاقات ایجاد کرده و آن را در قالب ICS بر روی دیسک ذخیره میکنیم و سپس آن را بارگذاری میکنیم.
بارگذاری یک قرار ملاقات در قالب ICS
برای بارگذاری یک قرار ملاقات در قالب ICS، مراحل زیر مورد نیاز است:
- یک نمونه از Appointment کلاس.
- متد را فراخوانی کنید Load() متد با ارائه مسیر فایل ICS.
- هر خصوصیتی را بخوانید تا هر اطلاعاتی را از قرار (فایل ICS) به دست آورید.
قطعههای کد زیر نشان میدهند چگونه یک قرار (Appointment) را در فرمت ICS بارگذاری کنید.
ایجاد یک قرار ملاقات و ذخیره بر روی دیسک در قالب ICS
مراحل زیر برای ایجاد یک قرار ملاقات و ذخیره آن در قالب ICS مورد نیاز است.
- یک نمونه از Appointment کلاس و آن را با این سازنده مقداردهی اولیه کنید.
- آرگومانهای زیر را در سازنده بالا بگذرانید
- شرکتکنندگان
- توضیح
- تاریخ پایان
- مکان
- تنظیمکننده
- تاریخ شروع
- خلاصه
- تاریخ ایجاد
- تاریخ آخرین تغییر
- متد را فراخوانی کنید Save() متد و نام فایل و فرمت را در آرگومانها مشخص کنید.
قرار ملاقات میتواند در Microsoft Outlook یا هر برنامهای که میتواند فایل ICS را بارگذاری کند، باز شود. اگر فایل در Microsoft Outlook باز شود، به طور خودکار قرار ملاقات را در تقویم Outlook اضافه میکند.
قطعات کد زیر نشان میدهند که چگونه یک قرار ملاقات را ایجاد و در قالب ICS بر روی دیسک ذخیره کنید.
ذخیره قرار ملاقاتها در قالب MSG
Aspose.Email امکان ذخیره مستقیم قرار ملاقاتها در فایلهای .msg را فراهم میکند. کلاسهای عمومی زیر برای سفارشیسازی فرآیند ذخیرهسازی قرار ملاقاتها در دسترس هستند:
- AppointmentMsgSaveOptions کلاس با گزینههای اضافی برای ذخیره قرار ملاقاتها در قالب msg.
- AppointmentIcsSaveOptions کلاس با گزینههای اضافی برای ذخیره قرار ملاقات در قالب ics. این کلاس برای جایگزینی IcsSaveOptions منسوخ شده اضافه شد.
نمونه کد زیر نشان میدهد که چگونه یک قرار ملاقات را از یک فایل بارگذاری کنید و سپس آن را در دو فرمت متفاوت ذخیره کنید: .ics و .msg.
Appointment appointment = Appointment.load("fileName");
appointment.save("fileName.ics", new AppointmentIcsSaveOptions());
appointment.save("fileName.msg", new AppointmentMsgSaveOptions());
ایجاد یک قرار ملاقات با محتوای HTML
استفاده از هدر X-ALT-DESC در فرمت iCalendar (RFC 5545) یک روش رایج است. این یک ویژگی گسترشیافته است که توصیف خواندنی انسانی جایگزینی برای یک مورد یا رویداد تقویم فراهم میکند. این هدر اغلب برای گنجاندن یک نمایش متنی ساده یا HTML از توصیف رویداد استفاده میشود، که میتواند برای سازگاری با نرمافزارهای تقویم قدیمی یا فراهم کردن نسخه سادهسازیشدهی توصیف مفید باشد. در مواردی که توصیف اصلی توسط برنامه تقویم دریافتکننده پشتیبانی یا بهدرستی نمایش داده نمیشود، هدر X-ALT-DESC برای ارائه توصیف جایگزین رویداد به کار میرود. این امکان به فرستنده میدهد تا نمایانسازیهای مختلفی از توصیف رویداد را بگنجاند تا سازگاری و دسترسی بهتر در میان نرمافزارها و پلتفرمهای تقویم مختلف تضمین شود. برای ایجاد یک قرار ملاقات با محتوای HTML، تنظیم کنید HtmlDescription ویژگی را به ’true’ تنظیم کنید. نمونه کد زیر را امتحان کنید که نشان میدهد چگونه یک شیء قرار ملاقات را با جزئیات و تنظیمات خاص ایجاد و تعریف کنید، شامل تاریخ، زمان، مکان، تنظیمکننده، شرکتکنندگان، و توصیف قالببندیشده:
Date startDate = new Date();
Appointment appointment = new Appointment("Bygget 83",
startDate, // start date
addHours(startDate, 1), // end date
new MailAddress("TintinStrom@from.com", "Tintin Strom"), // organizer
MailAddressCollection.to_MailAddressCollection(
new MailAddress("AinaMartensson@to.com", "Aina Martensson"))); // attendee
appointment.setHtmlDescription("<html>\n"
+ " <style type=\"\"text/css\"\">\n"
+ " .text {\n"
+ " font-family:'Comic Sans MS';\n"
+ " font-size:16px;\n"
+ " }\n"
+ " </style>\n"
+ " <body>\n"
+ " <p class=\"\"text\"\">Hi, I'm happy to invite you to our party.</p>\n"
+ " </body>\n"
+ " </html>");
ایجاد درخواست قرار ملاقات پیشنویس
برای ذخیره یک قرار ملاقات در حالت پیشنویس، Method ویژگی Appointment کلاس باید به Publish تنظیم شود. نمونه کد زیر استفاده از این ویژگی را به عنوان مثال نشان میدهد.
ایجاد پیشنویس قرار ملاقات از متن
افزودن و حذف پیوستها از آیتمهای تقویم
Aspose.Email یک مجموعه پیوستها ارائه میدهد که میتواند برای افزودن و بازیابی پیوستهای مرتبط با آیتمهای تقویم استفاده شود. این مقاله نشان میدهد چگونه:
- ایجاد و افزودن پیوستها به یک Appointment شیء کلاس.
- دریافت اطلاعات پیوستها از یک قرار ملاقات.
- استخراج پیوستها از یک قرار ملاقات.
قالببندی قرار ملاقاتها
نمونههای برنامهنویسی زیر نشان میدهند چگونه از AppointmentFormattingOptions کلاس برای قالببندی متن و HTML.
نمونه برنامهنویسی - قالببندی متن
نمونه برنامهنویسی - قالببندی HTML
خواندن چندین رویداد از فایل ICS
نوشتن چندین رویداد در فایل ICS
تنظیم وضعیت شرکتکنندگان برای شرکتکنندگان قرار ملاقات
API Aspose.Email برای .NET به شما امکان میدهد وضعیت شرکتکنندگان قرار ملاقات را هنگام تنظیم پیام پاسخ تعیین کنید. این کار ویژگی PARTSTAT را به فایل ICS اضافه میکند.
سفارشیسازی شناسه محصول برای iCalendar
API Aspose.Email برای Java امکان دریافت یا تنظیم شناسه محصولی که شیء iCalendar را ایجاد کرده است، فراهم میکند.
چگونگی دور زدن اعتبارسنجی آدرس هنگام تلاش برای بارگذاری قرار ملاقاتها
API Aspose.Email برای Java امکان دور زدن خطای اعتبارسنجی ایمیل را با تنظیم IgnoreSmtpAddressCheck گزینه در AppointmentLoadOptions شیء و عبور آن به فراخوانی load.
AppointmentLoadOptions lo = new AppointmentLoadOptions();
lo.setIgnoreSmtpAddressCheck(true);
Appointment appointment = Appointment.load("app.ics", lo);