學習筆記-Exchange Web Service API-開發

EWS將附件分為兩組：文件附件和項目附件

項目附件：附加到另一個強類型EWS項目的強類型EWS項目，例如電子郵件和日歷項目。

文件附件：任何文件，例如.txt，.jpg，.zip，.pdf，甚至是.msg文件。文件附件只有一些屬性，其中一個屬性是文件的base-64編碼內容。

引用附件：文件提供程序引用的任何附件，例如位于云中的文件。附件可以來自多個提供者。

內聯附件

內聯附件是一種特殊的附件。文件附件和項目附件都可以是內聯附件。內聯附件顯示為正文內容的一部分，并保留其相對于項目中其余內容的位置。

EWS日歷功能，自動發送會議通知示例

Exchange中與日歷相關的功能與您在Outlook等客戶端中看到的功能略有不同。Exchange中的EWS不是顯示信息，而是允許您執行創建，存儲，發送或更改信息等操作。要使用EWS處理日歷，您需要熟悉信息存儲，時間，重復和消息流等概念。更具體地說，您需要熟悉以下內容：

1. 日歷文件夾，日歷項和日歷視圖

2. 會議請求，響應，日程安排，與會者，資源，房間和可用性

3. 會議和約會的持續時間，時區以及開始和結束時間

4. 重復序列，重復模式，異常以及單實例約會和會議

EWS和EWS托管API提供了豐富的操作和方法，使您可以執行各種與日歷相關的任務。例如，使用EWS托管API，您可以使用幾行代碼創建會議并向與會者發送邀請，如以下示例所示。

Appointment meeting = new Appointment(service);
// Set the properties on the meeting object to create the meeting.
meeting.Subject = "Team building exercise";
meeting.Body = "Let's learn to really work as a team and then have lunch!";
meeting.Start = DateTime.Now.AddDays(2);
meeting.End = meeting.Start.AddHours(2);
meeting.Location = "Conference Room 12";
meeting.RequiredAttendees.Add("Mack.Chaves@contoso.com");
meeting.RequiredAttendees.Add("Sadie.Daniels@contoso.com");
meeting.OptionalAttendees.Add("Magdalena.Kemp@contoso.com");
meeting.ReminderMinutesBeforeStart = 60;
// Send the meeting request
meeting.Save(SendInvitationsMode.SendToAllAndSaveCopy);

在Exchange中委派訪問權限和EWS

https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/delegate-access-and-ews-in-exchange

Exchange標識符及EWS API標識符

Exchange存儲中的每個對象都具有唯一標識符。您可以使用對象的標識符來引用對象并將其與其他對象區分開來。您可能使用的兩個最常見的標識符是文件夾和項標識符。

為了理解標識符及其對應用程序的重要性，了解Exchange中對象之間的關系很有幫助。當EWS托管API或EWS應用程序與Exchange通信時，您將使用包含郵箱，文件夾和項目對象的對象層次結構。商店可以是這些對象類型中的任何一種。最常見的是，它是Exchange服務器上的郵箱，但它也可以是Exchange服務器上的公用文件夾。（請記住，在Exchange Online，作為Office 365的一部分的Exchange Online以及從Exchange 2013開始的Exchange版本中，公用文件夾只是另一種類型的郵箱，而不是另一種類型的存儲。）存儲包含文件夾和文件夾包含項目，每個文件夾和項目都有一個標識符，如下圖所示。

EWS用于文件夾和項目的標識符稱為EWS標識符或EwsIds。EWSIds可以在EWS中的許多不同對象中找到，但是對于不同的對象被稱為不同的對象。因為您可能在應用程序中使用這些對象，所以您需要了解這些對象的標識符與EwsId的關系。

EWS中的標識符也適用于EWS托管API。在EWS托管API中，標識符是對象的屬性，并在內部進行管理以映射到EWS元素。

模擬訪問EWS

什么時候應該選擇模擬而不是委托或文件夾權限？

• 如果要為用戶提供對文件夾的訪問權限但不希望用戶具有“代表發送”權限，請使用文件夾權限。

