Dashboard Widget Configuration

The CSA Service Management Console dashboard provides twelve out of the box widgets.

The widgets and dashboard differ to those available in the Marketplace Portal configuration and are more suited for the administrators versus consumers.

Similar to the side-bar menu configuration (see Side-Bar menu Configuration File Syntax), the Service Management Console can be configured by the CSA Administrator.

Configuration Steps:

  1. Open CSA_HOME/jboss-as/standalone/deployments/csa.war/dashboards/dashboardconfig folder, where the configuration files that define the dashboard layout are located.
  2. After installation, check for dashboardconfig folder to have the following 4 files:

    • dashboard-backup. zip - This is a zip file consisting backup of the last sync of the dashboard file system config to the database.

    • dashboardconfig.done - This is a trigger file that indicates the last sync is in a done state.

    • dashboards - The list of available dashboards.

      Within the dashboards folder are two files:

      csa.json - The CSA Dashboard

      codar.json - The CODAR dashboard

    • tiles - The list of tiles (widgets) available.

  3. The following is just an example for a dashboard widget configuration. Refer to one of the file system for a detailed information.

    {

    "id": "csa",
    "name": "csa_default_dashboard",
    "displayName": "CSA Dashboard",
    "enabled": true,
    "backgroundUri": "/csa/html-lib/images/common/dashboard/dashboard-solid-background-1.jpg",
    "restrictions": {
    "roles": [],
    "permissions": [],
    "licenseFeatures": [20795],
    "productFeatures": []
    },
    "tiles": [
    {
    "id": "1", [
    "tileId": "primaryid_csa",
    "selectedSize": "2x2",
    "row": 0,
    "col": 0 		
    },
    "id": "2",
    "tileId":"organization_subscription_summary", 
    "selectedSize": "5x2",
    "row": 2,
    "col": 5
    }]
    }

    Following table provides description of each attribute in the above dashboard configuration:

    Attribute Description
    id Unique ID of the dashboard.
    name Internal name for the dashboard
    displayName Display name if no translation is available.
    enabled If the dashboard is enabled and available to users - set to true, else set to false.
    backgroundUri Optional path to a background image for this dashboard, can be a relative path or full URL.
    restrictions List of criteria that must be met for this dashboard to be available.
    roles

    List of roles required to access this dashboard. Similar to sidebar configuration.

    For example: SERVICE_OPERATIONS_MANAGER

    permissions

    List of permissions required to access this dashboard. Similar to sidebar configuration.

    For example: SERVICE_BLUEPRINT_WRITE

    licenseFeatures

    License ID required for this dashboard to be available.

    20795: CSA, 20797: CODAR

    productFeatures

    Product features that must be available for this dashboard.

    For example: MONITORING, COMPLIANCE

    tiles List of tiles/widgets to include in this dashboard.
    tileid TileID reference to the widget to be used.
    selectedSize Default size (2x2) - Default tile/widget size for this tile, must match a size from the tile/widget definition or the first one will be automatically selected instead.
    row "0" is the default starting position
    column "0" is the default starting position

    The first tile in the list is referring to the primaryid_csa widget. Within the tiles folder, primaryid_csa.json file contains the widget configuration.

    {
    "id": "primaryid_csa",
    "name": "primaryid_csa",
    "displayName": "CSA Product tour",
    "template": "primaryid_csa.html",
    "enabled": true,
    "selectedSize": "2x2",
    "supportedSizes": ["2x2", "3x2", "3x3", "4x3", "4x4"],
    "interaction": 
    {
    "enabled": true,
    "uri": ""
    },
    "restrictions":
     {
    "licenseFeatures": [20795],
    "productFeatures": ["MONITORING", "COMPLIANCE"],
    "roles": ["<role_1>", "<role_2>", ... , "<role_n>"],
    "permissions": ["<permission_1>", "<permission_2>", ... , "<permission_n>"]
    }
    }

    Following table provides description of each attribute in the above tile/widget configuration:

    Attribute Description
    id Tile/widget ID. This value is referred by tileId in the dashboard configuration.
    name Internal name for this tile/widget
    displayName Display name if no translation is available.
    template Co-located html template to use for this widget. This file must exist in the same folder as the json file.
    enabled If the tile/widget is enabled - set to true, else set to false.
    selectedSize Default size (2x2) of tile if no size is configured in the dashboard json file.
    supportedSizes Available sizes for this tile.
    interaction Interaction configuration
    enabled

    true/false

    True- user can interact with the contents of the tile.

    False- a transparent overlay is added to avoid the user being able to click into a tile.

    uri Optional URI to launch when a user clicks a tile/widget. When this URI is set, a clickable overlay is added to the tile overriding the native interaction within a tile/widget.
    restrictions List of criteria that must be met for this widget to be available, same settings as available in the dashboard.
    roles

    List of roles required to access this dashboard. Similar to sidebar configuration.

    For example: SERVICE_OPERATIONS_MANAGER

    permissions

    List of permissions required to access this dashboard. Similar to sidebar configuration.

    For example: SERVICE_BLUEPRINT_WRITE

    licenseFeatures

    License ID required for this dashboard to be available.

    20795: CSA, 20797: CODAR

    productFeatures

    Product features that must be available for this dashboard.

    For example: MONITORING, COMPLIANCE

  4. Within the primaryid_csa.json is a reference to primaryid_csa.html which contains the portion of this widget that will be rendered to the user in the CSA Service Management Console.

  • NOTE: HTML content (primaryid_csa.html)will be added to the dashboard widget once it is rendered for the user.
    When using iframes and https, the SSL Certificate must be trusted by the user’s browser or otherwise the widget will fail to render.
  •  

    Add a Custom Widget

    To add a custom widget, get the HTTP/S location of a URL you want to iFrame into the dashboard.

    Other than the primaryid_csa widget, the other widgets in CSA are using internally developed code to render the graphical data. To develop a similar graphical widget outside of CSA and to present it to the users by an iframe widget, follow these steps:

    1. Create a new widget under the tiles folder.

    2. Create a new template under the tiles folder for the widget (use the primaryid_csa.html/json as a sample for this template creation).

    3. Add a new entry in the csa.json file under the dashboards folder for the new widget.

      NOTE: Ensure that the id value of the newly added widget is unique within the dashboard list.
    4. After the .json configuration, synchronize the changes into the database. This sync must be done at the time the json or templates have changed.

      Perform the following steps to re-synchronize the dashboard configuration:

      1. Update/add/remove dashboard configuration files in the directory:
        CSA_HOME\jboss-as\standalone\deployments\csa.war\dashboard\dashboardconfig
      2. Rename dashboardconfig.done to dashboardconfig.load

      3. Restart CSA on the system you have made the filesystem changes. Restart is executed for following reasons:

        1. After the CSA restart, dashboardconfig.load is renamed to dashboardconfig.done

        2. To ensure in an HA environment, only one CSA is syncing the dashboard changes back into the database.

          After the above steps are performed, a new widget will be available to the users who meet the restriction criteria specified.