如何配置 Outlook Web Access 中的 Web 部件

  • 项目

 

适用于： Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

上一次修改主题： 2009-10-29

本主题介绍 Microsoft Office Outlook Web Access Web 部件并说明如何使用 Web 部件打开特定的文件夹。可以使用 Outlook Web Access Web 部件指定要打开的邮箱、该邮箱中要打开的文件夹以及要使用的内容视图。

使用 Outlook Web Access Web 部件可以直接通过 URL 访问 Outlook Web Access 内容。URL 可以在 Web 浏览器中输入，也可以嵌入应用程序。通常不是手动创建 Web 部件，而是基于在用户界面 (UI) 中所做的选择，以编程方式创建 Web 部件，或直接将其嵌入应用程序（例如 Microsoft Office SharePoint Server 2007 页）。UI 后面的代码将创建 URL。Outlook Web Access Web 部件的一项用途是在 Office SharePoint Server 2007 页中显示用户的收件箱或日历。

note注意：
若要使用 Outlook Web Access Web 部件，用户的邮箱和通过 Web 部件打开的邮箱必须位于同一 Active Directory 林中。

使用 Outlook Web Access Web 部件的权限

若要使用 Outlook Web Access Web 部件，必须至少向您委派对所打开内容的“审阅者”访问权限。如果将要求进行身份验证的 Outlook Web Access Web 部件键入应用程序，则必须将身份验证信息与 Web 部件请求一起传递。若要这样做，一种方法是将 Outlook Web Access 虚拟目录配置为使用集成 Windows 身份验证。通过集成 Windows 身份验证，已使用 Active Directory 帐户登录的用户不必重新输入其凭据即可使用 Outlook Web Access。

Outlook Web Access Web 部件语法

Exchange 2007 Outlook Web Access 对 /owa 虚拟目录请求使用一种新的 URL 格式。可以通过直接在 Web 浏览器中键入 URL 或将 URL 嵌入 Web 应用程序（例如 Office SharePoint Server 页）发出这些请求。

可以使用 Outlook Web Access Web 部件创建不同复杂程度的 URL。可以使用简单的 Web 部件 URL 打开任意邮箱的收件箱。可以使用更复杂的 Web 部件 URL 指定要打开的邮箱、该邮箱中要打开的文件夹以及要使用的内容视图。

例如，简单的 Web 部件 URL https://<服务器名称>/owa/?cmd=contents 将打开由用户登录名确定的邮箱的收件箱。更复杂的 Web 部件 URL https://<服务器名称>/owa/<SMTP 地址>/?cmd=contents&f=inbox%2fProjects&view=by%20subject 将打开由 SMTP 地址指定的邮箱，打开至子文件夹 Projects，并按照主题进行排序。

根据网络上采用的安全措施，可能必须配置 Web 部件 URL 的编码。配置编码后，UI 后面的代码将使用 URL 编码的参数创建 URL。URL 编码的参数使用 %20 代替空格，使用 %2f 代替路径分隔符“/”。本主题中的所有示例都使用编码的参数。

受支持的 Microsoft Exchange 2000 和 Exchange 2003 Web 部件将自动转换为 Exchange 2007 Web 部件。

表 1 列出 Web 部件的参数以及如何使用这些参数的示例。

表 1   Web 部件的参数以及如何使用这些参数

URL 参数 说明 值和示例

服务器名称和目录（必需）

Outlook Web Access 虚拟目录的 URL。

此 URL 可以与用户登录到 Outlook Web Access 时所使用的 URL 相同，例如：

https://<服务器名称>/owa

Exchange 2007 明确的登录邮箱标识（可选）

与要打开的邮箱关联的任何 SMTP 地址。

如果 URL 缺少此部分，将打开经过身份验证的用户的默认邮箱。

如果未指定任何其他参数，默认行为将是打开收件箱。

若要打开 SMTP 地址为 tsmith@fourthcoffee.com 的邮箱，请使用：

