Documentation – Робота з елементами Outlook

Python-Net: Створення та збереження MSG файлів

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email підтримує створення файлів Outlook message (MSG). У цій статті пояснюється, як:

Створити повідомлення MSG.
Створити повідомлення MSG з вкладеннями.
Створіть повідомлення MSG з RTF‑тілом.
Зберегти повідомлення як чернетку.
Робота зі стисканням тіла.

Створення та збереження повідомлень Outlook

Клас MailMessage має метод Save(), який може зберігати файли Outlook MSG на диск або у потік. Наведені нижче фрагменти коду створюють екземпляр класу MailMessage, встановлюють властивості From, To, Subject та Body. Метод Save() приймає ім’я файлу як аргумент. Крім того, повідомлення Outlook можна створювати зі стислим RTF‑тілом за допомогою MapiConversionOptions. Щоб налаштувати, створіть новий Windows‑додаток і додайте посилання на бібліотеку Aspose.Email у проєкт.

Створіть новий екземпляр класу MailMessage та встановіть властивості From, To, Subject і Body.
Викличте метод FromMailMessage класу MailMessage, який приймає об’єкт типу MailMessage. Метод FromMailMessage() перетворює MailMessage у MailMessage (MSG).
Викличте метод MapiMessage.Save() для збереження файлу MSG.

Напишіть наступний код у обробнику події кліку кнопки у Windows‑додатку.

Створення файлів MSG з вкладеннями

У наведеному вище прикладі ми створили простий файл MSG. Aspose.Email також підтримує збереження повідомлень з вкладеннями. Все, що потрібно зробити — додати вкладення до екземпляра MailMessage. Додайте вкладення, викликавши метод Add() у колекції MailMessage.Attachments. Додайте listbox до форми, створеної вище, та два кнопки — одну для додавання і одну для видалення вкладень. Додаток, який додає вкладення, працює так:

Коли натискається кнопка Add Attachment, відображається Open File Dialog, який допомагає користувачам переглядати та вибирати вкладення.
Після вибору файлу його повний шлях додається до списку.
Коли створюється файл MSG, шляхи до вкладень беруться зі списку і додаються до колекції MailMessage.Attachments.

Напишіть наступний код у обробнику події кліку кнопки Add Attachment.

Додайте код для додавання вкладень до екземпляра MailMessage. Остаточний код функції Write Msg виглядає наступним чином.

Створення файлів MSG з тілом RTF

Ви також можете створювати файли Outlook Message (MSG) з тілом у форматі RTF за допомогою Aspose.Email. Тіло RTF підтримує форматування тексту. Створіть його, встановивши властивість MailMessage.HtmlBody. При конвертації екземпляра MailMessage у інший MailMessage, HTML‑тіло перетворюється в RTF. Таким чином, форматування тіла листа зберігається.

Наступний приклад створює файл MSG з тілом у форматі RTF. У HTML‑тілі є один заголовок, застосовано форматування жирним та підкресленим. Це форматування зберігається під час конвертації HTML у RTF.

Збереження повідомлення у статусі чернетки

Листи зберігаються як чернетки, коли їх почали редагувати, але планують повернутися до завершення пізніше. Aspose.Email підтримує збереження електронного листа у статусі чернетки шляхом встановлення прапорця повідомлення. Нижче наведено приклад коду для збереження листа Outlook (MSG) як чернетки.

Наслідки стискання тіла

Метод стискання RTF‑тіла можна використовувати для створення меншого за розміром MSG. Однак це знижує швидкість. Щоб створювати повідомлення швидше, встановіть прапорець у false. Цей прапорець, у свою чергу, впливає на створені PST: менші файли MSG призводять до менших PST, а великі файли MSG — до повільнішого створення PST.

Python-Net: Завантаження, перегляд та розбір файлу MSG

Mon, 01 Jan 0001 00:00:00 +0000

У цій темі пояснюється, як завантажити файл повідомлення Microsoft Outlook (*.msg). The MapiMessage Клас використовується для завантаження MSG файлів і надає кілька статичних функцій завантаження для різних сценаріїв. Нижче наведено фрагмент коду, який показує, як завантажити MSG файли з файлу або потоку.

Спробуйте!

Парсинг електронних файлів онлайн безкоштовно Додаток Aspose.Email Parser.

Завантаження файлів MSG

Нижче наведено фрагмент коду, який показує, як завантажити файли MSG.

from aspose.email.mapi import MapiMessage

# Create an instance of MapiMessage from file
msg = MapiMessage.from_file("message.msg")

# Get subject
print("Subject: " + msg.subject)

# Get from address
print("From: " + msg.sender_email_address)

# Get body
print("Body: " + msg.body)

# Get recipients information
recipients = ", ".join([r.email_address for r in msg.recipients])
print("Recipients: " + recipients)

# Get attachments
for att in msg.attachments:
    print(att.file_name)
    print(att.display_name)

Завантаження з потоку

Нижче наведено фрагмент коду, який показує, як завантажити файл з потоку.

from aspose.email.mapi import MapiMessage
import io

# Read the file into a byte array
file_path = dir_path + "message.msg"
with open(file_path, "rb") as file:
    bytes_data = file.read()

# Create a memory stream from the byte array
stream = io.BytesIO(bytes_data)
stream.seek(0)

# Create an instance of MapiMessage from the stream
msg = MapiMessage.from_stream(stream)

# Get subject
print("Subject: " + msg.subject)

# Get from address
print("From: " + msg.sender_email_address)

# Get body
print("Body: " + msg.body)

Конвертація EML у MSG з збереженням формату вбудованих EML

Файли EML можна завантажити в MapiMessage клас шляхом створення MailMessage Об’єкт і передати його до методу MapiMessage.from_mail_message. Якщо EML файл містить вбудовані EML файли, використовуйте MapiConversionOptions.PreserveEmbeddedMessageFormat, щоб зберегти формат вбудованих EML файлів. Нижчевказаний фрагмент коду показує, як завантажити EML файли у MapiMessage, зберігаючи формат вбудованих EML файлів.

from aspose.email import MailMessage, EmlLoadOptions
from aspose.email.mapi import MapiMessage, MapiConversionOptions, OutlookMessageFormat

eml_file = dir_path + "message.eml"

# Load the EML file
eml_options = EmlLoadOptions()
eml = MailMessage.load(eml_file, eml_options)

