Trabalhando com Propriedades MAPI

Determinar o tipo de item MAPI em uma pasta PST

Um arquivo PST normalmente contém vários tipos de dados, como mensagens de e‑mail, eventos de calendário, contatos e mais. O MapiItemType A classe da Aspose.Email permite acessar e categorizar diferentes tipos de itens MAPI dentro de um arquivo PST. O código abaixo demonstra como determinar o tipo de um item MAPI em uma pasta 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

Acessar e gerenciar propriedades MAPI

O MapiProperty classe representa uma propriedade MAPI, que contém:

  • Name: uma string que representa o nome da propriedade.
  • Tag: um inteiro longo que representa a tag da propriedade.
  • Data: um array de bytes que representa os dados da propriedade.

Obter propriedade MAPI usando a Tag da propriedade

O exemplo de código abaixo carrega uma mensagem MAPI, recupera propriedades-chave como o assunto e a página de código da internet, e lida com segurança com a possível ausência dessas propriedades. Para obter propriedades MAPI:

  1. Carregue a mensagem MAPI de um arquivo usando o carregar método.
  2. Use o MapiPropertyTag classe para acessar propriedades específicas de uma mensagem MAPI, como o assunto e a página de código da internet.
  3. Tratar propriedades ausentes.
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()))

Definir propriedades MAPI

O trecho de código a seguir mostra como definir propriedades MAPI.

Ler Propriedades MAPI Nomeadas

Aspose.Email fornece um conjunto de APIs para trabalhar com arquivos MSG, incluindo a extração de propriedades MAPI nomeadas.

Ler Propriedades MAPI Nomeadas de Arquivos MSG

Para ler propriedades MAPI nomeadas, você pode usar o named_properties propriedade do MapiMessage classe. O exemplo de código a seguir mostra como carregar uma mensagem, recuperar todas as propriedades MAPI nomeadas, iterar sobre cada propriedade para verificar seu valor:

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

Ler Propriedades MAPI Nomeadas de Anexos

Aspose.Email possibilita recuperar todas as propriedades MAPI nomeadas de um anexo. O exemplo de código a seguir mostra como ler propriedades MAPI nomeadas de anexos:

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

Gerenciamento de Propriedades

Remover Propriedades de Arquivos MSG e Anexos

O exemplo de código abaixo demonstra a criação de uma mensagem Outlook MSG com conteúdo de corpo e um arquivo de mensagem anexado. Ele também mostra como excluir uma propriedade de anexo da mensagem criada.

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

Convertendo MSG para Mensagem MIME

A API Aspose.Email fornece a capacidade de converter arquivos MSG em mensagens MIME usando o to_mail_message método.

Definindo Tempo Limite para Conversão e Carregamento de Mensagens

Para limitar o tempo em milissegundos da conversão de mensagem (valor padrão 3 seg), a propriedade timeout do MailConversionOptions classe é usada.

Veja como você pode definir um tempo limite para os processos de conversão e carregamento de mensagens:

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)

Ao definir um tempo limite para os processos de conversão e carregamento de mensagens, você pode controlar o tempo máximo que essas operações podem levar. Depois de definir o tempo limite, você pode prosseguir com seus processos de conversão e carregamento de mensagens.

Definir Categoria de Cor para Arquivos Outlook MSG

Às vezes você pode precisar diferenciar e-mails de importância particular e organizá-los visualmente. A biblioteca oferece uma maneira de fazer isso atribuindo uma cor específica a um item de mensagem. Quando você define uma categoria de cor para um item, isso permite identificar e localizar itens relacionados rapidamente. Use FollowUpManager classe para definir a categoria de cor para uma mensagem como mostrado no exemplo de código a seguir:

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)
Carregando e analisando arquivos MSG Convertendo e Processando Modelos do Outlook (OFT)