使用 Outlook Web App 網頁組件

適用於:Exchange Server 2013

您可以使用 Microsoft Office Outlook Web App Web 元件來指定要開啟的信箱、要開啟的信箱內的資料夾,以及要使用的內容檢視。

Outlook Web App網頁元件可讓您直接從 URL 存取Outlook Web App內容。 URL 可以輸入至網頁瀏覽器或內嵌在應用程式中。 一般而言,不會手動建立網頁元件。 相反地,它們是根據使用者介面 (UI) 中所做的選擇,或直接內嵌在應用程式中,例如 SharePoint Server 頁面,以程式設計方式建立。 然後,UI 背後的程式碼會建立 URL。 Outlook Web App網頁元件的其中一個用法是在 SharePoint 頁面上顯示使用者的 [收件匣] 或 [行事曆]。

注意事項

若要使用Outlook Web App網頁元件,使用者的信箱和透過網頁元件開啟的信箱必須位於相同的 Active Directory 樹系中。

使用網頁元件Outlook Web App許可權

若要使用Outlook Web App網頁元件,您至少必須將「檢閱者」存取權委派給您要開啟的內容。 如果您已將需要驗證的Outlook Web App 網頁組件內嵌到應用程式中,則必須透過 傳遞驗證資訊,以及 Web 元件的要求。 其中一個方法是將Outlook Web App虛擬目錄設定為使用整合式Windows 驗證。 整合式Windows 驗證可讓已使用其 Active Directory 帳戶登入的使用者使用 Outlook Web App,而不需要再次輸入其認證。

Outlook Web App網頁元件語法

Exchange 2013 中的Outlook Web App具有 URL 格式,可用於對 /owa 虛擬目錄的要求。 您可以直接在網頁瀏覽器中輸入 URL,或在 Web 應用程式中內嵌 URL,例如 SharePoint Server 頁面,來提出這些要求。

Outlook Web App網頁元件可用來建立不同複雜度的 URL。 簡單的網頁元件 URL 可用來開啟任何信箱的收件匣。 更複雜的網頁元件 URL 可用來指定要開啟的信箱、要開啟之信箱內的資料夾,以及要使用的內容檢視。

根據已套用至網路的安全性措施,您可能必須設定 Web 元件 URL 的編碼。 設定編碼之後,UI 背後的程式碼會使用 URL 編碼參數來建立 URL。 URL 編碼參數會使用 %20 取代空格,而 %2f 取代路徑分隔符號 「/」。 本主題中的所有範例都使用編碼參數。

下表列出網頁元件的參數,以及其使用方式的範例。

注意事項

Exchange 2016、Exchange 2019 和 Exchange Online 不再包含 Web 元件的支援。

網頁元件參數及其使用方式

URL 參數 描述 值和範例
需要伺服器名稱和目錄 () Outlook Web App虛擬目錄的 URL。 這可能是使用者用來登入Outlook Web App的相同 URL,例如:

https://<server name>/owa
Exchange 2013 明確登入信箱識別 (選擇性) 與要開啟的信箱相關聯的任何 SMTP 位址。

如果缺少此 URL 區段,則會開啟已驗證使用者的預設信箱。

如果未指定其他參數,則預設行為是開啟 [收件匣]。
若要使用 SMTP 位址 tsmith@fourthcoffee.com 開啟信箱,請使用下列 URL:

https://<server name>/owa/tsmith@fourthcoffee.com
如果您要指定明確登入信箱識別以外的任何參數,則需要 cmd () ?cmd=contents會顯示參數所指定的Outlook Web App 網頁組件,而不是完整的Outlook Web App使用者介面。 如果未指定信箱,cmd 參數會位於登入位址之後,如下所示:

https://<server name>/owa/?cmd=contents

如果指定信箱,Cmd 參數會在明確的信箱識別之後出現,如下所示:

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 的 THis 部分可能必須使用 URL 編碼來撰寫,才能通過防火牆。

當您使用 URL 編碼時,空格會變成 %20,而路徑分隔符號 (/) 會變成 %2f。

資料夾階層應該從信箱根目錄開始。

此資料夾路徑可以指向一般資料夾或搜尋資料夾。
若要在 [收件匣] 中開啟子資料夾專案,請使用下列 URL:

https://<server name>/owa/?cmd=contents&fpath=inbox%2fprojects
模組 (選擇性) 這個參數可用來指定任何預設資料夾,而不需要知道當地語系化的名稱。 模組參數的值不區分大小寫,並包含下列值:
  • 收件匣
  • 行事曆
  • Teammailbox

若要開啟信箱的行事曆,而不論當地語系化為何,請使用下列 URL:

https://<server name>/owa/?cmd=contents&module=calendar

檢視 (選用) 此參數會指定要針對資料夾顯示的檢視。

此參數不存在時的預設檢視如下:
  • 行事曆:每日
  • 訊息:訊息

注意:預設檢視的字串會自動進行 URL 編碼。

檢視的預設排序是資料夾在Outlook Web App用戶端中開啟時的排序方式。

識別檢視的字串不會當地語系化且不區分大小寫。

可用的檢視會根據資料夾類型而有所不同。

行事曆檢視:
  • 每日:每日行事曆檢視
  • 每週:每週行事曆檢視
  • 每月:每月行事曆檢視

訊息檢視:

  • 訊息:訊息檢視,具有預設排序
  • By%20Sender:依寄件者排序的訊息檢視,其寄件者名稱開頭為 「a」
  • By%20Subject:依主旨排序的訊息檢視,其主題開頭為 「a」
  • By%20Conversation%20Topic: Conversation View, not available in the light version of Outlook Web App
d、m、y (選用) 指定應顯示行事曆的日期。 這些參數可以依任何順序輸入,而且可以單一或一起使用。

如果未指定任何這些參數,則預設值為目前的日、月和年值。 例如,如果目前的日期是 2016 年 5 月 3 日,而您指定 9 月的月份值 「9」,則顯示的日期會是 2016 年 9 月 3 日。
資料參數的有效值如下:

d=[1-31]

m=[1-12]

y=[四位數年份]

若要開啟 2016 年 5 月 3 日日期的行事曆,您可以使用下列 URL: https://<server name>/owa/?cmd=content&fpath=calendar&view=daily&d=3&m=5&y=2016
部分 (選擇性) 指定Outlook Web App應顯示較小的網頁元件。 當您使用網頁元件存取Outlook Web App內容時,顯示的 UI 會小於完整Outlook Web App UI。 part 參數會進一步減少 UI。 下列範例 URL 會以最小的網頁元件格式顯示 [工作] 清單:

https://<server name>/owa/?cmd=contents&part=1

part 參數不適用於行事曆模組。
FolderList 此元件參數包含資料夾清單控制項,讓使用者在子資料夾之間切換。 這僅適用于電子郵件資料夾。 https://<server name>/owa/?cmd=contents&folderlist=1

手動輸入Outlook Web App網頁元件

Outlook Web App也可以在網頁瀏覽器中手動輸入網頁元件。 例如,使用者可以使用Outlook Web App 網頁組件 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

相關資訊