Gerenciar Modelos do Outlook, Mensagens Assinadas e Categorias

Ler e Gravar Arquivos de Modelo do Outlook (OFT)

Modelos do Outlook são arquivos de e‑mail reutilizáveis (.oft) que ajudam a automatizar o envio de mensagens semelhantes ou recorrentes. Em vez de reescrever o mesmo conteúdo a cada vez, você pode abrir um modelo salvo, atualizar os detalhes e enviá‑lo instantaneamente.

Usando Aspose.Email for C++, você pode carregar e modificar modelos OFT através do MailMessage classe. Uma vez carregada, você pode atualizar campos como remetente, destinatário, assunto e corpo e então ou:

  • Envie a mensagem atualizada usando a classe SmtpClient, ou
  • Salve-o como um arquivo MSG para edição ou validação posteriores no Microsoft Outlook.

O exemplo de código a seguir demonstra como carregar um modelo de e‑mail do Outlook (arquivo OFT), modificar seus detalhes de remetente e destinatário, personalizar o conteúdo do e‑mail substituindo marcadores de posição por valores específicos e, em seguida, salvar a mensagem atualizada como um arquivo MSG do Outlook com a bandeira de não enviado ativada.

Gerenciar Mensagens Digitalmente Assinadas (S/MIME)

Preservar Assinatura ao Converter EML para MSG

Aspose.Email oferece suporte total a operações S/MIME, permitindo salvar ou converter mensagens assinadas digitalmente sem quebrar a integridade da assinatura. A API oferece dois métodos para preservar a assinatura ao converter de EML para MSG.

1. Preservar assinatura S/MIME automaticamente

  1. Carregue o arquivo EML com MailMessage::Load(). Ele analisa a estrutura MIME: cabeçalhos, partes do corpo, anexos, assinaturas.
  2. Salvar como MSG chamando Save() com SaveOptions::get_DefaultMsgUnicode(). Isso cria o formato MSG Unicode automaticamente enquanto preserva a hierarquia da mensagem e a integridade do conteúdo.

Se a mensagem original incluir uma assinatura digital S/MIME, ela será reconhecida e preservada como um anexo especial dentro do arquivo MSG resultante.

Nenhuma reformatação do corpo ocorre, garantindo que a assinatura permaneça válida.

2. Conversão Controlada

Esta abordagem usa um processo de duas etapas que converte explicitamente uma mensagem baseada em MIME para uma representação de mensagem baseada em MAPI.

  1. Carregue o arquivo EML com MailMessage::Load(). Ele analisa o EML em modelo de objeto MIME com cabeçalhos, partes do corpo, anexos.
  2. Converter para mensagem MAPI com MapiMessage::FromMailMessage().
  3. Configurar MapiConversionOptions:
    • Definir codificação de saída (ANSI/Unicode).
    • Escolher formato da mensagem.
    • Preservar anexos TNEF, se necessário.
    • Incluir ou preservar assinaturas digitais.
    • Definir formato do corpo (Texto simples, RTF, HTML).
  4. Habilitar PreserveSignature = true para manter a assinatura S/MIME intacta. Isso incorpora a parte MIME da assinatura (application/pkcs7-mime ou pkcs7-signature) sem decodificar ou reempacotar.
  5. Salve a Mensagem MAPI resultante como arquivo MSG preservando todas as propriedades e assinaturas.

Use este método para permitir a personalização do formato do corpo da mensagem, codificação e manipulação de anexos. É útil para conversão mantendo dados TNEF, gerenciando anexos de forma diferenciada ou integrando a criação de MSG em fluxos de trabalho complexos do Outlook/MAPI. Ele fornece acesso ao conjunto de propriedades MAPI para manipulação em nível profundo.

Definir Categorias de Cor para Arquivos Outlook MSG

Categorias de cor ajudam a organizar e‑mails no Outlook. Aspose.Email fornece o FollowUpManager classe e algumas funções para gerenciar essas categorias:

  • AddCategory recebe MapiMessage e a string da categoria de cor, por exemplo "Categoria Roxa" ou "Categoria Vermelha" como argumentos.
  • RemoveCategory recebe MapiMessage e a string da categoria de cor a ser removida da mensagem.
  • ClearCategories() é usado para remover todas as categorias de cor da mensagem.
  • GetCategories é usado para recuperar todas as categorias de cor de uma mensagem específica.

O exemplo de código a seguir demonstra como carregar um arquivo de e‑mail Outlook MSG, adicionar categorias de cor à mensagem, recuperar e exibir suas categorias existentes e, em seguida, remover categorias específicas ou limpar todas as categorias usando o FollowUpManager.

Acessar Informações de Follow‑Up em Arquivos MSG

Aspose.Email pode extrair recibos de leitura, recibos de entrega e resultados de votação de mensagens do Outlook.

O exemplo de código a seguir demonstra como ler um arquivo Outlook MSG e iterar por seus destinatários para exibir informações detalhadas de rastreamento. Especificamente, mostra como acessar o nome de exibição de cada destinatário, o horário de entrega da mensagem a esse destinatário e o momento em que o destinatário leu a mensagem, recuperando essas propriedades das propriedades do destinatário da mensagem MAPI.