Documentation – Работа с Exchange EWS клиент

Cpp: Свързване с Microsoft Exchange чрез EWS на C++

Mon, 01 Jan 0001 00:00:00 +0000

За да се свържете с Exchange сървъри и MS 365, използвайки Exchange Web Service, Aspose.Email предоставя EWSClient клас. Този GetEWSClient метод създава и връща един IEWSClient обект, който се използва по-нататък за извършване на операции, свързани с Exchange пощенска кутия и други папки. Тази статия показва как да създадете обекти от IEWSClient.

Следният кодов пример демонстрира как да се свържете с Exchange Server, използвайки Exchange Web Services (EWS), като конфигурирате параметрите на връзката и се автентикирате с мрежови идентификационни данни, използвайки Aspose.Email за C++. Той показва процеса на задаване на URI на Exchange сървъра, домейн, потребителско име и парола, след което се създава обект за мрежови удостоверения и се установява връзка към Exchange сървъра чрез EWS клиент.

Cpp: Ръководство за управление на имейли с EWS: изпращане, четене и организиране на съобщения

Mon, 01 Jan 0001 00:00:00 +0000

Извличане на информация за Exchange пощенска кутия с EWS

Aspose.Email ви позволява да извлечете детайли за пощенска кутия от Microsoft Exchange чрез IEWSClient клас. При извикване на GetMailboxInfo() метод, клиентът връща ExchangeMailboxInfo обект, съдържащ полезни URI-та на папки като Mailbox, Inbox, Drafts и Sent Items.

За да се свържете с Exchange сървъра чрез Exchange Web Services (EWS), използвайте IEWSClient клас. Този клас използва EWS за свързване и управление на елементи в Exchange сървър.

Следният откъс от код демонстрира как да получите информация за пощенската кутия, използвайки Exchange Web Services.

Изпращане на имейл съобщения чрез EWS

Можете да изпращате имейли чрез Exchange, като извикате IEWSClient->Send() метод. Приема MailMessage обект и го изпраща директно през сървъра, използвайки EWS.

Следният примерен код показва как да изпратите HTML имейл съобщение чрез Exchange сървър, използвайки Exchange Web Services (EWS) с Aspose.Email за C++. Той демонстрира пълния процес на установяване на връзка с Exchange, създаване на имейл съобщение с подател, получател, тема и HTML съдържание, след което изпращане на съобщението чрез метода Send на EWS клиента.

Четене на имейли от пощенска кутия на друг потребител

Някои акаунти в Exchange сървъри имат право да достъпват множество пощенски кутии, а някои потребители имат множество имейл акаунти на един и същи Exchange сървър. И в двата случая потребителите могат да достъпват кутии на други потребители с Aspose.Email. API‑то предоставя механизъм за достъп до папки и имейли от други пощенски кутии, използвайки IEWSClient клас. Тази функционалност може да бъде постигната чрез претоварения GetMailboxInfo() метод и предоставяйки имейл адреса на потребителя като параметър.

Следният кодов откъс показва как да четете имейли, използвайки IEWSClient клас.

Изброяване на съобщения с EWS

Aspose.Email за C++ ви позволява да извличате метаданни за съобщения от пощенски кутии на Exchange сървър чрез IEWSClient. Използвайки базираното на EWS ListMessages с API‑то можете да изброявате съобщения от всяка папка, преглеждате метаданните на съобщенията и реализирате странициране за големи пощенски кутии.

Изброяване на съобщения от входящата кутия

Използвайте ListMessages за извличане на основна информация за съобщението като тема, подател, получатели и ID на съобщението от входящата кутия или която и да е папка.

Следният примерен код демонстрира как да изброите и покажете основната информация за всички съобщения в Exchange сървър.

Създайте инстанция на IEWSClient.
Извикайте ListMessages с URI на целевата папка.
Обхождане на ExchangeMessageInfoCollection.

Изброяване на съобщения от всяка папка

ListMessages приема всяко валидно URI на папка, позволявайки ви да изброявате елементи от Изтрити, Чернови, Изпратени или персонализирани папки. Използвайте IEWSClient->get_MailboxInfo->xxxFolderUri свойство за получаване на URI на различните папки.

Следният примерен код демонстрира как да достъпите различни URI на папки в Exchange сървър и да извлечете съобщения от конкретна папка.

Страниране при изброяване на съобщения

За големи пощенски кутии, използвайте ListMessagesByPage за зареждане на съобщения в по-малки блокове.

Следният примерен код демонстрира как да реализирате странициране за извличане на голям брой съобщения от входящата кутия на Exchange сървър.

Първо, той създава няколко тестови съобщения на сървъра.
След това използва ListMessagesByPage метод за извличане на съобщения на по-малки партиди (5 съобщения на страница в този случай), обхождайки всички страници, докато се достигне последната.
Накрая кодът проверява, че всички съобщения са успешно извлечени, като брои общия брой елементи във всички страници.

Получаване на информация за типа на съобщението

Използвайте ExchangeMessageInfo->MessageInfoType за определяне на подлежащия тип съобщение в Exchange (например имейл, заявка за среща и др.).

Следният примерен код демонстрира как да се свържете с Exchange сървър и да извлечете информация за типа съобщение от папката Изтрити.

