Building a Custom Template

Though eG Enterprise offers the flexibility to build the One Click Dashboard based on pre-built dashboard templates for certain mission-critical component-types, administrators may still want to create their own template for the component types of their interest. To address the needs of such administrators, eG Enterprise provides the capability to build custom templates and widgets. These templates when configured with key metrics on the performance of the component type that is of interest to the administrator, can be used extensively while creating a My Dashboard.

To build a custom template, do the following:

  1. Follow the menu sequence: Monitor -> Dashboards ->My Dashboard ->Templates.
  2. Figure 23 will then appear listing the default templates that are pre-built by eG Enterprise. Note that these templates will vary across environments as eG Enterprise intelligently displays the pre-built templates based on the component types managed in the target environment.

    Figure 23 : The pre-built templates in the target environment

  3. To create a new template click the Create New button in Figure 23. Figure 24 then appears.

    Figure 24 : Creating a Template

  4. In Figure 24, specify the following:

    • Template Name: Specify the name of the template.
    • Description: Here, provide a brief description of the new template.
    • Layout Style: Pick a layout style for the template. By default Linear will be chosen from this list. If you do not wish to choose between the layouts (Linear, Relative and Tabular) offered by eG Enterprise, you can create your own layout by picking the Custom option.
    • No of widgets: By default, this list will display the number of widgets offered by default for the chosen layout. If you wish to add more widgets you can do so by clicking the '+' symbol. If you wish to reduce the number of widgets, then you can do so by clicking the '-' symbol.
    • Template Type: By default, Cross-Application option is chosen from this list. This implies that the template can be created for any number of component types managed in the target environment. If you choose application, then, you will be allowed to choose only a single Component Type.
    • Apply to: This option is applicable only when Cross-Application is chosen from the Template Type list. To categorize the template, or to view only the components available in the Zone/Segment/Services, select the option under the Apply to drop down. For example, selecting the Service option will list only the components that are part of a service. To view all the components in the environment, click on the Components option. By default, the Components option will be chosen in the Apply to list.
    • Component Type(s): Select a Component Type for which you wish to create the template. If the Component Type(s) list consists of too many component types, then viewing all the component types and selecting the ones you need for creating the template could require endless scrolling. To avoid this, you can click the icon next to the Component Type(s) list. The COMPONENT TyPE(S) pop up window will then appear using which you can view almost all the component types in a single interface and Select the ones for which you wish to create the template. You can even search for a component type of your choice using the Search Component Type(s) field in the Component Type(s) list.
    • Use this template for Home Page: If you wish to set this template as the Monitor Home page, then, first you need to check this option. Once you created the template, navigate to the USER PROFILE page where you are allowed to set the Monitor Home page. In the Set Monitor Home section, choosing the Domain Dashboard flag would list all the dashboards and the templates that you wish to set as the Monitor Home page (see Figure 25).

      Figure 25 : Editing the USER PROFILE page to set the created template as Monitor Home page

  5. Click the CREATE button to create the new template. Figure 26 will then appear.

    Figure 26 : A custom template created

  6. Once the template is created, you can configure the widgets for the template either by creating your own widget or adding the widgets that are offered as pre-built widgets by eG Enterprise. To know how to create a widget, refer to Creating a Custom Widget.
  7. Clicking the Add a Widget button will append a new unconfigured widget to the created template.
  8. To add a widget that was created by you or was shared by other users with you or to add a pre-built widget, click the icon. Figure 27 then appears.

    Figure 27 : The Widgets Library

  9. In Figure 27 that appears, the My Widgets tab will be chosen by default from the left panel. The context-sensitive right panel will display the widgets that are either created by you or are shared with you by other users of eG Enterprise. By default, All Widgets will be chosen from the list in the right panel. You can choose the name of the widget group from this list to view specific widgets that you have created within that widget group.
  10. The Widgets Gallery tab will list the pre-built widgets offered by eG Enterprise. To know more about these widgets refer to Pre-built widgets offered by eG Enterprise.
  11. To edit a template, click the icon.
  12. To clone an existing template, click the icon. Figure 28 will then appear.

    Figure 28 : Cloning a Template

    In Figure 28, specify the name of the template in the New Template Name and click the Clone button.

  13. To delete a template, click the icon.
  14. To view the list of templates in your environment, click the icon. Figure 29 then appears listing the templates.

    Figure 29 : Listing the templates

Creating a Custom Widget

To create a custom widget, click the Configure Widget option in Figure 26. Figure 30 then appears.

Figure 30 : Configuring the custom widget

Specify the following in Figure 30:

  • Widget Name: Specify the name of the widget.
  • Description: Here, provide a brief description of the new widget.
  • Graphical Type: Specify the type of graphical representation that you want to use to represent the widget. This list consists of the graphical representations offered by default by eG Enterprise. To navigate across the next page, click on the arrow icon next to the list.
  • Add to widget library: By default, this flag is set to No indicating that the widget that you are adding is exclusive to the created template. If you wish to reuse the widget across the templates/dashboards, then set this flag to Yes.
  • Widget Group Name: This list appears only when the Add to widget library flag is set to Yes. Choose a group name under which you would like to categorize the widget. By default, this list will contain the My Widgets option and the Other option. When Other option is chosen from the list, an Enter New Group text box will appear where you will be allowed to provide the name of your choice to the group under which you would like to place the widget.
  • Test: Select a test for which you would like to configure the widget.
  • Measure: Select the Measure(s) for which you would like to configure the widget. You can even search for the measure of your choice from this list using the Search Metric(s) text box.
  • Clicking the ADD button will list your selection in the Selection Details section.
  • If you wish to delete a test/measure combination from the Selection Details section, click the icon.
  • If you wish to delete multiple selections, then you can check the check box against the test/measure combination and click the icon.
  • When you click the icon, a separate configuration section will appear as shown in Figure 31 which will vary based on the Graphical Type that you have chosen. To know more on how to configure this section, refer to Configurable Widgets

    Figure 31 : Additional configuration for the custom widget

  • Finally click the icon to save the widget.

Once the widgets are configured, the template will appear as shown in Figure 32.

Figure 32 : A template with configured custom widgets