# Create MapiConversionOptions
conversion_options = MapiConversionOptions()
conversion_options.format = OutlookMessageFormat.UNICODE

# Preserve Embedded Message Format
conversion_options.preserve_embedded_message_format = True

# Convert EML to MSG with options
msg = MapiMessage.from_mail_message(eml, conversion_options)

Python-Net: Керування файлами повідомлень за допомогою Aspose.Email.Outlook

Mon, 01 Jan 0001 00:00:00 +0000

Визначення типу елемента MAPI у PST папці

Файл PST зазвичай містить різні типи даних, такі як електронні листи, події календаря, контакти тощо. MapiItemType клас Aspose.Email дозволяє отримувати доступ та категоризувати різні типи елементів MAPI у файлі PST. Нижчий код демонструє, як визначити тип елемента MAPI у папці PST:

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file("test.pst")
folder = pst.root_folder.get_sub_folder("Calendar")
for messageInfo in folder.enumerate_messages():
    msg = pst.extract_message(messageInfo)

    # Get the class type based on msg.SupportedType
    item_type = msg.supported_type

    # Non-supported type. It cannot be accessed as appropriate item type.
    if item_type == ae.mapi.MapiItemType.NONE:
        print("Item type not supported")
    # An email message.
    elif item_type == ae.mapi.MapiItemType.MESSAGE:
        # You can access to MapiMessage properties there.
        # A subject for example
        print(msg.subject)
    # A contact item. Can be accessed as MapiContact.
    elif item_type == ae.mapi.MapiItemType.CONTACT:
        contact = msg.to_mapi_message_item()
        # You can access to MapiContact properties there. 
        # A name_info.display_name for example. 
        print(contact.name_info.display_name)
    # A calendar item. Can be accessed as MapiCalendar.
    elif item_type == ae.mapi.MapiItemType.CALENDAR:
        calendar = msg.to_mapi_message_item()
        # You can access to MapiCalendar properties there. 
        # A location for example. 
        print(calendar.location)
    # A distribution list. Can be accessed as MapiDistributionList.
    elif item_type == ae.mapi.MapiItemType.DIST_LIST:
        dlist = msg.to_mapi_message_item()
        # You can access to MapiDistributionList properties there
    # A Journal entry. Can be accessed as MapiJournal.
    elif item_type == ae.mapi.MapiItemType.JOURNAL:
        journal = msg.to_mapi_message_item()
        # You can access to MapiJournal properties there
    # A StickyNote. Can be accessed as MapiNote.
    elif item_type == ae.mapi.MapiItemType.NOTE:
        note = msg.to_mapi_message_item()
        # You can access to MapiNote properties there
    # A Task item. Can be accessed as MapiTask.
    elif item_type == ae.mapi.MapiItemType.TASK:
        task = msg.to_mapi_message_item()
        # You can access to MapiTask properties there

Конвертація MSG у MIME‑повідомлення

API Aspose.Email забезпечує можливість конвертувати файл MSG у MIME‑повідомлення за допомогою методу ToMailMessage.

Встановлення тайм‑аута для конвертації та завантаження повідомлення

Щоб обмежити час у мілісекундах конвертації повідомлення (значення за замовчуванням 3 сек), властивість timeout класу MailConversionOptions використовується клас.

Ось як можна встановити тайм-аут для процесів конвертації та завантаження повідомлень:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("my.msg")
options = ae.mapi.MailConversionOptions()
options.timeout = 5000
mailMessage = msg.to_mail_message(options)

Встановивши тайм-аут для процесів конвертації та завантаження повідомлень, ви можете контролювати максимальний час, протягом якого ці операції можуть виконуватися. Після встановлення тайм-ауту ви можете продовжити процеси конвертації та завантаження повідомлень.

Обробка файлів Outlook Template (OFT)

Завантажити, змінити та зберегти файл OFT

Шаблони Outlook (OFT) пропонують зручний спосіб спростити процес надсилання повторюваних електронних листів. Замість того, щоб щоразу створювати один і той самий лист з нуля, ви можете створити повідомлення в Outlook і зберегти його як шаблон Outlook (OFT). Пізніше, коли потрібно надіслати подібне повідомлення, ви можете швидко згенерувати його з шаблону. Такий підхід економить ваш час на повторне написання того ж вмісту в тілі листа, вказання теми, форматування тощо.

Aspose.Email MailMessage клас надає потужний інструмент для завантаження та маніпуляції файлами шаблонів Outlook (OFT). Після завантаження шаблону Outlook в екземпляр класу MailMessage, ви можете легко оновлювати властивості, такі як відправник, одержувач, тіло повідомлення, тема та інші атрибути.

import aspose.email as ae

# Load the OFT file
oft_file_path = "your_template.oft"
mail_message = ae.MailMessage.load(oft_file_path)

# Update properties as needed
mail_message.subject = "Updated Subject"
mail_message.body = "Updated body text."

# Save the updated message as an MSG file
msg_file_path = "updated_message.msg"
mail_message.save(msg_file_path, ae.MailMessageSaveType.outlook_message_format_unicode)

print(f"Updated message saved to {msg_file_path}")

Після внесення необхідних оновлень ви можете надіслати лист, використовуючи SmtpClient клас:

# Send the email
smtpClient.send(message)

Збереження файлу Outlook MSG як шаблону

Для цього ви можете використати MailMessage клас для створення електронного листа, а потім його збереження у файл OFT. Наведений приклад коду покаже, як зберегти лист у шаблон Outlook:

import aspose.email as ae

# Create a new MailMessage
message = ae.MailMessage()
message.subject = "Sample Outlook Template"
message.html_body = "<html><body>This is the body of the email.</body></html>"
message.from_address = ae.MailAddress("your.email@example.com", "Your Name")

# Save the MailMessage as an Outlook Template (OFT) file
oft_file_path = "sample_template.oft"
message.save(oft_file_path, ae.SaveOptions.default_oft)

print(f"Outlook Template saved as {oft_file_path}")

OFT або MSG: визначення типу MapiMessage

Наступний фрагмент коду ілюструє, як визначити, чи завантажене MAPI‑повідомлення представляє стандартний електронний лист чи шаблон Outlook (OFT):

msg = ae.mapi.MapiMessage.Load("message.msg");
isOft = msg.is_template # returns false

msg = ae.mapi.MapiMessage.Load("message.oft");
isOft = msg.IsTemplate; # returns true

