Before you begin: Widgets are the graphs, tables, text boxes, and images shown in dashboards and reports. To display data, you need to create and configure widgets. During the widget creation process, you will assign a data source to each widget. There are three types of widgets: Data, Media, and Admin. This article describes how to create and configure the different widgets. These instructions assume that you have already created a dashboard. If you need to create a dashboard, see How to Create a Dashboard.
Locate the Dashboard
1] Log in to TapClicks and, on the Reports menu, click Dashboards.
2] There are three ways to locate the dashboard:
- Search for it by entering the name into the search box in the upper left (results appear automatically).
- Or click Add Filters and enter a filter parameter into the Filter textbox (results appear automatically).
- Or use the page controls in the upper right to navigate through your collection.
3] When you locate the dashboard you want to add widgets to, click it.
How to Create a Data Widget
A data widget is specifically designed to display a data source in TapClicks. There are ten graph formats you can choose from including pie charts, line charts, and more. When you create a data widget from scratch, you specify the metrics to be displayed and can also tailor its look and feel.
4] In the upper-right corner of the dashboard, click the "+" icon.
5] From the dropdown menu, select Data Widget.
6] The New Widget menu appears on the right side of the page with the Data tab selected.
7] Click a widget type from the top of the New Widget menu. The widget type is the chart type used to display your data. You have the following choices:
- Big Number
- Data Grid
- Bar Chart
- Line Chart
- Combo Chart
- Pie Chart
- Funnel Chart
- Gauge Chart
- Bubble Chart
- Geo Chart (This option only appears when the appropriate data is selected. For more details, see How to Create a Geo Widget below.)
8] Enable the Use Sample Data option to preview your widget.
9] To use On Demand data, disable the Use Data Warehouse option.
10] Enter a title for the widget in the Title textbox.
11] Click the Data Category textbox and then choose a data source or channel from the dropdown menu for your widget. If you are using channels or smart connectors, scroll down the list until you find them. This list is often organized with Instant-on connectors at the top and then other data sources below. TapOrders and TapWorkflow views are found in the "Other Sources" section at the very bottom.
12] Click in the Data View textbox and from the dropdown, choose the data view for your widget. The data view is different for each data category and is based on how information in that application is structured.
13] Click inside the Metrics textbox, and a list of metrics appears.
14] Select the metric(s) to display in your widget. The chosen metric(s) appear in the Metrics box. Should you need to remove a metric, click the "x" inside the metric icon.
NOTE: At least one metric is required, so you will not see the deletion "x" when only one metric is present. To delete a lone metric, add another metric and then delete the one you want. |
Configure Metrics
15] Once you select the metric(s), configure them. Click the settings icon to the right in the Metrics box.
16] The metrics configuration utility appears.
17] To change the order of the metrics, hover over a metric until the cursor changes to a crosshair. Click, hold, and drag it to its new position, then release it.
18] Click the sort icon on the right of any metric to sort by that metric. To do multiple sorts, hold down the SHIFT key while clicking multiple sort icons.
19] To customize a metric color, click the color circle next to it.
20] From the color palette that appears, pick a color or click the pencil icon to input a specific color hex code.
21] To return to the New Widget column, click the back arrow at the top.
22] Choose dimensions by clicking inside the Dimensions (Group By) textbox and selecting from the list. Dimensions are how the data are grouped in the widget. Click the "x" to remove a dimension.
23] From the Time Grouping dropdown, select a time unit (e.g., hour, day, week).
24] Enable the Drilldown Chart? slider to make grouped dimensions clickable within the widget.
Style the Widget
25] To style your widget, click Styles from across the top of the column.
26] The Styles menu appears.
27] Choose the Look & Feel options and the widget options to style the widget your way. You'll see the changes reflected in the widget immediately.
28] When you have finished creating your widget, click Save at the bottom of the column.
How to Create a Geo Widget
1] Follow the same steps as above to create a Data Widget. Geo Widgets are a specialized visualization type and only appear when geographic data is selected.
2] Choose a Data Category and View that supports Geo Data. Data Views that support Geo will have a special location pin icon to the right when selecting them. You can view a list of connectors that support geographic data here.
3] The widget column will update. At the top of the column, click the Geo Chart option.
4] You can now Configure Metrics and Style your new widget the same as above.
5] When you have finished, click Save at the bottom of the column.
How to Create a Data Widget Using a Template
Data widgets can be created based on a template. Widget templates are pre-defined, but you can still change the look and feel of a widget based on a Template.
1] From the New Widget column, click Templates across the top menu.
2] A list of available templates appears.
3] To locate a specific template by title, either scroll through the list or type the title into the search box at the top and hit Enter.
4] To filter the template list, click the filter box, and a list of available filters appears.
5] Scroll through the filter list and when you locate the desired filter parameter, click it to filter the list by that parameter.
6] When you locate the template you want to use, click it. The chosen template becomes a widget and automatically appears center page.
7] You can change the look and feel of the widget by using styles as detailed in the steps above.
How to Create a Media Widget
A media widget is used to display something that isn't data or text, such as videos or images. You will be presented with a WYSIWYG editor where you can add text, images, and other common configurations.
1] On the dashboard screen click the "+" icon.
2] On the widget type menu click Media Widget.
3] The Media Widget modal appears.
4] To edit the media widget header, click inside the Header textbox.
5] When the Edit Widget Header workspace appears, enter and style your header text and then click Done.
6] To link the media widget to a data source, slide the Link media widget to a data source? slider to the right.
7] Click inside the Select a data source textbox and from the dropdown menu, choose a data source for the media widget.
8] To link the media widget as a header, slide the Use this widget as a header slider to the right.
Insert Image
9] To insert an image, click the picture icon in the Media Widget menu.
10] The Insert Image modal appears.
11] Enter the image URL in the Image URL textbox or click Choose Files and upload the image.
12] Click Insert Image.
13] Click Save.
Insert Video
14] To insert a video, click the video icon in the Media Widget menu.
15] The Insert Video modal appears.
16] Enter the video URL in the Video URL textbox.
17] Click Insert Video.
18] Click Save.
How to Create an Admin Widget
Admin Widgets display administrative data on the TapClicks dashboard, including names, addresses, emails, roles, time zones, and login timestamps.
1] On the Dashboard screen, click the "+" icon.
2] On the widget type menu click Admin Widget.
3] The untitled admin widget appears in the center and the New Widget column appears on the right.
4] Enter a title for the widget in the Title textbox on the right column.
5] Click inside the Metrics textbox, and a list of metrics appears.
6] Choose one or more metrics for the widget to display by clicking them. Click the "x" to remove them. The Date metric is required.
Configure Metrics
7] When you're finished choosing the metrics, click on the settings icon to the right to configure them.
8] The metrics appear in a list that can be reordered.
9] To reorder the metrics list, hover your mouse over the metric you want to move and the cursor turns into a cross. Click, hold and drag it to the desired location in the list and then release.
10] Click Save at the bottom of the column.