Adding a Chart

As you define the chart in the wizard, the Chart Preview (located in the upper right corner of the page) updates to illustrate how it will appear.

1. In TIBCO BusinessEvents Studio Explorer, select the data source you want to use for the chart. (Or you can select it in the wizard.) Click the New Chart Component toolbar button, in the Component drop-down list. (Or just click the Component drop-down list button. By default it opens the New Chart wizard.)
2. At the New Chart wizard, name the chart, and optionally, provide a description. You can also add and edit descriptions in the Chart editor. Click Next.
   Tip: The Description field value is shown to Dashboard users in the About This Chart option in the chart title bar. Use this field to provide a useful description, keeping the needs of Dashboard users in mind.
3. At the Select a Chart Type page, select the chart type and subtype you want to use and click Next.

   See Types of Charts for descriptions of all chart types. The Chart Preview area gives you an idea of what the chart will look like at runtime. As you continue to configure the chart on each wizard page, the preview reflects your choices.

4. At the Select Layout Options page, specify options relating to the overall layout of the chart (for more details, see Type Options):
   • Specify a chart title and labels as needed for the chart type. For example, many chart types use labels for their category and value axes, and table charts use a label for the columns.
   • Click in the chart size boxes to specify the chart size, that is, how much space on the Dashboard page the chart occupies.

     Click Next.

5. At the Enter Chart Preview Options page specify the chart preview options.
   • Click Add and name the category field or fields, as needed for the chart. These create fake category field values such as zip codes.
   • In the Value Field Range section you can limit the range of values that is used to populate the chart preview.

     Generated values populate the chart within this range, so you can see how the chart would look with real data.

   • You can rearrange the order of the category fields using the up and down buttons. They display top down or left to right, depending on the chart type.

     Click Next.

6. At the Configure Data Options page of the wizard, specify the appropriate data options for the chart type.

   Some fields are pre-populated based on the selected data source.

   You can add and configure as many series as are needed to define the chart. Each series has one value field. For each series you add, do the following:

   1. Enter a series name and (depending on the chart type) a series type. (See Categories, Values, and Data Points.)
   2. In the Measure field select a metric and in the Data Source field, select a data source that is valid for that metric. The data source query displays. It is not editable. These fields display defaults based on the data source you selected earlier.
   3. If the data source uses parameters, you can provide default values for each one. Specifying defaults enables the chart to display before Dashboard users enter parameter values.
   4. Select one field to use as the value field, and one field to use as the category field for each series.

      Guidelines for most charts: Use the same category for all series. Choose a metric aggregation field as the Value Field, and a group by field as the Category Field. See Categories, Values, and Data Points for more information and exceptions, such as multi-category charts.

7. As needed add more series and configure them as shown in step 6.
8. Use the Up and Down buttons to order the series so they appear in the chart in the desired top-down or left-right order.
9. Click Finish. The chart is saved, and opens in the editor.
10. Close the Chart editor, or continue to configure the chart as needed.