Outlook Web App の Web パーツの使用

  • [アーティクル]

 

適用先: Exchange Server 2010 SP2, Exchange Server 2010 SP3

トピックの最終更新日: 2016-11-28

Microsoft Office Outlook Web App の Web パーツを使用して、開くメールボックス、そのメールボックスの中で開くフォルダー、および使用するコンテンツ ビューを指定できます。

Outlook Web App の Web パーツを使用すると、URL から Outlook Web App のコンテンツに直接アクセスできます。URL は、Web ブラウザーで入力するか、アプリケーションに埋め込むことができます。一般に、Web パーツは手動では作成しません。ユーザー インターフェイス (UI) での選択に基づいてプログラムで作成するか、または MicrosoftOffice SharePoint Server 2007 または SharePoint Server 2010 ページなどのアプリケーションに直接埋め込みます。UI の背後にあるコードが、URL を作成します。Outlook Web App の Web パーツの用途の 1 つは、SharePoint Server 2007 または SharePoint Server 2010 ページにユーザーの受信トレイまたは予定表を表示することです。

注意

Outlook Web App の Web パーツを使用するには、ユーザーのメールボックスおよび Web パーツを使用して開くメールボックスの両方が同じ Active Directory フォレスト内にある必要があります。

Outlook Web Access の Web パーツを使用するためのアクセス許可

Outlook Web App の Web パーツを使用するには、少なくとも、開くコンテンツに対する "参照者" アクセスを委任される必要があります。認証が必要な Outlook Web App Web パーツをアプリケーションに埋め込む場合は、Web パーツに対する要求と共に認証情報を渡す必要があります。そのための方法の 1 つは、Outlook Web App 仮想ディレクトリを構成して統合 Windows 認証を使用するものです。統合 Windows 認証を使用すると、Active Directory アカウントを使用して既にログオンしているユーザーは、資格情報を再度入力しなくても Outlook Web App を使用できます。

Outlook Web App の Web パーツの構文

Microsoft Exchange Server 2010 の Outlook Web App は、/owa 仮想ディレクトリに対する要求について新しい URL 形式を使用します。このような要求は、Web ブラウザーに URL を直接入力することで、または SharePoint Server ページなどの Web アプリケーションに URL を埋め込むことで、行うことができます。

Outlook Web App の Web パーツを使用すると、さまざまな複雑さの URL を作成できます。メールボックスの受信トレイを開くには、簡単な Web パーツ URL を使用できます。開くメールボックス、そのメールボックスの中で開くフォルダー、および使用するコンテンツ ビューを指定するには、さらに複雑な Web パーツ URL を使用する場合があります。

たとえば、簡単な Web パーツ URL https://<サーバー名>/owa/?cmd=contents は、ユーザーのログオンによって決まるメールボックスの受信トレイを開きます。さらに複雑な Web パーツ URL https://<サーバー名>/owa/<SMTP アドレス>/?cmd=contents&fpath=inbox%2fProjects&view=by%20subject は、サブフォルダー Projects に対する SMTP アドレスで指定されるメールボックスを、件名で並べ替えて開きます。

ネットワークに適用されているセキュリティ手段によっては、Web パーツ URL のエンコーディングの構成が必要になる場合があります。エンコーディングを構成すると、UI の背後にあるコードが、URL エンコード パラメーターを使用して URL を作成します。URL エンコード パラメーターでは、空白の代わりに %20 が、またパス区切り文字 "/" の代わりに %2f が使用されます。このトピックのすべての例では、エンコードされたパラメーターを使用します。

次の表は、Web パーツのパラメーターとその使用例の一覧です。

Web パーツのパラメーターとその使用方法

URL パラメーター 説明 値と例

サーバー名とディレクトリ (必須)

Outlook Web App 仮想ディレクトリの URL。

これは、ユーザーが Outlook Web App へのサインインに使用するもとの同じ URL の場合があります。次はその例です。

https://<サーバー名>/owa

Exchange 2010 の明示的なログオン メールボックス ID (省略可能)

開くメールボックスに関連付けられている任意の SMTP アドレス。

URL のこのセクションがないと、認証されたユーザーの既定のメールボックスが開かされます。

他のパラメーターが指定されていない場合は、既定の動作として受信トレイが開かれます。

SMTP アドレス tsmith@fourthcoffee.com のメールボックスを開くには、次の URL を使用します。

https://<サーバー名>/owa/tsmith@fourthcoffee.com

cmd (明示的なログオン メールボックス ID 以外のパラメーターを指定する場合は必須)

?cmd=contents は、完全な Outlook Web App ユーザー インターフェイスの代わりにパラメーターで指定されている Outlook Web App Web パーツを表示します。

メールボックスが指定されていない場合は、cmd パラメーターは次のように、サインイン アドレスの後に記述します。

https://<サーバー名>/owa/?cmd=contents

メールボックスが指定されている場合は、cmd パラメーターは次のように、明示的なメールボックス ID の後に記述します。

https://<サーバー名>/owa/<SMTP アドレス>/?cmd=contents

他のパラメーターが指定されていない場合は、既定の動作として受信トレイが開かれます。

id (省略可能)

Web パーツがコンテンツを表示するフォルダーのフォルダー ID。この値は Web サービスを使用して取得でき、アプリケーション内で使用して開くフォルダーを動的に選択できます。

フォルダー ID は、フォルダーの Base64 エンコードの PR_ENTRY_ID です。次に例を示します。

https://<サーバー名>/owa/?cmd=contents&id=<PR_ENTRY_ID>

fpath (省略可能)

Web パーツで表示するメールボックス フォルダーを指定する文字列。Web パーツの URL は、ファイアウォールを通過できるように、URL エンコーディングを使用して記述することが必要になる場合があります。

