EWS と Exchange の他の Web サービスの新機能

  • [アーティクル]

Exchange と EWS マネージ API の EWS および Web サービスの新機能について説明します。

Exchange の Web サービスが更新され、新機能が含まれるようになりました。

表 1. Exchange Online、Exchange 2013、EWS マネージ API の新しい Web サービス機能

機能 Exchange Online での実装 Exchange 2013 での実装 EWS マネージ API での実装
電子情報開示
はい
 はい
 はい
アーカイブ
はい
 はい
 はい
ペルソナ
はい
 はい
 いいえ
統合連絡先ストア
はい
 はい
 いいえ
保持ポリシー
はい
 はい
 はい
ユーザーの写真
はい
 はい
 いいえ
Outlook 管理用のメール アプリ
はい
 はい
 はい
会議の新しい日時を提案する
はい
 いいえ
 いいえ

EWS における電子情報開示

電子情報開示は、SharePoint 2013 などの外部アプリケーションが Exchange データのクエリを実行できるようにするフェデレーション クエリ Web サービスです。 証拠開示は、主なデータの識別や保持、データの選別や確認、法廷でのデータの生成を含むいくつかのフェーズから構成されます。 電子情報開示のクエリは、Exchange と SharePoint にまたがる単一の証拠開示ワークフローを提供することで、証拠開示プロセスを容易にします。

表 2. 電子情報開示を操作するための EWS 操作と EWS マネージ API メソッド

操作名 EWS マネージ API メソッド 説明
GetDiscoverySearchConfiguration 操作
ExchangeService.GetDiscoverySearchConfiguration()
インプレース ホールド、保存された探索検索、探索検索が有効になっているメールボックスの構成情報を取得します。
GetHoldOnMailboxes 操作
ExchangeService.GetHoldOnMailboxes()
SetHoldOnMailboxes 操作を使用して設定されるクエリ ベースの保留の状態を取得します。
GetNonIndexableItemDetails 操作
ExchangeService.GetNonIndexableItemDetails()
インデックスを作成できないアイテムの詳細を取得します。 これには、アイテム識別子、エラー コード、エラーの説明、アイテムのインデックス作成を試行したタイミング、アイテムに関する追加情報が含まれますが、これに限定されません。
GetNonIndexableItemStatistics 操作
ExchangeService.GetNonIndexableItemStatistics()
メールボックス内にある、インデックスを作成できないアイテムの数を取得します。
GetSearchableMailboxes 操作
ExchangeService.GetSearchableMailboxes()
クライアントが検索または電子情報開示を実行するアクセス許可を持つメールボックスの一覧を取得します。
SearchMailboxes 操作
ExchangeService.SearchMailboxes()
特定のメールボックス内にある、クエリ キーワードに一致するアイテムを検索します。
SetHoldOnMailboxes 操作
ExchangeService.SetHoldOnMailboxes()
アイテムにクエリベースの保持を設定します。

EWS におけるアーカイブ

アーカイブ メールボックスは、ユーザーに関連付けられている 2 番目のメールボックスです。 通常、アーカイブ メールボックスはメールの格納域の制限に対処するために使用されます。 たとえば、古いメール アイテムは、定期的に受信トレイからアーカイブ メールボックスに移動されます。

Exchange では、プライマリ メールボックスから一連のメール アイテムをアーカイブするために使用できる 2 つの新しい EWS 操作が導入されています。 この方法で受信トレイのアイテムをアーカイブすると、アイテムのフォルダー階層が保持されます。 さらに、アーカイブ メールボックスを、クライアント上にローカルに格納することもリモートで格納することもできるようなりました。その際、アーカイブのコンテンツを指すフォルダー パスを使用し、ユーザーにはほとんど見えない方法で行うことができます。

表 3. アーカイブを操作するための EWS 操作と EWS マネージ API メソッド

操作名 EWS マネージ API メソッド 説明
ArchiveItem 操作
ExchangeService.ArchiveItems()
アイテムをプライマリ メールボックスからアーカイブ メールボックスに移動します。
CreateFolderPath 操作
実装されていません。
プライマリ メールボックスまたはアーカイブ メールボックスにフォルダー階層を作成します。

EWS におけるペルソナ

ペルソナは、個人に関連付けられているデータのコレクションです。 データは 1 つ以上のソースから取得でき、共通のリンク ID を使用してペルソナに関連付けられます。 EWS のペルソナを使用すると、複数のソースからユーザーに関する情報をリンク、検索、参照、取得し、その情報を 1 つの論理エンティティに整理できます。 ペルソナは、連絡先が個人に関連付けられている単一のソースからのデータのコレクションであるという点で連絡先とは異なります。たとえば、個人の Outlook 連絡先やグローバル アドレス一覧 (GAL) 内のエントリなどです。

EWS マネージ API はこの機能を実装していません。

注:

統合連絡先ストアは、その機能をサポートする操作を使用してペルソナ機能を公開します。

表 4. ペルソナを操作するための EWS 操作

操作名 説明
FindPeople 操作
指定した連絡先フォルダーからすべてのペルソナ オブジェクトを取得するか、指定したクエリ文字列に一致する連絡先すべてを取得します。
GetPersona 操作
ペルソナを取得します。

EWS における統合連絡先ストア

