Modern UI: How to Switch a Form Between the Modern UI and the Classic UI

MYOB Acumatica provides a number of ways that you can switch an MYOB Acumatica form that is using the Modern UI to the Classic UI or vice versa. You can also view a form in both the Modern UI and the Classic UI concurrently (in separate browser tabs).

Before you use any of the methods described in the following sections, you need to add the <add key="EnableSiteMapSwitchUI" value="True" /> key (if it has not already been added) in the appSettings section of the Web.config file of your MYOB Acumatica instance.

Attention:
If you have selected the Enable Modern UI check box while deploying your instance by using the MYOB Acumatica ERP Configuration Wizard, the system has automatically added the <add key="EnableSiteMapSwitchUI" value="True" /> key to the Web.config file of your instance.

Using the Menu on the Form Title Bar to Switch the UI

While you are on the Classic UI of a form, you can click Tools > Switch to Modern UI on the form title bar, as shown in the following screenshot to switch to the Modern UI of the form.



While you are on the Modern UI of a form, you can click Settings > Switch to Classic UI on the form title bar, as shown in the following screenshot, to switch to the Classic UI of the form.



Switching the UI on the Site Map Form to Switch the UI

To display a form in the Modern UI or the Classic UI for all users of the instance, you can select Modern or Classic in the UI column of the Site Map (SM200520) form for the row that corresponds to the form, as shown in the following screenshot.



The Site Map form also has the Switch to Modern UI and the Switch to Classic UI buttons on the form toolbar. By using either button, you can switch the default view of the UI for all forms with a single click. You click the Switch to Modern UI button to switch the UI to the Modern UI for all the forms that are already available in the Modern UI, except for the Site Map form. Clicking the button causes a confirmation dialog box to open, as shown in the following screenshot.



You click the Switch to Classic UI button to switch all the forms to the Classic UI. Clicking the button causes a confirmation dialog box to open, as shown in the following screenshot.



Modifying the Form URL to View a Form Concurrently in Both UIs

While you are working with the Modern UI, constantly switching between the two styles manually to compare their appearances, as described in the previous section, can become inconvenient. You can instead view a form in both the Modern UI and the Classic UI concurrently by using multiple tabs on your web browser. To do this, perform the following instructions:

  1. Open the form in the Classic UI in a tab of your web browser and copy its URL from the address bar of the tab.
  2. In another tab, open the same form in the Modern UI by pasting the URL that you copied in the preceding instruction in the address bar of the tab, and adding the ui=T parameter to the end of the URL, as shown in the following example.
    http://localhost/AcumaticaERP/Main?ScreenId=SO301000&ui=T

    You can switch back to the Classic UI by specifying ui=E in the page URL.

Attention:
The ui=T parameter provides only the appearance of the Modern UI for the form. To test the functionality of the form, you need to navigate to the form by using your instance and switch to its Modern UI, by using the ways described in the preceding sections.