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.
- 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.
- From the application toolbar, click Setup, and then select Customization.
- Select the View Designer tab.
- Under View Layout, select a work item and a view to which you are adding a single object chart.
- Under Controls, select the Single Object Chart control and drag it to the layout pane.
- Under Properties, select BrandXML to open the Code Editor dialog box. Add the XML for the chart.
- Click Save.
- Under Properties, select ConfigureXML to open the Code Editor dialog box. Add the XML for the chart.
- Click Save.
- Click Save.