Запазване на съобщения, използвайки Exchange Web Services (EWS)

Aspose.Email ви позволява да извличате съобщения от пощенска кутия на Exchange сървър и да ги запазвате в различни формати, като EML, потоци в паметта и MSG. Примерите по-долу демонстрират как да получим информация за съобщенията и как да ги съхраним, използвайки IEWSClient API.

Запазване на съобщения като EML файлове

За запазване на съобщения от пощенска кутия като EML файлове:

Създайте един IEWSClient инстанция, използвайки валидни данни за достъп.
Извикайте ListMessages() за извличане на ExchangeMessagesInfoCollection.
Обхождайте колекцията, за да достъпите уникалното URI на всяко съобщение.
Извикайте SaveMessage() за съхраняване на всяко съобщение на диска във формат EML.

Следният примерен код демонстрира как да запишете имейл съобщения от входящата кутия на Exchange сървър като отделни EML файлове локално, използвайки Aspose.Email за C++.

Записване на съобщения в поток в паметта

Вместо да ги записвате на диск, можете да запишете съобщенията в поток в паметта — полезно за съхраняване на имейли в база данни или обработка в паметта.

Следният примерен код демонстрира как да запишете имейл съобщения от входящата кутия на Exchange сървър в потоци в паметта.

Записване на съобщения във формат MSG

За запазване на съобщения като MSG:

Извлечете съобщението, използвайки FetchMessage(), което връща MailMessage.
Извикайте MailMessage::Save() с опции за запазване във MSG.

Следният примерен код демонстрира как да извлечете и запишете имейл съобщения от входящата кутия на Exchange сървър като файлове във формат Outlook MSG.

Извличане на детайли за съобщението по URI

Когато има налично само уникално URI на съобщение, все още можете да извлечете пълните ExchangeMessageInfo обекти. The IEWSClient::ListMessages() претоварената версия приема списък от ID на съобщения (URI) и връща ExchangeMessageInfoCollection. Използвайте тази функция, когато съхранявате или получавате URI на съобщения външно и се нуждаете от зареждане на метаданни (тема, подател, размер и др.) без изтегляне на пълните съобщения.

Следният примерен код демонстрира как да създадете няколко имейл съобщения на Exchange сървър и след това да извлечете информацията за тях, използвайки уникални идентификатори.

Извличане на пълното съдържание на съобщението

ListMessages() връща резюме на информацията (тема, подател, ID‑та). За зареждане на пълното съдържание на съобщението — тяло, хедъри, прикачени файлове — използвайте FetchMessage().

Следният примерен код демонстрира как да извлечете пълни съобщения от входящата кутия на Exchange сървър и да извлечете информация за прикачените файлове:

Създайте един IEWSClient екземпляр.
Извикайте ListMessages() за получаване на основните метаданни на съобщението.
Извлечете UniqueUri за всяко съобщение.
Извикайте FetchMessage() за извличане на пълните детайли на съобщението.

Извличане на размер на съобщението (без изтегляне на цялото съобщение)

Aspose.Email предоставя информация за размера на съобщението без да изтегля целия имейл, чрез ExchangeMessageInfo::Size свойство.

Това е полезно за:

статистика на пощенската кутия
изчисления на квотите
филтриране на големи съобщения преди изтегляне

Следният примерен код демонстрира как да изброите и покажете метаданните на съобщения, включително размера, от входящата кутия на Exchange сървър.

Изтегляне на имейли от публични папки в Exchange

Публичните папки в Exchange позволяват съхранението на споделени съобщения между потребители.

Aspose.Email IEWSClient Позволява ви да извършвате следните операции с тези папки и съхранените в тях съобщения:

Изброяване на публични папки
Рекурсивно преглеждане на подпапки
Изтегляне на съобщения и запазването им (например като MSG файлове)

Бележка: Необходим е Microsoft Exchange Server 2007 или по-нова версия, тъй като по-ранните версии не поддържат EWS.

Следният примерен код демонстрира как рекурсивно да изтеглите съобщения от всички публични папки и техните подпапки на Exchange сървър и да ги запишете локално като Outlook MSG файлове.

Преместване на съобщения между папки в Exchange

Можете да преместите съобщения от една папка в Exchange в друга, като използвате IEWSClient::MoveItem метод. Изисква:

Уникалното URI на съобщението за преместване.
Уникалното URI на целевата папка.

Следният примерен код демонстрира как да филтрирате и преместите конкретни имейл съобщения от входящата кутия на Exchange сървър в друга папка въз основа на съдържателни критерии.

Свържете се с Exchange сървър, използвайки EWS данни за достъп.
Получете информация за пощенската кутия (URI‑та на папките).
Избройте всички съобщения от входящата кутия.
Обхождайте всяко съобщение.
Проверете дали темата съдържа "process this message".
Премества съвпадащите съобщения в папката Изтрити.
Извежда потвърждение за всяко преместено съобщение.

Изтриване на съобщения от папка в Exchange

Можете да изтривате имейл съобщения от папка с помощта на IEWSClient->DeleteMessage метод. Той приема уникалния URI на съобщението като параметър.

Следният примерен код демонстрира как да филтрирате и изтриете конкретни имейл съобщения от входящата кутия на Exchange сървър, въз основа на критерий за тема.

