Работа с контактами Outlook

Создание контакта Outlook

Aspose.Email for Java поддерживает создание контактов Outlook (VCards) с помощью MapiContact класс. MapiContact содержит множество методов, некоторые из которых перечислены ниже.

• MapiContactElectronicAddressPropertySet содержит набор MapiContactElectronicAddress.
• MapiContactEventPropertySet
• MapiContactNamePropertySet
• MapiContactPersonalInfoPropertySet
• MapiContactPhysicalAddressPropertySet содержит набор MapiContactPhysicalAddress.
• MapiContactProfessionalPropertySet
• MapiContactTelephonePropertySet

Структура контакта в Aspose.Email for Java

Ниже представлена иерархия, реализованная для контактов в Aspose.Email для Java. Соответствующее имя класса указано рядом с каждым свойством. Предоставлены гиперссылки на онлайн-документацию для дальнейшего ознакомления.

1. Contact (MapiContact)
   1. Электронные адреса (MapiContactElectronicAddressPropertySet)
      1. Эл. почта 1 (MapiContactElectronicAddress)
         1. Тип адреса
         2. Отображаемое имя
         3. Адрес электронной почты
         4. Номер факса
      2. Эл. почта 2
      3. Эл. почта 3
      4. Домашний факс
      5. Основной факс
      6. Факс (деловой)
   2. События (MapiContactEventPropertySet) См. ниже пример установки событий.
      1. День рождения
      2. Годовщина свадьбы
   3. Информация о имени (MapiContactNamePropertySet)
      1. Отображаемое имя
      2. Префикс отображаемого имени
      3. Классифицировать под
      4. Идентификатор классификации
      5. Поколение
      6. Имя
      7. Инициалы
      8. Отчество
      9. Псевдоним
      10. Фамилия
   4. Личная информация (MapiContactPersonalInfoPropertySet)
      1. Учётная запись
      2. Бизнес‑домашняя страница
      3. Имя компьютерной сети
      4. Идентификатор клиента
      5. Свободное расположение бизнеса
      6. FTP‑сайт
      7. Пол
      8. Номер государственного удостоверения личности
      9. Хобби
      10. HTML
      11. Адрес мгновенных сообщений
      12. Язык
      13. Место
      14. Заметки
      15. Идентификационный номер организации
      16. Личная домашняя страница
      17. Имя рекомендующего
      18. Имя супруга(и)
   5. Физический адрес (MapiContactPhysicalAddressPropertySet)
      1. Домашний адрес (MapiContactPhysicalAddress)
         1. Адрес
         2. Город
         3. Страна
         4. Код страны
         5. Почтовый код
         6. Абонентский ящик
         7. Штат или провинция
      2. Другой адрес
      3. Рабочий адрес
   6. Профессиональная информация
      1. Ассистент
      2. Название компании
      3. Название отдела
      4. Имя менеджера
      5. Местоположение офиса
      6. Профессия
      7. Должность
   7. Телефоны (MapiContactTelephonePropertySet)
      1. Номер телефона помощника
      2. Рабочий номер телефона 2
      3. Рабочий номер телефона
      4. Номер обратного вызова
      5. Номер автомобильного телефона
      6. Основной номер телефона компании
      7. Домашний номер телефона 2
      8. Домашний номер телефона
      9. Номер ISDN
      10. Мобильный номер телефона
      11. Другой номер телефона
      12. Номер пейджера
      13. Основной номер телефона
      14. Номер радиотелефона
      15. Номер телексе
      16. Номер телефона TTY/TDD

Следующий код использует Aspose.Email для создания контакта Outlook и заполняет его именем, профессиональными свойствами, физическим адресом и электронной почтой. Он также показывает добавление MapiContactEventPropertySet к контакту.

|| | :- | |Рисунок: Контакт Microsoft Outlook, закодированный с помощью Aspose.Email|

Добавление информации о событии контакта в MapiContact

Microsoft Outlook позволяет пользователям добавлять информацию о событии в контакт. Событие содержит дату рождения и годовщину свадьбы. Aspose.Email предоставляет MapiContactEventPropertySet класс для добавления этой информации в контакт. Это подробно изложено в следующем примере.

Создание, сохранение и чтение контактов Outlook

Aspose.Email позволяет разработчикам создавать контакты Microsoft Outlook, а также сообщения электронной почты. The MapiContact класс предоставляет все свойства контакта, необходимые для создания контакта Outlook. Эта статья показывает, как создать, сохранить и прочитать контакт Outlook, используя MapiContact класс.

Создание и сохранение MapiContact

Следующие шаги можно использовать для создания и сохранения контакта на диск:

1. Создайте новый объект класса MapiContact класс.
2. Введите информацию, связанную с различными свойствами контакта.
3. Добавьте данные фотографии в контакт, если они есть.
4. Сохраните контакт в формате MSG или VCard. 

Сохранить контакт в формате VCF версии 3

Чтобы сохранить контакт в формате VCF версии 3, используйте VCardVersion перечисление для установки VCardSaveOptions.Version свойство. Приведенный ниже образец кода демонстрирует использование VCardVersion перечисление для сохранения контакта в формате VCF версии 3.

Чтение MapiContact

Этот MapiContact класс можно использовать для загрузки как файлов Microsoft Outlook MSG, так и контактов в формате VCard. Приведённые ниже примеры кода показывают, как загрузить контакты Outlook, сохранённые как MSG и VCF, в MapiContact.

Загрузка контакта из MSG

Загрузка контакта из VCard

Следующий код показывает, как создать MapiContact путём загрузки данных из файла VCard с использованием VCardLoadOptions:

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

Загрузка контакта VCard с указанной кодировкой

Поддерживаемый метод: MapiContact.fromVCard(String, Encoding)

Отображение информации о контакте в MHTML

Контакт Outlook можно конвертировать в MHTML с помощью Aspose.Email API. Этот пример показывает, как VCard загружается в MapiContact и затем преобразовано в MHTML с помощью MailMessage API.