العمل مع المواعيد

تحميل وحفظ موعد بتنسيق ICS

الـ Appointment يمكن استخدام الفئة في Aspose.Email for Java لتحميل موعد بتنسيق ICS وكذلك لإنشاء موعد جديد وحفظه على القرص بتنسيق ICS. في هذه المقالة، نقوم أولاً بإنشاء موعد وحفظه على القرص بتنسيق ICS ثم نقوم بتحميله.

تحميل موعد بتنسيق ICS

لتحميل موعد بتنسيق ICS، يلزم اتباع الخطوات التالية:

  1. إنشاء مثيل من الـ Appointment فئة.
  2. استدعِ الـ Load() method عن طريق توفير مسار ملف ICS.
  3. قراءة أي خاصية للحصول على أي معلومات من الموعد (ملف ICS).

تُظهر مقاطع الشيفرة التالية كيفية تحميل موعد بصيغة ICS.

إنشاء موعد وحفظه على القرص بتنسيق ICS

الخطوات التالية مطلوبة لإنشاء موعد وحفظه بتنسيق ICS.

  1. إنشاء مثيل من الـ Appointment الفئة وتهيئتها باستخدام هذا المُنشئ.
  2. مرّر المتغيّرات التالية في المُنشئ أعلاه
    1. الحضور
    2. الوصف
    3. تاريخ الانتهاء
    4. الموقع
    5. المنظم
    6. تاريخ البدء
    7. الملخص
    8. تاريخ الإنشاء
    9. تاريخ آخر تعديل 
  3. استدعِ الـ 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 مجموعة مرفقات يمكن استخدامها لإضافة واسترجاع المرفقات المرتبطة بعناصر التقويم. تُظهر هذه المقالة كيفية:

  1. إنشاء وإضافة مرفقات إلى Appointment كائن الفئة.
  2. استرجاع معلومات المرفقات من موعد.
  3. استخراج المرفقات من موعد.

تنسيق المواعيد

تُظهر عينات البرمجة أدناه كيفية استخدام الـ AppointmentFormattingOptions فئة لتنسيق النص وHTML.

عينة برمجية - تنسيق النص

عينة برمجية - تنسيق HTML

قراءة أحداث متعددة من ملف ICS

كتابة أحداث متعددة إلى ملف ICS

تحديد حالة المشاركين من حضور الموعد

تتيح Aspose.Email for .NET API تعيين حالة حضور المواعيد أثناء صياغة رسالة رد. يضيف ذلك خاصية PARTSTAT إلى ملف ICS.

تخصيص معرف المنتج لـ iCalendar

تتيح Aspose.Email for Java API الحصول على معرف المنتج الذي أنشأ كائن iCalendar أو ضبطه.

كيفية تجاوز التحقق من العنوان عند محاولة تحميل مواعيد

تتيح Aspose.Email for Java API تجاوز خطأ التحقق من صحة البريد الإلكتروني عن طريق ضبط الـ IgnoreSmtpAddressCheck خيار على AppointmentLoadOptions الكائن وتمريره إلى استدعاء التحميل.

AppointmentLoadOptions lo = new AppointmentLoadOptions();
lo.setIgnoreSmtpAddressCheck(true);
Appointment appointment = Appointment.load("app.ics", lo);
العمل مع رسائل MIME العمل مع عناصر Outlook