Обхождане на съобщения в входящата кутия.
Обработвайте съобщенията според определени критерии (в този пример намираме ключова дума в темата на съобщението).
Изтриване на съвпадащи съобщения.

Копиране на съобщения в друга папка в Exchange

Използвайте IEWSClient::CopyItem за дублиране на съобщение в различна папка. Претоварената версия връща URI на новосъздаденото копие.

Следният примерен код демонстрира как да създадете имейл съобщение в Exchange сървър и да го копирате в друга папка.

Cpp: Филтриране на съобщения от Exchange пощенска кутия

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email for C++ позволява на разработчиците да филтрират съобщения в Exchange пощенска кутия, като използват IEWSClient, MailQuery, и ExchangeQueryBuilder. Можете да филтрирате съобщения по дата, подател, домейн, MessageID, известия за доставка и много други критерии.

За да извлечете съобщения от папка за последваща обработка, IEWSClient. има следните методи:

ListMessages() - Получава всички съобщения от пощенска кутия.
ListMessages() презареждане – Връща само съобщения, които отговарят на конкретни условия. Приема MailQuery което определя правила за филтриране, като ключови думи в темата, диапазони от дати и филтриране по адрес.

Филтриране на съобщения с IEWSClient

Следният пример с код демонстрира как да заявите и извлечете конкретни имейли от Exchange Server, използвайки Exchange Web Services (EWS) с Aspose.Email за C++. Той показва целия процес на свързване към Exchange сървър (в случая Office 365), създаване на заявка за търсене, за да се намерят съобщения със "Newsletter" в темата, получени днес, изпълнение на заявката срещу пощенската кутия, извличане на съвпадащите съобщения и правилно управление на жизнения цикъл на връзката с обработка на грешки.

Свържете се с Exchange сървъра чрез IEWSClient.
Създайте MailQuery или ExchangeQueryBuilder и дефинирайте условия за филтриране.
Извикайте ListMessages(folderUri, query) за получаване на филтрираните резултати.

Филтриране на съобщения по критерий

Горният примерен код филтрира съобщения въз основа на темата и датата на имейла. Можете да филтрирате и по други свойства. По-долу са някои примери за задаване на условия, използвайки MailQuery.

Филтриране по датата на днес

Следният примерен код показва как да създадете заявка за намиране на имейли, получени днес.

Филтриране по диапазон от дати

Следният примерен код показва как да създадете заявка за намиране на имейли, получени през последните 7 дни.

Филтриране по конкретен подател

Следният примерен код показва как да създадете заявка за намиране на имейли от конкретен подател.

Филтриране по домейн

Следният примерен код показва как да създадете заявка за намиране на имейли от конкретен домейн.

Филтриране по получател

Следният примерен код показва как да създадете заявка за намиране на имейли, изпратени до конкретен получател.

Филтриране по MessageID

Следният примерен код показва как да създадете заявка за намиране на конкретен имейл по неговото MessageId.

Филтриране на известия за доставка на поща

Следният примерен код показва как да създадете заявка за намиране на известия за доставка на поща (MDN).

Филтриране по размер на съобщението

Следният примерен код показва как да създадете заявка за намиране на имейли, по-големи от конкретен размер.

Създаване на сложни заявки

Когато се използва MailQueryBuilder или ExchangeQueryBuilder, всяко зададено от вас свойство създава условие за филтриране. Ако тези условия са дефинирани в отделни изречения, те се комбинират с логическо AND, което означава, че всички условия трябва да съответстват, за да бъде върнато съобщение.

Това позволява на разработчиците да създадат прецизни филтри като:

Имейли в диапазон от дати
Имейли от конкретен домейн
Имейли, отговарящи на множество критерии едновременно

Комбиниране на заявки с AND

Използването на множество свойства на съставителя последователно автоматично създава операция AND.

Следният пример извлича съобщения, които:

Произхождат от конкретен домейн
Получени преди днес
Получени през последните седем дни

Комбиниране на заявки с OR

За да съвпадат съобщения, които отговарят на едно от двете условия, използвайте метода Or().

Следният пример получава съобщения, които:

Съдържат “test” в темата, или
Бяха изпратени от “noreply@host.com”

Филтриране на имейли с чувствителност към главни/малки букви

Можете да приложите регистрационно чувствително или нечувствително към регистъра филтриране при заявка за съобщения от Exchange пощенска кутия. За контролиране на това поведение, използвайте флага IgnoreCase, наличен в методите за филтриране. Предаване на true активира нечувствително към регистъра съвпадение.

Примерът по-долу филтрира съобщения, които:

Съдържат думата "Newsletter" в темата (без регистър)
Получени днес

Странициране при филтриране на съобщения

При работа с големи Exchange пощенски кутии, страницирането ви позволява да извличате съобщения на по-малки, управляеми партиди. ListMessagesByPage метод на IEWSClient връща резултати страница по страница въз основа на зададен размер на страницата и критерии за заявка.

Примерът по-долу показва как да:

Създайте филтър, използвайки MailQueryBuilder.
Извличайте резултатите на страници.
Обхождайте всички страници до последната.
Пребройте общия брой съвпадащи съобщения.

