次の方法で共有

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 (省略可能) このパラメーターを使用すると、ローカライズされた名前を知らなくても、既定フォルダーを指定できます。 モジュール パラメーターの値では、大文字と小文字は区別されず、次の値が含まれます。
  • 受信トレイ
  • Calendar
  • Teammailbox

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

https://<server name>/owa/?cmd=contents&module=calendar
view (省略可能) このパラメーターは、フォルダーに対して表示するビューを指定します。

このパラメーターを指定しない場合の既定のビューは、次のとおりです。
  • 予定表: 毎日
  • メッセージ: メッセージ

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

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

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

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

Calendar のビュー :
  • 日次: 毎日の予定表ビュー
  • 週単位: 週単位の予定表ビュー
  • 月次: 月次カレンダー ビュー

Message のビュー :

  • メッセージ: メッセージ ビュー(既定の並べ替えあり)
  • By%20Sender: 送信者名が先頭に "a" で始まる From で並べ替えられたメッセージ ビュー
  • By%20Subject: 件名で並べ替えられたメッセージ ビューで、先頭に "a" で始まる件名
  • By%20Conversation%20Topic: 会話ビュー(ライト バージョンのOutlook Web Appでは使用できません)
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

詳細情報