Managing charts

Predefined charts can be viewed and cloned. Custom charts can be created, edited, cloned, and deleted.

To create a new chart:

1. In the chart library:
   • If you are creating a chart in a FortiGate or FortiCarrier ADOM: right-click in the content pane and select Create New.
   • If you are creating a chart in any other ADOM: select Create New in the toolbar.

The New Chart dialog box opens.

Figure 138:Create new chart

Select the Tutorial icon, , to view the online chart creation video.

2. Enter the required information for the new chart.

Name	Enter a name for the chart.
Description	Enter a description of the chart.
Dataset	Select a dataset from the drop-down list. See “Dataset” on page 199 for more information. The options will vary based on device type.
Graph Type	Select a graph type from the drop-down list; one of: table, bar, pie, or line. This selection will affect the rest of the available selections.
Line Subtype	Select one of the following options: basic, stacked, or back-to-back. This option is only available when creating a line graph.
Resolve Hostname	Select to resolve the hostname. Select one of the following: Inherit, Enabled, or Disabled.
Data Bindings	The data bindings vary depending on the chart type selected.

bar, pie, or line graphs

X-Axis	Data Binding: Select a value from the drop-down list. The available options will vary depending on the selected dataset. Only Show First: Enter a numerical value. Only the first ‘X’ items will be displayed. Other items are bundled into the Others category. Overwrite label: Enter a label for the axis.
Y-Axis	Data Binding: Select a value from the drop-down list. The available options will vary depending on the selected dataset. Overwrite label: Enter a label for the axis. Group by: Select a value from the drop-down list. The available options will vary depending on the selected dataset. This option is only available when creating a bar graph.
Order By	Select to order by the X-Axis or Y-Axis. This option is only available when creating a line or bar graph.
table
Only Show First Items	Enter a numerical value. Only the first ‘X’ items will be displayed. Other items are bundled into the Others category. This option is available for all columns when Data Type is set to raw. When Data Type is set to ranked, this option is available in Column 1.
Data Type	Select either ranked or raw.
Add Column	Select add column icon, ,to add a column.
Columns	Up to fifteen columns can be added. The following column settings must be set: •      Header: Enter header information. •      Data Binding: Select a value from the drop-down list. The options vary depending on the selected dataset. •      Display: Select a value from the drop-down list. •      Merge Columns: Select a value from the drop-down list. This option is only available when Data Type is raw. If applicable, enter a Merge Header. •      Order by this column: Select to order the table by this column. This option is only available in Column 1 when Data Type is ranked.

3. Select OK to create the new chart.

To clone a chart:

1. In the chart library, select the chart that you would like to clone and select Clone, , from either the toolbar or right-click menu.

The Clone Chart dialog box opens.

2. Edit the information as needed, then select OK to clone the chart.

To edit a chart:

1. In the chart library, double-click on the custom chart you need to edit, or select the chart then select Edit, , from either the toolbar or right-click menu.

The Edit Chart dialog box opens.

2. Edit the information as required, then select OK to finish editing the chart.

Macro library

The FortiAnalyzer unit provides a selection of predefined macros. You can create new macros and clone existing macros. You can select to display predefined macros, custom macros, or both.

To view a listing of the available predefined macros, see “Charts, Datasets, & Macros” on page 219.

Macros are predefined to use specific datasets and queries. They are organized into categories, and can be added to, removed from, and organized in reports.

To view the macro library, go to Reports > Macro Library.

Figure 139:Macro library

The following information is available:

Name	The name of the macro.
Description	The macro description.
Category	The macro category.
Pagination	Adjust the number of entries that are listed per page and browse through the pages.

The following options are available in the toolbar:

Create New	Create a new macro. This option is only available from the right-click menu. See “To create a new macro:” on page 195.
Edit	Select to edit a macro. This option is only available for custom macros. See “To view a predefined macro:” on page 196.
View	Select to view macro details. This option is only available for predefined macros, as they cannot be edited.
Delete	Select to delete a macro. This option is only available for custom macros. See “To delete macros:” on page 197.
Clone	Select to clone an existing macro. See “To clone a macro:” on page 196.
Show Predefined	Select to display predefined macros.
Show Custom	Select to display custom macros.
Search	Enter a search term in the search field to find a specific macros.

Managing macros

Predefined macros can be viewed and cloned. Custom macros can be created, edited, cloned, and deleted. You can insert macros into text elements in the report layout.

To create a new macro:

1. In the macro library, select Create New in the toolbar or right-click in the content pane and select Create New.

The New Macro dialog box opens.

Figure 140:Create new macro

2. Enter the required information for the new macro.

Name	Enter a name for the macro.
Description	Enter a description of the macro.
Dataset	Select a dataset from the drop-down list. See “Dataset” on page 199 for more information. The options will vary based on device type.
Query	Displays the query statement for the dataset selected.
Data Binding	The data bindings vary depending on the dataset selected. Select a data binding from the drop-down list.
Display	Select a value from the drop-down list.

3. Select OK to create the new macro.

To clone a macro:

1. In the macro library, select the macro that you would like to clone and select Clone, , from either the toolbar or right-click menu.

The Clone Macro dialog box opens.

2. Edit the information as needed, then select OK to clone the macro.

To view a predefined macro:

1. In the macro library, double-click on the predefined macro you would like to view, or select the macro then select View, , from either the toolbar or right-click menu.

The View Macro dialog box opens. All fields are read-only.

2. Select Close when you are finished.

To edit a macro:

1. In the macro library, double-click on the custom macro you need to edit, or select the macro then select Edit, , from either the toolbar or right-click menu.

The Edit Macro dialog box opens.

Figure 141:Edit macro

2. Edit the information as required, then select OK to finish editing the macro.
3. In a report, select the Layout
4. Drag and drop the text element, , into a section.
5. Select the edit icon, , in the section toolbar.

The Edit Text dialog box is displayed.

Figure 142:Edit text dialog box

4. Enter the name of the macro in the XML open <faz-macro> and close </faz-macro>
5. For example, <faz-macro>Highest Session Count (Website)</faz-macro>.
6. Select OK to save the text element.
7. Select Save to save the report template change.