Cpp: Управление на елементи от разговори

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email може да се използва за управление на елементите от разговори в Exchange Server с EWSClient клас. Този клас използва Exchange Web Services, които са налични само в Exchange Server 2007 и по-късни версии. Тази статия показва как да се намерят, копират, преместят и изтрият елементи от разговори в Exchange Server 2010. За всички функции, включени в този раздел, е необходим Microsoft Exchange Server 2010 Service Pack 1.

Търсене на разговори

За да получите информация за разговор от конкретна папка в Exchange Server:

Свържете се с Exchange Server, използвайки IEWSClient клас.
Извикайте FindConversations() метод за намиране на всички елементи от разговор в папка.
Показване на свойства на елемента от разговор като ID, тема на разговора и статус на флага.

Следният кодов откъс показва как да намерите разговори.

Копиране на разговори

За да копирате разговори от една папка в друга:

Свържете се с Exchange Server, използвайки IEWSClient клас.
Извикайте CopyConversationItems() метод за копиране на елемент от разговор от изходната папка към целевата папка.

Следният кодов фрагмент показва как да копирате разговори.

Преместване на разговори

За да преместите разговори от една папка в друга:

Свържете се с Exchange Server, използвайки IEWSClient клас.
Извикайте MoveConversationItems() метод за преместване на разговор от изходната папка към целевата папка.

Следният кодов фрагмент показва как да преместите разговори.

Изтриване на разговори

За да изтриете разговори от папка:

Свържете се с Exchange Server, използвайки IEWSClient клас.
Извикайте DeleteConversationItems() метод за изтриване на разговорния елемент от изходната папка.

Следният кодов откъс показва как да изтриете разговори.

Cpp: Управление на разговори в Exchange чрез EWS на C++

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email ви позволява да управлявате елементи от разговори в Microsoft Exchange Server, използвайки EWSClient клас. Тази функционалност се базира на Exchange Web Services (EWS), налични в Exchange Server 2007 и по-нови версии. Примерите в това ръководство демонстрират как да намерите, копирате, преместите и изтриете елементи от разговори в Exchange Server 2010 SP1 или по-нов.

Намиране на разговори

За да извлечете информация за разговори от конкретна папка в Exchange, следвайте стъпките по-долу:

Свържете се към Exchange Server чрез IEWSClient.
Извикайте FindConversations() метод за изброяване на разговори в целевата папка.
Прочетете свойства като ID на разговора, тема и статус на флага.

Следният пример с код демонстрира как да намерите и покажете елементи от разговори от пощенска кутия в Exchange Server.

Копиране на разговори

За да копирате елементи от разговори в друга папка:

Свържете се към Exchange Server чрез IEWSClient.
Извличане на разговори с FindConversations() метод.
Използвайте CopyConversationItems() за копиране на съвпадащи разговори.

Следният пример с код демонстрира как да намерите и копирате конкретни елементи от разговори от пощенска кутия в Exchange Server в папката Изтрити елементи, въз основа на зададеното условие.

Преместване на разговори

Можете да преместите разговори между папки. Следният пример с код демонстрира как да намерите и преместите конкретни елементи от разговори от пощенска кутия в Exchange Server в друга папка.

Свържете се към Exchange Server чрез IEWSClient.
Идентифицирайте разговорите за преместване.
Извикайте MoveConversationItems() метод с URI на целевата папка.

Изтриване на разговори

За изтриване на нишки от разговори в папка:

Свържете се към Exchange Server чрез IEWSClient.
Използвайте FindConversations() за локализиране на целевите разговори.
Извикайте DeleteConversationItems() метод за премахването им.

Следният пример с код демонстрира как да намерите и изтриете конкретни елементи от разговори от пощенска кутия в Exchange Server.

Cpp: Управлявайте календар и заявки за срещи с Exchange Web Services (EWS)

Mon, 01 Jan 0001 00:00:00 +0000

Тази статия обяснява как да работите със заявки за срещи и календарни елементи, използвайки Aspose.Email за C++ и Exchange Web Services (EWS). Ще научите как да:

Изпращане на заявки за срещи до един или няколко получатели
Създаване, актуализиране и анулиране на срещи
Изброяване на календарни елементи с поддръжка на странициране
Добавяне на събития към вторични календари
Споделяне на календари с потребители
Извличане на разширени свойства от календарни елементи

Всички сценарии включват C++ примерен код, използващ IEWSClient.

Изпратете заявка за среща чрез EWS

Можете да създадете и изпратите заявка за среща, като съставите един Appointment обект и да я прикрепите към MailMessage преди да я изпратите чрез IEWSClient.

Следният примерен код показва как да създадете и изпратите заявка за повтаряща се среща чрез Exchange Web Services:

Създайте един Appointment и задайте местоположението, времето, участниците.
Добавете повтаряне, ако е необходимо.
Създайте имейл съобщение, използвайки MailMessage клас.
Прикрепете заявката за среща чрез AddAlternateView().
Свържете се с Exchange сървъра и изпратете съобщението, използвайки IEWSClient->Send(MailMessage) метод.

Създаване, актуализиране и анулиране на срещи

Aspose.Email предлага специализирани IEWSClient методи за управление на календарни елементи:

CreateAppointment()
UpdateAppointment()
CancelAppointment()
FetchAppointment()

