Web Part URLs supported by Exchange 2007 Outlook Web Access


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

Comments (2)
  1. Luisb says:

    Great tip!!

    I want make a connection with Calendar View as Work Week. But I don’t find the keyword.

    Can you help me? Thanks

  2. Dave Lievense says:

    This was helpful somewhat, but I can’t seem to figure out the folder structure for the public folders.  I’ve tried both:

    Public FoldersAll Public FoldersSome DirectorySome Calendar

    and

    \Public FoldersAll Public FoldersSome DirectorySome Calendar

    but I can’t get access to any of the items in our public folders.  Any clue as to what I might be doing wrong?

Comments are closed.

Skip to main content