Trabalhando com Contatos do Outlook

Criar Contato do Outlook

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

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

Estrutura de Contato no Aspose.Email for Java

Abaixo está a hierarquia implementada para contatos no Aspose.Email for Java. O nome da classe relevante é fornecido ao lado de cada propriedade. Links são fornecidos para a documentação online para referência adicional.

1. Contato (MapiContact)
   1. Endereços Eletrônicos (MapiContactElectronicAddressPropertySet)
      1. Email1 (MapiContactElectronicAddress)
         1. Tipo de Endereço
         2. Nome de Exibição
         3. Endereço de E‑mail
         4. Número de Fax
      2. Email2
      3. Email3
      4. Fax Residencial
      5. Fax Principal
      6. Fax Comercial
   2. Eventos (MapiContactEventPropertySet) Veja abaixo um exemplo de como definir eventos.
      1. Data de Nascimento
      2. Aniversário de Casamento
   3. Informações de Nome (MapiContactNamePropertySet)
      1. Nome de Exibição
      2. Prefixo do Nome de Exibição
      3. Arquivar Sob
      4. ID de Arquivamento
      5. Geração
      6. Nome Próprio
      7. Iniciais
      8. Nome do Meio
      9. Apelido
      10. Sobrenome
   4. Informações Pessoais (MapiContactPersonalInfoPropertySet)
      1. Conta
      2. Página Comercial
      3. Nome da Rede de Computadores
      4. ID do Cliente
      5. Localização Comercial Gratuita
      6. Site FTP
      7. Gênero
      8. Número de ID Governamental
      9. Passatempos
      10. HTML
      11. Endereço de Mensagem Instantânea
      12. Idioma
      13. Local
      14. Observações
      15. Número de ID Organizacional
      16. Página Pessoal
      17. Nome da Referência
      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 Comercial
   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 de Chamada
      5. Número de Telefone de 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 Móvel
      11. Outro Número de Telefone
      12. Número de Telefone Pager
      13. Número de Telefone Principal
      14. Número de Telefone Rádio
      15. Número de Telex
      16. Número de Telefone TTY/TDD

O código a seguir usa o Aspose.Email para criar um contato do Outlook e preenche‑lo com nome, propriedades profissionais, endereço físico e e‑mail. Também demonstra a adição de MapiContactEventPropertySet para o contato.

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

Adicionando Informações de Evento ao Contato em um 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 o MapiContactEventPropertySet classe para adicionar essas informações a um contato. Isso é detalhado no exemplo a seguir.

Criando, Salvando e Lendo Contatos do Outlook

Aspose.Email permite que desenvolvedores criem contatos do Microsoft Outlook, bem como mensagens de e‑mail. O MapiContact classe 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 o MapiContact classe.

Criar e Salvar um MapiContact

Os passos a seguir podem ser usados para criar e salvar um contato em disco:

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

Salvar Contato no Formato VCF Versão 3

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

Ler um MapiContact

O MapiContact classe pode ser usada para carregar tanto arquivos MSG do Microsoft Outlook quanto contatos no formato VCard. Os exemplos de código a seguir mostram como carregar contatos do Outlook salvos como MSG e VCF em MapiContact.

Carregar um Contato a partir de MSG

Carregar um contato a partir de VCard

O código a seguir mostra como criar um MapiContact carregando dados de um arquivo VCard usando VCardLoadOptions:

MapiContact mapiContact = MapiContact.fromVCard("contact.vcf", new VCardLoadOptions());
System.out.println(mapiContact.getNameInfo().getDisplayName());

Carregar Contato VCard com Codificação Especificada

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

Renderizando Informações de Contato para MHTML

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