Работа с встречами

Загрузка и сохранение встречи в формате ICS

Этот 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 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