Article
08/21/2009

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.

Schema Hierarchy

Registry
  Experience
    ApplicationElement
      ElementClass
        Mapping (Forms Registry XML Element)

Syntax

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

Attributes and Elements

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

Attributes

Attribute	Description
Action	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
State	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.
Form	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.
RequiredFeatures	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
ElementClass	A container for mappings between custom forms and the content class and action that the forms will be used for.

Remarks

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
ae	ae=Item	Application Element. Defines the type of Outlook Web Access object. Custom forms can be called for Folder and Item objects.
a	a=Open	Action. Describes the type of action to perform on the object.
t	t=IPM.Note	Type. Defines the content class type of the item.
id	id=RgAAAADAOYRcvwRy…	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.
s	s=Draft	State. Describes the current state of the item. This parameter is optional. For e-mail messages, this value is typically Draft.
ea	ea=user@example.com	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.