Outlook Web App の Web パーツの使用
製品: Exchange Server 2013
Microsoft Office Outlook Web App Web パーツを使用して、開くメールボックス、開くメールボックス内のフォルダー、および使用するコンテンツ ビューを指定できます。
Outlook Web App の Web パーツを使用すると、URL から Outlook Web App のコンテンツに直接アクセスできます。 URL は、Web ブラウザーで入力するか、アプリケーションに埋め込むことができます。 一般に、Web パーツは手動では作成しません。 ユーザー インターフェイス (UI) での選択に基づいてプログラムで作成するか、または SharePoint Server ページなどのアプリケーションに直接埋め込みます。 UI の背後にあるコードが、URL を作成します。 Outlook Web App の Web パーツの用途の 1 つは、SharePoint ページにユーザーの受信トレイまたは予定表を表示することです。
注:
Outlook Web App の Web パーツを使用するには、ユーザーのメールボックスおよび Web パーツを使用して開くメールボックスの両方が、同じ Active Directory フォレスト内にある必要があります。
Outlook Web App 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 パーツの構文
Exchange 2013 の Outlook Web App には、/owa 仮想ディレクトリに対する要求に使用する URL 形式があります。 このような要求は、Web ブラウザーに URL を直接入力することで、または SharePoint Server ページなどの Web アプリケーションに URL を埋め込むことで、行うことができます。
Outlook Web App の Web パーツを使用すると、さまざまな複雑さの URL を作成できます。 メールボックスの受信トレイを開くには、簡単な Web パーツ URL を使用できます。 開くメールボックス、そのメールボックスの中で開くフォルダー、使用するコンテンツ ビューを指定するには、さらに複雑な Web パーツ URL を使用する場合があります。
ネットワークに適用されているセキュリティ手段によっては、Web パーツ URL のエンコーディングの構成が必要になる場合があります。 エンコーディングを構成すると、UI の背後にあるコードが、URL エンコード パラメーターを使用して URL を作成します。 URL エンコード パラメーターでは、空白の代わりに %20 が、またパス区切り文字 "/" の代わりに %2f が使用されます。 このトピックのすべての例では、エンコードされたパラメーターを使用します。
次の表は、Web パーツのパラメーターとその使用例の一覧です。
注:
Exchange 2016、Exchange 2019、Exchange Onlineには Web パーツのサポートが含まれていません。
Web パーツのパラメーターとその使用方法
| URL パラメーター | 説明 | 値と例 |
|---|---|---|
| サーバー名とディレクトリ (必須) | Outlook Web App 仮想ディレクトリの URL。 | これは、ユーザーが Outlook Web App へのサインインに使用するもとの同じ URL の場合があります。次はその例です。 https://<server name>/owa |
| Exchange 2013 の明示的なログオン メールボックス ID (省略可能) | 開くメールボックスに関連付けられている任意の SMTP アドレス。 URL のこのセクションがないと、認証されたユーザーの既定のメールボックスが開きます。 他のパラメーターが指定されていない場合は、既定の動作として受信トレイが開きます。 |
SMTP アドレス tsmith@fourthcoffee.comでメールボックスを開くには、次の URL を使用します。https://<server name>/owa/tsmith@fourthcoffee.com |
| cmd (明示的なログオン メールボックス ID 以外のパラメーターを指定する場合は必須) | ?cmd=contentsは、完全なOutlook Web App ユーザー インターフェイスではなく、パラメーターによって指定されたOutlook Web App Web パーツを表示します。 |
メールボックスが指定されていない場合は、cmd パラメーターは次のように、サインイン アドレスの後に記述します。https://<server name>/owa/?cmd=contents メールボックスが指定されている場合は、cmd パラメーターは次のように、明示的なメールボックス ID の後に記述します。 https://<server name>/owa/<SMTP address>/?cmd=contents 他のパラメーターが指定されていない場合は、既定の動作として受信トレイが開きます。 |
| exsvurl | LiveID 認証を使用する場合は、このパラメーターを含める必要があります。 が存在しない場合 "exsvurl=1" 、LiveID 認証中にすべてのパラメーターが破棄されます。 このパラメーターは Microsoft 365 および Office 365 メールボックス専用です。 |
https://<server name>/owa/?cmd=contents&exsvurl=1 |
| fpath (省略可能) | URL のこの部分は、ファイアウォールを通過できるように、URL エンコーディングを使用して記述することが必要になる場合があります。 URL エンコーディングを使用するときは、空白は %20 になり、パス区切り文字 (/) は %2f になります。 フォルダーの階層は、メールボックス ルートから開始する必要があります。 このフォルダー パスは、通常のフォルダーまたは検索フォルダーを示すことができます。 |
受信トレイのサブフォルダー Projects を開くには、次の URL を使用します。https://<server name>/owa/?cmd=contents&fpath=inbox%2fprojects |
| module (省略可能) | このパラメーターを使用すると、ローカライズされた名前を知らなくても、既定フォルダーを指定できます。 | モジュール パラメーターの値では、大文字と小文字は区別されず、次の値が含まれます。
ローカライズに関係なくメールボックスの予定表を開くには、次の URL を使用します。 |
| view (省略可能) | このパラメーターは、フォルダーに対して表示するビューを指定します。 このパラメーターを指定しない場合の既定のビューは、次のとおりです。
注: 既定のビューの文字列は、自動的に URL エンコードされます。 |
使用できるビューは、フォルダーの種類によって異なります。 Calendar のビュー :
Message のビュー :
|
| d、m、y (省略可能) | 予定表を表示する日付を指定します。 これらのパラメーターは、任意の順序で指定でき、単独でも複数を組み合わせても使用できます。 これらのパラメーターを指定しない場合の既定値は、当日の年、月、日の値です。 たとえば、当日が 2016 年 5 月 3 日で、月の値に 9 月を示す "9" を指定すると、表示される日付は 2016 年 9 月 3 日になります。 |
日付パラメーターの有効な値は次のとおりです。 d=[1 から 31] m=[1 から 12] y=[4 桁の年] 2016 年 5 月 3 日の予定表を開くには、次の URL を使用します。 https://<server name>/owa/?cmd=content&fpath=calendar&view=daily&d=3&m=5&y=2016 |
| part (省略可能) | 小さい Web パーツを表示するよう Outlook Web App に指定します。 | Web パーツを使用して Outlook Web App のコンテンツにアクセスするとき、表示される UI は、完全な Outlook Web App UI より小さくなります。 part パラメーターは、UI をさらに小さくします。 次の URL の例では、最小の Web パーツ形式でタスクの一覧を表示します。https://<server name>/owa/?cmd=contents&part=1 この part パラメーターは、予定表モジュールには適用されません。 |
| FolderList | このパーツ パラメーターには、ユーザーがサブフォルダーを切り替えるためのフォルダー リスト コントロールが含まれています。 これは、メール フォルダーにのみ適用されます。 | https://<server name>/owa/?cmd=contents&folderlist=1 |
Outlook Web App の Web パーツの手入力
Outlook Web App の Web パーツは、Web ブラウザーで手動で入力することもできます。 たとえば、ユーザーは、Outlook Web App Web パーツの URL を使用して、別のユーザーの予定表を開くことができます。
次の例では、Outlook Web App の一般的なビューに直接アクセスする方法を示します。
- 受信トレイ:
https://<server name>_/owa/?cmd=contents\&module=inbox - 予定表 (今日):
https://<server name>/owa/?cmd=contents\&module=calendar\&exsvurl=1 - 予定表 (毎週):
https://<server name>/owa/?cmd=contents\&module=calendar\&view=weekly\&exsvurl=1 - 予定表 (月単位):
https://<server name>/owa/?cmd=contents\&module=calendar\&view=monthly\&exsvurl=1