Global Constants(全局常量)标签页¶
此标签页用于定义常量,这些常量的值在整个测试执行期间始终可用,且不会发生变化。
在标签页的上半部分可以直接创建全局常量。
可通过按钮
添加新常量。
Python 标识符的常规规则同样适用(不允许特殊字符,不允许空格)。
在 Package 中,可通过 api.GlobalConstants.Name 在表达式内访问这些值(例如比较、计算、求值等)。
测试配置和测试台架配置都可以使用全局常量进行参数化。 尤其是,这样可以通过 REST API 为各个字段填充值。 如果要在测试配置或测试台架配置中访问 Global Constant,可使用表达式 ${Const.Name}。
有关在测试台架配置中使用全局常量的详细信息,请参见 Referencing settings specified in the test configuration(引用测试配置中指定的设置)。
如果在启动测试配置时无法解析 ${Const.Name} 形式的表达式(例如常量未定义),则会产生错误消息。
如果重命名全局常量,可以指定 ecu.test 是否也应重命名当前 Workspace(工作区)中所有 Package、配置或全局常量定义文件里的对应常量。 为此,必须勾选重命名对话框中相应的复选框。
说明文本可以有多行。编辑文本时,可通过 <Ctrl>-<Return> 插入换行。
单击按钮
可将当前全局常量导出为 *.gcd 文件。
这样就可以在其他测试配置或 project elements(项目元素) 中复用已定义的常量。
此类常量定义可在 Constants definition editor(常量定义编辑器) 中编辑。
按优先级排序的常量定义文件和脚本¶
通过此控件可以引用常量定义文件。
单击按钮
会打开文件选择对话框,然后可以选择现有的 *.gcd 文件。单击
可将所选文件从列表中移除。
列表中文件的顺序会影响常量的求值优先级。也就是说,如果两个不同文件中定义了同一个常量,但值不同,则最终值以列表中位置更靠上的文件为准。
为确保常量值能够按优先级生效,列表会按从下到上的顺序处理。 因此需要注意,脚本只能访问在其下方列表项中定义的常量。
在窗口上半部分静态定义的常量以条目 <statically defined entries> 表示,其优先级取决于它在列表中的位置。
另一个预定义条目 <Constants defined via REST API> 用于指定通过 REST API 启动配置时所设置常量的优先级。
可通过按钮
和
修改所选文件的优先级。显示的文件名相对于当前 Workspace(工作区)目录。双击文件名会在 Constants definition editor(常量定义编辑器) 中打开该文件。
常量生成器脚本
除了 *.gcd 文件外,也可以引用 Python 脚本,以便在配置启动期间动态初始化常量。
这些脚本必须包含一个名为 Init 的方法,该方法接收一个类型为 GlobalConstantsDefinition 的参数。
已定义常量的优先级与使用 *.gcd 文件时类似,取决于该文件在列表中的位置。
通过按钮
可以基于模板创建此类常量生成器,并将其保存到磁盘:
# -*- coding: utf-8 -*-
def Init(constants):
'''
This method can be used to dynamically create and evaluate global constants.
By defining constants here, they are added to the configuration.
It is also possible to throw an exception to abort the configuration start:
raise AbortConfigError(u'Reason for the error')
@param constants: Container for global constants
@type constants: <GlobalConstantsDefinition> (see documentation of Object Api)
'''
# Example implementation
constants.AppendConstant('ConstName', "'read from py-File'", 'Description for text value')
constValue = constants.GetValue('AnImportantConstant')
if constValue == 'None':
raise AbortConfigError(u'AnImportantConstant is not set!')