URL エンコーディングを使用するときは、空白は %20 になり、パス区切り文字 (/) は %2f になります。

フォルダーの階層は、メールボックス ルートから開始する必要があります。

このフォルダー パスは、通常のフォルダーまたは検索フォルダーを示すことができます。

受信トレイのサブフォルダー Projects を開くには、次の URL を使用します。

https://<サーバー名>/owa/?cmd=contents&fpath= inbox%2fprojects

module (省略可能)

このパラメーターを使用すると、ローカライズされた名前を知らなくても、4 つの既定フォルダーを指定できます。

module パラメーターの値では大文字と小文字は区別されず、次の値を使用できます。

  • 受信トレイ

  • 予定表

  • 連絡先

  • タスク

  • Publicfolders

ローカライズに関係なくメールボックスの予定表を開くには、次の URL を使用します。

https://<サーバー名>/owa/?cmd=contents&module=calendar

view (省略可能)

このパラメーターは、フォルダーに対して表示するビューを指定します。

このパラメーターを指定しない場合の既定のビューは次のとおりです。

  • Calendar   Daily

  • Messages   Messages

  • Contacts   Two%20Line

  • Tasks   By%20Due%20Date

注意

既定のビューの文字列は、自動的に URL でエンコードされます。

ビューの既定の並べ替えは、フォルダーが Outlook Web App クライアントで開かれる場合の並べ替え方法です。

ビューを識別する文字列はローカライズされず、大文字と小文字は区別されません。

使用できるビューは、フォルダーの種類によって異なります。

Calendar のビュー :

  • Daily   日単位の予定表のビュー

  • Weekly   週単位の予定表のビュー

  • Monthly   月単位の予定表のビュー

Message のビュー :

  • Messages   メッセージ ビュー、既定の並べ替え

  • By%20Sender   送信元で並べ替えられたメッセージ ビュー ("a" から始まる送信者名が最初に配置される)

  • By%20Subject   件名で並べ替えられたメッセージ ビュー ("a" から始まる件名が最初に配置される)

  • By%20Conversation%20Topic   スレッド ビュー、Outlook Web App の Light バージョンでは利用できません

Contact のビュー :

  • Phone%20List   連絡先ビュー、既定の並べ替え

Tasks のビュー :

  • By%20Due%20Date   タスク ビュー、既定の並べ替え

  • By%20Subject   件名で並べ替えられたタスク ビュー ("a" から始まる件名が最初に配置される)

https://<サーバー名>/owa/?cmd=contents&fpath=Calendar&view=Weekly は、要求した予定表を Weekly ビューで表示します。

d、m、y (省略可能)

予定表を表示する日付を指定します。これらのパラメーターは、任意の順序で指定でき、単独でも複数を組み合わせても使用できます。

これらのパラメーターを指定しない場合の既定値は、当日の年、月、日の値です。たとえば、当日が 2010 年 5 月 3 日で、月の値に 9 月を示す "9" を指定すると、表示される日付は 2010 年 9 月 3 日になります。

日付パラメーターの有効な値は次のとおりです。

d=[1 ～ 31]

m=[1 ～ 12]

y=[4 桁の年]

2007 年 5 月 3 日の予定表を開くには、次の URL を使用します。https://<サーバー名>/owa/?cmd=content&fpath=calendar&view=daily&d=3&m=5&y=2007

part (省略可能)

小さい Web パーツを表示するよう Outlook Web App に指定します。

Web パーツを使用して Outlook Web App のコンテンツにアクセスするとき、表示される UI は、完全な Outlook Web App UI より小さくなります。part パラメーターは、UI をさらに小さくします。次の URL の例では、最小の Web パーツ形式でタスクの一覧を表示します。

https://<サーバー名>/owa/?cmd=contents&fpath=tasks&part=1

この part パラメーターは、予定表モジュールには適用されません。

以下の図は、part=1 パラメーターを指定しない場合の Outlook Web App Tasks Web パーツです。

Part=1 を指定しない場合の Web パーツ URL

以下の図は、part=1 パラメーターを指定する場合の Outlook Web App Tasks Web パーツです。

Part=1 を指定する場合の Web パーツ URL

複数のパラメーターを使用して、表示するフォルダーを指定し、表示の書式を設定できます。1 つ以上のフォルダー パラメーターを使用した場合の優先順位は、id、f、module の順になります。これらのどのパラメーターも指定しないと、既定で受信トレイが表示されます。

注意

セグメンテーションを使用して機能をオフにしてある場合、その機能は Web パーツとして使用できません。たとえば、Outlook Web App の予定表を無効にしている場合は、Outlook Web App の Web パーツを使用して予定表にアクセスすることはできません。

Outlook Web App の Web パーツの手入力

Outlook Web App の Web パーツは、Web ブラウザーで手動で入力することもできます。たとえば、ユーザーは、Outlook Web App Web パーツの URL を使用して、別のユーザーの予定表を開くことができます。

Weekly ビューで特定の予定表を開くには、次の手順を使用します。

  1. Web ブラウザー ウィンドウを開きます。

  2. Outlook Web App の URL を入力し、次の文字列を URL の末尾に追加します。<メールボックスの SMTP アドレス>/?cmd=contents&fpath=calendar&view=weekly

  3. 要求された場合は、サインイン資格情報を入力します。

たとえば、Outlook Web App の URL が https://email.fourthcoffee.com/owa の場合は、次の URL にアクセスすると、ユーザー tsmith の予定表が Weekly ビューで開きます。https://email.fourthcoffee.com/owa/tsmith@fourthcoffee.com/?cmd=contents&fpath=calendar&view=weekly

詳細情報

 © 2010 Microsoft Corporation.All rights reserved.