Praca z właściwościami MAPI

Określ typ elementu MAPI w folderze PST

Plik PST zazwyczaj zawiera różne rodzaje danych, takie jak wiadomości e‑mail, zdarzenia kalendarza, kontakty i inne. MapiItemType klasa w Aspose.Email pozwala na dostęp i kategoryzację różnych typów elementów MAPI w pliku PST. Poniższy kod demonstruje, jak określić typ elementu MAPI w folderze PST:

import aspose.email as ae
import aspose.pycore as pycore

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

    # Get the class type based on msg.supported_type
    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 = pycore.cast(ae.mapi.MapiContact, 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 = pycore.cast(ae.mapi.MapiCalendar, 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 = pycore.cast(ae.mapi.MapiDistributionList, 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 = pycore.cast(ae.mapi.MapiJournal, 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 = pycore.cast(ae.mapi.MapiNote, 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 = pycore.cast(ae.mapi.MapiTask, msg.to_mapi_message_item())
        # You can access to MapiTask properties there

Dostęp i zarządzanie właściwościami MAPI

Ten MapiProperty klasa reprezentuje właściwość MAPI, zawierającą:

  • Name: łańcuch znaków reprezentujący nazwę właściwości.
  • Tag: długi całkowity reprezentujący znacznik właściwości.
  • Data: tablica bajtów reprezentująca dane właściwości.

Pobierz właściwość MAPI używając znacznika właściwości

Poniższy przykład kodu ładuje wiadomość MAPI, pobiera kluczowe właściwości, takie jak temat i strona kodowa internetu, oraz bezpiecznie obsługuje ewentualny brak tych właściwości. Aby uzyskać właściwości MAPI:

  1. Załaduj wiadomość MAPI z pliku przy użyciu załaduj metoda.
  2. Użyj MapiPropertyTag klasa umożliwiająca dostęp do określonych właściwości wiadomości MAPI, takich jak temat i strona kodowa internetu.
  3. Obsługa brakujących właściwości.
from aspose.email.mapi import MapiMessage, MapiPropertyTag

# Load from file
msg = MapiMessage.load("message.msg")

# Access the MapiPropertyTag.PR_SUBJECT property
prop = msg.properties[MapiPropertyTag.SUBJECT]

# If the property is not found, check the MapiPropertyTag.PR_SUBJECT_W (which is a // Unicode peer of the MapiPropertyTag.PR_SUBJECT)
if prop is None:
	prop = msg.properties[MapiPropertyTag.SUBJECT_W]

# Cannot found
if prop is None:
	print("No property found!")

# Get the property data as string
subject = prop.get_string()

print("Subject:" + subject)

# Read internet code page property
prop = msg.properties[MapiPropertyTag.INTERNET_CPID]
if prop is not None:
	print("CodePage:" + str(prop.get_long()))

Ustaw właściwości MAPI

Poniższy fragment kodu pokazuje, jak ustawić właściwości MAPI.

Odczyt nazwanych właściwości MAPI

Aspose.Email udostępnia zestaw interfejsów API do pracy z plikami MSG, w tym wyodrębnianie nazwanych właściwości MAPI.

Odczyt nazwanych właściwości MAPI z plików MSG

Aby odczytać nazwane właściwości MAPI, możesz użyć named_properties właściwość MapiMessage class. Poniższy przykład kodu pokazuje, jak załadować wiadomość, pobrać wszystkie nazwane właściwości MAPI, iterować po każdej właściwości, aby sprawdzić jej wartość:

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

Odczyt nazwanych właściwości MAPI z załączników

Aspose.Email umożliwia pobranie wszystkich nazwanych właściwości MAPI załącznika. Poniższy przykład kodu pokazuje, jak odczytać nazwane właściwości MAPI z załączników:

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

Zarządzanie właściwościami

Usuwanie właściwości z plików MSG i załączników

Poniższy przykład kodu demonstruje tworzenie wiadomości Outlook MSG z treścią w ciele oraz załączonym plikiem wiadomości. Pokazuje również, jak usunąć własność załącznika z utworzonej wiadomości.

import aspose.email as ae

# create an MSG
msg = ae.mapi.MapiMessage("from@domain.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"After removal = {msg.attachments[0].properties.count}")

Konwersja MSG do wiadomości MIME

API Aspose.Email zapewnia możliwość konwersji pliku MSG do wiadomości MIME przy użyciu to_mail_message metoda.

Ustawianie limitu czasu dla konwersji i ładowania wiadomości

Aby ograniczyć czas konwersji wiadomości w milisekundach (wartość domyślna 3 sek), właściwość timeout z MailConversionOptions class jest używany.

Oto jak możesz ustawić limit czasu dla procesów konwersji i ładowania wiadomości:

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)

Ustawiając limit czasu (timeout) dla procesów konwersji i ładowania wiadomości, możesz kontrolować maksymalny czas, jaki te operacje mogą działać. Po ustawieniu limitu czasu możesz kontynuować konwersję i ładowanie wiadomości.

Ustawienie kategorii koloru dla plików Outlook MSG

Czasami możesz potrzebować odróżnić e-maile o szczególnej ważności i wizualnie je zorganizować. Biblioteka zapewnia sposób na to, poprzez przypisanie określonego koloru elementowi wiadomości. Ustawiając kategorię koloru dla elementu, umożliwiasz łatwe zidentyfikowanie i odnalezienie powiązanych elementów na pierwszy rzut oka. Użyj FollowUpManager class do ustawienia kategorii koloru wiadomości, jak pokazano w poniższym przykładzie kodu:

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)
Ładowanie i parsowanie plików MSG Konwersja i przetwarzanie szablonów Outlook (OFT)