Після завантаження файлу MSG код перевіряє, чи властивість is_template у MapiMessaage клас повертає True або False. Якщо повертає false, завантажене повідомлення є стандартним електронним листом, а не шаблоном Outlook; якщо повертає true, це не стандартне повідомлення, а шаблон Outlook.

Збереження MapiMessage або MailMessage у форматі OFT

The SaveOptions це абстрактний базовий клас для класів, які дозволяють користувачеві задавати додаткові параметри при збереженні MailMessage у певному форматі. Наведений приклад коду демонструє, як зберегти повідомлення у формат OFT:

import aspose.email as ae

# Save the MailMessage to OFT format
eml = ae.MailMessage.load("message.eml")

eml.save("message.oft", ae.SaveOptions.default_oft)

# or alternative way 2
save_options = ae.MsgSaveOptions(ae.MailMessageSaveType.outlook_template_format)
eml.save("message.oft", save_options)

# or alternative way 3
save_options = ae.SaveOptions.create_save_options(ae.MailMessageSaveType.outlook_template_format)
eml.save("message.oft", save_options)

# Save the MapiMessage to OFT format
msg = ae.mapi.MapiMessage.load("message.msg")

msg.save("message.oft", ae.SaveOptions.default_oft)

# or alternative way 2
save_options = ae.MsgSaveOptions(ae.MailMessageSaveType.outlook_template_format)
msg.save("message.oft", save_options)

# or alternative way 3
save_options = ae.SaveOptions.create_save_options(ae.MailMessageSaveType.outlook_template_format)
msg.save("message.oft", save_options)

Керування повідомленнями з цифровими підписами

Бібліотека надає LoadOptions клас, абстрактний базовий клас для класів, які дозволяють користувачеві задавати додаткові параметри при завантаженні MailMessage з певного формату. Параметр збереження підпису встановлюється за замовчуванням.

Конвертація з EML у MSG з збереженням підпису

Нижче наведений приклад коду демонструє, як завантажити повідомлення, конвертувати його у формат MSG та зберегти як MSG (підпис зберігається за замовчуванням):


import aspose.email as ae

# Load mail message
loadOptions = ae.EmlLoadOptions()
message = ae.MailMessage.load("Message.eml", loadOptions)
# Save as MSG
message.save("ConvertEMLToMSG_out.msg", ae.SaveOptions.default_msg_unicode)

Конвертувати S/MIME повідомлення з MSG у EML

Aspose.Email дозволяє конвертувати з MSG у EML, зберігаючи цифровий підпис, як показано у наступному фрагменті коду.

import aspose.email as ae

# Load mail message
loadOptions = ae.EmlLoadOptions()
smime_eml = ae.MailMessage.load("smime.eml", loadOptions)

conversion_options = ae.mapi.MapiConversionOptions(ae.mapi.OutlookMessageFormat.UNICODE)
msg = ae.mapi.MapiMessage.from_mail_message(smime_eml, conversion_options)
# Save File to disk
msg.save("ConvertMIMEMessagesFromMSGToEML_out.msg")

Встановлення колірної категорії для Outlook MSG файлів

Іноді вам може знадобитися розрізняти електронні листи особливої важливості та візуально їх організовувати. Бібліотека забезпечує спосіб зробити це, призначаючи певний колір елементу повідомлення. Коли ви встановлюєте колірну категорію для елементу, це дозволяє легко ідентифікувати та знаходити пов’язані елементи з першого погляду. Використовуйте FollowUpManager клас для встановлення кольорової категорії повідомлення, як у наведеному прикладі коду:


import aspose.email as ae

msg = ae.mapi.MapiMessage.load("my.msg")

# Add Two categories
ae.mapi.FollowUpManager.add_category(msg, "Purple Category")
ae.mapi.FollowUpManager.add_category(msg, "Red Category")

# Retrieve the list of available categories
categories = ae.mapi.FollowUpManager.get_categories(msg)

# Remove the specified category and then Clear all categories
ae.mapi.FollowUpManager.remove_category(msg, "Red Category")
ae.mapi.FollowUpManager.clear_categories(msg)

Отримання інформації про подальші дії з файлу MSG

Витяг інформації про прочитання та підтвердження доставки

Нижче наведений приклад коду демонструє, як витягти інформацію про одержувачів та їх статус відстеження з Outlook повідомлення (MSG) файлу:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("received.msg")

for recipient in msg.recipients:
    print(f"Recipient: {recipient.display_name}")
    print(f"Delivery time:  {recipient.properties[ae.mapi.MapiPropertyTag.RECIPIENT_TRACKSTATUS_TIME_DELIVERY]}")
    print(f"Read time:  {recipient.properties[ae.mapi.MapiPropertyTag.RECIPIENT_TRACKSTATUS_TIME_READ]}")

Створення листів Forward та Reply

Aspose.Email надає прості способи створювати повідомлення переадресації та відповіді на основі існуючих.

Створення листа‑перенаправлення

Ви можете використати ForwardMessageBuilder клас для створення повідомлення пересилання, встановлюючи вихідне повідомлення, відправника, отримувачів, тему та тіло. Переслані повідомлення можуть містити оригінальний лист як вкладення або як тіло пересланого листа. Ви маєте гнучкість налаштовувати додаткові властивості, такі як вкладення, заголовки та параметри форматування. Нижче наведено приклад коду, який показує, як створити повідомлення пересилання:


import aspose.email as ae

msg = ae.mapi.MapiMessage.load("original.msg")

builder = ae.tools.ForwardMessageBuilder()
builder.addition_mode = ae.tools.OriginalMessageAdditionMode.TEXTPART

forwardMsg = builder.build_response(msg)
forwardMsg.save("forward_out.msg")

Створення відповіді

The ReplyMessageBuilder клас використовується для налаштування параметрів відповіді, включаючи вихідне повідомлення, відправника, отримувачів, режим відповіді, префікс теми та тіло відповіді. Повідомлення відповіді можна створювати у різних режимах, таких як "Reply to Sender" або "Reply to All", згідно з вашими вимогами. Ви можете налаштувати різні властивості, такі як вкладення, заголовки та параметри форматування відповіді. Нижче наведено приклад коду, який показує, як створити повідомлення пересилання:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("original.msg")

builder = ae.tools.ReplyMessageBuilder()

