Web Part URLs supported by Exchange 2007 Outlook Web Access
Published Oct 26 2006 03:09 PM 21.9K Views

Web Part URL formats can be used to access Outlook Web Access web parts contents directly.

Exchange Server 2007 OWA has a new URL format to be used for requests to the /owa virtual directory.  Exchange Server 2007 will use this format when forwarding web part requests in the Exchange 2003 format to the Exchange Server 2007 /owa virtual directory.

Format used by SharePoint 2007 and 3rd parties using OWA2007 web parts:

  • http<s>://<server name>/owa/
  • [<EXCHANGE 2007 explicit logon mailbox identification>/]
  • ?cmd=contents
  • [&id=<folder id>]
  • [&f=<URL encoded folder path>]
  • [&module=<module to show default folder for>]
  • [&view=<view to show for folder>]
  • [&d=<day for calendar view>&m=<month>&y=<year>]
  • [&part=1]
  • [<legacy parameters>]

Example:

"https://srv22/owa/john.doe%40example.com/?cmd=contents&f=inbox%2fmyfolder&view=%20by%20subject"

Several of these parameters specify which folder the web part should display. When more than one of them is specified in the URL, this is the precedence order:

  1. Parameter "id"
  2. Parameter "f"
  3. Parameter "module"
  4. If none of the parameters above are present, the default folder to show is the inbox.

All these parameters require URL encoding. We don't expect users to compose them manually. Instead, we expect web parts and others who use these URLs to give users some kind of UI where they can select mailboxes, folders etc. Code behind the UI will then compose the actual URL with the URL encoded parameters.

<legacy parameters> are any Exchange 2000/2003 web part URL parameters not supported by Exchange Server 2007 OWA,  received as part of a web part URL directed to legacy virtual directories on Exchange Server 2007 (e.g. "/exchange" or "/public") which are forwarded to OWA2007 so support for them can be added in future releases if necessary.

URL component

Description

Values

EXCHANGE SERVER 2007 explicit logon mailbox identification

Any SMTP address registered for the user account associated with the mailbox

 

If this part of the URL is not present, the default mailbox of the authenticated user is assumed.

 

https://server/owa/john.doe@microsoft.com/

?cmd=contents

 

Example:   

 

john.doe@microsoft.com or john.doe@exchange.microsoft.com 

 

If both SMTP addresses are registered for the mail box to be accessed

 

id

The folder id of the folder the web part should display contents from.

 

The Base64-encoded PR_ENTRY_ID of the folder

f

A string indicating the mailbox folder to be shown in the web part. It is URL encoded (eg. Space " " becomes "%20",  path delimiter "/"  becomes. "%2f".

 

The folder hierarchy should start from the mailbox root.

 

This folder path can point to normal folders or search folders.

 

https://server/owa/

?cmd=contents

&f= inbox%2fmyfolder

&view=by%20sender

 

Example:

 

 "inbox%2fmyfolder"

 

Connects to the inbox subfolder "myfolder"

view

This parameter specifies the view to be displayed for the folder.

 

Example:

 

https://server/owa/

?cmd=contents

&f=MyCalendarFolder

&view=Weekly

 

Exchange 2003 Web Part views not supported in Exchange Server 2007 are:

 

"monthly" view for Calendar, "address card" and "detailed address card" views for Contacts and "unread by conversation topic" and "sent to" for messages.

 

The default views when this parameter is not present are:

 

Calendar: Daily

Messages: Messages

Contacts: Two%20Line

Tasks: By%20Due%20Date

 

When 'default sort' is used for a view, that means the view should be sorted as it would it if was opened in the OWA client (i.e. not through a web part).

 

The strings identifying the views are not localized and not case sensitive.

Calendar views:

"Daily"

"Weekly"

 

Message views:

"Messages"- one line, with default sort

"By%20Sender" - one line, sorted by 'from' with 'a' on top.

"By%20Subject" - one line, sorted by 'subject' with 'a' on top.

"By%20Conversation %20Topic" - Conversation View, only in OWA Premium

"Two%20Line" - two line, with default sort, only in OWA Premium

 

Contact Views:

"Phone%20List" - one line, with default sort

"Two%20Line" - multi line, with default sort, only in OWA Premium

 

Tasks:

"By%20Due%20Date" - one line, with default sort

"By%20Subject" - one line, sorted by 'subject' with 'a' on top.

d, m, y

Specifies the date to display the calendar for.

Example:

https://server/owa/

?cmd=contents

&module=calendar

&view=daily

&d=2&m=9&y=2005

 

The default date when these parameters aren't specified is today's date.

 

d=[1-31]

m=[1-12]

y=[four digit year]

module

This parameter can be used to specify that a certain default folder should be shown in the web part, without specifying the localized name of the folder. We expose this parameter since some users won't know the localized name of default folders they want to access.

 

https://server/owa/

?cmd=contents

&module=tasks

 

"inbox"

"calendar"

"contacts"

"tasks"

Part

Specifies that OWA should provide UI optimized for the web part format.  See below for the different UI OWA will display when part=1 is applied.

 

https://server/owa/

?cmd=contents

&part=1

 

 

 

1

 

Web Part URL with Part=1

Web Part URL without Part=1

For backwards compatibility, Exchange Server 2007 will continue to support the Exchange 2003 OWA format for Web Part URLs.    The Exchange 2003 OWA Web Part URL format can be used against legacy virtual directories on Exchange Server 2007 (e.g. "/exchange" or "/public").

Exchange Server 2007 will parse URLs in the Exchange 2003 OWA Web Part format and  reformat the URLs of requests that should be handled by Exchange Server 2007 OWA to the new format, and then redirect these requests to the /owa virtual directory.   The /owa virtual directory only executes URLs in the new OWA2007 format.

Format used by SharePoint 2003 against Exchange 2003 OWA 2003 and Exchange Server 2007 OWA legacy virtual directories

http<s>://<server name>/<"exchange" or other OWA legacy virtual directory name>/

<E2003 explicit logon mailbox identification>/<folder path>/?cmd=contents<n parameters>

Example:

"https://srv22/exchange/john.doe/calendar/?cmd=contents&view=weekly"

Where:

  • <"exchange" or other OWA legacy virtual directory name> is the name of an Exchange 2000 or Exchange 2003 OWA virtual directory, which can be a custom name, but by default is "exchange" (for mailbox access).
  • <Exchange 2003 explicit logon mailbox identification> is a complete SMTP address or the left hand side of an address in the SMTP domain associated with an E200x OWA virtual directory.
  • <folder path> is the path of a folder in the mailbox from the root of the mailbox, including "/" characters as the folder name delimiter.
  • <n parameters> is any of the URL parameters specified in the Exchange 2000 OWA customization white paper. There can be 0 or n parameters. Each of them has the format "&<parameter>=<value>".

Many thanks to Kristian Andaker, the preceding information about the URL formats has been largely co-op'd from his functional specification for OWA Web Parts.

- Lisa Schulte

2 Comments
Version history
Last update:
‎Jul 01 2019 03:19 PM
Updated by: