Project

General

Profile

Coverage format » History » Version 11

Alexey Khoroshilov, 09/15/2014 04:02 PM

1 2 Viktoria Kopach
h1. Формат файла с информацией о покрытии
2 1 Viktoria Kopach
3
Описывается на XML.
4
5 2 Viktoria Kopach
<pre>
6
<?xml version="1.0" encoding="UTF-8"?>
7
<coverageInfo> 
8
  <reqcoverage qid="уникальный_идентификатор_требования_или_тестовой_ситуации">
9 6 Viktoria Kopach
    <covered_by uri="путь_к_покрывающему_элементу" hits="1"/>
10 2 Viktoria Kopach
  </reqcoverage>
11 9 Denis Kildishev
  <reqcoverage qid="уникальный_идентификатор_требования_или_тестовой_ситуации">
12
    <covered_by uri="путь_к_покрывающему_элементу"/>
13
  </reqcoverage>
14 11 Alexey Khoroshilov
  <error [name="имя_ошибки"] testuri="путь_к_покрывающему_элементу_из_reqcoverage" [uri="ссылка_на_описание_ошибки"]>
15 10 Denis Kildishev
      [<violates qid="уникальный_идентификатор_требования_или_тестовой_ситуации"/>]*
16 11 Alexey Khoroshilov
      [<description [format="вид_описания_ошибки"]>описание_ошибки</description>]
17 9 Denis Kildishev
  </error>
18 2 Viktoria Kopach
</coverageInfo>
19
</pre>
20 1 Viktoria Kopach
21
Здесь:
22 8 Denis Kildishev
23 9 Denis Kildishev
Квадратными скобками обозначены опциональные параметры.
24 5 Viktoria Kopach
Элемент *coverageInfo* только один и может содержать несколько элементов reqcoverage.
25 1 Viktoria Kopach
Для каждого покрытого узла должен быть свой элемент reqcoverage. Непокрытые узлы не описываются вовсе.
26 9 Denis Kildishev
Элемент *reqcoverage* может содержать несколько элементов covered_by, если его покрывают несколько тестовых процедур или тестов.
27 1 Viktoria Kopach
Атрибут hits является опциональным, он указывает количество упоминаний этого требования в тесте.
28 9 Denis Kildishev
Элемент *error* представляет собой ошибки полученные в результате выполнения тестов. Может содержать один элемент description с описанием ошибки. Может включать один или несколько элементов violates в ситуации когда можно определить какие именно требования нарушает ошибка.
29 3 Viktoria Kopach
30 5 Viktoria Kopach
*_уникальный_идентификатор_требования_или_тестовой_ситуации_* это user-visible-name(element) или qualifying-id(element) покрываемого элемента
31 1 Viktoria Kopach
32 5 Viktoria Kopach
* user-visible-name(element) - это имя элемента, если оно есть (то есть если поле name в Properties view у этого элемента не пустое),
33
иначе это user-visible-name(element.parent)/id, то есть сначала user-visible-name родительского элемента, потом id - идентификатор элемента (в качестве разделителя использовать ''/'').
34
Например: 
35 3 Viktoria Kopach
"TR-FMF-01-01-002/TR-FMF-01-01-002_T01"
36 1 Viktoria Kopach
37 5 Viktoria Kopach
* qualifying-id(element) - это полный путь к элементу, начиная с корневого элемента (Requirements), в качестве разделителя используется ''/''.
38
Например:
39
"Requirements/01/MyRequirement01"
40
41 1 Viktoria Kopach
*_путь_к_покрывающему_элементу_*
42
* если описывается покрытие тестовых ситуаций тестовыми процедурами, то это путь к шагу тестовой процедуры.
43 6 Viktoria Kopach
** Если тестовая процедура находится в том же проекте, то путь записывается без протокола, например:
44 1 Viktoria Kopach
"/TestProcedures/01/TestStep04"
45
Здесь 01 - идентификатор тестовой процедуры, 04 - номер шага тестовой процедуры.
46 6 Viktoria Kopach
** Если тестовая процедура находится в другом проекте Requality, то путь записывается следующим образом:
47
"requality://ProjectName/TestProcedures/01/TestStep04"
48
Здесь ProjectName - имя проекта, где находится тестовая процедура.
49 1 Viktoria Kopach
50 6 Viktoria Kopach
* если описывается покрытие тестовых ситуаций тестами, то это путь к тесту, например:
51 2 Viktoria Kopach
"file:///home/user/work/test1.c#12"
52 1 Viktoria Kopach
53
*имя_ошибки* - опциональный параметр, представляет собой отображаемое имя ошибки. В случае если не определен, используется имя "error"+порядковый_номер_ошибки. 
54
55 9 Denis Kildishev
*путь_к_покрывающему_элементу_из_reqcoverage* - путь к одному из тестов, описанных по принципу *_путь_к_покрывающему_элементу_*
56 10 Denis Kildishev
57 11 Alexey Khoroshilov
*ссылка_на_описание_ошибки* - опциональный параметр, путь к файлу с подробной информацией об ошибке
58 9 Denis Kildishev
59
*уникальный_идентификатор_требования_или_тестовой_ситуации* - путь к требованию или тестовой ситуации, соответствующий *qualifying-id(element)*
60
61
*format="вид_описания_ошибки"* - формат описания ошибки, есть два возможных представления, соответвующих "вид_описания_ошибки" - представление в формате html или plain соответствующий тексту без форматирования. Для последнего варианта все html теги будут отображаться в виде текста.
62
63
*описание_ошибки* представляет собой описание ошибки, при этом для формата html допускается использование html тегов для форматирования текста.
64
65 2 Viktoria Kopach
Пример описания покрытия тестовыми процедурами:
66
67
<pre>
68
<?xml version="1.0" encoding="UTF-8"?>
69 1 Viktoria Kopach
  <coverageInfo>
70 2 Viktoria Kopach
    <reqcoverage qid="TR-FMF-01-01-001/TR-FMF-01-01-001_T02">
71 9 Denis Kildishev
      <covered_by uri="/TestProcedures/01/TestStep05" hits="1"/>
72 2 Viktoria Kopach
    </reqcoverage>
73 1 Viktoria Kopach
    <reqcoverage qid="TR-FMF-01-01-001/TR-FMF-01-01-001_T01">
74 9 Denis Kildishev
      <covered_by uri="/TestProcedures/01/TestStep03" hits="1"/>
75 1 Viktoria Kopach
    </reqcoverage>
76 2 Viktoria Kopach
    <reqcoverage qid="TR-FMF-01-01-001">
77 9 Denis Kildishev
      <covered_by uri="/TestProcedures/01/TestStep01" hits="1"/>
78 2 Viktoria Kopach
    </reqcoverage>
79
    <reqcoverage qid="TR-FMF-01-01-002/TR-FMF-01-01-002_T01">
80 9 Denis Kildishev
      <covered_by uri="/TestProcedures/01/TestStep02" hits="1"/>
81 2 Viktoria Kopach
    </reqcoverage>
82
    <reqcoverage qid="TR-FMF-01-01-006">
83 9 Denis Kildishev
      <covered_by uri="/TestProcedures/01/TestStep04" hits="1"/>
84 2 Viktoria Kopach
    </reqcoverage>
85 1 Viktoria Kopach
  </coverageInfo>
86
</pre>