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 はこの機能を実装していません。