# Set ReplyMessageBuilder Properties
builder.reply_all = True
builder.addition_mode = ae.tools.OriginalMessageAdditionMode.TEXTPART
builder.response_text = "<p><b>Dear Friend,</b></p> I want to do is introduce my co-author and co-teacher. <p><a href=\"www.google.com\">This is a first link</a></p><p><a href=\"www.google.com\">This is a second link</a></p>";

replyMsg = builder.build_response(msg)
replyMsg.save("reply_out.msg")

Python-Net: Робота зі списками розповсюдження

Mon, 01 Jan 0001 00:00:00 +0000

Можливо створити список розсилки за допомогою Aspose.Email API, який є колекцією кількох контактів. Список розсилки можна зберегти на диск у форматі Outlook MSG і переглянути/обробити, відкривши його в MS Outlook.

Створення та збереження розсилкового списку

Наведений фрагмент коду показує, як створити та зберегти список розповсюдження.

Читання списку розповсюдження з PST

Наведений фрагмент коду показує, як прочитати список розповсюдження з PST‑файлу.

import aspose.email as ae

pst = ae.storage.pst.PersonalStorage.from_file( "your_pst_file.pst")
folder = pst.root_folder.get_sub_folder("Contacts")
for messageInfo in folder.enumerate_messages():
    msg = pst.extract_message(messageInfo)

    dlist = msg.to_mapi_message_item()
    if isinstance(dlist, ae.mapi.MapiDistributionList):
        for member in dlist.members:
            print("Member Display Name:", member.display_name)
            print("Member Email Address:", member.email_address)

Python-Net: Робота з нагадуванням і датою виконання для файлів Outlook MSG

Mon, 01 Jan 0001 00:00:00 +0000

Прапорець follow up позначає електронний лист для певної дії. Microsoft Outlook дозволяє користувачам позначати листи прапорцями та у налаштуваннях прапорця задавати дату виконання (due date) для follow up. Outlook надсилає нагадування отримувачу, щоб спонукати його виконати follow up листа. Програмне встановлення прапорців та дат виконання дозволяє розробникам автоматизувати певні типи листів і допомагати отримувачам пам’ятати про необхідність дії. Наприклад, це може бути використано для надсилання щомісячних повідомлень команді продажу з нагадуванням завершити звіти; або для надсилання повідомлення всім співробітникам з нагадуванням про загальне засідання. Aspose.Email для .NET підтримує встановлення прапорця follow up і дати виконання для об’єктів MapiMessage за допомогою FollowUpManager та FollowUpOptions. Існує кілька варіантів, у яких можна встановити прапорець follow up на повідомлення. Усі вони використані у наведеному нижче прикладі коду:

Встановити прапорець follow up для повідомлення
Додати дату виконання та дату нагадування до повідомлення
Додати мітку до повідомлення одержувача.
Позначити як завершене.
Видалити мітку.
Прочитати параметри follow up.

Встановлення прапорця FollowUp

Нижче наведено фрагмент коду, який показує, як встановити прапорець followUp.

import aspose.email as ae
from datetime import datetime, timedelta

# Create a new MailMessage
mail_msg = ae.MailMessage()
mail_msg.from_address = ae.MailAddress("from@domain.com")
mail_msg.to.append(ae.MailAddress("to@domain.com"))
mail_msg.body = "This message will test if follow-up options can be added to a new MAPI message."

# Convert MailMessage to MapiMessage
mapi = ae.mapi.MapiMessage.from_mail_message(mail_msg)

# Define follow-up options
dt_start_date = datetime(2013, 5, 23, 14, 40, 0)
dt_reminder_date = datetime(2013, 5, 23, 16, 40, 0)
dt_due_date = dt_reminder_date + timedelta(days=1)

options = ae.mapi.FollowUpOptions("Follow Up", dt_start_date, dt_due_date, dt_reminder_date)

# Set follow-up options for the MapiMessage
ae.mapi.FollowUpManager.set_options(mapi, options)

# Save the MapiMessage
mapi.save("SetFollowUpFlag_out.msg")

Встановлення Follow Up для отримувачів

Нижче наведено фрагмент коду, який показує, як встановити follow Up для отримувачів.

import aspose.email as ae
from datetime import datetime

# Create a new MailMessage
mail_msg = ae.MailMessage()
mail_msg.from_address = ae.MailAddress("from@domain.com")
mail_msg.to.append(ae.MailAddress("to@domain.com"))
mail_msg.body = "This message will test if follow-up options can be added to a new MAPI message."

# Convert MailMessage to MapiMessage
mapi = ae.mapi.MapiMessage.from_mail_message(mail_msg)

# Mark the message as draft
mapi.set_message_flags(ae.mapi.MapiMessageFlags.UNSENT)

dt_reminder_date = datetime(2013, 5, 23, 16, 40, 0)

# Add the follow-up flag for recipients
ae.mapi.FollowUpManager.set_flag_for_recipients(mapi, "Follow up", dt_reminder_date)

# Save the MapiMessage
mapi.save("SetFollowUpForRecipients_out.msg")

Позначення прапорця FollowUp як завершеного

Нижче наведено фрагмент коду, який показує, як позначити прапорець followUp як завершений.

import aspose.email as ae

# Load the MapiMessage from file
mapi_message = ae.mapi.MapiMessage.load("Message.msg")

# Mark the message as completed
ae.mapi.FollowUpManager.mark_as_completed(mapi_message)

# Save the updated MapiMessage
mapi_message.save("MarkedCompleted_out.msg")

Видалення прапорця FollowUp

Нижче наведено фрагмент коду, який показує, як видалити прапорець followUp.

import aspose.email as ae

# Load the MapiMessage from file
mapi_message = ae.mapi.MapiMessage.load("message.msg")

# Clear the follow-up flag
ae.mapi.FollowUpManager.clear_flag(mapi_message)

# Save the updated MapiMessage
mapi_message.save("RemoveFollowUpflag_out.msg")

Прочитати параметри прапорця follow-up для повідомлення

Нижче наведено фрагмент коду, який показує, як прочитати параметри прапорця followup для повідомлення.

import aspose.email as ae

# Load the MapiMessage from file
mapi_message = ae.mapi.MapiMessage.load("message.msg")

# Get the follow-up options
options = ae.mapi.FollowUpManager.get_options(mapi_message)

Python-Net: Робота з властивостями MAPI

Mon, 01 Jan 0001 00:00:00 +0000

