筛选

筛选可用于选择特定元素,并支持自动补全。

简单筛选

简单筛选允许搜索名称中包含特定字符串的文件。

通配符

‘?’

表示任意单个字符

‘*’

表示任意数量的任意字符

示例

数据:

Testcase123.pkg
Testcase236.pkg
Testcase366.pkg
Testcase499.pkg

按文件名筛选:

Test            --> [Testcase123.pkg, Testcase236.pkg, Testcase366.pkg, Testcase499.pkg]
23              --> [Testcase123.pkg, Testcase236.pkg]
Testcase*6      --> [Testcase236.pkg, Testcase366.pkg]
Testcase1?3     --> [Testcase123.pkg]

扩展筛选

扩展筛选允许基于文件属性和特征搜索文件。多个筛选条件可以通过运算符组合使用。

关键字

关键字可用于指定文件的特定属性,并允许在筛选查询中使用该属性。

关键字

类型

说明

PATH

字符串

Workspace(工作区)中文件的路径

NAME

字符串

Workspace(工作区)中文件的名称

TEST_MANAGEMENT_ID

字符串

Package 或 Project 的测试管理 ID

VERSION

字符串

Package 的版本

DESCRIPTION

字符串

描述

TODO

字符串

Package 的 TODO

VARIABLE_NAME

字符串

变量名称

PARAMETER_NAME

字符串

参数名称

RETURN_PARAMETER_NAME

字符串

返回参数名称

KEYWORD_ID

字符串

Package 内关键字的 ID

FILE_REFERENCE

列表(字符串)

Package 内的文件引用

IS_TEST_CASE

布尔值

指示该 Package 是否表示一个 test case(测试用例)

Compatibility

String

该产物兼容的最低 ecu.test 版本

除预定义关键字外,还可以使用文件的属性(例如 Project 和 Package)来定义筛选查询。

说明

如果关键字中包含空格,必须使用单引号或双引号将其括起。

通配符

‘?’

表示任意单个字符

‘*’

表示任意数量的任意字符

运算符

‘=’

检查是否相等

‘!=’

检查是否不相等

数值属性运算符

‘<’、‘<=’、‘>=’ 和 ‘>’ 可用于比较数值。

列表运算符

‘has’

检查值列表是否包含某个元素

‘hasnot’

检查值列表是否不包含某个元素

复杂表达式运算符

‘and’

AND 运算符:两个表达式都必须满足

‘or’

OR 运算符:至少有一个表达式必须满足

示例

数据:

Testcase123.pkg:
  "Tester": "John Doe"
  "Status": "Draft"
  "Testlevel": ["System", "SubSystem"]
  "Estimated Duration [min]": 2

Testcase236.pkg:
  "Tester": "Peter Smith"
  "Status": "In Review"
  "Testlevel": ["SubSystem"]
  "Estimated Duration [min]": 5

Testcase366.pkg:
  "Tester": "Peter Jones"
  "Status": "Ready"
  "Testlevel": ["Component"]
  "Estimated Duration [min]": 8

Testcase499.pkg:
  "Tester": "Peter Jonas"
  "Status": "In Review"
  "Testlevel": ["System"]
  "Estimated Duration [min]": 8

按文件名筛选(等同于简单筛选):

NAME = "*Testcase*"     --> [Testcase123.pkg, Testcase236.pkg, Testcase366.pkg, Testcase499.pkg]
NAME = "*23*"           --> [Testcase123.pkg, Testcase236.pkg]
NAME = "*Testcase*6*"   --> [Testcase236.pkg, Testcase366.pkg]
NAME = "*Testcase1?3*"  --> [Testcase123.pkg]

按文本属性筛选:

"Tester" = "John Doe"     --> [Testcase123.pkg]
"Tester" = "Peter Jon?s"  --> [Testcase366.pkg, Testcase499.pkg]
"Tester" = "Peter*"       --> [Testcase236.pkg, Testcase366.pkg, Testcase499.pkg]

"Status" != "Ready"       --> [Testcase123.pkg, Testcase236.pkg, Testcase499.pkg]

按数值属性筛选:

"Estimated Duration [min]" = 8   --> [Testcase366.pkg, Testcase499.pkg]
"Estimated Duration [min]" < 5   --> [Testcase123.pkg]
"Estimated Duration [min]" <= 5  --> [Testcase123.pkg, Testcase236.pkg]
"Estimated Duration [min]" > 8   --> []
"Estimated Duration [min]" != 8  --> [Testcase123.pkg, Testcase236.pkg]

按列表元素筛选:

"Testlevel" has "System"                         --> [Testcase123.pkg, Testcase499.pkg]
"Testlevel" has "*System"                        --> [Testcase123.pkg, Testcase236.pkg, Testcase499.pkg]
"Testlevel" hasnot "System"                      --> [Testcase236.pkg, Testcase366.pkg]

按布尔属性筛选:

IS_TEST_CASE = True                                --> [Testcase123.pkg, Testcase499.pkg]
IS_TEST_CASE = False                               --> [Testcase236.pkg, Testcase366.pkg]

筛选表达式组合:

"Tester" = "Peter*" and "Testlevel" has "System"                                  --> [Testcase499.pkg]
"Tester" = "John Doe" or "Status" = "In Review"                                   --> [Testcase123.pkg, Testcase499.pkg]
"Tester" = "John Doe" or "Status" = "In Review" and "Testlevel" has "System"      --> [Testcase123.pkg, Testcase499.pkg]
"Tester" = "John Doe" or ("Status" = "In Review" and "Testlevel" has "System")    --> [Testcase123.pkg, Testcase499.pkg]
("Tester" = "John Doe" or "Status" = "In Review") and "Testlevel" has "System"    --> [Testcase499.pkg]

说明

AND 运算符始终优先于 OR 运算符求值。可以通过括号改变这一优先级。

形式定义

筛选语言定义如下:

../_images/filterLanguage.png