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 клас. The GetEWSClient метод створює та повертає IEWSClient об’єкт, який далі використовується для виконання операцій, пов’язаних з поштовою скринькою Exchange та іншими папками. У цій статті показано, як створювати екземпляри IEWSClient.

Нижче наведено приклад коду, який демонструє, як підключитися до сервера Exchange, використовуючи 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 Server через IEWSClient. Використовуючи EWS‑based ListMessages API, ви можете вивести список повідомлень з будь-якої папки, переглядати метадані повідомлень та реалізовувати посторінкове навантаження для великих поштових скриньок.

Список повідомлень з Вхідних

Використати ListMessages для отримання базової інформації про повідомлення, такої як тема, відправник, отримувачі та ідентифікатор повідомлення, з Вхідних або будь-якої папки.

Наступний приклад коду демонструє, як вивести список і відобразити базову інформацію про всі повідомлення на сервері Exchange.

Створіть екземпляр IEWSClient.
Викличте ListMessages з URI цільової папки.
Перебирайте ExchangeMessageInfoCollection.

Список повідомлень з будь‑якої папки

ListMessages приймає будь-який дійсний URI папки, дозволяючи виводити елементи з Видалені, Чернетки, Відправлені або користувацькі папки. Використайте IEWSClient->get_MailboxInfo->xxxFolderUri властивість для отримання URI різних папок.

Наступний приклад коду демонструє, як отримати доступ до різних URI папок Exchange Server та отримати повідомлення з вказаної папки.

Посторінкова навігація у списку повідомлень

Для великих поштових скриньок використовуйте ListMessagesByPage для завантаження повідомлень у менших блоках.

Наступний приклад коду демонструє, як реалізувати пагінацію для отримання великої кількості повідомлень з вхідних на сервері Exchange.

Спочатку він створює кілька тестових повідомлень на сервері.
Потім використовує ListMessagesByPage метод для отримання повідомлень у менших пакетах (у цьому випадку по 5 повідомлень на сторінку), перебираючи всі сторінки до останньої.
Нарешті, код перевіряє, що всі повідомлення були успішно отримані, підраховуючи загальну кількість елементів на всіх сторінках.

Отримати інформацію про тип повідомлення

Використати ExchangeMessageInfo->MessageInfoType для визначення базового типу повідомлення Exchange (наприклад, електронна пошта, запит на зустріч тощо).

Наступний приклад коду демонструє, як підключитися до сервера Exchange і отримати інформацію про тип повідомлення з папки Видалені.

Збереження повідомлень за допомогою Exchange Web Services (EWS)

Aspose.Email дозволяє отримувати повідомлення з поштової скриньки Exchange Server та зберігати їх у кількох форматах, таких як 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() перевантаження приймає список ідентифікаторів повідомлень (URI) і повертає ExchangeMessageInfoCollection. Використовуйте цю функцію, коли ви зберігаєте або отримуєте URI повідомлень зовні і потрібно завантажити метадані (тема, відправник, розмір тощо) без отримання повних повідомлень.

Наступний приклад коду демонструє, як створити кілька електронних листів на сервері Exchange, а потім отримати їхню інформацію за допомогою унікальних ідентифікаторів.

Отримати повний вміст повідомлення

ListMessages() повертає резюме інформацію (тема, відправник, ідентифікатори). Щоб завантажити повний вміст повідомлення — тіло, заголовки, вкладення — використовуйте FetchMessage().

Наступний приклад коду демонструє, як отримати повні повідомлення з вхідних на сервері Exchange і отримати інформацію про вкладення:

Створіть IEWSClient екземпляр.
Викличте ListMessages() для отримання базових метаданих повідомлення.
Отримайте унікальний URI кожного повідомлення.
Викличте 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, посторінкове отримання дозволяє отримувати повідомлення меншими, зручними порціями. The 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. API Aspose.Email забезпечує таку ж можливість, дозволяючи ділитися календарем за допомогою API EWS.