Следният примерен код показва как да управлявате календарните операции на Exchange сървър, използвайки Aspose.Email за C++. Той демонстрира пълния жизнен цикъл на създаване, извличане, актуализиране и анулиране на срещи чрез Exchange Web Services, включително задаване на информация за часовата зона, изброяване на всички срещи и потвърждаване на промените чрез извличане и показване на детайли за срещата преди и след модификациите.

Изброяване на срещи с поддръжка на странициране

Когато пощенска кутия съдържа много срещи, страницирането помага за ефективно извличане на елементите. За тази цел, Aspose.Email предлага множество претоварвания на ListAppointmentsByPage() метод, включващ комбинации от функции за заявки.

Следният примерен код показва как да създадете няколко календарни срещи със следователни времеви слотове, след което да приложите странициране, за да изброите всички срещи, като ги извличате на по-малки, управляеми страници, вместо да зареждате цялата колекция наведнъж, което е полезно при работа с голям брой календарни елементи.

Добавяне на събития към вторична календарна папка

Можете да създавате персонализирани календарни папки и да управлявате срещи в тях. Следният примерен код показва как да създадете и управлявате вторична календарна папка в Exchange сървър и да извършвате операции със срещи в нея. Това включва проверка за съществуваща персонализирана календарна папка, създаване на нова папка, ако не съществува, след което изпълнение на пълни CRUD операции (създаване, четене, актуализиране, изтриване) на срещи както в персонализираната папка, така и в стандартната календарна папка, включително задаване на текущ контекст на календар за опростени API повиквания.

Споделяне на покана за календар

Microsoft Exchange сървърът предоставя възможност за споделяне на календари, като изпраща календарни покани до други потребители, регистрирани на същия Exchange сървър. Aspose.Email API предоставя същата възможност, като позволява споделяне на календара чрез EWS API.

Извличане на разширени свойства от календарни елементи

Aspose.Email ви позволява да извличате персонализирани MAPI свойства от календарни елементи, използвайки дескриптори на свойства.

Cpp: Управление на контакти с Exchange Web Services (EWS) на C++

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email ви позволява да работите с повече от само имейл съобщения на Microsoft Exchange Server. С помощта на EWSClient API, можете да извличате, разрешавате, създавате, актуализирате и изтривате контакти, съхранени в пощенска кутия на Exchange. Тази статия обяснява ключовите операции за управление на контакти с Exchange Web Services (EWS).

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

Aspose.Email предоставя EWSClient клас за свързване с Microsoft Exchange чрез EWS. Примерът по-долу показва как да прочетете всички контакти от папката Contacts:

Търсене на контакти по име

Можете да разрешавате контакти, използвайки име за показване. Следният пример извлича съвпадащи контакти и техните данни:

Определяне на формата на бележките на контакта

Този Contact->get_NotesFormat свойство задава формата на текста на бележките според TextFormat изброител.

Извличане на контакт по ID

Можете да извлечете конкретен контакт, използвайки неговото уникално ID, както е показано в кода по-долу.

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

Използвайте CreateContact() метод за добавяне на нов контакт в Exchange Server. Следният пример демонстрира как да попълните и запазите контакт:

Актуализиране на контакти

Информацията за контакт може да бъде променяна на сървъра, използвайки IEWSClient->UpdateContact. Следният кодов пример демонстрира как да извлечете, покажете и актуализирате контакти в Exchange Server:

Изтриване на контакти

Този IEWSClient клас предоставя DeleteContact за достъп и изтриване на контакти от Exchange Server. Този метод приема ID на контакта или Contact като входен параметър.

Следният кодов фрагмент показва как да изтриете контакти от Exchange сървър, използвайки IEWClient->DeleteContact.

Cpp: Управление на списъци за разпространение в Exchange Server с EWS на C++

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email за C++ предоставя пълна поддръжка за създаване, четене, актуализиране и изтриване на списъци за разпространение в Exchange чрез IEWSClient. С помощта на EWS можете да управлявате частни и публични списъци за разпространение, да добавяте или премахвате членове, да извличате детайли за списъка и да изпращате съобщения до списъците за разпространение програмено.

Създаване на списък за разпространение

Използвайте CreateDistributionList() за създаване на нов частен списък за разпространение и определяне на неговите членове.

Извличане на частен списък за разпространение

Следният кодов фрагмент показва как да извлечете всички частни списъци и да изброите техните членове.

Разширяване на публичен списък за разпространение

Следният кодов фрагмент показва как да разширите публични списъци, като посочите техния имейл адрес.

Добавяне на членове към частен списък за разпространение

Добавяне след изброяване

Следният фрагмент от код показва как да добавите членове към частен списък за разпространение.

Добавяне без изброяване

Следният фрагмент от код показва как да добавите членове без изброяване.

Изпращане на имейл до частен списък за разпространение

Следният кодов фрагмент показва как да изпратите имейли до частен списък за разпространение.

Изтриване на членове от частен списък за разпространение

Изтриване след изброяване

Следният фрагмент от код показва как да изтриете членове от частен списък за разпространение.

Изтриване без изброяване

Следният фрагмент от код показва как да изтриете членове без изброяване.

Изтриване на частен списък за разпространение

Изтриване след изброяване

Следният фрагмент от код показва как да изтриете частен списък за разпространение.

Изтриване без изброяване

