學(xué)習(xí)筆記-Exchange Web Service API-開發(fā)

EWS將附件分為兩組：文件附件和項(xiàng)目附件

項(xiàng)目附件：附加到另一個(gè)強(qiáng)類型EWS項(xiàng)目的強(qiáng)類型EWS項(xiàng)目，例如電子郵件和日歷項(xiàng)目。

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

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

內(nèi)聯(lián)附件

內(nèi)聯(lián)附件是一種特殊的附件。文件附件和項(xiàng)目附件都可以是內(nèi)聯(lián)附件。內(nèi)聯(lián)附件顯示為正文內(nèi)容的一部分，并保留其相對(duì)于項(xiàng)目中其余內(nèi)容的位置。

EWS日歷功能，自動(dòng)發(fā)送會(huì)議通知示例

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

1. 日歷文件夾，日歷項(xiàng)和日歷視圖

2. 會(huì)議請(qǐng)求，響應(yīng)，日程安排，與會(huì)者，資源，房間和可用性

3. 會(huì)議和約會(huì)的持續(xù)時(shí)間，時(shí)區(qū)以及開始和結(jié)束時(shí)間

4. 重復(fù)序列，重復(fù)模式，異常以及單實(shí)例約會(huì)和會(huì)議

EWS和EWS托管API提供了豐富的操作和方法，使您可以執(zhí)行各種與日歷相關(guān)的任務(wù)。例如，使用EWS托管API，您可以使用幾行代碼創(chuàng)建會(huì)議并向與會(huì)者發(fā)送邀請(qǐng)，如以下示例所示。

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中委派訪問權(quán)限和EWS

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

Exchange標(biāo)識(shí)符及EWS API標(biāo)識(shí)符

Exchange存儲(chǔ)中的每個(gè)對(duì)象都具有唯一標(biāo)識(shí)符。您可以使用對(duì)象的標(biāo)識(shí)符來引用對(duì)象并將其與其他對(duì)象區(qū)分開來。您可能使用的兩個(gè)最常見的標(biāo)識(shí)符是文件夾和項(xiàng)標(biāo)識(shí)符。

為了理解標(biāo)識(shí)符及其對(duì)應(yīng)用程序的重要性，了解Exchange中對(duì)象之間的關(guān)系很有幫助。當(dāng)EWS托管API或EWS應(yīng)用程序與Exchange通信時(shí)，您將使用包含郵箱，文件夾和項(xiàng)目對(duì)象的對(duì)象層次結(jié)構(gòu)。商店可以是這些對(duì)象類型中的任何一種。最常見的是，它是Exchange服務(wù)器上的郵箱，但它也可以是Exchange服務(wù)器上的公用文件夾。（請(qǐng)記住，在Exchange Online，作為Office 365的一部分的Exchange Online以及從Exchange 2013開始的Exchange版本中，公用文件夾只是另一種類型的郵箱，而不是另一種類型的存儲(chǔ)。）存儲(chǔ)包含文件夾和文件夾包含項(xiàng)目，每個(gè)文件夾和項(xiàng)目都有一個(gè)標(biāo)識(shí)符，如下圖所示。

EWS用于文件夾和項(xiàng)目的標(biāo)識(shí)符稱為EWS標(biāo)識(shí)符或EwsIds。EWSIds可以在EWS中的許多不同對(duì)象中找到，但是對(duì)于不同的對(duì)象被稱為不同的對(duì)象。因?yàn)槟赡茉趹?yīng)用程序中使用這些對(duì)象，所以您需要了解這些對(duì)象的標(biāo)識(shí)符與EwsId的關(guān)系。

EWS中的標(biāo)識(shí)符也適用于EWS托管API。在EWS托管API中，標(biāo)識(shí)符是對(duì)象的屬性，并在內(nèi)部進(jìn)行管理以映射到EWS元素。

模擬訪問EWS

什么時(shí)候應(yīng)該選擇模擬而不是委托或文件夾權(quán)限？

• 如果要為用戶提供對(duì)文件夾的訪問權(quán)限但不希望用戶具有“代表發(fā)送”權(quán)限，請(qǐng)使用文件夾權(quán)限。

• 如果要授予一個(gè)用戶代表另一個(gè)用戶執(zhí)行工作的權(quán)限，請(qǐng)使用委派訪問權(quán)限。通常，這是一對(duì)一或一對(duì)一的權(quán)限 - 例如，管理管理員日歷的單個(gè)管理助理，或管理一組會(huì)議室的日歷的單個(gè)房間調(diào)度程序。

• 當(dāng)您擁有需要訪問多個(gè)郵箱并“充當(dāng)”郵箱所有者的服務(wù)應(yīng)用程序時(shí)，請(qǐng)使用模擬。

當(dāng)您處理多個(gè)郵箱時(shí)，模擬是最佳選擇，因?yàn)槟梢暂p松地授予一個(gè)服務(wù)帳戶訪問數(shù)據(jù)庫中每個(gè)郵箱的權(quán)限。當(dāng)您僅授予少數(shù)用戶訪問權(quán)限時(shí)，委派和文件夾權(quán)限最佳，因?yàn)槟仨毞謩e為每個(gè)郵箱添加權(quán)限。

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

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

收件箱規(guī)則

讓我們面對(duì)現(xiàn)實(shí)：并非每封電子郵件都是平等的。許多用戶轉(zhuǎn)向收件箱規(guī)則以幫助削減郵件，并使其收件箱變得更加美好。使用Exchange Web服務(wù)（EWS），您的應(yīng)用程序可以承擔(dān)規(guī)則的強(qiáng)大功能。

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

• EWS無法訪問或創(chuàng)建“僅限客戶端”的規(guī)則或規(guī)則，這些規(guī)則或規(guī)則在Outlook中設(shè)置為“僅在此計(jì)算機(jī)上”運(yùn)行。

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

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

EWS通知訂閱類型

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

通知訂閱返回的事件類型

流式通知

拉動(dòng)通知

推送通知

EWS同步如何工作

初始同步的模式如下

正在運(yùn)行中的同步模式（增量同步）

更多關(guān)于同步的最佳實(shí)踐請(qǐng)參考：https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/mailbox-synchronization-and-ews-in-exchange

Exchange中EWS中的持久應(yīng)用程序設(shè)置

用戶配置對(duì)象是存儲(chǔ)EWS客戶端應(yīng)用程序配置設(shè)置的最佳選擇。https://docs.microsoft.com/en-us/exchange/client-developer/exchange-web-services/persistent-application-settings-in-ews-in-exchange

EWS提供的分頁搜索接口

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

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

處理EWS API中的時(shí)區(qū)

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

更多信息，請(qǐng)關(guān)注下方微信公眾號(hào)