JavaScript is not currently enabled, but is required for full CodeSonar manual search and browse functionality.

If you are viewing this file in your hub's Web GUI, enable JavaScript in your browser: you will also need it for GUI functionality.

If you opened this file directly from disk, your browser may be directly suppressing JavaScript functionality: certain browsers perform this suppression on local files (but not files delivered by web servers) for security reasons.

CodeSonar® 9.2p0 CONFIDENTIAL CodeSecure Inc
General

GUI Reference: Chart

This page displays a chart specified by the user (through the chart wizard, or by clicking a chart shortcut).

Charts are available in a variety of formats and with highly customizable data and scope. For full details, see the Chart Wizard section.

Saved charts are securable resources. Permission requirements for charting are discussed in Charts and Chart Tables: Permissions.

Charting is available for all analyses, regardless of the language or languages involved. However, charts of procedure data will only include data from C/C++, C#, and Java code: procedure information is not available for other languages.

Navigating To

Important Note: the CodeSonar Web GUI makes extensive use of JavaScript. Make sure JavaScript is enabled in your web browser.

A Chart page can be reached in any of the following ways.

From Chart Table: Select View Chart from the View menu to show a chart of the information shown in the table.
From Chart Wizard: Click Create Chart (or Update Chart, if editing an existing chart) to show the chart specified in the wizard.
From Analysis There are several ways to view charts:
From Project There are several ways to view charts:
From Home There are several ways to view charts:

Page Properties

Output formats none
Visibility Filter Applied Visible Warnings or none, depending on the chart domain
RBAC Permissions Needed
Page AccessANALYSIS_READ
PROJECT_READ
Page Contents/FunctionalityANALYSIS_EXISTS
ANALYSIS_READ
ANALYSIS_WARNING_EXISTS
NAMEDSEARCH_EXISTS
NAMEDSEARCH_READ
PROJECT_EXISTS
SAVEDCHART_DELETE
SAVEDCHART_EXISTS
SAVEDCHART_READ

Contents and Usage

The following annotated screenshot shows the various parts of a Chart page.

Annotated Screenshot: Chart Page standard header breadcrumbs page heading Options menu bar the chart chart details standard footer

Standard Header See GUI Reference: Standard Header.
Breadcrumbs The Chart page breadcrumbs depend on the scope of the chart:
  • Home > Chart: Chart_Description if the chart includes data from the entire hub.
  • Home > [Other_ProjectTree_Ancestors >] Project_Name > Chart: Chart_Description if the chart has been restricted to include only data from a single project.
  • Home > [Other_ProjectTree_Ancestors >] Project_Name > Analysis_Name > Chart: Chart_Description if the chart has been restricted to include only data from a single analysis of a project.
Where
  • Chart_Description is a short, automatically generated description of the data displayed in the chart.
  • Home links to the GUI Home page.
  • Together with the Home link (corresponding to the root project tree), Other_ProjectTree_Ancestors represents the project tree ancestors of the analyzed project as a >-separated sequence of project tree names. Each name links to the corresponding Project Tree page.
  • Project_Name links to the corresponding Project page.
  • Analysis_Name links to the corresponding Analysis page.
Page Heading Chart: Chart_Title
where Chart_Title can be controlled through the options tab of the chart wizard.
Options menu bar Contains three menus:
File menu New chart Opens a chart wizard.
Open saved chart Opens the Open a saved chart form, as in the example below.

Annotated Screenshot Fragment: Save this chart form

See Charts and Chart Tables: Permissions for details of the permissions required to preview and open a chart.

To use:

  1. Select a chart name from the list in the form. The form will update to show a preview of the selected chart (where available).
  2. Click a button.
    • Open Chart to open the selected chart in a Chart page.
    • Permissions black key to navigate to the Saved Chart Role-Permissions page for the selected chart.
    • Cancel, or the [X] in the top right corner, to close the form without performing any other action.
Save this chart Opens the Save this chart form, as in the example below.

Annotated Screenshot Fragment: Save this chart form

See Charts and Chart Tables: Permissions for details of the permissions required to save a chart.

To save a chart:

  1. Enter a name for the chart in the text box.
  2. If you want to overwrite an existing chart with the same name, select overwrite.
  3. Click Save Chart. If you are not already signed in, CodeSonar will ask you to Sign In before it saves your chart.
    If you have zoomed in on a region in your chart, CodeSonar will save the entire chart plus information about the zoom region. When you open the chart later, it will open in the zoomed state but you will be able to zoom out if you wish.
To close the form without saving a chart:
  • Click Cancel, or click the [X] in the top right corner.
Delete a saved chart Opens the Delete charts form, as in the example below.

Annotated Screenshot Fragment: Delete Charts form

See Charts and Chart Tables: Permissions for details of the permissions required to delete a saved chart.

To delete one or more charts:

  1. Select the charts to delete from the list in the form. The form will update each time you make a selection to show a preview of the selected chart (where available).
  2. Click Delete Selected Charts. If you are not already signed in, CodeSonar will ask you to Sign In before performing the deletion.
To close the form without deleting any chart:
  • Click Cancel, or click the [X] in the top right corner.

The chart page will display a list of the deleted charts.
Permissions key [Only present when viewing a saved chart.]
Navigate to the Saved Chart Role-Permissions page for this chart.
Edit menu Change chart type

Opens the chart type tab of a chart wizard populated with the specifications for the current chart. Use the wizard to make your desired changes, then click Update Chart.
Change data Opens the data tab of a chart wizard populated with the specifications for the current chart. Use the wizard to make your desired changes, then click Update Chart.
Change groups Opens the groups tab of a chart wizard populated with the specifications for the current chart. Use the wizard to make your desired changes, then click Update Chart.
Change search settings Opens the search tab of a chart wizard populated with the specifications for the current chart. Use the wizard to make your desired changes, then click Update Chart.
Change groups Opens the groups tab of a chart wizard populated with the specifications for the current chart. Use the wizard to make your desired changes, then click Update Chart. (Not available for pie charts.)
Change options Opens the options tab of a chart wizard populated with the specifications for the current chart. Use the wizard to make your desired changes, then click Update Chart. (Not available for pie charts.)
Show chart wizard Opens a chart wizard populated with the specifications for the current chart. Use the wizard to make your desired changes, then click Update Chart.
View menu Zoom in The cursor will change into a cross. Drag over the chart region that you want to zoom to. The chart display will update to show a zoomed view corresponding to the region you selected.

If your dragged region includes any part of a chart bar (segment), the entire bar (segment) will be included in the zoomed view.

zooming in on a bar chart

Zoom out (Only available if the chart is zoomed) Updates the display to show the entire chart.
View table Navigates to a Chart Table page that displays the chart information in tabular form.
Chart The chart itself.
Chart Details A natural language description of the domain and scope of the chart.
Standard Footer See GUI Reference: Standard Footer.

"Chart component" in this context means any of the following:

Navigating from

view the search results corresponding to a particular chart component Click on the component.
view the information in the chart as a chart table Select View Table from the View menu.
view parent analysis information (if any) Click the analysis name in the page breadcrumbs.
view parent project information (if any) Click the project name in the page breadcrumbs.

Related Tasks

 

To report problems with this documentation, please visit https://support.codesecure.com/.