Следният кодов откъс показва как да изтриете без изброяване.

Cpp: Работа с папки в Exchange Server

Mon, 01 Jan 0001 00:00:00 +0000

Изброяване на всички папки от сървъра

Aspose.Email API осигурява възможност за свързване към Exchange Server и изброяване на всички папки и подпапки. Можете също да извлечете всички подпапки от всяка папка рекурсивно. Осигурява и възможност за изброяване на папки със странициране от Exchange клиента, използвайки Exchange Web Service (EWS). Тази статия показва как да извлечете всички подпапки от Exchange сървъра и да изброявате папките със странициране.

Следният кодов фрагмент ви показва как да изброите папки от Exchange Server.

Получаване на информация за типа на папка с EWS

Този ExchangeFolderType изброител, предоставен от ExchangeFolderInfo клас може да се използва за получаване на информация за типа на папката. Това е показано в следния пример с код.

Изброяване на папки със странициране с EWS

Следният кодов фрагмент показва как да използвате поддръжка на странициране с EWS.

Достъп до персонализирани папки или подпапки в пощенската кутия

IEWSClient позволява на разработчиците достъп до всяка персонализирана папка или подпапка от пощенската кутия. FolderExists() метод на IEWSClient връща URI на указаната персонализирана папка/подпапка, което след това може да се използва за достъп до целевата папка. В следващия пример се достъпва персонализирана папка наречена "TestInbox", създадена под INBOX, и се показват всички съобщения от тази папка. За изпълнение на тази задача се извършват следните стъпки:

Инициализирайте IEWSClient обект, като се предоставят валидни идентификационни данни.
Достъпете пощенската кутия по подразбиране.
Достъпете родителската папка, която в този пример е INBOX. Тази родителска папка също може да бъде персонализирана папка.
Използвайте FolderExists() метод за търсене в указаната персонализирана подпапка, например "TestInbox". Той ще върне URI‑то на "TestInbox".
Използвайте този URI, за да достъпите всички съобщения в тази потребителска папка.

Следният кодов откъс показва как да получите достъп до персонализирани папки или подпапки в пощенската кутия с EWS.

Изброяване на публични папки

Microsoft Exchange Server позволява на потребителите да създават публични папки и да публикуват съобщения в тях. За да направите това чрез вашето приложение, използвайте EWSClient клас за свързване към Exchange Server и четене и изтегляне на съобщения и публикации от публични папки. Следният кодов фрагмент показва как се четат всички публични папки и подпапки, както и как се изброяват и изтеглят намерените съобщения в тези папки. Този пример работи само с Microsoft Exchange Server 2007 или по-нов, тъй като само те поддържат EWS.

Синхронизиране на елементи в папка

API‑та на Aspose.Email IEWSClient осигурява функция за синхронизация на Exchange папка и нейното съдържание. SyncFolder метод, предоставен от IEWSClient клас, който може да се използва за синхронизиране на информация за папка в указаната папка. Следният кодов фрагмент показва как да синхронизирате информация за папка в Exchange.

Извличане на разрешения за Exchange папки

На потребителите се задават разрешения за публични папки в Exchange Server, което ограничава/определя нивото на достъп, което потребителят има до тези папки. Класът ExchangeFolderPermission предоставя набор от свойства за разрешения за папки в Exchange, като ниво на разрешение, дали могат да създават елементи, да изтриват елементи и да извършват други задачи, определени от свойствата на разрешенията. Разрешенията могат да се извлекат чрез GetFolderPermissions() метод на IEWSClient. Тази статия показва как да се извлекат разрешенията, приложени към публична папка, за всички потребители, които имат достъп до споделените папки.

За да изпълните тази задача:

Инициализирайте IEWSClient.
Използвайте ListPublicFolders за получаване на списък с всички публични папки
Получете разрешенията, свързани с папка, като използвате GetFolderPermissions() метод

Следният кодов откъс показва как да използвате IEWSClient клас за извличане на разрешенията, приложени към папка.

Създаване на папки и подпапки

Aspose.Email API предоставя възможност за създаване на папки в Exchange пощенска кутия. The CreateFolder метод на IEWSClient може да се използва за тази цел. За да създадете папка в пощенската кутия на Exchange сървъра, могат да се следват следните стъпки.

Създайте инстанция на IEWSClient.
Задайте set_UseSlashAsFolderSeparator свойство, както е необходимо. Ако е зададено на true, приложението ще счита „Slash“ за разделител на папки и подпапката ще бъде създадена след наклонената черта.
Използвайте CreateFolder метод за създаване на папката.

Следният кодов фрагмент показва как да създавате папки и подпапки.

Архивиране на папки от Exchange към PST

Често се случва потребителите да искат да създадат резервно копие на всички или част от папките в пощенската кутия. Aspose.Email предоставя възможност за създаване на резервно копие на всички или избрани папки от Exchange пощенска кутия в PST файл. За да направите резервно копие на папки от Exchange сървъра, могат да се следват следните стъпки.

Създайте инстанция на IEWSClient.
Добавете необходимата информация за папката към ExchangeFolderInfoCollection
Използвайте IEWSClient->Backup метод за експортиране на съдържанието на папката в PST

Следният кодов фрагмент показва как да архивирате папки от Exchange в PST.