Доступ та встановлення Outlook MAPI властивості

Клас MapiProperty представляє MAPI властивість, яка містить:

Name: рядок, що представляє назву властивості.
Tag: довге число, що представляє тег властивості.
Data: масив байтів, що представляє дані властивості.

Отримання MAPI властивості за допомогою тега MAPI властивості

Для отримання MAPI властивостей:

Створіть екземпляр MapiMessage, завантаживши його з файлів або потоку.
Отримайте MapiProperty з MapiMessage.Properties за ключами MapiPropertyTag.
Отримайте дані MapiProperty методом GetX.

Нижче наведено фрагмент коду, який показує, як отримати MAPI властивість, використовуючи тег MAPI властивості.

Встановлення MAPI властивостей

Наступний фрагмент коду показує, як встановити властивості MAPI.

де визначення методу convertDateTime таке:

Зчитування іменованих MAPI властивостей з Outlook MSG файлів

Aspose.Email надає набір API для роботи з MSG файлами, включаючи вилучення названих MAPI‑властивостей.

Зчитування іменованих MAPI властивостей з файлу MSG

Щоб прочитати іменовані MAPI властивості, ми можемо використати властивість named_properties. MapiMessage клас. Наведений нижче приклад коду показує, як завантажити повідомлення, отримати всі названі MAPI‑властивості, пройти по кожній властивості для перевірки її значення:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("my.msg")

# Get all named MAPI properties
properties = msg.named_properties.values
# Read all properties in foreach loop
for prop in properties:
    #  Read any specific property
    if prop.descriptor.canonical_name == "PidLidSideEffects":
        print(f"{prop.descriptor.canonical_name} = {prop}")
    if prop.descriptor.canonical_name == "PidLidInternetAccountName":
        print(f"{prop.descriptor.canonical_name} = {prop}")

Читання іменованої MAPI властивості з вкладення

Aspose.Email робить можливим отримання всіх названих MAPI‑властивостей прикріплення. Наведений нижче приклад коду показує, як читати названі MAPI‑властивості з прикріплень:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("my.msg")

# Get all named MAPI properties
attach_properties = msg.attachments[0].named_properties.values
# Read all properties in foreach loop
for prop in attach_properties:
    #  Read any specific property
    if prop.descriptor.name == "AttachmentOriginalUrl":
        print(f"{prop.descriptor.name} = {prop.get_string()}")
    if prop.descriptor.name == "AttachmentWasSavedToCloud":
        print(f"{prop.descriptor.name} = {prop.get_boolean()}")

Видалення властивостей з MSG та вкладень

Цей приклад коду демонструє створення Outlook MSG повідомлення з вмістом тіла та прикріпленим файлом повідомлення. Він також показує, як видалити властивість вкладення зі створеного повідомлення.

import aspose.email as ae

# create an MSG
msg = ae.mapi.MapiMessage("from@doamin.com", "to@domain.com", "subject", "body");
msg.set_body_content("<html><body><h1>This is the body content</h1></body></html>", ae.mapi.BodyContentType.HTML)

# load message and add it to created MSG as attachment
attachment = ae.mapi.MapiMessage.load(attach.msg")
msg.attachments.add("Outlook2 Test subject.msg", attachment)

# count of attachment properties before removal
print(f"Before removal = {msg.attachments[0].properties.count}")

# Delete anyone attachment property
msg.attachments[0].remove_property(923467779)

# count of attachment properties after removal
print(f"Before removal = {msg.attachments[0].properties.count}")

Python-Net: Робота з вкладеннями повідомлень

Mon, 01 Jan 0001 00:00:00 +0000

Керування вкладеннями за допомогою Aspose Outlook

Створення та збереження Outlook Message (MSG) файлів пояснює, як створювати та зберігати повідомлення, а також створювати файли MSG з вкладеннями. У цій статті розглядається керування вкладеннями Microsoft Outlook за допомогою Aspose.Email. Вкладення з файлу повідомлення доступні та зберігаються на диск за допомогою властивості Attachments класу MapiMessage. Властивість Attachments — це колекція типу класу MapiAttachmentCollection.

Перевірка, чи є вкладення вбудованим або звичайним

"Inline" та "Regular" прикріплення відносяться до способу їх включення в електронне повідомлення. Regular прикріплення — це файли, прикріплені традиційним способом. Зазвичай вони відображаються у списку в клієнті електронної пошти та можуть бути завантажені одержувачем і збережені у локальне сховище. Inline прикріплення, також відомі як вбудовані або inline‑зображення, зазвичай використовуються для включення зображень або іншого медіа у тіло листа. Вони не відображаються у окремому списку, а показуються безпосередньо вмістом листа, наприклад у його тілі. Це дозволяє включати зображення або інше медіа, що є частиною вмісту повідомлення. Наведений нижче приклад коду демонструє, як визначити, чи є прикріплення inline чи regular:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("message.msg")

for attachment in msg.attachments:
    print(f"{attachment.display_name}:{attachment.is_inline}")

Збереження вкладень з Outlook Message (MSG) файлу

Щоб зберегти прикріплення з MSG файлу:

Пройдіться по колекції MapiAttachmentCollection і отримайте окремі вкладення.
Щоб зберегти вкладення, викличте метод Save() класу MapiAttachment.

Наступний фрагмент коду показує, як зберегти вкладення на локальний диск.

import aspose.email as ae

data_dir = "C://dataDir/"
file_name = "message.msg"

# Create an instance of MapiMessage from file
message = ae.mapi.MapiMessage.from_file(data_dir + file_name)

# Iterate through the attachments collection
for attachment in message.attachments:
    # Save the individual attachment
    attachment.save(data_dir + attachment.file_name)

Отримання вкладень вкладених поштових повідомлень

Вбудовані OLE‑вкладення також відображаються у колекції Attachment класу MapiMessage. Наведений приклад коду аналізує файл повідомлення на наявність вбудованих вкладень і зберігає їх на диск. Статичний метод FromProperties() класу MapiMessage може створити нове повідомлення з вбудованого вкладення. Наступний фрагмент коду показує, як отримати вкладення вкладених поштових повідомлень.

import aspose.email as ae

eml = ae.mapi.MapiMessage.load("my.msg")

# Create a MapiMessage object from the individual attachment
get_attachment = ae.mapi.MapiMessage.from_properties(eml.attachments[0].object_data.properties)

# Create an object of type MailMessageInterpreter from the above message and save the embedded message to a file on disk
mail_message = get_attachment.to_mail_message(ae.mapi.MailConversionOptions())
mail_message.save("NestedMailMessageAttachments_out.eml", ae.SaveOptions.default_eml)

Видалення вкладень

Бібліотека Aspose Outlook забезпечує можливість видаляти вкладення з файлів Microsoft Outlook Message (.msg):

Викличте метод RemoveAttachments(). Він приймає шлях до файлу повідомлення як параметр. Реалізовано як публічний статичний метод, тому не потрібно створювати екземпляр об’єкта.

Наступний фрагмент коду показує, як видаляти вкладення.

import aspose.email as ae

ae.mapi.MapiMessage.remove_attachments("AttachmentsToRemove_out.msg")

Ви також можете викликати статичний метод DestoryAttachment() класу MapiMessage. Він працює швидше, ніж RemoveAttachment(), оскільки метод RemoveAttachment() аналізує файл повідомлення.

import aspose.email as ae

# Destroy attachments in the MapiMessage
ae.mapi.MapiMessage.destroy_attachments(data_dir + "AttachmentsToDestroy_out.msg")

Додавання MSG вкладень

Лист Outlook може містити інші листи Microsoft Outlook як вкладення, як звичайні, так і вбудовані. MapiAttachmentCollection надає перевантажені варіанти методу Add для створення листів Outlook з обома типами вкладень.

Спробуйте!

Додавайте або видаляйте вкладення електронної пошти онлайн за допомогою безкоштовного Aspose.Email Editor App.

Додати довідкове вкладення до MapiMessage

"Довідкове вкладення" зазвичай означає вкладення, яке містить посилання або лінк на зовнішній ресурс, а не сам файл. Такі посилання часто використовуються в HTML‑поштових листах для зв’язку з зовнішніми зображеннями або ресурсами, розміщеними на віддаленому сервері. Замість вбудовування всього файлу, довідкове вкладення містить URL або посилання на зовнішній вміст.

Aspose.Email надає набір інструментів для правильного відображення довідкових вкладень, представлений у наведеному прикладі коду:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("message.msg")

# Add reference attachment
msg.attachments.add("Document.pdf",
    "https://drive.google.com/file/d/1HJ-M3F2qq1oRrTZ2GZhUdErJNy2CT3DF/",
    "https://drive.google.com/drive/my-drive",
    "GoogleDrive")

# Also, you can set additional attachment properties
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_PERMISSION_TYPE, int(ae.AttachmentPermissionType.ANYONE_CAN_EDIT))
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_ORIGINAL_PERMISSION_TYPE, 0)
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_IS_FOLDER, False)
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_PROVIDER_ENDPOINT_URL, "")
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_PREVIEW_URL, "")
msg.attachments[0].set_property(ae.mapi.KnownPropertyList.ATTACHMENT_THUMBNAIL_URL, "")
# Finally save the message
msg.save("msg_with_ref_attach.msg")

