Transforming Control and Menu IDs

Microsoft Dynamics Nav 2009

When you transform a form to a page, the transformation tool generally applies a one-to-one mapping between form control and menu IDs on a form and page control and action IDs on a page. A control on a transformed page has the same ID as the corresponding control on the source form.

However, in the following cases, the controls and menu items are assigned a new ID by the transformation tool:

  • If one-to-one mapping of controls or menu items is not possible. For example, you may have mapped one tab control on a form to multiple FastTab controls on a page.

  • If new controls or actions have been added to the page that do not originate from the source form. For example, you may have added a FactBox to a page by using transformation input.

  • If controls exist on the source form that are moved to a different page when transformed. For example, you may have specified that a menu item on a main form calls a subform. It is then transformed to an action on a subpage instead of on the main page.

The new automatically generated IDs are assigned based on a hash algorithm that uses the ENU caption of the control or menu item.

NoteNote

This topic applies only to Microsoft Dynamics NAV 2009 SP1. For more information about the hotfix for the RTM version of Microsoft Dynamics NAV 2009, see Hotfix for Microsoft Dynamics NAV 2009: Control and Action ID Assignments on PartnerSource.

Example

An application has a form with ID=10. The TabControl with ID=1 specifies three tabs in the PageNames Property. The tabs on the form are:

  • General

  • Invoicing

  • Shipping

When you transform the form to a page, the tabs are transformed to three controls of Type=Group (FastTabs). The following table shows the automatically generated control IDs of the FastTabs.

Control ID

General FastTab

1

Invoicing FastTab

1905885101

Shipping FastTab

1906801201

Now, you modify the source form to include an additional tab, "Communication." The tabs now are:

  • General

  • Communication

  • Invoicing

  • Shipping

When you retransform the form, the new page has four FastTab controls. The original three FastTabs have the same control IDs as they had when you transformed the form to a page the first time. The new FastTab has a control ID that is based on its ENU caption. The following table shows the control IDs of the FastTabs.

Control ID

General FastTab

1

Communication FastTab

1902768801

Invoicing FastTab

1905885101

Shipping FastTab

1906801201

Assigning Control and Action IDs

You can also specify control and action IDs for the transformed page. You may want to identify all objects, fields, and controls that you create by assigning IDs within a given range. In that case, you can assign specific control and action IDs instead of allowing the transformation tool to assign IDs automatically. Controls and menu items for which you do not specify an ID will be assigned a unique ID based on the hash algorithm.

For more information about assigning control IDs, see the following topics:

See Also

Community Additions

ADD
Show: