Naming Measurements and Results

Procedure

Measurements, and results can optionally be named. Naming these objects helps document your code coverage statistics. If you are working with a measurement series object or measurement object, you can also use names to retrieve sets of measurements or results from the repository.

Here are some guidelines for naming conventions:

You are not required to give names to measurements and results. You can skip them if:
- You are working with standalone measurements that you are not going to save to the repository
- You are working with a measurement series that has only one measurement and only one result per measurement. Here, the relationship between the objects is clear. In this case, the name of the measurement series by itself may be enough to document the series measurements and results.
Names are not the technical keys of measurements and results. That means that you can give the same name to all of a set of related measurements or results.
If you calculate more than one result for each measurement you make, then give each set of results a name. You can then use the result name to retrieve each set of results separately.
Example: You might want to calculate separate results for each of a set of disparate packages. .

Naming Convention for Multiple Results per Measurement in a Measurement Series

For the example shown in the graphic, the code to retrieve the second set of results might look like this:
Syntax
1. ```
DATA: results TYPE if_scv_result=>tab, 
      result TYPE REF TO if_scv_result. 

results = repository->find_results_by_series( i_series = series i_result_name = 'r2' ).

LOOP AT results INTO result.
  " Analyze the trend of R2 results over time. You could pass the 
  " coverage data to an SAP-internal or external graphing or 
  " spreadsheet program. 
ENDLOOP.
```
End of the code.
The same technique is possible with sets of results generated from a standalone measurement. If you have reloaded the measurement object, then you can find the results of the measurement by name.
Syntax
1. ```
DATA: repository TYPE REF TO if_scv_repository,
      measurement TYPE REF TO if_scv_measurement.

results = repository->find_results_by_measurement(
      i_measurement = measurement
      i_result_name = 'r2' ).
```
End of the code.