Вбудувати повідомлення як вкладення

Наступний фрагмент коду показує, як Outlook MSG файли, вбудовані у файл MSG, містять PR_ATTACH_METHOD зі значенням 5.

import aspose.email as ae

# Create a new MapiMessage
message = ae.mapi.MapiMessage("from@test.com", "to@test.com", "Subj", "This is a message body")

# Load the attachment message
attach_msg = ae.mapi.MapiMessage.load("Message.msg")

# Add the attachment to the message
message.attachments.add("Weekly report.msg", attach_msg)

# Save the message with the embedded message attachment
message.save("WithEmbeddedMsg_out.msg")

Читання вбудованих повідомлень з прикріплень

Наступний фрагмент коду показує, як зчитати вбудоване повідомлення з вкладення.

import aspose.email as ae

file_name = "path/to/file.msg"

# Load the MapiMessage from file
message = ae.mapi.MapiMessage.from_file(file_name)

# Check if the first attachment is an Outlook message
if message.attachments[0].object_data.is_outlook_message:
    # Get the embedded message as MapiMessage
    embedded_message = message.attachments[0].object_data.to_mapi_message()
    # Perform further operations with the embedded message
    # ...

Вставка та заміна вкладень

API Aspose.Email надає можливість вставляти вкладення у певний індекс батьківського повідомлення. Він також дозволяє заміняти вміст вкладення іншим повідомленням. Наступний фрагмент коду показує, як виконувати вставку та заміну вкладень.

Вставка у конкретне місце

API Aspose.Email надає можливість вставляти MSG‑вкладення до батьківського MSG за допомогою методу Insert колекції MapiAttachmentCollection: MapiAttachmentCollection Insert(int index, string name, MapiMessage msg). Наступний фрагмент коду показує, як вставити у конкретне місце.

import aspose.email as ae
from io import BytesIO

file_name = "path/to/file.msg"

# Load the MapiMessage from file
message = ae.mapi.MapiMessage.load(file_name)

# Save the attachment to a memory stream
memory_stream = BytesIO()
message.attachments[2].save(memory_stream)

# Load the attachment from the memory stream
get_data = ae.mapi.MapiMessage.load(memory_stream)

# Insert the loaded attachment at index 1
message.attachments.insert(1, "new 11", get_data)

Замінити вміст прикріплення

Це можна використати для заміни вбудованого вмісту вкладень новим за допомогою методу Replace. Однак це не можна застосовувати для вставлення вкладення з PR_ATTACH_NUM = 4 (наприклад) у колекцію, у якої collection.Count = 2. Наступний фрагмент коду показує, як замінити вміст вкладення.

import aspose.email as ae
from io import BytesIO
file_name = "path/to/file.msg"

# Load the MapiMessage from file
message = ae.mapi.MapiMessage.load(file_name)

# Save the attachment to a memory stream
memory_stream = BytesIO()
message.attachments[2].save(memory_stream)

# Load the attachment from the memory stream
get_data = ae.mapi.MapiMessage.load(memory_stream)

# Replace the attachment at index 1 with the loaded attachment
message.attachments.replace(1, "new 1", get_data)

Перейменувати вкладення у MapiMessage

Можливо змінювати відображувані назви вкладень у електронних листах, завантажених з файлу. Нижче наведено приклад коду, який показує, як це зробити:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("message.msg")

msg.attachments[0].display_name = "New display name 1"
msg.attachments[1].display_name = "New display name 2"

