Custom Operational Measurements
The dsClient Desktop Custom Operation Measurements feature provides the ability to define measurements that can manipulate the values of core dsTest OMs, using mathematical operations, and include the custom OMs in standard charts or tabular reports . The custom measurement definitions are saved with the report, and custom measurements may be imported from one report into another regardless of report type (chart to tabular and vise versa). The custom OM feature is not available with SmartReports.
Custom OMs are defined with the Manage.... dialog within the Report Definition window. Open the Manage dialog and chose 'Custom Measurement' to define custom measurements for charts/reports.
Note: only measurements that produce the same type of native values (cumulative values or interval values ) can be used in the measurement's configuration and the custom measurement will take on the same designation as its component OMs. When the first OM is selected in the tree, or if measurements already exist in the component list, the check boxes associated with incompatible OMs will be disabled.
The steps below show how to define a simple custom measurement from the core OMs available in an existing, running test.
Step 1. Define a new custom measurements on an exiting report, naming it uniquely from other custom measurements
Step 2. Specify/choose the Component OMs that will be used in the definition/calculation of the desired custom measurement.
Step 3. Define the operations on the specified component OMs that define the custom measurement. The formula pane shows the calculations that have been defined. The validation pane will display any validation errors that exist in the displayed configuration with the errors shown in red. The name of any measurement whose configuration is not valid is also shown in red in the custom measurement list. The Update Configuration button will remain disabled until all errors are resolved.
Step 4. Add the newly defined custom OM to a new or existing OM Chart or Report. With the icon, open the Add/Remove Measurements dialog. Choose (click on the box) the Custom Measurement just defined and validated, then click on 'Update Configuration'.
The newly defined custom measurement will be added to the specified chart:
Compound calculations provide the ability to define an intermediate value as the value source for one or both sides of a simple calculation. This option creates embedded custom measurements that will not be displayed in the measurement tree. In the formula pane intermediate calculations are enclosed in parentheses.
Importing Custom Measurements
Clicking the Import... button in the custom OM list tool bar triggers a library scan that will collect custom measurements from all standalone or workspace reports in the library (including locked libraries and examples but omitting the current report) and display them in a new dialog, arranged by file. Select the check boxes of the desired OMs and then click 'Import Selected Measurements'. If any of the imported measurements have the same name as measurements already defined in this report, " 2" is appended to the name.
If a measurement that uses other custom measurements is selected, the subordinate measurements are also selected automatically and cannot be cleared until the parent measurement has also been cleared.
If standard measurements used as value sources by imported measurements cannot be found in the this report's measurement tree, the import will succeed but the configuration will become invalid (unless it's a set operation and some measurements were found). When this is the case, the same dialog used to list issues with importing or opening a workspace will display the measurement path of the OMs that could not be found. In order to resolve the problem the appropriate measurements will need to be added to the component list and then selected from the applicable drop-down list, unless it's a set operation.