•  Refresh
  • Tools
  •  
  • Expand All
  • Collapse All
  • Locales
  • Get File Link
  • Report Typo
  • Print
  • Export

Modern UI Development: Switching a Form Between the Modern UI and the Classic UI

Acumatica ERP provides a number of ways that you can use to switch an Acumatica ERP form that’s using the Modern UI to the Classic UI or vice versa.

When you deploy or update an instance of Acumatica ERP in the Acumatica ERP Configuration wizard, make sure the Use Modern UI as Default check box is selected (the default state), as shown below.

Selection of the Modern UI as the default interface
Selection of the Modern UI as the default interface
Before you use any of the methods described in the following sections, you may need to make a change to the Web.config file of your Acumatica ERP instance. In the appSettings section, check if the <add key="EnableSiteMapSwitchUI" value="False" /> key has been added. If it has, remove this key from the file and save your changes. This is because this key disables the option to switch the UI of a form in the instance. By removing the key, you enable the option to switch the UI of a form.

If you switch a form’s UI by using the methods described below, the form’s UI will be switched for all users. Thus, this capability is not provided to all users. Only users with the Edit level of access rights to the Site Map (SM200520) form can switch the UI of a form.



In This Topic [Hide/Show]

Back to TopSwitching the UI of the Particular Form

While viewing a form in the Modern UI, you can click the Settings button on the form title bar and then Switch to Classic UI to switch the form to the Classic UI.

The Switch to Classic UI command
The Switch to Classic UI command
While viewing a form in the Classic UI, you can click Tools > Switch to Modern UI on the form title bar to switch the form to the Modern UI.
The Switch to Modern UI command
The Switch to Modern UI command

The Switch to Modern UI command is available for only the forms that have been migrated to the Modern UI.

Back to TopSwitching the UI of the Entire Site

To specify the user interface for all forms, use the Default UI setting on the Site Preferences (SM200505) form. It defines the UI to be used by default (Modern UI or Classic UI) for all users of the current tenant.

The Default UI setting
The Default UI setting

The form will use the interface specified as the default UI, if the form supports the selected UI.

Back to TopSwitching the UI of Multiple Forms

You can use the Site Map (SM200520) form to specify the default UI to be displayed for any number of forms.

To cause a form to be displayed in the Modern UI or the Classic UI, you select Modern, Classic, or Default in the UI column of the row that corresponds to the form, as shown in the following screenshot.

The options in the UI column
The options in the UI column
The Site Map form also has the Copy UI Settings to Tenants button on the form toolbar. By using this button, you can copy the UI settings of all the listed forms to other tenants. When you click this button, the system displays a dialog box where you can select the tenants to which you want to copy the UI settings.