Cpp: Работа с правила в Exchange Server

Mon, 01 Jan 0001 00:00:00 +0000

Управление на правила

Aspose.Email може да се използва за управление на правилата в Exchange Server чрез EWSClient клас. Този клас използва Exchange Web Services (EWS), които са достъпни в Exchange Server 2007 и по-късни издания. За да покажем как да управляваме правила, тази статия обяснява как да:

Прочетете правилата, вече налични на сървъра.
Създайте ново правило.
Актуализирайте съществуващо правило.

Microsoft Exchange Server 2010 Service Pack 1 е необходим за всички функции, описани в тази статия.

Четене на правила

За получаване на всички правила от Exchange Server:

Свържете се с Exchange Server, използвайки IEWSClient клас.
Извикайте IEWSClient->GetInboxRules() метод за получаване на всички правила.
В цикъл, прегледайте всички правила и покажете свойствата им, като условия, действия и имена.

Следният кодов фрагмент показва как да четете правилата.

Създаване на ново правило

За създаване на ново правило в Exchange Server, изпълнете следните стъпки:

Свържете се с Exchange Server, използвайки IEWSClient клас.
Създайте нов екземпляр от класа InboxRule и задайте следните задължителни свойства:
1. Показвано име
2. Условия
3. Действия
Извикайте IEWSClient->CreateInboxRule() метод за създаване на правилото.

Следният кодов фрагмент показва как да създадете ново правило.

Актуализиране на правило

За актуализиране на правило в Exchange Server:

Свържете се с Exchange Server, използвайки IEWSClient клас.
Извикайте IEWSClient->GetInboxRules() метод за получаване на всички правила.
В цикъл обходете всички правила и намерете правилото, което искате да промените, като съпоставите DisplayName в условие.
Актуализирайте свойствата на правилото
Извикайте IEWSClient.UpdateInboxRule() метод за актуализиране на правилото.

Следният кодов фрагмент показва как да актуализирате правило.

Cpp: Работа със задачи в Exchange Server

Mon, 01 Jan 0001 00:00:00 +0000

Работа със задачи

Aspose.Email поддържа обработка на задачи на Exchange сървър, използвайки класа ExchangeTask. Различни свойства на ExchangeTask, като Subject, Status, DueDate и Priority, могат да се използват за конфигуриране на задачата в Exchange. IEWSClientкласът излага функции като CreateTask, UpdateTask, и DeleteTask които се използват за обработка на задачи на Exchange сървъра. Тази статия показва как да:

Създаване на нова задача.
Задаване на часовата зона на задача.
Актуализиране на задача.
Изтриване на задача.
Изпращане на заявка за задача
Запазване на задача на диск

Създаване на нова задача

Следният кодов откъс показва как да създадете нова задача.

Задаване на часовата зона

Този IEWSClient интерфейсът и ExchangeTask предоставят TimeZoneId свойство за задаване на информация за часовата зона при създаване на задача. Следният кодов фрагмент показва как да зададете часовата зона.

Актуализиране на задача

Следните откъси от код показват как да актуализирате задача на Exchange сървъра.

Изтриване на задача

Следният откъс от код показва как да изтриете задача на Exchange сървъра.

Изпращане на заявка за задача

Aspose.Email Exchange услугата предоставя възможност за изпращане на заявки за задачи, подобно на Outlook. Следният кодов откъс показва как да заредите съобщение за заявка за задача от диска и да го изпратите, използвайки IEWSClient.

Запазване на задача на диск

Aspose.Email също позволява запазване на Exchange задачи на диск в Outlook MSG формат. Следният кодов откъс показва как да запазите задача на диск.

Cpp: Работа с потребителска конфигурация на сървъра

Mon, 01 Jan 0001 00:00:00 +0000

Управление на потребителска конфигурация

Aspose.Email API може да се използва за управление на потребителска конфигурация в Exchange Server с EWSClient клас. Този клас използва Exchange Web Services, достъпни само в Exchange Server 2007 и по-нови версии. В тази статия ще видим как да четете, създавате, обновявате и изтривате потребителски конфигурации в Exchange Server 2010. Microsoft Exchange Server 2010 Service Pack 1 е необходим за всички функции, описани в тази статия. Следният кодов откъс показва как да се свържете с Exchange Server 2010 във всички примери в статията.

Четене на потребителска конфигурация

За да получите информация за потребителската конфигурация на конкретна папка от Exchange Server:

Свържете се с Exchange Server чрез IEWSClient.
Извикайте GetUserConfiguration() метод за получаване на потребителската конфигурация за папка.
Показване на свойствата на потребителската конфигурация като ID, име и елементи от речника като двойки ключ-стойност.

Следният кодов откъс показва как да прочетете потребителска конфигурация.

Създаване на потребителски конфигурации

За да създадете потребителска конфигурация за конкретна папка в Exchange Server:

Свържете се към Exchange Server чрез IEWSClient.
Извикайте CreateUserConfiguration() метод за създаване на потребителска конфигурация за папка.

Следният кодов пример показва как да създадете потребителски конфигурации.

Обновяване на потребителска конфигурация

За да обновите потребителската конфигурация за конкретна папка в Exchange Server:

Свържете се към Exchange Server чрез IEWSClient.
Извикайте UpdateUserConfiguration() метод за актуализиране на потребителската конфигурация за папка.