統合連絡先ストアは、Office 製品間で一貫性のある連絡先操作を提供し、同じ連絡先ストアを使用するサード パーティ製アプリケーションの統合ポイントとして動作する機能です。 これにより、ユーザーとアプリケーションは連絡先情報を保存、管理、アクセスでき、Lync、Exchange 2013、Outlook、Outlook Web App、および統合連絡先ストアへのアクセスを実装するその他のアプリケーション間でグローバルに利用できるようになります。 Exchange は、統合連絡先ストアを利用するための連絡先ストアです。

EWS マネージ API はこの機能を実装していません。

表 5。 統合連絡先ストアを操作するための EWS 操作

操作名 説明
AddNewImContactToGroup 操作
新しい IM 連絡先をグループに追加します。 統合連絡先ストアには、最大 1000 件の連絡先を含めることができます。
AddImContactToGroup 操作
既存の IM 連絡先をグループに追加します。 統合連絡先ストアには、最大 1000 件の連絡先を含めることができます。
AddImGroup 操作
新しい IM グループを追加します。 統合連絡先ストアには、最大 64 個のグループを含めることができます。
AddNewTelUriContactToGroup 操作
新しい連絡先を、連絡先の電話番号に基づいたグループに追加します。
AddDistributionGroupToImList 操作
新しい配布リスト グループを追加します。 統合連絡先ストアには、最大 64 個のグループを含めることができます。
GetImItemList 操作
IM グループと IM 連絡先のペルソナの一覧を取得します。
GetImItems 操作
指定の IM グループと IM 連絡先ペルソナの情報を取得します。
RemoveContactFromImList 操作
すべての IM グループから、指定の連絡先を削除します。
RemoveImContactFromGroup 操作
特定のグループから IM 連絡先を削除します。
RemoveDistributionGroupFromImList 操作
指定の IM 配布リスト グループを削除します。
RemoveImGroup 操作
指定の IM グループを削除します。
SetImGroup 操作
グループの表示名を変更します。

EWS における保持ポリシー

保持ポリシーは、1 つ以上の保持タグをグループ化したり、フォルダーや個別のアイテム (たとえば、メール、ボイス メール メッセージなど) に保持設定を適用したり、保持設定をメールボックスに適用したりするために Exchange で使用するポリシーです。

Exchange には、次の 3 種類の保持タグがあります。

  • 既定のポリシー タグ。他の種類の保持タグが適用されていないメールボックス アイテムに適用されます。

  • システム フォルダー ポリシー タグ。受信トレイなどの既定のフォルダーに適用されます。

  • 個人タグ。ユーザーが、作成するフォルダーや個別のアイテムに適用できます。

メールボックスに割り当てることができるアイテム保持ポリシーは 1 つだけですが、ポリシーにはさまざまな種類のアイテム保持タグを 1 つ以上リンクできます。 保持タグは、いつでもアイテム保持ポリシーにリンクしたり、アイテム保持ポリシーからリンク解除したりできます。 Exchange の EWS では、新しい操作 GetUserRetentionPolicyTags が公開され、EWS マネージ API には、アイテム保持ポリシーにリンクされているすべてのタグの一覧を提供する新しいメソッド ExchangeService.GetUserRetentionPolicyTags()が実装されています。 CreateItem、CreateFolder、UpdateItem、UpdateFolder、GetItem、GetFolder の各操作を使用して、アイテムとフォルダーのアイテムとフォルダーのアイテム保持ポリシー タグを設定および取得できます。

ユーザーの写真を要求する

GetUserPhoto 操作の 2 つの実装 (REST または SOAP) のいずれかを使用して、Exchange サーバーからユーザーの写真を要求できます。 REST エンドポイントは、標準の HTTPS GET 要求を使用してユーザーの写真を取得します。 このサービスは、Exchange に格納されているユーザーの写真か、Active Directory ドメイン サービス (AD DS) からの写真を返します。

EWS マネージ API はこの機能を実装していません。 ただし、EWS マネージ API を使用して、連絡先に添付されている写真を取得することで、メールボックスに格納されているユーザーの写真を返すことができます。

EWS で送信者をブロックしメールを迷惑メールとしてマークする

EWS の新しい MarkAsJunk 操作 または EWS マネージ API の ExchangeService.MarkAsJunk() メソッドを使用して、送信者をブロックし、電子メールを迷惑メールとしてマークできるようになりました。

Outlook 用メール アプリ

EWS には、Outlook のメール アプリを管理するサポートが含まれるようになりました。

表 6. Outlook 用メール アプリを操作するための EWS 操作と EWS マネージ API メソッド

操作名 EWS マネージ API メソッド 説明
DisableApp 操作
ExchangeService.DisableApp()
インストールされているアプリを無効にします。
GetAppManifests 操作
ExchangeService.GetAppManifests()
メールボックスのアプリ マニフェストを取得します。
GetAppMarketplaceUrl 操作
ExchangeService.GetAppMarketplaceUrl()
App Marketplace URL を取得します。
GetClientAccessToken 操作
ExchangeService.GetClientAccessToken()
クライアント アクセス トークンを取得します。
InstallApp 操作
ExchangeService.InstallApp()
メールボックスのアプリをインストールします。
UninstallApp 操作
ExchangeService.UninstallApp
メールボックスのアプリをアンインストールします。

会議の新しい日時を提案する

新しい日時の提案機能は、Exchange のバージョン 15.00.0800.007 で導入されました。 これにより、会議参加者は会議開催者に対して会議の新しい日時を提案できます。

EWS マネージ API はこの機能を実装していません。

関連項目