使用 Outlook Web App Web 部件

  • 项目

 

适用于： Exchange Server 2010 SP2, Exchange Server 2010 SP3

上一次修改主题： 2016-11-28

可以使用 MicrosoftOfficeOutlook Web App Web 部件指定要打开的邮箱、该邮箱中要打开的文件夹以及要使用的内容视图。

使用 Outlook Web App Web 部件可以直接通过 URL 访问 Outlook Web App 内容。URL 可以在 Web 浏览器中输入，也可以嵌入应用程序。通常不以手动方式创建 Web 部件。而是根据在用户界面 (UI) 中作出的选择以编程方式创建 Web 部件，或直接将其嵌入应用程序（例如 MicrosoftOffice SharePoint Server 2007 或 SharePoint Server 2010 页）中。UI 后面之后的代码即创建 URL。Outlook Web App Web 部件的一项用途是在 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 部件的请求一起传递。这样做的一种方法是将 Outlook Web App 虚拟目录配置为使用集成 Windows 身份验证。通过集成 Windows 身份验证，已使用 Active Directory 帐户登录的用户不必重新输入其凭据即可使用 Outlook Web App。

Outlook Web App Web 部件语法

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

可以使用 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 将打开由 SMTP 地址指定的邮箱，打开至子文件夹 Projects，并按照主题进行排序。

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

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

Web 部件参数及其使用方法

URL 参数 描述 值和示例

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

Outlook Web App 虚拟目录的 URL。

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

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

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

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

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

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

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

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

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

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

如果未指定邮箱，则 cmd 参数跟在登录地址后面，如下所示：

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

如果指定了邮箱，则 cmd 参数跟在明确的邮箱标识后面，如下所示：

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

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

id（可选）

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

文件夹 ID 是文件夹的 Base64 编码的 PR_ENTRY_ID，例如：

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

fpath（可选）

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

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

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

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

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

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

module（可选）

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

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

  • Inbox

  • Calendar

  • Contacts

  • Tasks

  • Publicfolders

若要打开邮箱的日历（与本地化无关），请使用以下 URL：

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

view（可选）

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

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

  • 日历视图 Daily

  • 邮件视图 Messages

  • 联系人视 Two%20Line

  • 任务视图 By%20Due%20Date

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

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

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

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

日历视图：

  • Daily 每日日历视图

  • Weekly 每周日历视图

  • Monthly 月历视图

邮件视图：

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

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

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

  • By%20Conversation%20Topic 会话视图，在简易版本的 Outlook Web App 中不可用

联系人视图：

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

任务视图：

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

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

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

d, m, y（可选）

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

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

数据参数的有效值如下：

d=[1-31]

m=[1-12]

y=[四位的年份]

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

part（可选）

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

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

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

部件参数不适用于日历模块。

下图显示了不含 part=1 参数的 Outlook Web App 任务 Web 部件。

没有 Part=1 的 Web 部件 URL

下图显示了包含 part=1 参数的 Outlook Web App 任务 Web 部件。

包含 Part=1 的 Web 部件 URL

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

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

手动输入 Outlook Web App Web 部件

也可以在 Web 浏览器中手动输入 Outlook Web App 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 将在 Weekly 视图中打开属于用户 tsmith 的日历：https://email.fourthcoffee.com/owa/tsmith@fourthcoffee.com/?cmd=contents&fpath=calendar&view=weekly

详细信息

 © 2010 Microsoft Corporation。保留所有权利。