This documentation is archived and is not being maintained.

Mapping (Forms Registry XML Element)

Topic Last Modified: 2007-11-12

The Mapping element specifies the form that will be called when the content class is in the specified state, and the user performs the specified action.

<Mapping Action="" State="" Form=""/>

The following sections describe attributes, child elements, and parent elements.


Attribute Description


Optional. Specifies the user actions that Microsoft Office Outlook Web Access for Microsoft Exchange Server 2007 Service Pack 1 (SP1) will respond to by opening the specified form. Separate multiple values by using spaces; for example, "Print Open" indicates that the form will be used for both printing the item, and for displaying the item in an noneditable way. If this attribute is omitted, the form mapping will be used for all actions unless a more specific mapping is specified. If this attribute is included, the values must be one or more of the following:

  • Forward
  • GetMime
  • New
  • Open
  • OpenEmbedded
  • PostReply
  • Preview
  • Print
  • Print
  • Reply
  • ReplyAll
  • SendAgain


Optional. Specifies the state that the item must be in for this form to be displayed by Outlook Web Access. If this attribute is omitted, the form mapping will be used for item states unless a more specific mapping is specified.


Specifies the full URL or the form that will be opened when the user performs the matching action on an item that is in the specified state.


Optional. Specifies which Outlook Web Access segmentation components must be enabled for this form mapping to be used. If more than one component is listed, they must be separated by a space character. The following are the possible values for this element:

  • AddressLists
  • Calendar
  • ChangePassword
  • Contacts
  • Dumpster
  • EasMobileOptions
  • Journal
  • JunkEMail
  • Notifications
  • PublicFolders
  • RichClient
  • Rules
  • SMime
  • SearchFolders
  • Signature
  • SpellChecker
  • StickyNotes
  • Tasks
  • Themes
  • UMIntegration
  • UncIntegrationFromPrivateComputer
  • UncIntegrationFromPublicComputer
  • WssIntegrationFromPrivateComputer
  • WssIntegrationFromPublicComputer

Child Elements

This element has no child elements.

Parent Elements

Element Description


A container for mappings between custom forms and the content class and action that the forms will be used for.

Outlook Web Access verifies that the mapping matches the content class, action, and state before it calls the form.

Outlook Web Access passes parameters to the form in the GET URL. The following table lists the parameters that are passed to the form.

Parameters that are passed in the GET URL

Parameter Example Description



Application Element. Defines the type of Outlook Web Access object. Custom forms can be called for Folder and Item objects.



Action. Describes the type of action to perform on the object.



Type. Defines the content class type of the item.



Identifier. Provides the Outlook Web Access identifier for the item. The application should use the Exchange Web Services method to convert the id value into a value that Exchange Web Services uses.



State. Describes the current state of the item. This parameter is optional. For e-mail messages, this value is typically Draft.


E-mail Address. Provides the short Simple Mail Transfer Protocol (SMTP) e-mail address of the Outlook Web Access user whose mailbox is being accessed.