Следният кодов откъс показва как да обновите потребителска конфигурация.

Изтриване на потребителска конфигурация

За да изтриете потребителската конфигурация за конкретна папка в Exchange Server:

Свържете се към Exchange Server чрез IEWSClient.
Извикайте DeleteUserConfiguration() метод за изтриване на потребителската конфигурация за папка.

Следният кодов откъс показва как да изтриете потребителска конфигурация.

Cpp: Полезни функции

Mon, 01 Jan 0001 00:00:00 +0000

Изпращане на съобщение с опция за гласуване

Microsoft Outlook позволява на потребителите да създадат анкета при съставяне на ново съобщение. Това се постига чрез включване на опции за гласуване като Да, Не, Може би и др. Класът FollowUpOptions, предлаган от Aspose.Email, предоставя свойството VotingButtons, което може да се използва за задаване или получаване на стойността на опциите за гласуване. Тази статия предоставя подробен пример за създаване на MapiMessage с опции за гласуване за създаване на анкета и след това изпращане на съобщението чрез клиент за Exchange Web Service (EWS).

Създаване и изпращане на съобщение с опции за гласуване

Следният фрагмент от код показва как да създадете ново съобщение и след това да го изпратите с опции за гласуване.

Следният кодов фрагмент показва дефиницията на метода CreateTestMessage, използван в горния пример.

Игнориране или заобикаляне на невалиден или изтекъл SSL сертификат

Aspose.Email може да обработва SSL сертификати в Exchange Server, като използва EWSClient клас. Ако SSL сертификатът е изтекъл или станал невалиден, Aspose.Email хвърля изключение поради невалиден SSL сертификат. Избягвайте такива SSL грешки, като ги игнорирате чрез метода, използван в кода по-долу. Регистрирайте обработчика за обратно извикване в вашия main() или init() метод и добавете метода по-долу като член на класа.

Създаване на RE и FW съобщения от MSG файлове

IEWSClient позволява на разработчиците да създават RE (Reply/Reply All) и FW (Forward) съобщения от изходно съобщение. Изходното съобщение се идентифицира чрез избор на конкретно ExchangeMessageInfo от ExchangeMessageInfoCollection получен чрез ListMessages(). Другият аргумент е действителният MailMessage за изпращане като RE или FW съобщение. Следният кодов фрагмент показва как да изпратите съобщение, след което да отговорите на това съобщение и да го препратите. За изпълнение на тази задача:

Инициализирайте IEWSClient обект, като се предоставят валидни идентификационни данни.
Изпратете няколко примерни съобщения.
Извикайте Reply(), ReplyAll() и Forward() методи за изпращане на съобщения.

Добавяне на заглавки в EWS заявки

Aspose.Email API позволява добавяне на заглавки към заявките към Exchange. Това може да се използва за добавяне на заглавки към EWS заявките за различни цели. Един пример е добавянето на заглавката X-AnchorMailbox, която се използва за управление на проблемите с ограничаването (throttling) на Exchange сървъра. AddHeader метод на IEWSClient се използва за добавяне на заглавки към EWS заявките, както е показано в следния кодов откъс.

Работа с обединено съобщение

Aspose.Email може да извлича информация за обединено съобщение от Exchange Server 2010. Обединените съобщения, като получаване на конфигурационна информация, иницииране на изходящо обаждане, извличане на информация за телефонно обаждане по ID и прекъсване на обаждане по ID, в момента се поддържат. Следният примерен код показва как да се извлече конфигурационна информация за обединено съобщение от Microsoft Exchange Server 2010.

Получаване на съвети за поща

Microsoft Exchange Server добави няколко нови функции с Exchange Server 2010 и 2013. Една от тях позволява на потребителите да получават съвети за имейл, докато съставят съобщение. Тези съвети са много полезни, защото предоставят информация преди изпращане на имейла. Например, ако имейл адресът в списъка на получателите е грешен, се показва съвет, който ви информира, че адресът е невалиден. Съветите за поща също ви позволяват да видите отговори за извън офис, преди да изпратите имейл: Exchange Server (2010 & 2013) изпраща съвет за поща, докато имейлът се съставя, ако един или повече получатели са задали отговори за извън офис. За всички функции, демонстрирани в тази статия, е необходим Microsoft Exchange Server 2010 Service Pack 1. Следният кодов фрагмент показва как се използва EWSClient клас, който използва Exchange Web Services, налични в Microsoft Exchange Server 2007 и по-нови версии.

Cpp: Филтриране на назначения от Exchange Server

Mon, 01 Jan 0001 00:00:00 +0000

Aspose.Email за C++ позволява на разработчиците да филтрират календарни срещи в Microsoft Exchange, като използват IEWSClient и ExchangeQueryBuilder API‑та. Можете да филтрирате срещи по диапазон от дати, състояние на повторяемост или други свойства, за да извлечете само необходимите събития.

Филтриране на срещи по диапазон от дати

Използвайте ExchangeQueryBuilder за да зададете условия за начално и крайно време и генерирате MailQuery за извличане на съвпадащи срещи.

Филтриране на повторяеми или неповторяеми срещи

Можете да филтрирате срещи въз основа на това дали са повторяеми събития.