Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Watch this video or follow the procedure below to create a grid-type widget in MSPbots.

Widget Connector
urlhttp://youtube.com/watch?v=ooF8CEW7e7A

...

How to create a Grid Widget:

  1. Navigate to Widgets on the MSPbots app menu and click New Widget
    Image Added
  2. Choose the Grid 

MSPbots Widgets help you to quickly view important data and highlight action items at a glance. This article shows how you can start creating your own widget which you can further customize according to your business needs.

Do these steps to create a basic grid-type widget

  1. On the MSPbots menu, navigate to Widgets.
  2. On the Widgets tab, click New Widget.
    Design New WidgetImage Removed
  3. Choose the Grid widget type on the New Widget window.
    widget typesImage Modified
  4. When the Widget Builder window opens, go to  the Basic Setting tab. Provide the following and click Apply.:
    • Name - Give the widget a Namename.
    • Description - Provide Give the widget a short Descriptiondescription.
    • Role - Select User or Adminthe roles that will have access to the widget.
      widget builderImage RemovedImage Added
  5. Go to the Dataset tab. Click the + button and add a Image Addedand select New Layer.
    Do the following on the Dataset window: Image Added
    Image Added
  6. In the Dataset window,
    1. Select the Dataset with the data you need. 
      Image Added
    2. Enter a datasource name in the Show datasource name as field. (Optional) 
    3. For Columns Display
      1. Go to
    4. Select a dataset to use.
    5. Add columns by selecting an option from
      1. the Column Name dropdown
      list and assigning an Alias and Business Type for each. Click the (plus) button
      1. and selecta field for the drill-through.
        Image Added 
      2. Give an Alias and select a Business Type for your selection. 
      3. ClickImage Addedto add more rows.  
    6. For Filter 
      Add filters, measures, and dimensions. Refer to
      1. ClickImage Addedand choose either Add Condition or Add Group.
        Image AddedImage Added
      2. Select all the fields you want to filter.
      3. Set conditions for each field using the subsequent two dropdowns. For a guide on each option on the list, refer to the article 
      1. What Conditions are Available for Creating Widgets?
      as a guide for this step.
      edit widget datasetImage Removed
  7. Click Save. This will show a preview of the simple grid table that you created.
  8. Click Apply.

You can modify this basic widget further to show details like how many tickets are created per technician or to show the statuses of each ticket.

...

      1. Select the logical operator AND or OR for the filter group.
        Image Added
    1. For Measure
      1. Click the Image Added sign corresponding to Measure
        image add measureImage Added
      2. When the Measure window opens, select a Summary Type.
      3. Select a computation option from the Fields list.
      4. Type an Alias for the measure.
      5. Select a Format Type.
      6. Click Add.
        image dataset measureImage Added
    2. For Dimension,
      1. Click the Image Added sign corresponding to Dimension.
        image dataset dimensionImage Added
      2. Select a grouping option from the Fields dropdown.
      3. Give an Alias for the dimension.
      4. Select a Format Type.
      5. Click Add.
        image dimension parametersImage Added
    3. For DrillThrough Order By,
      1. Click the Image Added button.
      2. Select a parameter to automatically sort drill-throughs. 
        image drill-through sorting optionsImage Added
    4. For Order By (Optional)
      1. Click the Image Added button.
      2. Select a parameter to sort the data. 
        image sort data order byImage Added
    5. Row Limit - Select an option to set a limit on how many rows of data will be shown. (Optional) 
      image set row limitImage Added
    6. Remove duplicate data - Select this option if you have duplicate data to delete. 
      image remove duplicate dataImage Added
    7. Materialized - Select an option according to your requirements.
      image materializedImage Added
    8. Click Save to keep the Dataset configuration. 
      Tip

      The optional settings Order By and Row Limit are also available in the Widget Builder window. The settings configured in this area are applied to the grid widget. If the configurations were done in the Dataset window, the settings are applied on the drill-down. 
      Image Added Outdent



  1. Go to the Config tab and configure the following settings: 
    1. Under Grid Option
      image config grid optionImage Added
      • Font Size - Set the font size for the text in the table. 
      • Grid Style - Select the style of the grid for the table. Click Image Added and select any of the following:  
        • Data Grid - Shows all the tables 
        • Table - Lets you customize the parameters to show on the widget by clicking.

          image grid styleImage Added
      • Grid Lines - Select the type of grid lines to use for the table. (default, both, none, horizontal, vertical) 
      • Toolbar - Select the file types for the export feature. 
      • Show Paging - If toggled on, this will show the paging settings at the bottom of the table. 
      • Show Toolbar - If toggled on, this will show the toolbar at the top of the table. 
      • Auto Fit - If toggled on, this will enlarge the page font size and users can scroll with the scroll bar to view the table. If toggled off, this will automatically adjust the page size to show all the data on that page. 
      • Auto Scroll 
      • Show Export Option - This option applies onlywhen the PDF is the option selected for Toolbar
        • If enabled, clicking PDF Export will show the followingexport options:
          • Page orientation:
            • Portrait - vertical
            • Landscape - horizontal
          • Page size:
            Select the appropriate size.
            image export settingsImage Added
        • If disabled, clicking PDF Export, will export the PDF file with the following default settings:
            • Page orientation: Portrait
            • Page Size: A4 

    2. Under Columns Setting, edit the following options for each column:
      • Header Text - Assign a column name.
      • Header Tooltip - Add a tooltip for the column.
      • Text Align - Set to the Left, Center, or Right
      • Allow Filtering - Toggle to allow users to filter the column. 
      • Disable HTML - Toggle to disable the use of HTML codes. 
      • Max Width - Set the width for the column. 
      • Aggregates - Select if the column's total will be included at the bottom of the table (Sum, Count, Avg, Min, or Max). 
      • Number Format only Set how many decimal places will be shown for the aggregate. (This is available only if Avg is selected.)
        Image Added
  2. Lastly, add conditional formatting under the Condition tab.
    Image Added
    1. Click the +Add a rule link. 
    2. Enter a name for the new widget rule. 
      Image Added
    3. Set the conditions for the rule.
    4. Select the format to be applied once conditions are satisfied. You can apply color to a cell or row. 
      Image Added 
    5. Click Apply to save and show a preview of the grid widget you created. 
      Image Added


Content by Label
showLabelsfalse
max5
showSpacefalse
titleRelated Topics:
excludeCurrenttrue
cqllabel in ("widgets","widget")