Skip to main content
Top
Review meshIQ Products (G2.com)

Create a viewlet

You can add a viewlet to your dashboard by writing a jKQL query or entering the viewlet's specifications in a form. Please note, if a user has the Suppress jKQL query interface option enabled, they will only have permissions to create viewlets using the form method.

To create a viewlet:

  • In version 11.2, on the left toolbar, select  Viewlet  > Create Viewlet. You can also click the blue Viewlet button Viewlet button.png.
    In versions 11.1 and earlier, click the blue Viewlet button mceclip0.png (or depending on your permissions, the Viewlet Form button mceclip1.png). You can also click on the Main Menu button mceclip0.png and select Viewlet > Create.

mceclip2.png 

The Create/Open Viewlet dialog box opens. You are given the option to create a viewlet with jKQL or a form. See the below sections for instructions on how to do each. You can also open an existing viewlet from this window.

Create a Viewlet with jKQL

Perform the following steps to create a viewlet by writing a jKQL query:

  1. Select Create Viewlet with jKQL on the Create/Open Viewlet dialog box and click Create.
    Create viewlet with jKQL.png
  2. The Create Viewlet window opens. In the Define Query field, start typing the query. As you type, suggestions are provided in a drop-down list. In the below example the query, Get Log, is entered. 
    mceclip5.png
  3. Enter a name for your viewlet. In this example, My First Query was entered.
    mceclip6.png
  4. Click Create. Your viewlet is added to the dashboard: Create a Viewlet with a Form

Create a Viewlet with a Form

Perform the following steps to create a viewlet using the form.

  1. Select Create Viewlet with a Form on the Create/Open Viewlet dialog box. 
    create viewlet with a form.png
  2. The form opens. Specify the configurations  for the new viewlet. Required fields are signified with a red box as seen in the below image.mceclip6.png
    Configure the following options:
    • Viewlet Name: Specify a name for the viewlet.
    • Data Type:  In version 11.1 and earlier, select Historical or Real-Time, specify all associated options. 
      In version 11.2 specify all associated options to view Historical data.
    • Fields: Depending on the chart type, the Count option is required for certain viewlets. Associated required fields will be signified with a red box.
    • Group By:  Select an option from the drop-down menu to use as the criteria to group data. Items with numerical elements will have a bucket option which allows you to specify how data should be grouped. Enable this option and select the type of bucketing. The Having option allows you to to narrow the "count" for grouped results based on the number of records in those counts. The Having filter applies only when a "count" of records is selected for the Data Type (using the [Data Type] Count checkbox under the Fields section). In other words, for the Activity Data Type, the Activities Count checkbox must be selected; for the Log Data Type, the Logs Count checkbox must be selected; and the same holds true for all other data types (Events, Sets, Datasets, and so on). For example, if you select the Activities Count checkbox, group Activities by Severity, and select NumberOf > Greater than 10, the grouped results include only Severity levels that are associated with at least ten records.
    • Filters:  Multiple variables can be used to filter viewlets. Click the Add button mceclip2.png to add a filter. The operators available depend on the filter selected. After selecting the filter and operator, populate the Value field.
      mceclip0.png
      Click the Create Variable button mceclip3.png to create or modify variables.
      mceclip4.png
    • Viewlet Type:  Select viewlet type.
    • Viewlet Settings:  Modify viewlet options. Please note that not all viewlets will have this section. Select the X and Y axes values and the Collated by option (available for column, bar, line, stack and area charts). Enable the Show option within the Legend section to display the chart definitions.
  3. After all specifications have been made, click the Preview button to view the viewlet before saving. To cancel and discard changes, click Close. When finished, click Create and your viewlet will be added to your dashboard.

Create Viewlet using Image Template

Perform the following steps to create a viewlet by using image template:

  1. Select Create Viewlet Using Image Template on the Create/Open Viewlet dialog box and click Create. Check out the Create Viewlet using Image Template article for more information..

Create image using image template.png

Open Existing Viewlet

For more information, see the article on Open a Viewlet.