https://<服务器名称>/owa/tsmith@fourthcoffee.com

cmd（如果指定的参数不是明确的登录邮箱标识，则是必需的）

?cmd=contents 显示通过参数指定的 Outlook Web Access Web 部件，而不是显示整个 Outlook Web Access 用户界面。

如果未指定任何邮箱，此参数将采用服务器目录：

https://<服务器名称>/owa/?cmd=contents

如果指定了邮箱，此参数将采用明确的邮箱标识：

https://<服务器名称>/owa/<SMTP 地址>/?cmd=contents

如果未指定任何其他参数，默认行为将是打开收件箱。

id（可选）

Web 部件应显示其内容的文件夹的文件夹 ID。此 ID 可以使用 Web 服务获取，并且可以在应用程序中用于动态选择要打开的文件夹。

文件夹 ID 是文件夹的 Base64 编码的 PR_ENTRY_ID：

https://<服务器名称>/owa/?cmd=contents&id=<PR_ENTRY_ID>

f（可选）

指定要在 Web 部件中显示的邮箱文件夹的字符串。可能必须使用 URL 编码编写 Web 部件 URL，以便可以通过防火墙。

使用 URL 编码时，空格变为 %20，路径分隔符 (/) 变为 %2f。

文件夹层次结构应从邮箱根目录开始。

此文件夹路径可以指向普通文件夹或搜索文件夹。

若要打开收件箱中的子文件夹 Projects，请使用：

https://<服务器名称>/owa/?cmd=contents&f= inbox%2fprojects

module（可选）

可以使用此参数指定四个默认文件夹中的任意一个，而不必了解本地化名称。

module 参数的值不区分大小写，并且包含下列值：

  • Inbox

  • Calendar

  • 联系人

  • Tasks

  • Publicfolders

打开邮箱的日历（与本地化无关）：

https://<服务器名称>/owa/?cmd=contents&module=calendar

view（可选）

此参数指定文件夹要显示的视图。

没有此参数时的默认视图如下：

  • Calendar   Daily

  • Messages   Messages

  • Contacts   Two%20Line

  • Tasks   By%20Due%20Date

note注意：
默认视图的字符串将自动采用 URL 编码。

视图的默认排序是在 Outlook Web Access 客户端打开文件夹时文件夹的排序方式。

Exchange 2007 中不支持的 Exchange 2003 Web 部件视图如下：

  • Contacts   Address card and detailed address card

  • Messages   Unread by conversation topic and sent to

标识视图的字符串未本地化，并且不区分大小写。

可用视图根据文件夹类型的不同而有所不同。

日历视图：

  • Daily   每日日历视图

  • Weekly   每周日历视图

  • 每月   月历视图

邮件视图：

  • Messages   单行邮件视图，采用默认排序

  • By%20Sender   单行邮件视图，按发件人排序（以“a”开头的发件人姓名排在前面）

  • By%20Subject   单行邮件视图，按主题排序（以“a”开头的主题排在前面）

  • By%20Conversation%20Topic   转换视图，只有在 Outlook Web Access Premium 中可用

  • Two%20Line   双行邮件视图，采用默认排序，只有在 Outlook Web Access Premium 中可用

联系人视图：

  • Phone%20List   单行联系人视图，采用默认排序

  • Two%20Line   双行联系人视图，采用默认排序，只有在 Outlook Web Access Premium 中可用

任务视图：

  • By%20Due%20Date   单行任务视图，采用默认排序

  • By%20Subject   单行任务视图，按主题排序，以 a 开头的主题排在前面

https://<服务器名称>/owa/?cmd=contents&f=Calendar&view=Weekly 将在 Weekly 视图中显示所请求的日历。

d, m, y（可选）

指定应显示日历的日期。这些参数可以按任意顺序输入，可以单独使用，也可以一起使用。

