Робота з зустрічами

Завантажити та зберегти зустріч у форматі ICS

The Appointment Клас у Aspose.Email for Java можна використати для завантаження зустрічі у форматі ICS, а також для створення нової зустрічі та збереження її на диск у форматі ICS. У цій статті спочатку створюємо зустріч і зберігаємо її на диск у форматі ICS, а потім завантажуємо її.

Завантажити зустріч у форматі ICS

Щоб завантажити зустріч у форматі ICS, необхідно виконати наступні кроки:

  1. Створіть екземпляр Appointment клас.
  2. Викличте Load() метод, вказавши шлях до файлу 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 для .NET API дозволяє встановлювати статус учасників зустрічі під час формування відповіді. Це додає властивість PARTSTAT до файлу ICS.

Налаштування ідентифікатора продукту для iCalendar

Aspose.Email for Java API дозволяє отримати або встановити ідентифікатор продукту, який створив об’єкт iCalendar.

Як обійти валідацію адреси під час завантаження зустрічей

Aspose.Email for Java API дозволяє обійти помилку валідації електронної пошти, встановивши IgnoreSmtpAddressCheck опція на AppointmentLoadOptions об’єкт і передачу його у виклик load.

AppointmentLoadOptions lo = new AppointmentLoadOptions();
lo.setIgnoreSmtpAddressCheck(true);
Appointment appointment = Appointment.load("app.ics", lo);