Управление элементами календаря Outlook

Этот MapiCalendar класс в библиотеке Aspose.Email предоставляет различные методы и свойства для настройки и управления элементами календаря. Это позволяет эффективно управлять элементами календаря Outlook, повышая продуктивность и организацию. Ниже представлены разделы, которые проведут вас через различные аспекты управления элементами календаря.

Создание и сохранение элементов календаря

Создать и сохранить элементы календаря

Следующий фрагмент кода демонстрирует, как создать и сохранить элемент календаря в формате ICS:

Укажите путь, где будет сохранён ваш файл календаря.
Создайте встречу, инициализировав новый MapiCalendar объект с конкретными деталями, такими как место, тема, описание, время начала и окончания.
Сохраните созданную встречу в файл формата ICS в указанном каталоге.

import aspose.email as ae
from datetime import datetime

data_dir = "path/to/data/directory"

# Create the appointment
calendar = ae.mapi.MapiCalendar(
    "LAKE ARGYLE WA 6743",
    "Appointment",
    "This is a very important meeting :)",
    datetime(2012, 4, 1),
    datetime(2012, 5, 1))

calendar.save(data_dir + "CalendarItem_out.ics", ae.calendar.AppointmentSaveFormat.ICS)

Сохранить элементы календаря как MSG

Следующий фрагмент кода показывает, как сохранить элемент календаря в формате MSG:

Установить идентификатор продукта при конвертации MapiCalendar в ICS

Библиотека Aspose.Email позволяет сохранить MapiCalendar (элемент календаря) в файл формата ICS (iCalendar) с определёнными параметрами. Следующее свойства это позволит сохранить исходные метки даты и времени, связанные с элементом календаря, и установить идентификатор продукта в файле ICS, например, "Foo Ltd", соответственно:

ics_save_options.keep_original_date_time_stamp
ics_save_options.product_identifier

Идентификатор продукта — это поле, указывающее программное обеспечение или сервис, сгенерировавший файл ICS.

Вот пример кода, который позволяет задать идентификатор продукта при сохранении MapiCalendar в формат ICS:

import aspose.email as ae
from datetime import datetime

mapi_calendar = ae.mapi.MapiCalendar(
    "LAKE ARGYLE WA 6743",
    "Appointment",
    "This is a very important meeting :)",
    datetime(2024, 4, 1),
    datetime(2024, 4, 2))

ics_save_options = ae.mapi.MapiCalendarIcsSaveOptions()
ics_save_options.keep_original_date_time_stamp = True
ics_save_options.product_identifier = "Foo Ltd"

mapi_calendar.save("my.ics", ics_save_options)

Подсчитать общее количество событий календаря

Этот CalendarReader класс предоставляет возможность читать и анализировать данные календаря из указанного файла. Инициализируя объект CalendarReader, вы можете извлечь важные детали, такие как общее количество событий, версия календаря, используемый метод и наличие нескольких событий в календаре. Ниже приведён фрагмент кода, демонстрирующий работу с данными календаря и загрузку встреч в виде полного списка событий:

import aspose.email as ae

reader = ae.calendar.CalendarReader("calendar.ics")
print(f"Calendar contains {reader.count} events")
print(f"The Version of the calendar is {reader.version}")
print(f"The Method of the calendar is {reader.method}")
print(f"Is calendar contains contains multiple events? - {reader.is_multi_events}")
appointments = reader.load_as_multiple()

Добавить визуальные напоминания к элементам календаря

Следующий фрагмент кода показывает, как добавить визуальное напоминание в календарь.

Добавить аудио‑напоминания к элементам календаря

Следующий фрагмент кода показывает, как добавить аудио‑напоминание в календарь.

Явно установить состояние MapiCalendar

Aspose.Email предоставляет метод для явного определения состояния объекта MapiCalendar, переопределяя поведение по умолчанию:

void MapiCalendar.set_state_forced(MapiCalendarState state) - предоставляет больший контроль над состоянием элемента календаря, особенно при работе с полученными запросами на встречу.

Когда объект MapiCalendar создаётся, ему автоматически присваивается состояние MapiCalendarState.MEETING. Когда элемент получен получателем, состояние обычно меняется на MapiCalendarState.RECEIVED, и класс сообщения обновляется на "IPM.Schedule.Meeting.Request".

Следующий пример кода демонстрирует, как создать встречу с помощью Aspose.Email для Python через .NET, вручную установить организатора и состояние календаря, и сохранить встречу в файл Outlook .msg:

from aspose.email.mapi import MapiCalendar, MapiCalendarState, MapiElectronicAddress
from aspose.email.calendar import AppointmentSaveFormat
from datetime import datetime, timezone

