Trabalhando com Contatos do Outlook

Criar Contato do Outlook

Aspose.Email para Java suporta a criação de contatos do Outlook (VCards) usando a classe MapiContact. MapiContact contém muitos métodos, alguns dos quais são listados abaixo.

• MapiContactElectronicAddressPropertySet contém um conjunto de MapiContactElectronicAddress.
• MapiContactEventPropertySet
• MapiContactNamePropertySet
• MapiContactPersonalInfoPropertySet
• MapiContactPhysicalAddressPropertySet contém um conjunto de MapiContactPhysicalAddress.
• MapiContactProfessionalPropertySet
• MapiContactTelephonePropertySet

Estrutura de Contato em Aspose.Email para Java

Abaixo está a hierarquia implementada para contatos em Aspose.Email para Java. O nome da classe relevante é fornecido contra cada propriedade. Hiperligações são fornecidas para a documentação online para referência adicional.

1. Contact (MapiContact)
   1. Endereços Eletrônicos (MapiContactElectronicAddressPropertySet)
      1. Email1 (MapiContactElectronicAddress)
         1. Tipo de Endereço
         2. Nome para Exibição
         3. Endereço de Email
         4. Número de Fax
      2. Email2
      3. Email3
      4. Fax Residencial
      5. Fax Primário
      6. Fax Comercial
   2. Eventos (MapiContactEventPropertySet). Veja abaixo um exemplo de como definir eventos.
      1. Aniversário
      2. Aniversário de Casamento
   3. Informações do Nome (MapiContactNamePropertySet)
      1. Nome para Exibição
      2. Prefixo do Nome para Exibição
      3. Arquivar Sob
      4. Arquivar Sob ID
      5. Geração
      6. Nome Dado
      7. Iniciais
      8. Nome do Meio
      9. Apelido
      10. Sobrenome
   4. Informações Pessoais (MapiContactPersonalInfoPropertySet)
      1. Conta
      2. Página Inicial Comercial
      3. Nome da Rede do Computador
      4. ID do Cliente
      5. Localização Comercial Gratuita
      6. Site FTP
      7. Gênero
      8. Número de Identificação do Governo
      9. Hobbies
      10. HTML
      11. Endereço de Mensagens Instantâneas
      12. Idioma
      13. Localização
      14. Notas
      15. Número de Identificação Organizacional
      16. Página Inicial Pessoal
      17. Referido por Nome
      18. Nome do Cônjuge
   5. Endereço Físico (MapiContactPhysicalAddressPropertySet)
      1. Endereço Residencial (MapiContactPhysicalAddress)
         1. Endereço
         2. Cidade
         3. País
         4. Código do País
         5. Código Postal
         6. Caixa Postal
         7. Estado ou Província
      2. Outro Endereço
      3. Endereço de Trabalho
   6. Informações Profissionais
      1. Assistente
      2. Nome da Empresa
      3. Nome do Departamento
      4. Nome do Gerente
      5. Localização do Escritório
      6. Profissão
      7. Título
   7. Telefones (MapiContactTelephonePropertySet)
      1. Número de Telefone do Assistente
      2. Número de Telefone Comercial 2
      3. Número de Telefone Comercial
      4. Número de Telefone de Retorno
      5. Número de Telefone do Carro
      6. Número de Telefone Principal da Empresa
      7. Número de Telefone Residencial 2
      8. Número de Telefone Residencial
      9. Número ISDN
      10. Número de Telefone Celular
      11. Outro Número de Telefone
      12. Número de Telefone do Pager
      13. Número de Telefone Primário
      14. Número de Telefone de Rádio
      15. Número de Telex
      16. Número de Telefone TTY/TDD

O seguinte código usa Aspose.Email para criar um contato do Outlook e preenchê-lo com nome, propriedades profissionais, endereço físico e email. Também mostra como adicionar MapiContactEventPropertySet ao contato.

Figura: Um contato do Microsoft Outlook codificado com Aspose.Email

Adicionando Informações de Evento ao MapiContact

O Microsoft Outlook permite que os usuários adicionem informações de evento a um contato. O evento contém o aniversário e o aniversário de casamento. Aspose.Email fornece a classe MapiContactEventPropertySet para adicionar essas informações a um contato. Isso é detalhado no seguinte exemplo.

Criando, Salvando e Lendo Contatos do Outlook

Aspose.Email permite que desenvolvedores criem contatos do Microsoft Outlook, bem como mensagens de email. A classe MapiContact fornece todas as propriedades de contato necessárias para criar um contato do Outlook. Este artigo mostra como criar, salvar e ler um contato do Outlook usando a classe MapiContact.

Criar e Salvar um MapiContact

Os seguintes passos podem ser usados para criar e salvar um contato no disco:

1. Instanciar um novo objeto da classe MapiContact.
2. Inserir informações relacionadas a várias propriedades do contato.
3. Adicionar dados de foto ao contato, se houver.
4. Salvar o contato no formato MSG ou VCard.

Salvar Contato no Formato VCF da Versão 3

Para salvar o contato no formato VCF da versão 3, use o VCardVersion enumerável para definir a propriedade VCardSaveOptions.Version. O seguinte código de exemplo demonstra o uso do VCardVersion enumerável para salvar o contato no formato VCF da versão 3.

Ler um MapiContact

A classe MapiContact pode ser usada para carregar arquivos MSG do Microsoft Outlook, assim como contatos no formato VCard. Os seguintes exemplos de código mostram como carregar contatos do Outlook salvos como MSG e VCF no MapiContact.

Carregar um Contato de MSG

Carregar um Contato de VCard

Carregar Contato VCard com Codificação Especificada

Método Suportado: MapiContact.fromVCard(String, Encoding)

Renderizando Informações de Contato para MHTML

O Contato do Outlook pode ser convertido para MHTML usando a API Aspose.Email. Este exemplo mostra como um VCard é carregado no MapiContact e então convertido para MHTML com a ajuda da API MailMessage.