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

Python-Net: Създаване и запазване на MSG файлове

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

Aspose.Email поддържа създаването на Outlook съобщения (MSG) файлове. Тази статия обяснява как да:

Създайте MSG съобщения.
Създайте MSG съобщения с прикачени файлове.
Създайте MSG съобщение с RTF тяло.
Запазете съобщение като чернова.
Работа с компресиране на тялото.

Създаване и запазване на Outlook съобщения

Класът MailMessage разполага с метод Save(), който може да запазва Outlook MSG файлове на диск или в поток. Следните кодови отрязъци създават екземпляр на класа MailMessage, задават свойства като from, to, subject и body. Методът Save() приема името на файла като аргумент. Освен това, Outlook съобщения могат да се създадат със компресиран RTF текст, използвайки MapiConversionOptions. За настройка, създайте ново Windows приложение и добавете препратка към Aspose.Email dll в проекта.

Създайте нов екземпляр на класа MailMessage и задайте свойствата From, To, Subject и Body.
Извикайте метода FromMailMessage на класа MailMessage, който приема обект от тип MailMessage. Методът FromMailMessage() конвертира MailMessage в MailMessage (MSG).
Извикайте метода MapiMessage.Save(), за да запазите MSG файла.

Пишете следния код в събитието click на бутона в Windows приложението.

Създаване на MSG файлове с прикачени файлове

В горния пример създадохме прост MSG файл. Aspose.Email също поддържа запазване на съобщения с прикачени файлове. Всичко, което трябва да направите, е да добавите прикачените файлове към екземпляра MailMessage. Добавете прикачени файлове, като извикате метода Add() върху колекцията MailMessage.Attachments. Добавете ListBox към формата, създадена по-горе, и две бутона – един за добавяне и един за премахване на прикачени файлове. Приложението, което добавя прикачени файлове, работи по следния начин:

Когато бутонът Add Attachment бъде натиснат, се извежда Open File Dialog, за да помогне на потребителите да прегледат и изберат прикачения файл.
Когато файлът бъде избран, пълният път се добавя към списъка.
Когато MSG файлът бъде създаден, пътеките към прикачените файлове се взимат от списъка и се добавят към колекцията MailMessage.Attachments.

Пишете следния код в събитието click на бутона Add Attachment.

Добавете кода за добавяне на прикачените файлове към екземпляра MailMessage. Финалният код за функцията Write Msg е написан както по-долу.

Създаване на MSG файлове с RTF тяло

Също така можете да създавате Outlook съобщения (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 Messagefile (*.msg). The MapiMessage класът се използва за зареждане на MSG файлове и предоставя няколко статични функции за зареждане за различни сценарии. Следният кодов откъс показва как да заредите MSG файлове от файл или от поток.

Try it out!

Парсирайте имейл файлове онлайн безплатно с Приложение за парсване Aspose.Email.

Зареждане на 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 съобщение

Aspose.Email API предоставя възможност за конвертиране на 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 шаблони (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

Този 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]}")

Създаване на съобщения за препращане и отговор

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")

Създаване на отговорно съобщение

Този ReplyMessageBuilder Класът се използва за конфигуриране на настройките за отговор, включително изходното съобщение, подател, получатели, режим на отговор, представка на темата и тялото на отговорното съобщение. Отговорните съобщения могат да се създават в различни режими като „Отговор до подателя“ или „Отговор до всички“, в зависимост от вашите изисквания. Можете да персонализирате различни свойства като прикачени файлове, хедъри и опции за форматиране на отговорното съобщение. Следният пример с код показва как да създадете препратено съобщение:

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

Флаг за последващи действия маркира имейл съобщение за определено действие. Microsoft Outlook позволява на потребителите да маркират съобщения и, при настройка на флага, да зададат краен срок за последващи действия. Microsoft Outlook изпраща напомняне до получателя, за да го подтикне да следва имейла. Маркирането на имейли и задаването на крайни дати програмено позволява на разработчиците да автоматизират определени типове имейли и да помогнат на получателите да помнят да предприемат действие. Например, може да се използва за изпращане на месечни съобщения до екип продажби, за да ги напомни да завършат отчетите си; или за изпращане на съобщение до целия персонал, за да ги напомни за фирмена среща. Aspose.Email за .NET поддържа задаване на флаг за последващи действия и краен срок за обектите MapiMessage, като използва FollowUpManager и FollowUpOptions. Съществуват няколко варианта, при които флагът за последващи действия може да бъде зададен върху съобщение. Всички те се използват в кода по-долу:

Задайте флаг за последващи действия за съобщение
Добави дата за изпълнение и дата за напомняне към съобщение
Добави флаг към съобщението на получателя.
Маркирай като завършено.
Премахни флага.
Прочетете опциите за последващо действие.

Задаване на флаг 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 за получателите.

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")

Прочетете опциите за флага на последващо действие за съобщение

Следният кодов откъс показва как да прочетете опциите за флаг за последващи действия за съобщение.

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 съобщения (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 съобщение (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 съобщения (.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 съобщения и с двата вида прикачени файлове.

Try it out!

Добавяйте или премахвайте имейл прикачени файлове онлайн с безплатния Aspose.Email Editor App.

Добавяне на референтен прикачен файл към MapiMessage

"Reference attachment" обикновено се отнася до прикачен файл, който съдържа референция или връзка към външен ресурс, вместо самия файл. Тези референции често се използват в 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
    # ...

Вмъкване и замяна на прикачени файлове

Aspose.Email API предоставя възможност за вмъкване на прикачени файлове на конкретен индекс в родителското съобщение. Той също така предоставя възможност за замяна на съдържанието на прикачен файл с друг прикачен файл от съобщение. Следният кодов отрязък ви показва как се извършва вмъкване и замяна на прикачени файлове.

Вмъкване на конкретно място

Aspose.Email API предоставя възможност за вмъкване на 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 (например) в колекция, чийто 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. Това задава версия 3.0 за vCard. Извикайте метода 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 Contact може да бъде конвертиран в 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 бележка.

Четене на MapiNote

Обектът от клас MapiNote се използва за преобразуване на обекта MapiMessage, който зарежда бележка от диска във формат MSG. Следният кодов откъс показва как да прочетете MapiNote.

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

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

Създаване, запазване и четене на задачи

Aspose.Email за .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 съобщение. Този 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)