# Create a MapiCalendar appointment
appointment = MapiCalendar(
    "LAKE ARGYLE WA 6743",                     # Location
    "Appointment",                             # Subject
    "This is a very important meeting :)",     # Body
    datetime(2024, 5, 10, 12, 30, 0, tzinfo=timezone.utc),  # Start time (UTC)
    datetime(2024, 5, 10, 13, 30, 0, tzinfo=timezone.utc)   # End time (UTC)
)

# Set the organizer
appointment.organizer = MapiElectronicAddress()
appointment.organizer.email_address = "test@aaa.com"
appointment.organizer.display_name = "test display Name"

# Forcefully set the calendar state to Meeting | Received
appointment.set_state_forced(MapiCalendarState.MEETING | MapiCalendarState.RECEIVED)

# Save the appointment to a .msg file
appointment.save("appointment.msg", AppointmentSaveFormat.MSG)

Вызвав set_state_forced, вы можете вручную установить состояние элемента календаря на конкретное значение (например, MapiCalendarState.RECEIVED). Это особенно полезно, когда вы хотите:

Смоделировать полученный запрос на встречу.
Сохраните метаданные организатора и встречи при сохранении встречи в файл .MSG.
Настройте рабочие процессы календаря, когда стандартное поведение недостаточно.

Примечание: Ручная установка состояния с помощью set_state_forced может влиять на поведение Outlook, например, на возможность пересылать или повторно отправлять встречу. Поэтому использовать его следует осторожно и только в случае необходимости для логики вашего приложения.

Управление файлами календаря

Добавить или получить вложения из файлов календаря

Модуль Aspose.Email Calendar ("ae.calendar") также предоставляет возможность добавлять и получать информацию о вложениях.

Чтобы добавить вложение к встрече, выполните следующие шаги:

Создайте Attachment объект, предоставляющий путь к файлу.
Добавьте это вложение в список вложений встречи.
Сохраните встречу в указанный путь в формате iCalendar, используя сохранением метод и соответствующий формат файла.

Чтобы получить вложения из встречи, выполните следующие шаги:

Загрузите встречу из сохранённого файла, используя загрузка метод.
Получите количество вложений в встрече, используя свойство .attachments.length.
Итерировать каждый вложенный файл.
Выведите имя каждого вложения, используя свойство .name внутри цикла.

Приведённый ниже фрагмент кода демонстрирует, как создавать встречи с вложениями, сохранять их и получать информацию о вложениях с помощью модуля "ae.calendar". Он подчёркивает функциональность и возможности работы с встречами и вложениями в приложении календаря.

import aspose.email as ae
import datetime as dt

# Add an attachment to an appointment
attendees = ae.MailAddressCollection()
attendees.append(ae.MailAddress("attendee@domain.com", "Recipient 1"))

appointment = ae.calendar.Appointment("Room 112", dt.datetime(2023, 5, 27), dt.date(2023, 5, 28),  ae.MailAddress("organizer@domain.com"), attendees)

attachment = ae.Attachment("D:\\Aspose\\Files\\Attachment.txt")
appointment.attachments.append(attachment)

appointment.save("D:\\Aspose\\Files\\appWithAttachments_out.ics", ae.calendar.AppointmentSaveFormat.ICS)

# Retrieve attachments from an appointment 
appointment2 = ae.calendar.Appointment.load("D:\\Aspose\\Files\\appWithAttachments_out.ics")
print(appointment2.attachments.length)
for att in appointment2.attachments:
    print(att.name)

Получить статус получателя из запросов на встречу

Aspose.Email позволяет работать с запросами на встречу, представленными объектом MapiCalendar, и получать статус получателя (отслеживание присутствия) из таких запросов. Следующий фрагмент кода показывает, как определить статус письма для каждого получателя:

Конвертировать встречи из EML в MSG с сохранением HTML‑тела

Aspose.Email позволяет конвертировать встречу из EML в MSG и сохранять HTML‑тело. Свойство forced_rtf_body_for_appointment класса MapiConversionOptions класс используется для управления типом тела встречи. При установке в True тело по умолчанию преобразуется в формат RTF. Чтобы сохранить тело в формате HTML, необходимо установить False. Следующий пример кода показывает, как сохранить HTML‑тело встречи при преобразовании из EML в MSG:

import aspose.email as ae

eml = ae.MailMessage.load("appointment.eml")

conversionOptions = ae.mapi.MapiConversionOptions()
conversionOptions.format = ae.mapi.OutlookMessageFormat.UNICODE
# default value for ForcedRtfBodyForAppointment is true
conversionOptions.forced_rtf_body_for_appointment = False

msg = ae.mapi.MapiMessage.from_mail_message(eml, conversionOptions)

print(f"Body Type: {msg.body_type}")

msg.save("appointment.msg")

Управление последующей обработкой и сроками в файлах Outlook MSG с помощью Python Управление контактами Outlook в PST-файлах