Viewing Dashboards

Viewing the Dashboards Page

To view the Dashboards page:

On the Home page, click Dashboards.
To open a dashboard, click the dashboard's name.

This opens the dashboard in the runtime environment.

Note:

If you've selected a Dashboard 2.0 dashboard and you see an Error during Dashboard 2.0 component initialization message, the dashboard has Forms 2.0 forms associated with it. You must ensure that a Service Administrator enables Forms 2.0 before you can view the dashboard.

To enable Forms 2.0, a Service Administrator must click Application, then Settings, and then under Other Options, find Forms Versions, select Forms 2.0, and then click Save.
A dashboard form might be prevented from opening if it includes undefined user variables. If you're prevented from viewing a dashboard form, you'll see a message prompting you to select members for the user variables:
```
Before you can open this form, you must select a member for each User Variable. To select members for missing user variables: Click here
```
When you click the link in the message, the User Preferences page opens in a new dynamic tab and the user variables with missing member values are displayed first. Select a member for each undefined user variable. See Setting User Variables.

Features of the Dashboards Page

On the Dashboards page:

Folders are supported. The Dashboards page uses the same folder hierarchy as infolets and data entry forms and all artifacts and folders reside under a root folder called Library.

Note:

Only administrators can add files (for example, dashboards, infolets, forms, reports, and so on) to the Library root folder.
Hide Empty Folders: Hides folders that don't contain relevant artifacts for the current context. When the toggle is off, all folders are visible in the list region, including empty ones. When the toggle is on, only folders containing relevant artifacts for the Dashboards artifact page are displayed.

By default this option is off, and will reset to off each time you start a new session. The state of the toggle is retained by the page during the session and is page-specific. Navigating away from the Dashboards page and returning preserves the toggle state until the tab is closed or until you log out.
Dashboards are available in two versions. To help you differentiate between the dashboard versions on the Dashboards page, we've provided an icon in front of each dashboard:
- : Dashboard 1.0
- : Dashboard 2.0
The Dashboards page can be filtered by type. Click the Type filter chip in the Search box and select Dashboard 1.0, Dashboard 2.0, or select both.
To search for a specific dashboard, enter any sequence of characters (also known as a string) and the search results will display in a drop-down under the Search box. Click Enter to view the search results in the list region. Search results list all instances of dashboards that include the searched string (including folder names). Each search result displays the complete folder path. Searching inside a folder narrows the search to that folder and its subfolders.

Note:

If you perform a Search and the Hide Empty Folders toggle is off, all matching folders and artifacts are displayed. If the toggle is on, only folders containing matching artifacts are displayed. Empty folders are hidden.

Dashboards Page Actions

There are three types of Actions you can perform on the Dashboards page:

Global Actions: Perform actions at the Library (root folder) level. See Global Actions.
Folder Actions: Perform actions at the level of the selected folder. See Folder Actions.
Dashboard Actions: Perform actions at the level of the selected dashboard. See Dashboard Actions.

Global Actions

At the top of the Dashboards page there is a global Actions menu. Clicking (More Actions) at the top of the page displays the following actions:

Create Dashboard 1.0: Creates a Dashboard 1.0 dashboard and places it in the folder that is currently open. If no folder is open, new dashboards are placed in the Library folder.
Create Dashboard 2.0: Creates a Dashboard 2.0 dashboard and places it in the folder that is currently open. If no folder is open, new dashboards are placed in the Library folder.
Create Folder: Creates a new folder in the folder that is currently open. If no folders are open, new folders are created in the Library folder.

Note:

Keep in mind that newly created folders are empty and therefore will not display if the Hide Empty Folders toggle is on. New folders become visible after content is added to them, or if the toggle is switched off.
Convert Dashboards to 2.0: Finds any Dashboard 1.0 dashboards in the folder that is currently open, including any subfolders, and converts them all to Dashboard 2.0 dashboards. Selecting a folder in the listing and then selecting the global action for Convert Dashboards to 2.0, finds any Dashboard 1.0 dashboards within the folder, including any subfolders, and converts them to Dashboard 2.0 dashboards. Selecting one or more Dashboard 1.0 dashboards in the listing and then selecting the global action for Convert Dashboards to 2.0, converts the selected dashboards to Dashboard 2.0 dashboards. This action cannot be undone.
Assign Permission: Assigns access permissions to the folder that is currently open. If no folder is open, permissions are assigned to the Library folder.
Move to: (This option is only visible if one or more artifacts in the listing are selected.) Moves the selected artifacts to another location in the folder hierarchy.

Folder Actions

To the right of the Dashboards listing there is an Actions column. Clicking (Actions) next to a folder displays the following actions:

Delete: Deletes a folder. The folder must be empty to delete it.
Rename: Renames a folder. The folder cannot be renamed if it contains other folders.
Move to: Moves the folder to another location in the folder hierarchy.

Note:

All folders are displayed and are selectable in the Move interface, regardless of the state of the Hide Empty Folders toggle.
Convert Dashboards to 2.0: Finds any Dashboard 1.0 dashboards within the folder hierarchy, and converts them to Dashboard 2.0 dashboards. This action cannot be undone.
Assign Permission: Assigns access permissions to the folder. Folder permissions apply to all items within that folder, even to items that may not be visible in the list.

Dashboard Actions

To the right of the Dashboards listing there is an Actions column. Clicking (Actions) next to a dashboard displays the following actions:

Open: Opens the dashboard in the runtime environment.
Edit: Opens the dashboard in the Dashboard Designer with the underlying form data. The dashboard opens in a dynamic tab.
Edit without Data (Dashboard 2.0 option only): Opens the dashboard in the Dashboard Designer without the underlying form data so you can more easily perform such actions as realigning the dashboard components and tiles. The dashboard opens in a dynamic tab.
Delete: Deletes a dashboard.
Rename: Renames a dashboard.
Copy As: Copies a dashboard with a new name. The dashboard is copied to the listing directly under the original dashboard.
Move to: Moves a dashboard to another folder.

Note:

All folders are displayed and are selectable in the Move interface, regardless of the state of the Hide Empty Folders toggle.
Copy URL: Enables you to copy and share the direct URL for a dashboard. See Copying Individual URLs in Administering FreeForm.
Convert Dashboards to 2.0 (Dashboard 1.0 option only): Converts the dashboard to a Dashboard 2.0 dashboard. This action cannot be undone.
Assign Permission: Assigns access permissions to the dashboard.