• 如果要授予一個用戶代表另一個用戶執行工作的權限，請使用委派訪問權限。通常，這是一對一或一對一的權限 - 例如，管理管理員日歷的單個管理助理，或管理一組會議室的日歷的單個房間調度程序。

• 當您擁有需要訪問多個郵箱并“充當”郵箱所有者的服務應用程序時，請使用模擬。

當您處理多個郵箱時，模擬是最佳選擇，因為您可以輕松地授予一個服務帳戶訪問數據庫中每個郵箱的權限。當您僅授予少數用戶訪問權限時，委派和文件夾權限最佳，因為您必須分別為每個郵箱添加權限。

模擬是連接到Exchange Online，作為Office 365的一部分的Exchange Online和Exchange的本地版本并執行操作的應用程序的理想選擇，例如歸檔電子郵件，為度假用戶自動設置OOF或任何其他需要該操作的任務該應用程序充當郵箱的所有者。當應用程序使用模擬發送郵件時，電子郵件似乎是從郵箱所有者發送的。收件人無法知道服務帳戶發送的郵件。另一方面，委派授予另一個郵箱帳戶代表郵箱所有者的權限。當委托發送電子郵件時，“from”值標識郵箱所有者，“sender”值標識發送郵件的委托。

配置模擬：https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/how-to-configure-impersonation

收件箱規則

讓我們面對現實：并非每封電子郵件都是平等的。許多用戶轉向收件箱規則以幫助削減郵件，并使其收件箱變得更加美好。使用Exchange Web服務（EWS），您的應用程序可以承擔規則的強大功能。

EWS托管API提供用于處理規則的ExchangeService.GetInboxRules和ExchangeService.UpdateInboxRules方法。EWS提供了用于處理規則的GetInboxRules和UpdateInboxRules操作。但請注意，使用收件箱規則時，EWS托管API和EWS具有以下限制：

• EWS無法訪問或創建“僅限客戶端”的規則或規則，這些規則或規則在Outlook中設置為“僅在此計算機上”運行。

• 要使用EWS更改當前規則集，您必須刪除Outlook規則BLOB（如果存在）。這意味著使用EWS修改規則會刪除以前使用Outlook關閉（禁用）的所有規則。

https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/inbox-management-and-ews-in-exchange

EWS通知訂閱類型

您可以使用EWS托管API和Exchange Web服務（EWS）訂閱，以便在郵箱中或郵箱中的一個或多個文件夾中發生事件時接收通知。提供三種訂閱類型：流通知，拉取通知和推送通知。這些訂閱類型中的每一種都使用不同的技術來接收或檢索通知。

通知訂閱返回的事件類型

流式通知

拉動通知

推送通知

EWS同步如何工作

初始同步的模式如下

正在運行中的同步模式（增量同步）

更多關于同步的最佳實踐請參考：https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/mailbox-synchronization-and-ews-in-exchange

Exchange中EWS中的持久應用程序設置

用戶配置對象是存儲EWS客戶端應用程序配置設置的最佳選擇。https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/persistent-application-settings-in-ews-in-exchange

EWS提供的分頁搜索接口

使用EWS托管API或EWS發送搜索請求時，指定視圖大小，該大小控制返回的最大項目數。但是，服務器上與您的搜索匹配的項目數可能會大于視圖大小。在這種情況下，服務器指示有更多項可用。您可以使用分頁重復搜索并獲取下一組結果。

例如，您可以發送視圖大小為10的搜索請求。服務器上可能有15個項目與您的搜索匹配，但您只會返回前10個項目以及指示符（FindItemsResults <TItem>。如果您正在使用EWS托管API，則更多可用屬性）服務器上有更多結果。然后，您可以發送偏移量為10的相同搜索，以詢問與您的搜索匹配的下10個項目。服務器將返回剩余的五個項目。

處理EWS API中的時區

https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/time-zones-and-ews-in-exchange

更多信息，請關注下方微信公眾號