Partager via

  • Article

Mapping (Forms Registry XML Element)

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.

Registry
  Experience
    ApplicationElement
      ElementClass
        Mapping (Forms Registry XML Element)

<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 Outlook Web App for Microsoft Exchange Server 2010 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 App. 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 App 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 App verifies that the mapping matches the content class, action, and state before it calls the form.

Outlook Web App 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 App object. Custom forms that work with Exchange 2010 can be called for only 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 App 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 App user whose mailbox is being accessed.