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:
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:
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.
?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:
?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: ?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.
?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.
?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:
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
You must be a registered user to add a comment. If you've already registered, sign in. Otherwise, register and sign in.