Adding widgets to an existing dashboard

2 minute read

You can add widgets to an existing dashboard to extend its functionality. You can create a widget or copy a widget from an existing widget. For example, you might want to create two entirely new widgets and also add copies of two widgets that exist in a second dashboard.

Creating a Widget

To create a widget and add it to a dashboard:

  1. Select the dashboard from the dashboards pull-down menu.

    The dashboard appears in Graphical viewing mode.

  2. Click the Dashboard Editor button to switch to dashboard edit mode.

  3. Click the Add Widget button and then click Create New. A dialog box for creating the widget appears.

  4. Enter the following details into the dialog box:

    Menu or Field Description

    Name

    Name of the widget to create. This name appears as the title above the widget in the dashboard.

    You should avoid using special characters, which are described in "Using Special Characters in CloudBees CD Object Names" in the CloudBees CD User Guide .

    Description

    (Optional) Description of the new widget.

    Place into…

    (Command-center widget types) Header or column in which to add the new widget. Click Header or Column (the default), and then select the specific header or column.

    Widget position

    (Command-center widget types) Location of the new widget in relation to another widget (if one already exists) that you choose via the Select Widget pulldown menu. You can ignore the widget position setting if this is the first widget.

  5. Click Define and then edit the definition of the widget.

Copying a Widget

To copy a widget from one dashboard to another:

  1. Select the dashboard to contain the new widget from the dashboards pull-down menu. The dashboard appears in Graphical viewing mode.

  2. Click the Dashboard Editor button to switch to edit mode.

  3. Click the Add Widget button, and then click Copy Existing.

    The New Widget from Existing dialog box appears:

  4. Choose a project from the Select Project menu.

  5. Choose a dashboard from the Select Dashboard pulldown menu. The list of available widgets to copy appears in the dialog box.

  6. Click the widget that you want to copy. A dialog box for editing the new widget appears. The name and description from the source widget are prefilled.

  7. (Optional) Modify the following details in the widget editor dialog box:

    Menu or Field Description

    Name

    Name of the widget to create. This name appears as the title above the widget in the dashboard.

    You should avoid using special characters, which are described in "Using Special Characters in CloudBees CD Object Names" in the CloudBees CD User Guide .

    Description

    (Optional) Description of the new widget.

  8. Click Define and then edit the definition of the widget.

    For details, see: