Работа с контактами на сервере Exchange

Учетные записи Exchange Server содержат больше, чем просто электронные сообщения. Кроме того, получение, перемещение, отправка и удаление электронных сообщений С серверов Exchange Aspose.Email позволяет работать с контактами. Эта статья объясняет, как получать информацию о контактах с помощью Exchange Web Services. Также в статье показано, как перечислять контакты из папки Contacts или разрешать контакты по имени.

Получение контактов с EWS

Aspose.Email предоставляет EWSClient класс для подключения к Microsoft Exchange Server с использованием Exchange Web Services. Последующие фрагменты кода используют Exchange Web Services для чтения всех контактов. Следующий фрагмент кода показывает, как получить контакты с помощью EWS.

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// List all the contacts
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
for (Contact contact : contacts) {
    MapiContact mapiContact = Contact.to_MapiContact(contact);
    // Display name and email address
    System.out.println("Name: " + mapiContact.getNameInfo().getDisplayName() + "+ Email Address: " + mapiContact.getElectronicAddresses().getEmail1());
}

Разрешение контактов по имени

Следующий фрагмент кода показывает, как получать контакты с помощью EWS

// Create instance of IEWSClient class by giving credentials
IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

// List all the contacts
Contact[] contacts = client.resolveContacts("Changed Name", ExchangeListContactsOptions.FetchPhoto);
for (Contact c : contacts) {
    MapiContact contact = Contact.to_MapiContact(c);
    // Display name and email address
    System.out.println("Name: " + contact.getNameInfo().getDisplayName() + "+ Email Address: " + contact.getElectronicAddresses().getEmail1());
}

Определение формата заметок контакта

NotesFormat указывает тип текстового формата заметок контактов, определенный перечислением TextFormat.

Получить контакт по ID

Определенный контакт может быть получен с сервера по его ID, как показано в следующем примере кода.

Contact fetchedContact = client.getContact(id);

Добавление контактов

Этот EWSClient класс createContact() метод может использоваться для добавления информации о контакте на сервер Exchange. createContact() метод принимает Contact объект в качестве входного параметра.

Для добавления контактов на сервер Exchange:

Инициализировать EWSClient с указанием адреса и учетных данных.
Инициализировать объект Contact с требуемыми свойствами.
Вызовите метод CreateContact, чтобы добавить контакт на сервер Exchange.

Aspose.Email предоставляет EWSClient класс для подключения к Microsoft Exchange Server с использованием Exchange Web Services. Фрагменты кода показывают, как использовать Exchange Web Services для добавления контактов на сервер Exchange.

// Set mailboxURI, Username, password, domain information
String mailboxUri = "https://ex2010/ews/exchange.asmx";
String username = "test.exchange";
String password = "pwd";
String domain = "ex2010.local";
NetworkCredential credentials = new NetworkCredential(username, password, domain);
IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// Create New Contact
Contact contact = new Contact();

// Set general info
contact.setGender(Gender.Male);
contact.setDisplayName("Frank Lin");
contact.setCompanyName("ABC Co.");
contact.setJobTitle("Executive Manager");
PhoneNumber tmp0 = new PhoneNumber();
tmp0.setNumber("123456789");
tmp0.setCategory(PhoneNumberCategory.getHome());

// Add Phone numbers
contact.getPhoneNumbers().add(tmp0);
AssociatedPerson tmp1 = new AssociatedPerson();
tmp1.setName("Catherine");
tmp1.setCategory(AssociatedPersonCategory.getSpouse());

// contact's associated persons
contact.getAssociatedPersons().add(tmp1);
AssociatedPerson tmp2 = new AssociatedPerson();
tmp2.setName("Bob");
tmp2.setCategory(AssociatedPersonCategory.getChild());
contact.getAssociatedPersons().add(tmp2);
AssociatedPerson tmp3 = new AssociatedPerson();
tmp3.setName("Merry");
tmp3.setCategory(AssociatedPersonCategory.getSister());
contact.getAssociatedPersons().add(tmp3);
Url tmp4 = new Url();
tmp4.setHref("www.blog.com");
tmp4.setCategory(UrlCategory.getBlog());

// URLs
contact.getUrls().add(tmp4);
Url tmp5 = new Url();
tmp5.setHref("www.homepage.com");
tmp5.setCategory(UrlCategory.getHomePage());
contact.getUrls().add(tmp5);
EmailAddress tmp6 = new EmailAddress();
tmp6.setAddress("Frank.Lin@Abc.com");
tmp6.setDisplayName("Frank Lin");
tmp6.setCategory(EmailAddressCategory.getEmail1());

// Set contact's Email address
contact.getEmailAddresses().add(tmp6);

try {
    client.createContact(contact);
} catch (java.lang.RuntimeException ex) {
    System.out.println(ex.getMessage());
}

Обновление контактов

Информация о контакте может быть обновлена с помощью Microsoft Outlook. Aspose.Email также может обновлять информацию о контакте на сервере Exchange, используя Exchange Web Service (EWS). IEWSClient’s updateContact() метод может обновлять информацию о контакте на сервере Exchange.

IEWSClient client = EWSClient.getEWSClient(mailboxUri, credentials);

// List all the contacts and Loop through all contacts
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
Contact contact = contacts[0];
System.out.println("Name: " + contact.getDisplayName());
contact.setDisplayName("David Ch");
client.updateContact(contact);

Удаление контактов

Этот EWSClient class предоставляет deleteItem для доступа и удаления контактов из папки Contacts сервера Exchange. Этот метод принимает ID контакта в качестве входного параметра.

Для удаления контактов с сервера Exchange:

Инициализировать ExchangeWebServiceClient с указанием адреса и учетных данных.
Удалить контакт по его ID.

Следующие фрагменты кода показывают, как удалять контакты с сервера Exchange с помощью Exchange Web Service.

IEWSClient client = EWSClient.getEWSClient("https://outlook.office365.com/ews/exchange.asmx", "testUser", "pwd", "domain");

String strContactToDelete = "John Teddy";
Contact[] contacts = client.getContacts(client.getMailboxInfo().getContactsUri());
for (Contact contact : contacts) {
    if (contact.getDisplayName().equals(strContactToDelete))
        client.deleteItem(contact.getId().getEWSId(), DeletionOptions.getDeletePermanently());

}
client.dispose();

Работа с элементами календаря на сервере Exchange Работа со списками рассылки на Exchange Server