Converting Dashboard 1.0 Dashboards to 2.0

Learn how to convert Dashboard 1.0 dashboards to Dashboard 2.0 dashboards.

If your application currently uses Dashboard 1.0, you can convert them to Dashboard 2.0.

You convert dashboards on the Dashboards listing page at the individual dashboard level or at the folder level. For example, if you wish to convert all dashboards in the application from 1.0 to 2.0, you can select the top level Library folder and convert them all.

Note:

  • After converting to Dashboard 2.0, you cannot convert your dashboards back to Dashboard 1.0.

  • The conversion process does not change the dashboard names. Navigation flows will still work as they did before the conversion.

  • After converting to Dashboard 2.0, dynamic POVs are displayed first instead of fixed POVs.

To convert Dashboard 1.0 to Dashboard 2.0:

  1. On the Home page, click Library, and then click the Dashboards tab at the bottom of the page.

  2. Navigate to the folder or to the individual Dashboard 1.0 dashboard that you'd like to convert, then select from the following options:

    • To convert an individual dashboard, click Actions icon (Actions) to the right of the dashboard, and then select Convert to Dashboards 2.0.

    • To convert all dashboards within a folder, click Actions icon (Actions) to the right of the folder, and then select Convert All Dashboards to 2.0.

Note:

  • Very old dashboards might include a dashboard definition with a component width value that is no longer supported. This could result in an unexpected dashboard rendering after converting an old dashboard to Dashboard 2.0.

    To resolve this issue, we recommend any of the following workarounds:

    • Open the original dashboard in Dashboard 1.0, edit the dashboard, and then save it. The dashboard will be automatically saved with the corrected component width values, and then it can be converted to Dashboard 2.0.

    • Create a new dashboard in Dashboard 1.0 with the same set of forms and charts and the same settings, then convert the dashboard to Dashboard 2.0.

    • Create a new dashboard in Dashboard 2.0 with the same artifacts and settings.

  • Dashboards containing master forms and details that were converted to Dashboard 2.0 prior to the 23.11 update might display two Apply Context menu options in a grid's context menu. This issue was fixed in 23.11.

  • After converting a Dashboard 1.0 dashboard to Dashboard 2.0, charts containing small values may appear empty even when the source form contains data.

    Dashboard 2.0 uses the data type of the first cell in the form’s first row to determine which form precision settings apply to the visualization. These settings control the number of decimal places displayed. For example, if that cell has a currency data type and Currency Maximum Precision is set to 0, a value of 0.456 is displayed as 0.

    To display small currency values, edit the source form and select Other Options → Precision → Currency Values. Increase Maximum to the number of decimal places needed, save the form, and refresh the dashboard. For example, setting Maximum to 3 displays 0.456 in the dashboard. Smaller values may require greater precision.