עבודה עם פריטי יומן של Outlook

עבודה עם MapiCalendar

מחלקת MapiCalendar של Aspose.Email מספקת מתודות ותכונות לקביעת מאפיינים שונים של פריט לוח שנה.

יצירה ושמירת פריטי לוח שנה

קטע הקוד הבא מציג איך ליצור ולשמור פריט יומן בפורמט 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:

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 בעזרת שמירה מתודה והפורמט הקובץ המתאים.

  • כדי לקבל קבצים מצורפים מפגישה, היא נטענת תחילה מהקובץ השמור בעזרת טעינה במתודה, מספר הקבצים המצורפים ב‑"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. דוגמת הקוד הבאה מציגה כיצד לשמור על גוף 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