Python-Net: Робота з пунктами календаря Outlook

Mon, 01 Jan 0001 00:00:00 +0000

Робота з 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")

Python-Net: Робота з контактами Outlook

Mon, 01 Jan 0001 00:00:00 +0000

Створення, збереження та читання контактів

Як і MapiMessage, Aspose.Email дозволяє створювати контакти Outlook. Клас MapiContact надає всі властивості, пов’язані з контактом, необхідні для створення Outlook контакту. У цій статті показано, як створити, зберегти та прочитати Outlook контакт, використовуючи клас MapiContact.

Створити та зберегти Outlook контакт

Щоб створити контакт та зберегти його на диск:

Створіть новий об’єкт класу MapiContact.
Введіть інформацію про властивості контакту.
Додати дані фотографії (за наявності).
Збережіть контакт у форматі MSG або VCard.

Нижче наведено фрагмент коду, який показує, як створити та зберегти Outlook контакт.

import aspose.email as ae

data_dir = "path/to/data/directory"

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
contact.professional_info = ae.mapi.MapiContactProfessionalPropertySet("Awthentikz", "Social work assistant")
contact.personal_info.personal_home_page = "B2BTies.com"
contact.physical_addresses.work_address.address = "Im Astenfeld 59 8580 EDELSCHROTT"
contact.electronic_addresses.email1 = ae.mapi.MapiContactElectronicAddress("Experwas", "SMTP", "BerthaABuell@armyspy.com")
contact.telephones = ae.mapi.MapiContactTelephonePropertySet("06605045265")
contact.personal_info.children = ["child1", "child2", "child3"]
contact.categories = ["category1", "category2", "category3"]
contact.mileage = "Some test mileage"
contact.billing = "Test billing information"
contact.other_fields.journal = True
contact.other_fields.private = True
contact.other_fields.reminder_topic = "Test topic"
contact.other_fields.user_field1 = "ContactUserField1"
contact.other_fields.user_field2 = "ContactUserField2"
contact.other_fields.user_field3 = "ContactUserField3"
contact.other_fields.user_field4 = "ContactUserField4"

# Add a photo
with open(data_dir + "Desert.jpg", "rb") as file:
    buffer = file.read()
    contact.photo = ae.mapi.MapiContactPhoto(buffer, ae.mapi.MapiContactPhotoImageFormat.Jpeg)

# Save the Contact in MSG format
contact.save(data_dir + "MapiContact_out.msg", ae.mapi.ContactSaveFormat.MSG)

# Save the Contact in VCF format
contact.save(data_dir + "MapiContact_out.vcf", ae.mapi.ContactSaveFormat.V_CARD)

Зберегти контакт у форматі VCF версії 3

Щоб зберегти контакт у форматі VCF версії 3, використайте властивість version у VCardSaveOptions Клас. Створіть новий екземпляр класу VCardSaveOptions, встановіть властивість version об’єкта VCardSaveOptions у VCardVersion.V30. Це встановлює версію vCard у 3.0., викличте метод save об’єкта MapiContact, передавши ім’я файлу "contact.vcf" та об’єкт VCardSaveOptions як параметри. Це зберігає контакт у файлі vCard із зазначеним іменем та параметрами. Нижче наведено фрагмент коду, який показує, як зберегти контакт у форматі VCF версії 3:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.version = ae.personalinfo.vcard.VCardVersion.V30
contact.save("contact.vcf", options)

Читання MapiContact

Клас MapiContact можна використовувати для завантаження контактів у форматах Outlook MSG та VCard. Нижче наведено фрагмент коду, який показує, як завантажити Outlook контакти, збережені як MSG та VCF, у MapiContact.

Завантаження контакту з MSG

Нижче наведено фрагмент коду, який показує, як завантажити контакт з MSG.

Завантаження контакту з VCard

Нижче наведено фрагмент коду, який показує, як завантажити контакт з vCard.

Завантаження контакту з VCard з вказаним кодуванням

Нижче наведено фрагмент коду, який показує, як завантажити контакт з vCard з вказаною кодуванням.

Збереження контактів VCard з вказаним кодуванням

При збереженні файлу vCard можливо вказати кодування символів, яке використовується, забезпечуючи сумісність з не-ASCII символами. Встановіть властивість preferred_text_encoding об’єкта VCardSaveOptions у "utf-8". Нижче наведено фрагмент коду, який показує, як впровадити цю функцію у ваш проект:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.preferred_text_encoding = "utf-8"
contact.save("contact.vcf", options)

Збереження файлів VCard з розширеними полями

При збереженні файлу vCard можна також вказати параметри, включаючи використання розширених полів, які є додатковими властивостями або атрибутами, що можуть бути додані до vCard поза стандартним набором полів, визначеним специфікацією vCard. Властивість use_extensions об’єкта VCardSaveOptions Клас дозволяє це зробити. Нижче наведено фрагмент коду, який показує, як зберегти файл VCard з розширеними полями:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.use_extensions = True
contact.save("contact.vcf", options)

Читання кількох контактів у форматі VCard

Вам знадобляться наступні методи для отримання списку всіх контактів з VCard:

# Checks whether VCard source stream contains multiple contacts.
aspose.email.personalinfo.vcard.VCardContact.is_multi_contacts(stream)

# Loads list of all contacts from VCard file.
aspose.email.personalinfo.vcard.VCardContact.load_as_multiple(file_path, encoding)

# Loads list of all contacts from VCard stream.
aspose.email.personalinfo.vcard.VCardContact.load_as_multiple(stream, encoding)

Нижченаведений фрагмент коду продемонструє процес читання кількох контактів з файлу VCard:

import aspose.email as ae

contact = ae.mapi.MapiContact()
contact.name_info = ae.mapi.MapiContactNamePropertySet("Bertha", "A.", "Buell")
options = ae.personalinfo.vcard.VCardSaveOptions()
options.use_extensions = True
contact.save("contact.vcf", options)

if ae.personalinfo.vcard.VCardContact.is_multi_contacts("contact.vcf"):
    ae.personalinfo.vcard.VCardContact.load_as_multiple("contact.vcf")

Рендеринг інформації про контакт у MHTML

Outlook контакт можна конвертувати у MHTML за допомогою Aspose.Email API. У цьому прикладі показано, як VCard завантажується у MapiContact і потім конвертується у MHTML за допомогою MailMessage API.

Python-Net: Робота з нотатками Outlook