Отримати розширені властивості з елементів календаря

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. Нижче наведено приклад, як прочитати всі контакти з папки Контакти:

Визначити контакти за ім’ям

Ви можете розв’язувати контакти за допомогою відображуваного імені. Нижче наведено приклад, який отримує підходящі контакти та їхні деталі:

Визначити формат нотаток контакту

The Contact->get_NotesFormat властивість вказує формат тексту нотаток згідно з TextFormat перелічувач.

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

Ви можете отримати конкретний контакт, використовуючи його унікальний ідентифікатор контакту, як показано у наведеному нижче коді.

Додати контакти

Використайте CreateContact() метод для додавання нового контакту до Exchange Server. Нижче наведено приклад, який демонструє, як заповнити та зберегти контакт:

Оновити контакти

Інформацію про контакт можна змінити на сервері за допомогою IEWSClient->UpdateContact. Нижче наведено приклад коду, який демонструє, як отримати, відобразити та оновити контакти Exchange Server:

Видалення контактів

The IEWSClient class надає DeleteContact для доступу та видалення контактів з Exchange Server. Цей метод приймає ідентифікатор контакту або Contact як вхідного параметра.

Нижче наведено фрагмент коду, який показує, як видалити контакти з сервера Exchange за допомогою IEWSClient->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.

Отримання інформації про тип папки за допомогою EWS

The 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. 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

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

Робота з завданнями

Aspose.Email підтримує обробку завдань на сервері Exchange за допомогою класу ExchangeTask. Різні властивості, що надаються ExchangeTask, такі як Subject, Status, DueDate і Priority, можна використовувати для налаштування завдання в Exchange. IEWSClientклас відкриває функції, такі як CreateTask, UpdateTask, та DeleteTask які використовуються для обробки завдань на сервері Exchange. У цій статті показано, як:

Створити нову задачу.
Встановити часовий пояс задачі.
Оновити задачу.
Видалити задачу.
Надіслати запит на задачу
Зберегти задачу на диск

Створити нову задачу

Наступний фрагмент коду показує, як створити нову задачу.

Вказання часового поясу

The IEWSClient інтерфейс та ExchangeTask надають TimeZoneId властивість для встановлення інформації про часовий пояс під час створення завдання. Нижче наведено фрагмент коду, який показує, як вказати часовий пояс.

Оновити задачу

Наступні фрагменти коду показують, як оновити завдання на сервері Exchange.

Видалити задачу

Наступний фрагмент коду показує, як видалити завдання на сервері Exchange.

Надсилання запиту на задачу

Сервіс Aspose.Email Exchange забезпечує можливість надсилати запити на задачу, подібно до Outlook. Наступний фрагмент коду показує, як завантажити повідомлення запиту на задачу з диска та надіслати його за допомогою IEWSClient.

Збереження задачі на диск

Aspose.Email також дозволяє зберігати задачі Exchange на диск у форматі Outlook MSG. Наступний фрагмент коду показує, як зберегти задачу на диск.

Cpp: Робота з конфігурацією користувача на сервері

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

Керування конфігурацією користувачів

API Aspose.Email можна використовувати для керування конфігурацією користувачів на 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

API Aspose.Email дозволяє додавати заголовки до запитів 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 for C++ дозволяє розробникам фільтрувати календарні зустрічі у Microsoft Exchange за допомогою IEWSClient і ExchangeQueryBuilder API. Ви можете фільтрувати зустрічі за діапазоном дат, станом повторення або іншими властивостями, щоб отримати лише потрібні події.

Фільтрація зустрічей за діапазоном дат

Використати ExchangeQueryBuilder для вказання умов початку та завершення та створення MailQuery для отримання відповідних зустрічей.

Фільтрація повторюваних або неповторюваних зустрічей

Ви можете фільтрувати зустрічі залежно від того, чи є вони повторюваними.