如果未指定其中的任何参数，默认值为当前日、月和年的值。例如，如果当前日期为 2007 年 5 月 3 日，并且将月的值指定为“9”（代表九月），显示的日期将为 September 3, 2007。

数据参数的有效值如下：

d=[1-31]

m=[1-12]

y=[四位的年份]

若要打开 2007 年 5 月 3 日的日历，应使用 https://<服务器名称>/owa/?cmd=content&f=calendar&view=daily&d=3&m=5&y=2007。

part（可选）

指定 Outlook Web Access 应显示更小的 Web 部件。

使用 Web 部件访问 Outlook Web Access 内容时，显示的 UI 将小于整个 Outlook Web Access UI。part 参数可以进一步减小 UI。以下示例以最小的 Web 部件格式显示任务列表：

https://<服务器名称>/owa/?cmd=contents&f=tasks&part=1

图 1 和图 2 分别显示对任务 Web 部件应用和不应用 part=1 时，Outlook Web Access 将显示的 UI。

图 1 显示没有 part=1 参数的 Outlook Web Access 任务 Web 部件。

图 1   没有 Part=1 的 Web 部件 URL

WebPartWithout1

图 2 显示包含参数 part=1 的 Outlook Web Access 任务 Web 部件。

图 2   包含 Part=1 的 Web 部件 URL

WebPartWith1

可以使用多个参数指定要显示的文件夹及其显示格式。如果使用多个文件夹参数，优先顺序依次为 id、f 和 module。如果不存在其中的任何参数，默认情况下将显示收件箱。

note注意：
如果使用分段禁用某项功能，该功能将无法作为 Web 部件使用。例如，如果禁用了 Outlook Web Access 日历，将无法使用 Outlook Web Access Web 部件访问日历。

手动使用 Outlook Web Access Web 部件

也可以在 Web 浏览器中手动输入 Outlook Web Access Web 部件。例如，用户可以使用 Outlook Web Access Web 部件 URL 打开另一个用户的日历。

在 Weekly 视图中打开特定的日历：

  1. 打开 Web 浏览器窗口。

  2. 输入 Outlook Web Access 的 URL 并在 URL 结尾添加以下字符串：<邮箱 SMTP 地址>/?cmd=contents&f=calendar&view=weekly。

  3. 输入登录凭据（如果系统提示您这样做）。

例如，如果 Outlook Web Access 的 URL 是 https://email.fourthcoffee.com/owa，则下列 URL 将在 Weekly 视图中打开属于用户 tsmith 的日历。

https://email.fourthcoffee.com/owa/tsmith@fourthcoffee.com/?cmd=contents\&f=calendar\&view=weekly

若要直接访问公用文件夹中的某个特定文件夹，请将字符串 &f=<Foldername> 添加到 URL /owa/?cmd=contents&module=PublicFolders。例如，访问公用文件夹中特定文件夹的完整 URL 类似于如下结构：

https://cas.contoso.com/owa/?cmd=contents\&module=PublicFolders\&f=\<FolderName>

对于您要访问的且低于此级别的每个文件夹级别，必须添加字符串 %2f<FolderName>。例如，若要访问公用文件夹层次结构中下一个级别的文件夹，完整的 URL 应当类似如下结构：

https://cas.contoso.com/owa/?cmd=contents\&module=PublicFolders\&f=\<FolderName>%2f<FolderName>

对于您想访问的每个文件夹级别，请添加字符串 %2f<FolderName>。例如，如果您想访问的文件夹在公用文件夹中的深度达四级，请使用一个类似如下结构的 URL：

https://cas.contoso.com/owa/?cmd=contents\&module=PublicFolders\&f=\<FolderName>%2f<FolderName>%2f<FolderName>%2f<FolderName>

详细信息

有关 Web 部件以及如何规划网页的详细信息，请参阅下列主题：

有关 Outlook Web Access 身份验证的详细信息，请参阅下列主题：