Single Object Chart

A Single Object Chart is used to show values in a summary view as a chart. The Single Object Chart must be configured using the BrandXML, ConfigureXML, Data Processor, and Data Processor Assembly properties.

Properties

The Single Object Chart control has the following properties:

Properties Description
BrandXML

The BrandXML property is used to control the visual display and color scheme of a chart.

ConfigureXML

The ConfigureXML property is used to control the data displayed on the single object chart.

DataProcessor

The DataProcessor property is used to specify the code that generates a chart. Effectively, this determines the type of chart.

DataProcessorAssembly

The DataProcessorAssembly property is used to specify the location of a custom chart data processor.

Height

The Height property is used to specify the height (in pixels) of an attribute, control, or widget.

Left

The Left property is used to set the number of pixels from the left side of a page that an attribute, control, or widget is positioned. Use this property to align the attributes, controls, and widgets on a page.

ID

Read only. The ID property is used to show the unique ID of the design control.

Top

The Top property is used to set the number of pixels from the top of a page that an attribute, control, or widget is positioned. Use this property to align the attributes, controls, and widgets on a page.

Type

Read only. The Type property is used to show the control type. For example, linklabel, button, hr, and so on.

Width

The Width property is used to specify the width (in pixels) of an attribute, control, or widget.

Z-Index

The Z-Index property is used to set the order by which attributes, controls, and widgets are layered on a page. For example, you can layer a form on top of an image.

Adding a single-object chart

A single object chart is an XML-based chart type that can be added to summary views and homepages. Using a single object chart, you can quickly and visually represent several types of data for users.

The following visual shows a single object chart inserted into a summary view. The attributes used to render the chart are also placed on the view. The single object chart provides a quick visual reference for the user of this summary view.

The configurations for the single object chart are made in two XML-based properties in the View Designer tab:
  • BrandXML This property controls the visual display and color scheme of the chart.
  • ConfigureXML This property controls the data displayed on the single object chart.

Example files for both a pie chart and gauge chart type are provided. The files for the pie chart type are PESAlignmentPieSOChartBrand.xml and PESAlignmentPieSOChartConfigure.xml, respectively.

The pie chart type can easily be modified to render several other chart types, such as a bar chart and a radar chart, simply by changing the chart type in the XML.

The files for the gauge chart type are PESSOGaugeChartBrand.xml and PESSOGaugeChartConfigure.xml, respectively.

These files are located in your installation directory, by default at C:\Program Files\Serena\Mariner\Mariner\charts\config. You will need the appropriate files to paste into the Code Editor dialog box and then modify for your purposes.

To add a single object chart
  1. From the application toolbar, click Setup, and then select Customization.
  2. Select the View Designer tab.
  3. Under View Layout, select a work item and a view to which you are adding a single object chart.
  4. Under Controls, select the Single Object Chart control and drag it to the layout pane.
  5. Under Properties, select BrandXML to open the Code Editor dialog box. Add the XML for the chart.
  6. Click Save.
  7. Under Properties, select ConfigureXML to open the Code Editor dialog box. Add the XML for the chart.
  8. Click Save.
  9. Click Save.