使用 Outlook 日历项目

使用 MapiCalendar

Aspose.Email 的 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_save_options.keep_original_date_time_stamp 和 ics_save_options.product_identifier 属性，您可以保留日历项的原始日期时间戳，并在 ICS 文件中设置产品标识符，例如设置为 "Foo Ltd"。产品标识符用于标识生成该 ICS 文件的软件或服务。

以下代码示例演示了在将 MapiCalendar 保存为 ICS 时设置产品 ID：

import aspose.email as ae

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

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

获取事件总数

该功能 CalendarReader 类允许您从指定文件读取日历数据。通过创建 CalendarReader 对象，我们可以提取重要信息，如事件总数、日历版本、使用的方法以及日历是否包含多个事件。以下代码片段演示如何处理日历数据，并将日历中的约会加载为多个事件的列表。

import aspose.email as ae

reader = ae.calendar.CalendarReader(fileName)
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()

向日历添加显示提醒

以下代码片段演示了如何向日历添加显示提醒。

向日历添加音频提醒

以下代码片段展示了如何向日历添加音频提醒。

添加/检索日历文件中的附件

Aspose.Email Calendar（"ae.calendar"）模块还提供添加和检索附件信息的功能。

要在约会中添加附件，创建一个提供文件路径的 "Attachment" 对象。然后将该附件追加到约会的附件列表中。使用该方法将约会保存为 iCalendar 格式到指定文件路径。保存方法以及适当的文件格式。
要检索约会的附件，首先使用该方法从保存的文件中加载约会。 load 该方法显示 "appointment2" 中的附件数量，并遍历附件打印其名称。

以下代码片段演示了如何使用 "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)

会议请求中收件人的状态

以下代码片段展示如何获取会议请求中收件人的状态。

将 EML 约会转换为 MSG 并保留 HTML 格式正文

Aspose.Email 可以将 EML 约会转换为 MSG 并保留 HTML 正文。该类的 "forced_rtf_body_for_appointment" 属性用于 MapiConversionOptions 该类用于操作约会正文的类型。当设置为 True 时，正文默认会转换为 RTF 格式。要保留正文为 HTML 格式，应设置为 False。以下代码示例展示了在将 EML 转换为 MSG 时如何保留约会的 HTML 正文：

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 联系人