This documentation is archived and is not being maintained.

Report Controls

Updated: April 15, 2013

Applies To: System Center Operations Manager 2007

Report controls are displayed in the Operations console when you open a report. They allow you to set the values of parameters for the report before running it. When you want to create a linked report and you are not going to provide specific values for certain parameters, you typically use the same control as the base report for the same parameter. You can also provide configuration for certain controls to modify their behavior.


Controls are displayed in the header of the report when it is opened in the Operations console. The width of the header expands to fit the width of the report window. The parameter block of the report has a columns attribute that defines how many columns the header should be separated into. Each control has a columnSpan attribute that defines the width of the control. If the columnSpan attribute is not provided, it is set to the default value of 1.

The controls are populated into the header from left to right in the order that they are listed in the parameter block. When the column width of the header has been reached, the controls continue to populate from the left side of the header beneath the control in the same horizontal position.

The height of the control is defined by the rowSpan attribute. If the rowSpan attribute is not provided, it is set to the default value of 1. If a control has a rowSpan that is greater than the rowSpan of other controls, the controls stack on top of each other before they are placed in the next column.

For example, the following table lists the controls with their columnSpan and rowSpan attributes for the Alert report. The Relative Date Time Picker and the Monitoring Object XML Picker controls are side-by-side and take up the entire height of the header. Two Checked List Box controls are on the right side of the header and sit on top of each other.

The columns attribute of the parameter block is set to 6. Because the columnSpan attribute for Relative Date Time Picker and Monitoring Object XML Picker are set to 2 and 3 respectively, these controls take up the first five column positions of the header. The Checked List Box controls have a columnSpan of 1 meaning that they should each take up an additional column position. Because the rowSpan for both is 1, and the rowSpan for the first two controls is 2, the controls are able to stack on top of each other and take up just a single column position. If the rowSpan for these controls were the same as the first two controls, the second Checked List Box would wrap to the next position in the first column.


Control columnSpan rowSpan














Each control has one or more report parameters that it collects data for. This parameter is specified in the binding attribute for the control. If a control uses a prompt, it does not require a binding attribute because the prompt maps to a specific parameter.


Prompts can be used to populate a control with possible values. For example, Event reports use a parameter for the event source. The prompt Microsoft.SystemCenter.DataWarehouse.Report.ParameterPrompt.EventSource retrieves a list of all sources in the data warehouse for populating a check box or combo box. Appropriate prompts for different controls and parameters are included in the definition of the generic report. You can copy it to the linked report as part of the parameter block.

Prompts that can be used for different parameters are defined with the parameter in Report Parameters.


Properties can be used to control the configuration of certain controls. For example, the Numeric Up Down control allows for two parameters called Minimum and Maximum that define the range of allowed values.

Properties that can be used with different controls are defined with the controls in the following sections. They can be used with multiple types of reports.

In This Section

Common Report Controls
Describes and provides examples for controls used in multiple kinds of reports for populating different parameters. These include Object XML Picker, Report Column Picker, Boolean Picker, Combo Box, Checked List Box, and Numeric Up Down controls.

Date Report Controls
Describes and provides examples for controls used in multiple kinds of reports for populating date parameters. These include the Relative Date Time Picker and Business Relative Date Time Picker controls.

Performance Parameters
Describes and provides examples for controls used in performance reports. These include the Performance Chart Object Picker and Linked Performance Chart Object Picker controls.

See Also