The following tables show the mapping rules from Classic client form controls to RoleTailored client page controls.

NoteNote

All actions are placed in action groups. Action groups have different subtypes that specify in which menu in the Command Bar the action will be displayed. For more information about action groups and subtypes, see How to: Add Actions to a Page.

Command Button Control
Command button control on Classic client form Mapping rule Page control

Application-specific command buttons (except Comment and Help)

Moved to the Actions menu in the command bar. Property Promoted=Yes.

Action

Comment and Help buttons

Does not transform

Not applicable

System command buttons:

  • OK/Cancel

  • Close

  • Yes/No

  • LookupOK

  • LookupCancel

  • Removed

  • If code is present, it is moved to the OnQueryClosePage trigger. The code is placed in an IF statement that corresponds to the return value from the system button.

Not applicable

Label Control
Label control on Classic client form Mapping rule Page Control

Label is a child to a parent control and label does not have a CaptionML value

The label is not transformed.

CaptionML of the parent control is used as a label

Label is a child to a parent control and label has a CaptionML value

CaptionML value of the label is transferred to the CaptionML of the parent control. The label is not transformed.

CaptionML of the parent control, which was transferred from the label, is used as a label.

Label is a stand-alone (parentless) control that is adjacent to another control (for example, a text box or a check box), and the other control has the following X and Y positions:

  • Xpos of control <= Xpos of the label + label width + 220 pixels

  • Ypos = Ypos of the label ±25

CaptionML value of the label is transformed to CaptionML of the adjacent control. The label is not transformed. The action is logged.

CaptionML of the adjacent control, which was transferred from the label, is used as a label.

Label is a stand-alone (parentless) control that is used as the header of a group of indented controls (labels, text boxes, or check boxes), and these indented controls have the following X and Y positions:

  • Xpos of control <= Xpos of the label + 330 pixels

  • Xpos of control >= Xpos of the label + 110 pixels

  • Ypos of control - Ypos of label >= 0

  • Distance between Ypos of two indented controls is a maximum of 660

CaptionML value of label is transformed as a CaptionML (header) for a group of controls.

The CaptionML property of the group contains the form's label CaptionML value.

Label is a stand-alone (parentless) control and is marked as InstructionalTextML

CaptionML of the label is transformed to InstructionalTextML property of its group. You must specify instructional text in the MoveElements.xml file for each group on the page.

InstructionalTextML is a property on a group.

Label is a stand-alone (parentless) control and is not marked as InstructionalTextML but still can be recognized as InstructionalTextML

CaptionML of the label is transformed to InstructionalTextML property of its group. The action is logged.

InstructionalTextML is a property on a group.

Label is a standalone (parentless) control that is not marked as InstructionalTextML

Transformed as a control with CaptionML but without SourceExpr.

Control without SourceExpr.

Label is a parent to other controls

Log as exception.

Not applicable

Menu Button Controls
Menu button control on Classic client form Mapping rule Page control

Menu buttons calling a form

  • Moved to the menu bar

  • Distributed between the Actions and Related Information menus based on the following distribution rules:

    • By default, all menu items are moved to the Related Information container

    • Transformation input file, MoveElements.xml, specifies that actions with the following CaptionML values are moved to the Actions menu: ENU=Posting, ENU=Issuing, ENU=Registering, ENU=Functions, ENU=Print

  • Placed in the same sorting order as displayed on the form

Action

Menu buttons calling the subform

Moved to subpage under the Actions menu.

Menu buttons are moved to the subpage in many cases but in others remain on the main page.

In some cases, menu buttons that call the subform are not moved to a subpage but are instead logged. The user must modify the form manually.

Action in the Actions menu.

Separator (MenuItemType)

Transformed to the new separator MenuType

SeparatorControl

Subform Controls
Subform control on Classic client form Mapping rule Page control

In documents

  • Transformed to a group

  • Placed second in a sorting order

ListPart

In other forms

  • Transformed to a group

  • Placed in the same sorting order as on the form, for example as a last control

ListPart

Text Box Control
Text box control on Classic client form Mapping rule Page control

Text box control

  • Transformed to a field

  • Placed in the same sorting order as displayed on the form

Field

Text box is a control with Focusable=No and SourceExpr=<value>. Text box is positioned adjacent to another control (for example, an OptionButton)

SourceExpr value is transformed to the CaptionClass property of the parent control. The text box is not transformed.

Not applicable

Text box is a control used for instructional text with width>=6100

Transformed to a control with a CaptionClass but without a SourceExpr

Field

Other Controls
Control on Classic client form Mapping rule Page control

Check Box (same as Text Box)

See Text Box Control table

Field

Frame

  • If placed on a tab, transformed to a group

  • If placed on a form directly, transformed to a FastTab

  • Placed in the same sorting order as displayed on the form

Group

Image

Does not transform

Not applicable

Indicator

Transformed into a progress bar on the page

Progress Indicator (=PowerBar)

Matrix Box

Logged as exception

Not applicable

Picture Box

Does not transform

Not applicable

Option Button (same as Text Box)

A group of radio buttons is transformed as a single control with an enumerated list of options.

RadioButton or DropDown depending on display target and number of options.

Shape

Does not transform

Not applicable

Tab

  • Transformed to a FastTab

  • Placed in the same sorting order as tabs

  • CaptionML=value transformed as a CaptionML (header) for the FastTab

Group

Table Box

Transformed

Repeater