Mon, 01 Jan 0001 00:00:00 +0000

Створення, збереження та читання нотаток

Aspose.Email надає можливість створювати Outlook нотатки та зберігати їх на диск у форматі MSG. Клас MapiNote надає властивості та методи для встановлення інформації про завдання. У цій статті показано, як створити, зберегти та прочитати MapiNote з диска.

Створення та збереження Outlook нотатки

Наступні кроки можна використати для створення та збереження нотатки на диск:

Створіть екземпляр класу MapiNote.
Встановіть різні властивості.
Збережіть нотатку на диск у вигляді файлу MSG.

Нижче наведено фрагмент коду, який показує, як створити та зберегти Outlook Note.

Читання MapiNote

Об’єкт класу MapiNote використовується для приведення об’єкта MapiMessage, який завантажує нотатку з диска у форматі MSG. Нижче наведено фрагмент коду, який показує, як прочитати MapiNote.

Python-Net: Робота з задачами Outlook

Mon, 01 Jan 0001 00:00:00 +0000

Створення, збереження та читання завдань

Aspose.Email for .NET дозволяє створювати завдання Outlook та зберігати їх у форматі MSG. Клас MapiTask надає низку властивостей, таких як Percentcomplete, Estimatedeffort, ActualEffort, History, LastUpdate та інші, для встановлення інформації, необхідної для завдання Outlook. У цій статті показано, як створити, зберегти та зчитати MapiTask з диска. Щоб створити та зберегти завдання на диск:

Створіть новий об’єкт класу MapiContact.
Введіть інформацію про властивості завдання.
Зберегти завдання на диск у форматі MSG.

Наступний фрагмент коду показує, як створювати, зберігати та читати завдання.

Читання MapiTask

Об’єкт класу MapiContact використовується для приведення об’єкта MapiMessage, який завантажує завдання з диска у форматі MSG. Наступний фрагмент коду показує, як зчитати MapiTask.

Читання задачі VToDo

Google Tasks, експортувані у формат iCalendar як події VToDo, можна завантажити за допомогою класу MapiTask, як показано у наведеному прикладі коду. Наступний фрагмент коду показує, як зчитати задачу VToDo.

import aspose.email as ae

data_dir = "path/to/data/directory"

task = ae.mapi.MapiTask.from_v_todo(data_dir + "VToDoTask.ics")
task.save(data_dir + "VToDo_out.msg", ae.TaskSaveFormat.Msg)

Додавання інформації про нагадування до MapiTask

Подібно до Microsoft Outlook, Aspose.Email може додавати інформацію про нагадування до MapiTask. Наступний фрагмент коду показує, як додати інформацію про нагадування до MapiTask.

Додавання вкладень до MapiTask

Використайте Додати метод MapiAttachmentCollection клас для додавання вкладення до MapiTask. Наступний приклад коду допоможе вам у цьому:

import aspose.email as ae
import datetime as dt

task = ae.mapi.MapiTask("Task with attacment", "Test body of task with attacment", dt.datetime.now(), dt.datetime.now());
task.attachments.add("Attachment.txt", str.encode("attachment data"))
task.save("AddAttachmentsToMapiTask_out", ae.mapi.TaskSaveFormat.MSG)

Додавання повторення до MapiTask

Aspose.Email дозволяє створювати повторюване завдання, де повторення може бути щоденним, щотижневим, щомісячним або щорічним. Наступний фрагмент коду показує, як створити завдання з різними типами повторення.

Конвертація завдання у MHT

Наступний приклад коду демонструє, як конвертувати завдання у формат MHT, вказуючи додаткові параметри для MHT формату, коли слід виводити поля, специфічні для завдання (RENDER_TASK_FIELDS), та включати інформацію заголовка (WRITE_HEADER). Властивість mht_format_options класу MhtSaveOptions клас використовується для визначення додаткових параметрів під час збереження у форматі MHTML.

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("MapiTask.msg")

opt = ae.SaveOptions.default_mhtml
opt.mht_format_options = ae.MhtFormatOptions.RENDER_TASK_FIELDS | ae.MhtFormatOptions.WRITE_HEADER

msg.save("MapiTask_out.mht", opt)

Python-Net: Робота з опцією голосування за допомогою MapiMessage

Mon, 01 Jan 0001 00:00:00 +0000

Створення параметра голосування за допомогою MapiMessage

Microsoft Outlook дозволяє користувачам створювати опитування під час написання нового повідомлення. Вони можуть включати параметри голосування, такі як Так, Ні, Можливо тощо. Aspose.Email дозволяє те ж саме при створенні нового повідомлення Outlook. The FollowUpOptions Клас надає властивість VotingButtons, яку можна використовувати для встановлення або отримання значення параметрів голосування. У цій статті подано докладний приклад створення MapiMessage з параметрами голосування для створення опитування.

Створення опитування за допомогою MapiMessage

Нижче наведений приклад коду показує, як використати властивість voting_buttons об’єкта FollowUpOptions Клас для створення опитування:

import aspose.email as ae

msg = ae.mapi.MapiMessage.load("my.msg")

# Set FollowUpOptions Buttons
options = ae.mapi.FollowUpOptions()
options.voting_buttons = "Yes;No;Maybe;Exactly!"

msg.save("voting_btns.msg")

Читання параметрів голосування з MapiMessage

Нижче наведено фрагмент коду, який показує, як прочитати параметри голосування з MapiMessage.

Читання лише кнопок голосування

Нижче наведено фрагмент коду, який показує, як читати лише кнопки голосування.

Додавання кнопки голосування до існуючого повідомлення

Нижче наведено фрагмент коду, який показує, як додати кнопку голосування до існуючого повідомлення.

Видалення кнопки голосування з повідомлення

Нижче наведено фрагмент коду, який показує, як видалити кнопку голосування з повідомлення.

Прочитати інформацію про результати голосування

Нижче наведено фрагмент коду, який показує, як прочитати інформацію про результати голосування.

Встановити прапорець незаданого повідомлення

Нижче наведено фрагмент коду, який показує приклади методів, використаних у прикладах.

import aspose.email as ae

msg = ae.mapi.MapiMessage("from@test.com", "to@test.com", "Flagged message", "Make it nice and short, but descriptive. The description may appear in search engines' search results pages...")
msg.set_message_flags(msg.flags ^ ae.mapi.MapiMessageFlags.UNSENT)