本主题说明了如何指定设置来控制报告、任务分配、许可等选项。本地设置可用于在团队中共享首选项,以及将不同的设置组应用于不同的项目和测试运行。 

内容包括:

关于本地设置

本地设置可以控制报告设置、Parasoft DTP 设置、错误作者设置等。您可能想使用以下本地设置创建文件:

  • 为不同的项目配置和使用不同的设置配置。
  • 根据需要扩展或重写整个团队范围的设置(例如,涉及本地路径的设置)。
  • 在 Parasoft DTP 中输入 GUI 指定的和手动指定的设置,以在团队中集中进行首选项分配和更新。
  • 无需打开 GUI 即可调整设置。

(info) 如果在本地设置文件和 GUI 中都配置了选项,则本地设置将重写 GUI 配置。

指定和存储本地设置

有两种方法可以指定本地设置:

  • 在一个简单文本文件中手动输入它们。没有名称或位置要求。
  • 按照将 GUI 首选项导出到本地设置文件中的说明将 GUI 首选项导出,然后根据需要调整或扩展它们。

    通过导出 GUI 首选项创建本地设置(选项)文件

    创建选项文件的最快、最简单的方法是从 GUI 导出首选项。

    1. 选择 Parasoft> 首选项
    2. 选择 Parasoft (左树中的根元素)。
    3. 单击面板右侧的共享 链接。
    4. 在打开的对话框中,指定要导出到文件的首选项。
    5. 单击 浏览按钮,然后指定要保存设置的文件。
    6. 点击 确定
      • 如果选择现有文件,则设置将被附加到该文件。否则,将创建一个新文件。
      • 导出的密码将被加密。

本地设置可以存储在 Parasoft DTP 上(它们会自动应用于连接的 C/C++test 安装),也可以存储在本地文件中(可以在命令行中指定)。  有关如何存储和应用本地设置的详细信息,请参见 C/C++test 配置概述。 

附加信息

  • 每个设置都应在一行中输入。
  • 我们强烈建议您使用编码密码,以确保成功进行身份验证并提高安全级别;请参见 Creating an Encoded Password
  • 如果要从 DTP 上指定的本地设置导入首选项,并且要从 GUI 重写这些设置,则可以清除相应页面上的 Use DTP settings选项,然后手动配置设置。
  • 如果在测试运行期间检测到任何本地设置问题,则将在命令行输出中报告详细信息。
  • 如果从开发人员/测试人员桌面(而不是从 Server 计算机)运行 cli 模式,请使用 tasks.clear=false 选项以确保保留先前运行的结果。

可用设置

报告设置

设置目的
build.id=[id]

指定用于标记结果的构建标识符。对于每个构建,它可能是唯一的,但也可能标记在指定构建过程中执行的多个测试会话。 

构建 ID 的最大长度为 128 个字符。

默认是 ${dtp_project}-yyyy-MM-dd

report.active_rules=true|false

确定报告是否包含已为测试启用的规则的列表。

默认: false

report.archive=true|false

允许在指定的报告位置生成其他压缩存档 (.zip) 文件。ZIP 文件包含为生成报告而生成的所有文件。 

此选项可以为任何报告格式(例如 HTML、CSV、PDF 等)生成存档。 

通过生成存档,您还可以执行报表的自定义转换,因为所有元素都生成到指定的目标文件夹。

默认: false

report.associations=true|false

指定报告是否显示与测试关联的需求、缺陷、任务和功能请求。

默认: false

report.authors_details=true|false

确定该报告是否包括分配给每个团队成员的任务数量和类型的概述。 

Default: true

report.contexts_details=true|false

确定报告是否包括测试期间检查或执行的文件的概述。

默认: false

report.custom.extension

report.custom.xsl.file

指定自定义格式的 XSL 文件的位置和扩展名。使用 report.format=custom

有关详细信息和示例,请参见 配置报告设置

report.developer_errors=true|false

确定管理员报告是否包括有关团队成员任务的详细信息。

默认: false

report.developer_reports=true|false

确定系统是否为所有团队成员生成详细报告(除了针对管理员的摘要报告)。 

Default: true

report.format=html|pdf|sate|xunit|custom

指定报告格式。

默认: html

report.generate_htmls=true|false

确定否生成 HTML 报告并将其保存在本地文件系统上。不论此设置的值如何,都会生成并保存 XML 报告。

Default: true

report.graph.cs_start_date=[MM/dd/yy]确定在一段时间内跟踪静态分析任务的趋势图的开始日期。有关这些报告的更多详细信息,请参见了解报告
report.graph.ue_coverage_start_date=[MM/dd/yy]确定跟踪一段时间内覆盖率的趋势图的开始日期。有关这些报告的更多详细信息,请参见 了解报告
report.graph.ue_start_date=[MM/dd/yy]确定跟踪一段时间内测试执行结果的趋势图的开始日期。 
report.location_details=true|false

指定是否将绝对文件路径添加到 XML 数据。如果要在导入桌面安装时重新定位任务,则需要在服务器安装上启用此功能。 

默认: false

report.mail.attachments=true|false

确定是否将报告作为附件发送。所有组件均作为附件包括在内; 您必须将所有附件保存到磁盘上,然后才能查看带有图像的 HTML 报告。

默认: false

report.mail.cc=[email_addresses]指定电子邮件综合管理器报告的位置。此设置后必须为以分号分隔的电子邮件地址列表。此设置通常用于将报告发送给管理员或架构师。如果没有自动发送报告到团队成员,也可以使用它(例如,因为团队没有使用受支持的源代码控制系统)。
report.mail.compact=trends|links

指定您要通过电子邮件发送紧凑的报告或链接,而不是完整的报告。 

如果使用趋势 ,则电子邮件包含趋势图、摘要表和其他紧凑数据;不包括详细数据。

如果使用 链接 ,则电子邮件仅包含报告的链接(在团队服务器上可用)

report.mail.domain=[domain]指定用于发送报告的电子邮件域。
report.mail.enabled=true|false

确定是否将报告通过电子邮件发送给团队成员以及通过 cc 设置指定的其他收件人。 

请记住,将为每位从事项目代码工作的开发人员自动发送一份报告,该报告仅包含与他或她的工作有关的错误/结果。

默认: false

report.mail.exclude=[email_addresses]指定您不希望接收报告的任何电子邮件地址。此设置用于防止将报告自动发送给从事代码工作的人员,但不应接收报告。
report.mail.exclude.developers=true|false

指定是否将报告发送给任何未在 report.mail.cc属性中明确列出其电子邮件的团队成员。此设置用于防止将报告发送给各个开发人员。

默认: false

report.mail.format=html|ascii

指定电子邮件格式。

默认: html

report.mail.from=[email_address OR user_name_of_the_same_domain]

指定已发送电子邮件的“发件人”行。

默认<global_user_name>

report.mail.include=[email_addresses]指定要接收单个报告的团队成员的电子邮件地址。此设置后必须为以分号分隔的邮件地址列表。如果未自动发送此类报告(例如,因为团队未使用受支持的源代码控制系统),则通常使用此设置将单个报告发送给团队成员。它会重写 'exclude’列表中指定的团队成员。 
report.mail.on.error.only=true|false

确定仅在生成任务或发生致命异常时才将报告发送给管理员。团队成员的电子邮件不受此设置的影响;单个电子邮件仅发送给负责所报告任务的团队成员。

默认: false

report.mail.server=[server]指定用于发送报告的邮件服务器。
report.mail.port=[port]

指定邮件服务器主机的端口号。

默认25

report.mail.security=[SL| STARTTLS| NONE]指定所需的安全性。可用设置为 SSL、STARTTLS、NONE。SSL 在 Visual Studio 中不可用。
report.mail.subject=My New Subject

指定发送的电子邮件的主题行。默认主题行是 ${tool_name} 报告 - ${config_name}。例如,如果要将主题行更改为“项目 A 的报告”,则可以使用

report.mail.subject=Report for Project A

默认${tool_name} Report - ${config_name}

report.mail.time_delay=[server]

指定通过电子邮件发送报告之间的时间延迟(以避免批量电子邮件限制)。

默认0

report.mail.unknown=[email_address OR user_name_of_the_same_domain]指定将报告分配给“未知”错误的报告发送位置。
report.mail.username=[username] report.mail.password=[password] report.mail.realm=[realm]

指定 SMTP 服务器认证的设置。

只有使用 SASL 领域 进行身份验证的服务器才需要该领域值。

report.metrics_details=true|false

确定是否生成带有度量指标摘要信息(以及适用时的单个类和方法详细数据)的 XML 报告。仅在运行启用了度量指标的测试配置时才生成此报告。度量指标详细信息将显示在 HTML 和 PDF 报告中。

Default: true

report.ref.report.file=[path]指定在分析期间将创建引用报告文件的位置的路径。请参见配置任务报告首选项
report.setup.problems=top|bottom|hidden

确定报告是否包括有关设置问题的部分。 

顶部 -在报告顶部添加“设置问题”部分。这为默认。 

隐藏 - 阻止添加“设置问题”部分。

底部 - 在报告底部添加“设置问题”部分。 

默认:底部

report.suppressed_msgs=true|false

确定报告是否包括抑制的报文。

默认: false

report.test_params=true|false

确定报告是否包含测试参数详细信息。

默认: false

report.ue_coverage_details_htmls=[coverage_type]

确定测试的 HTML 报告是否链接到另一个报告,该报告包含带有逐行覆盖范围详细信息注释的源代码。 

以下值可用于 [coverage_type]:

LC - 用于行覆盖率
SC - 用于语句覆盖率
BCC - 用于块覆盖率
DC - 用于决策覆盖率
SCC - 用于简单条件覆盖率
MCDC - 用于 MC/DC 覆盖率

session.tag=[name]

指定用于标记这些结果的会话标签。此值用于将摘要结果上传到团队服务器。 

标签是在分析过程中检查的模块的标识符。不同模块的报告应标记不同的标签。

默认${config_name}

tasks.source.control.details=true|false
此设置指定报告中是否包含来自源代码管理的其他信息,例如修订和注释。


Parasoft DTP 设置

设置目的
dtp.enabled=true|false

确定当前的 C/C++test 安装是否已连接到 DTP。

dtp.server=[server]指定 DTP 服务器的主机名。
dtp.port=[port]指定 DTP 服务器的端口号。
dtp.user=[username]指定用于 DTP 服务器认证的用户名。
dtp.password=[password]指定 DTP 服务器认证的密码。我们强烈建议您使用编码密码,以确保成功进行身份验证并提高安全级别;请参见创建编码密码
dtp.context.path=[path]指定 DTP 的路径。上下文路径是使用 dtp.server设置指定的主机名的相对路径。仅当 DTP 部署到主机服务器的根以外的其他位置时才应配置此设置,如果您的组织使用反向代理,则可能是这种情况。
report.dtp.publish=true|false启用或禁用向 DTP 服务器报告的结果。
dtp.project=[project_name]指定要将这些结果链接到的 DTP 项目的名称。
dtp.additional.settings=[KEY1\=VALUE1\nKEY2\=VALUE2...]指定用于将结果报告给 DTP 的高级设置。
dtp.autoconfig=true|false使用 DTP 服务器上存储的 C/C++test 设置启用自动配置

团队服务器设置

设置目的
tcm.server.enabled=true|false

确定 C/C++test 是否已连接到 Parasoft 团队服务器。 

默认: false

tcm.server.name=[name]指定运行团队服务器的计算机的计算机名称或 IP 地址。 
tcm.server.port=[port]

指定团队服务器端口号。

默认18888

tcm.server.accountLogin=true|false
tcm.server.username=[username]
tcm.server.password=[password]

确定是否提交用户名和密码以连接到团队服务器。并非总是需要用户名/密码。这取决于您团队的设置。 

如果第一个设置为true,则第二个和第三个设置指定用户名和密码。

请注意,必须先启用团队服务器的用户名和密码设置,然后才能使用这些设置。

tcm.server.accountLogin default: false

许可设置

有关其他说明和示例,请参见 将许可证手动添加到本地设置

设置目的
cpptest.license.use_network=true|false

启用或禁用检索网络许可证。

示例: cpptest.license.use_network=true

Default: true

(info) 默认情况下,C/C++test 将尝试在配置为您的主 DTP 服务器的 DTP 上检索许可证表单“许可证服务器”;请参见Parasoft DTP 设置。如果要配置其他许可证服务器,请启用 license.network.use.specified.server 选项。

cpptest.license.local.password=[password]指定 C/C++test 要使用的本地密码。 
cpptest.license.local.expiration=[expiration]

指定本地许可证的到期日期。

默认0

cpptest.license.network.edition=[edition_name]

指定 C/C++test 要从许可证服务器检索的许可证类型。 

[edition_name] can be automation_edition.要使用自定义版本,请不要在 "=";之后设置任何内容。只需将值保留为空。

示例:

cpptest.license.network.edition=desktop_edition

cpptest.license.network.edition=automation_edition

默认: custom_edition

cpptest.license.custom_edition_features=[feature name]指定在 C/C++test 许可证的自定义版本中想启用的功能。
cpptest.license.wait.for.tokens.time=[time in minutes]

如果许可证当前不可用,指定 C/C++test 将等待许可证的时间。 

例如,要使 C++test 等待 3 分钟以获得许可证令牌,请使用 cpptest.license.wait.for.tokens.time=3。

默认0

cpptest.license.autoconf.timeout=[seconds]

指定 C/C++test 等待许可证从许可证服务器自动配置的最大秒数。

默认20

license.network.use.specified.server=true|false

启用或禁用从使用 license.network.hostlicense.network.port选项指定的自定义许可证服务器中检索许可证。

示例: license.network.use.specified.server=true

默认: false

license.network.host=[host]

指定用于获取许可证的独立许可证服务器、辅助 DTP 或旧版许可证服务器的主机名。需要将 license.network.use.specified.server 选项设置为 true

示例: license.network.host=jade.mycompany.com

(info) 如果从使用 HTTPS 协议的独立许可证服务器中检索许可证,请在主机名前加上 https://

license.network.port=[port]

指定分配给使用 license.network.host 选项指定的许可证服务器的端口号。

  • 对于独立的许可证服务器:  取决于您的 Tomcat 设置; 通常是一个 HTTP 端口,例如, 8080。
  • 对于辅助 DTP 上的许可服务器:通常,使用 HTTPS 端口,例如 443 或 8443。
  • 对于旧版许可证服务器:通常, 2002。

示例: license.network.port=2222

license.network.context.path=[path]

指定 DTP 许可证服务器的路径。上下文路径是来自使用许可证 license.network.host 设置指定的主机名的相对路径。仅当 DTP 部署到主机服务器的根以外的其他位置时才应配置此设置,如果您的组织使用反向代理,则可能是这种情况。

独立许可证服务器不支持配置上下文路径。

有关反向代理服务器配置和上下文路径配置的其他信息,请参见 DTP 文档。

示例: license.network.context.path=/foo/bar

license.network.connection.type=[http|tcp]

如果从自定义许可证服务器获取许可证,则指定连接类型。

http: 允许您从独立的许可证服务器或辅助 DTP 上的许可证服务器获取许可证。

tcp: 允许您从旧版许可证服务器获取许可证。

它要求启用 license.network.use.specified.server, license.network.host, 和 license.network.port to be enabled.

示例: license.network.connection.type=http

license.network.auth.enabled=true|false

在使用license.network.host 和 license.network.port 选项指定的辅助 DTP 服务器上启用或禁用身份验证。

需要将 license.network.use.specified.server 选项设置为 true

license.network.user=[username]

在使用license.network.host 和 license.network.port 选项指定的辅助 DTP 服务器上指定用于认证的用户名。需要将 license.network.use.specified.serverlicense.network.auth.enabled 选项设置为true

示例: license.network.user=JohnSnow

license.network.password=[password]

指定使用license.network.host 和 license.network.port 选项指定的辅助 DTP 服务器上的身份验证密码。它需要将 license.network.use.specified.serverlicense.network.auth.enabled 选项设置为 true, 并配置 license.network.user。我们强烈建议您使用编码密码,以确保成功进行身份验证并提高安全级别;请参见创建编码密码

示例: license.network.password=Wic2019!

OpenID Connect 设置

设置目的
oidc.enabled=true|false

通过 OpenID Connect 启用或禁用用户身份验证。

默认为 false

oidc.issuer.uri=[uri]指定注册 DTP 的 OpenID Connect 服务器的 URI。
oidc.client.id=[id]指定在您的 OpenID Connect 服务器上注册的 ID。
oidc.client.secret=[password]指定您的 OpenID Connect 服务器提供的密码。
oidc.keystore=[path]

指定密钥库文件的路径,该密钥库文件存储证书以对 OpenID Connect 服务器上的用户进行身份验证。

oidc.keystore.password=[password]指定用于存储自签名客户端证书的密钥库文件的密码。我们强烈建议您使用编码密码,以确保成功进行身份验证并提高安全级别;请参见创建编码密码
oidc.keystore.alias=[alias]

指定要用于在 OpenID Connect 服务器上进行身份验证的别名。如果您的密钥库文件包含多个条目,则可能需要配置此设置。

示例: oidc.keystore.alias=grs

oidc.callback.host=localhost | 127.0.0.1

此设置指定在 IDE 中配置为与 OpenID Connect 服务器通信的本地回调主机。

(info) 这是与 IDE 相关的设置,不适合命令行使用。

默认为 localhost

oidc.callback.port=0 | [port number]

此设置指定在 IDE 中配置为与 OpenID Connect 服务器通信的回调端口号。

(info) 这是与 IDE 相关的设置,不适合命令行使用。

0: 端口将被自动配置。

默认为 0

oidc.callback.timeout=[seconds]

此设置指定在 IDE 中使用 C/C++test 时,通过 OpenID Connect 在身份验证页面上提供用户凭据以在 DTP 上进行身份验证所允许的最长时间。

(info) 这是与 IDE 相关的设置,不适合命令行使用。

默认为 60

技术支持设置

设置目的
techsupport.auto_creation=true|false

确定在发生测试问题时是否自动准备存档。

默认: false

techsupport.send_email=true|false

确定是否将准备好的存档通过电子邮件发送给 Parasoft 支持。如果启用此功能,请确保从 GUI 或报告设置中的选项指定电子邮件设置。

默认: false  

techsupport.archive_location=[directory]指定存档的存储位置。
techsupport.verbose=true|false

确定详细日志是否包含在存档中。请注意,如果日志记录系统具有自定义配置,则无法启用此选项。

  • 详细日志存储在用户主目录临时位置内的 xtest.log 文件中(在 Windows 上,这是 <drive>:\Documents and Settings\<user>\Local Settings\Temp\parasoft\xtest)。

  • 详细的日志记录状态是跨会话持久的(在应用程序启动时恢复)。

  • 日志文件是一个滚动文件:它不会增长到一定大小,并且每次达到最大大小时,都会创建一个备份。

默认: false

techsupport.verbose.scontrol=true|false

日志文件是一个滚动文件:它不会增长到一定大小,并且每次达到最大大小时,都会创建一个备份。请注意,输出可能包含源代码的片段。  

默认: false

techsupport.item.general=true|false

确定是否包括常规应用程序日志。

默认: false

techsupport.item.environment=true|false

确定环境变量、JVM系统属性、平台详细信息、其他属性(内存等)是否包含在归档文件中。

默认: false

techsupport.advanced=true|false

指定是否发送高级选项。

默认: false

techsupport.advanced.options=[option]

指定支持团队要求您输入的所有高级选项。

默认: false

techsupport.dtp.engine=true|false

指定是否将发送在分析期间生成的其他数据。

默认: false

作者/范围设置

设置目的
authors.mappings.location=team|local|shared

指定作者身份映射文件的存储位置。除非指定本地 共享,否则此设置默认为团队

如果设置为 本地 (推荐),则可以直接在【本地设置】中设置作者映射。有关详细信息,请参见 authors.mappingauthors.user{n}

如果设置为 共享,则可以使用 authors.mappings.file选项将映射存储在本地文件中。 

团队共享 选项已弃用。这些选项指定的文件应采用以前使用的格式:

#author to author
user1=user3
user2=user3
#author to email
[email protected]

 默认: team

authors.mapping{n}=[from_user, to_user]

如上所述,为 authors.mappings.location=local指定特定的作者映射。

示例:

authors.mappings.location=local
authors.mapping1=baduser,gooduser
authors.mapping2=brokenuser,fixeduser 
authors.mapping3=olduser,newuser 

authors.user{n}=[username, email, full_name]

authors.mappings.location=local指定特定的作者姓名和电子邮件。

示例:

authors.user1=dan,[email protected],Dan Stowe
authors.user2=jim,[email protected],Jim White 

authors.mappings.file=[path]

如上面 authors.mappings.location 中所述,指定“共享”文件的位置。

示例:

authors.mappings.file=/home/user/dev/temp/author_mapping1.txt

authors.ignore.case=true|false

确定作者名称是否区分大小写。如果为 true,则 David 和 david 将被视为同一用户。如果为 false,则 David 和 david 将被视为两个单独的用户。

默认: false

scope.sourcecontrol=true|false

确定 C++test 是否基于来自受支持的源代码控制系统的数据来计算代码作者。如果要使用 GUI 中指定的值,则不需要此设置。

默认: false

scope.local=true|false

确定 C++test 是否基于本地用户计算代码作者。如果要使用 GUI 中指定的值,则不需要此设置。

Default: true

scope.recommended.computation=first|random确定 C/C++test 如何为每个团队成员选择【推荐任务】,它可以随机选择 n 个任务(默认),也可以选择报告的前 n 个任务( n 是 C/C++test 配置为每天显示每个团队成员的最大任务数)
scope.xmlmap=true|false

确定是否基于 XML 文件计算任务分配,该 XML 文件定义了如何为特定文件或文件集分配任务(可以在 GUI 中指定这些映射,然后将其保存在 XML 文件中)。

Default: true

scope.xmlmap.file=[file]指定 XML 文件的名称,该 XML 文件定义了如何为特定文件或文件集分配任务。

源代码控制设置

定义多个相同类型的存储库

配置多个相同类型的存储库需要在定义每个存储库的设置中添加索引(从 1 到 n)。示例: 

scontrol.rep1.svn.url= svn://buildmachine.foobar.com/home/svn
scontrol.rep1.svn.login=admin
scontrol.rep1.svn.password=1qa2ws

scontrol.rep2.svn.url= svn://tests.mycompany.com/projects/svn
scontrol.rep2.svn.login=lead
scontrol.rep2.svn.password=8ik9ol
 

Git 存储库定义属性

属性说明
scontrol.rep.type=gitGit 存储库类型标识符。
scontrol.git.exec=Git 可执行文件的路径。如果未设置,则假定 git 命令位于路径上。
scontrol.rep.git.branch=源代码管理模块将使用的分支的名称。可以将其保留为空白,并使用当前签出的分支。
scontrol.rep.git.url=远程存储库网址 (例如, git://hostname/repo.git).
scontrol.rep.git.workspace= 包含本地 git 存储库的目录。

Perforce 存储库定义属性

属性说明
scontrol.perforce.exec=外部客户端可执行文件的路径 (p4)。
scontrol.rep.type=perforcePerforce 存储库类型标识符。 
scontrol.rep.perforce.host=Perforce 服务器主机。 
scontrol.rep.perforce.port=Perforce 服务器端口。默认端口为 1666。
scontrol.rep.perforce.login=Perforce 用户名。 
scontrol.rep.perforce.password=密码。 
scontrol.rep.perforce.client=客户端工作空间名称,如 P4CLIENT 环境变量或其等效项中所指定。工作空间的根目录应配置为本地路径(以便可以下载文件)。 

Subversion 存储库定义属性

属性说明
scontrol.rep.type=svnSubversion 存储库类型标识符。 
scontrol.rep.svn.url=Subversion URL 指定协议、服务器名称、端口和起始存储库路径(例如 svn://buildmachine.foobar.com/home/svn)。 
scontrol.rep.svn.login=登录名。 
scontrol.rep.svn.password =密码(未编码)。 
scontrol.svn.exec=外部客户端可执行文件的路径 (svn)。

Microsoft Team Foundation 服务器存储库定义属性 

属性说明
scontrol.rep.type=tfsTFS 存储库类型标识符。 
scontrol.rep.tfs.host=运行 TFS 的计算机的名称。
scontrol.rep.tfs.port=TFS 服务器的端口号(可选;未指定时,使用 8080)。
scontrol.rep.tfs.protocol=用于连接到 TFS 服务器的协议。可用值为 HTTP 和 HTTPS。
scontrol.rep.tfs.url=TFS 资料库 URL(例如, http://localhost:8080/tfs)。
scontrol.rep.tfs.login =TFS 用户名。确保提供与在计算机上配置 TFS 存储库所使用的用户名相同的用户名。
scontrol.rep.tfs.password=TFS 密码。

用于创建或导入项目的设置

C/C++test 项目创建和导入设置

创建或导入项目的选项仅在创建或导入项目时有效。在后续运行期间将忽略它们。

用于创建基于 BDF 的项目的设置

选项说明

bdf.import.location=[WORKSPACE|BDF_LOC|<path>]

您可以指定外部位置,或使用关键字 工作空间。如果使用 工作空间 ,将在工作空间目录的子目录中创建项目。

如果使用BDF_LOC并将创建一个项目,则将在与 bdf 文件相同的位置创建该项目。如果将创建多个项目,则将在 bdf 文件位置内的子目录中创建项目。这些子目录将使用相应的项目名称命名。

如果指定了外部路径,则将在指定位置创建项目。

默认为WORKSPACE

有关可用的项目创建选项及其影响的详细信息,请参见 使用 C++test 项目

bdf.import.pathvar.enabled=[true|false]

指定是否应在将在新项目中创建的链接文件夹中使用路径变量。默认为 false。

bdf.import.pathvar.name=<name>

指定路径变量的名称(如果使用了路径变量,则根据 bdf.import.pathvar.enabled 属性)。默认路径变量名称为 DEVEL_ROOT_DIR

bdf.import.pathvar.value=<path>

指定路径变量的值(如果使用了路径变量,则根据 bdf.import.pathvar.enabled 属性)。默认值是所有链接文件夹的最通用根目录。

bdf.import.compiler.family=<compiler_family>

指定将使用的编译器系列(例如, vc_6_0, vc_7_0, vc_7_1, vc_8_0, gcc_2_9, gcc_3_2, gcc_3_3, gcc_3_4, ghs_4_0)。对于自定义编译器,您需要使用自定义编译器系列标识符,该标识符是包含 gui.properties、c.psrc 和 cpp.psrc 文件的目录的名称。如果未指定此属性,则将使用默认值。

bdf.import.c.compiler.exec=<exec>

指定将在创建的项目中使用的 C 编译器的可执行文件。

bdf.import.cpp.compiler.exec=<exec>

指定将在创建的项目中使用的 C++ 编译器的可执行文件。

bdf.import.linker.exec=<exec>

指定将在创建的项目中使用的链接器的可执行文件。

bdf.import.project.<proj_name>=dir1;dir2;dir3

指定要链接项目prj_name的文件夹集。应将文件夹指定为文件夹路径的值列表,并用分号分隔。

导入 Green Hills .gpj 项目的设置

设置目的
gpj.import.location=WORKSPACE|ORIG|<path>

指定导入项目的位置。

如果使用 工作空间 ,则将在工作空间中创建项目。

如果使用 ORIG , 然后将在 .gpj 项目位置创建该项目。

如果指定了外部路径,则将在指定位置创建项目。

默认值是 工作空间

gpj.import.linked=true|false

指定 .gpj 项目源文件夹是否链接到创建的 Eclipse 项目中。

默认值是 true

gpj.import.subdirs=true|false

gpj.import.location=<path>时适用

指定是将项目导入到子目录还是直接导入到指定位置。

如果要将项目导入到在指定外部位置创建的子目录中,请使用 true。

如果仅导入一个项目,并且希望将其直接导入到指定的外部位置,请使用 false。

默认值为 true(为在外部位置导入的每个项目创建子文件夹)。

gpj.import.pathvar.enabled=true|false

指定在创建链接目录时是否应使用路径变量(如果上述选项设置为 true)。

默认值是 false

gpj.import.pathvar.name=<name>

指定路径变量名称。除非您指定指向不同位置的路径变量名称(例如 DEVEL_ROOT_DIR),否则将使用默认值。

如果在 Eclipse 工作空间中已经定义了具有指定名称的项目,并且该项目指向的位置与 gpj.import.pathvar.location 属性中传递的值不同,则将不使用路径变量;而将会使用全路径。同样,如果没有指定 gpjimport.pathvar.name 属性,则 gpjimport.pathvar.name 的默认值将始终为DEVEL_ROOT_DIR 。如果使用某些 <name>指定此属性,则该 <name> 将用作路径变量名称。

默认值是 DEVEL_ROOT_DIR

gpj.import.pathvar.value=<path>

指定路径变量值。默认情况下,C++test 计算所有链接文件夹的通用根。

gpj.import.compiler.family=name

指定编译器系列(编译器 ID)

gpj.import.c.compiler.exec=name指定 C 编译器可执行文件
gpj.import.cpp.compiler.exec=name

指定 C++ 编译器可执行文件

gpj.import.linker.exec=name指定链接器可执行文件

导入 IAR Embedded Workbench .ewp 项目的设置

设置目的
ewp.import.location=WORKSPACE|EWP_LOC|<path>

指定导入项目的位置。

如果使用 WORKSPACE ,则将在工作空间中创建项目。

如果使用 EWP_LOC , 然后将在 .ewp 项目位置创建该项目。

如果指定了外部路径,则将在指定位置创建项目。

默认值是 工作空间

ewp.import.config=<name>

指定应使用的 .ewp 项目配置。如果在导入的项目中找不到指定的配置,则将使用默认配置。

可以通过两种方式传递配置名称:<project_name> - <configuration_name> 或者仅用 <configuration_name>.如果导入了多个项目,则仅应输入 <configuration_name> 。

这将提示向导在所有项目中搜索该配置。默认值为 .ewp 中的默认值。

ewp.import.linked=true|false

指定 .project 源文件夹是否链接到创建的 Eclipse 项目。

默认: true

ewp.import.subdirs=true|false

指定是将项目导入到子目录还是直接导入到指定位置。当使用 ewp.import.location=<path> 时适用。

设置为 true 可以将项目导入到在指定外部位置创建的子目录中。默认

设置为 false 可将单个项目直接导入到指定的外部位置。

ewp.import.pathvar.enabled=true|false

设置为 true 创建链接目录时使用路径变量。

默认值是 false

ewp.import.pathvar.name=name

指定路径变量名称。除非指定了指向其他位置的路径变量名称,否则将使用默认名称DEVEL_ROOT_DIR

ewp.import.pathvar.value=<path>指定路径变量值。默认情况下,C++test 计算所有链接文件夹的通用根。

导入 Microsoft Visual Studio 6.0 .dsp 项目的设置

设置
目的
dsp.import.location=WORKSPACE|DSP_LOC|<path>

指定导入项目的位置。

如果使用 WORKSPACE ,则将在工作空间中创建项目。

如果使用 DSP_LOC, 然后将在 .dsp 项目位置创建该项目。

如果指定了外部路径,则将在指定位置创建项目。

默认值是 工作空间

dsp.import.linked=true|false

指定是否将 .dsp 项目源文件夹链接到创建的 Eclipse 项目中。

默认值是 true

dsp.import.subdirs=true|false

dsp.import.location=<path> 时适用

指定是将项目导入到子目录还是直接导入到指定位置。

如果要将项目导入到在指定外部位置创建的子目录中,请使用 true。如果仅导入一个项目,并且希望将其直接导入到指定的外部位置,请使用 false。

默认值为 true(为在外部位置导入的每个项目创建子文件夹)。

dsp.import.pathvar.enabled=true|false

指定在创建链接目录时是否应使用路径变量(如果上述选项设置为 true)。

默认值是 false

dsp.import.pathvar.name=<name>

指定路径变量名称。除非您指定指向不同位置的路径变量名称(例如DEVEL_ROOT_DIR),否则将使用默认值。

如果在 Eclipse 工作空间中已经定义了具有指定名称的项目,并且该项目指向的位置与 dsp.import.pathvar.location 属性中传递的值不同,则将不使用路径变量;而将会使用全路径。同样,如果没有指定 dsp.import.pathvar.name 属性,则 dsp.import.pathvar.name 的默认值将始终为 DEVEL_ROOT_DIR 。如果使用某些 <name>指定此属性,则该 <name> 将用作路径变量名称。

默认值是 DEVEL_ROOT_DIR

dsp.import.pathvar.location=<loc>

指定路径变量指向的位置。默认情况下,将使用自动生成的位置。该位置是所有链接目录的公共根目录位置。如果找不到公共位置(例如,因为 .dsp 项目位于多个驱动器上)或无法使用指定位置,则将不使用路径变量。将会使用全路径。

例如,假定您具有以下路径:

path1: c:\a\b\c\proj1

path2: c:\a\b\proj2

公共根目录位置为 c:\a\b

默认值是自动生成的。

dsp.import.config=<name>

指定应使用的 .dsp 项目配置。如果在导入的项目中找不到指定的配置,则将使用默认配置。

可以通过两种方式传递配置名称:<project_name> - <configuration_name> or only <configuration_name>.如果导入了多个项目,则仅应输入 <configuration_name> 。这将提示向导在所有项目中搜索该配置。

默认值为 .dsp 中的默认值。

例如,如果应该在导入的项目中链接文件夹 C:\temp\sources ,例如,如果应该在导入的项目中链接文件夹DEVEL_ROOT_DIR 定义为值 C:\temp, ,则该文件夹将链接为 DEVEL_ROOT_DIR/sources 和 DEVEL_ROOT_DIR 路径变量将在工作区中创建。如果无法使用这样的变量(例如,由于其值指向不包含 C:\temp\sources 文件夹的另一个文件夹,则该变量已经定义且具有不同的值,或者具有无效的值),则使用 C:\temp\sources 文件夹将使用完整路径 C:\temp\sources 链接。

导入 Keil uVision 项目的设置

设置
目的
uv.import.location=WORKSPACE|ORIG|<path>

指定导入项目的位置。

如果使用 WORKSPACE ,则将在工作空间中创建项目。

如果使用 ORIG , 然后将在原始项目位置创建该项目。

如果指定了外部路径,则将在指定位置创建项目。

默认值是 工作空间

uv.import.linked=true|false

指定 uVision 项目源文件夹是否链接到创建的 Eclipse 项目中。

默认值是 true

uv.import.subdirs=true|false

uv.import.location=<path> 时适用

指定是将项目导入到子目录还是直接导入到指定位置。

如果要将项目导入到在指定外部位置创建的子目录中,请使用 true

如果仅导入一个项目,并且希望将其直接导入到指定的外部位置,请使用 false

默认值为 true(为导入到外部位置的每个项目创建子文件夹)。

uv.import.pathvar.enabled=true|false

指定在创建链接目录时是否应使用路径变量(如果上述选项设置为 true)。

默认值是 false

uv.import.pathvar.name=<name>

指定路径变量名称。除非您指定指向不同位置的路径变量名称(例如 DEVEL_ROOT_DIR),否则将使用默认值。

如果在 Eclipse 工作空间中已经定义了具有指定名称的项目,并且该项目指向的位置与 uv.import.pathvar.location属性中传递的值不同,则将不使用路径变量;而将会使用完整路径。同样,如果没有指定 uv.import.pathvar.name 属性,则 uv.import.pathvar.name 的默认值将始终为 DEVEL_ROOT_DIR 。如果使用一个 <name>指定此属性,则该 <name> 将用作路径变量名称。

默认值是 DEVEL_ROOT_DIR

uv.import.pathvar.value=<path>指定路径变量值。默认情况下,C++test 计算所有链接文件夹的通用根。
uv.import.config=<name>指定要使用的构建配置的名称。

导入 Renesas 高性能嵌入式项目的设置

设置
目的
hew.import.location=WORKSPACE|ORIG|<path>

指定导入项目的位置。

如果使用 WORKSPACE ,则将在工作空间中创建项目。

如果使用 ORIG , 然后将在原始项目位置创建该项目。

如果指定了外部路径,则将在指定位置创建项目。

默认值是 工作空间

hew.import.linked=true|false

指定 HEW 项目源文件夹是否链接到创建的 Eclipse 项目中。

默认值是 true

hew.import.subdirs=true|false

hew.import.location=<path> 时适用

指定是将项目导入到子目录还是直接导入到指定位置。

如果要将项目导入到在指定外部位置创建的子目录中,请使用 true

如果仅导入一个项目,并且希望将其直接导入到指定的外部位置,请使用 false

默认值为 true(为导入到外部位置的每个项目创建子文件夹)。

hew.import.pathvar.enabled=true|false

指定在创建链接目录时是否应使用路径变量(如果上述选项设置为 true)。

默认值是 false

hew.import.pathvar.name=<name>

指定路径变量名称。除非您指定指向不同位置的路径变量名称(例如DEVEL_ROOT_DIR),否则将使用默认值。

如果在 Eclipse 工作空间中已经定义了具有指定名称的项目,并且该项目指向的位置与hew.import.pathvar.location属性中传递的值不同,则将不使用路径变量;而将会使用全路径。同样,如果没有指定 hew.import.pathvar.name属性,则 hew.import.pathvar.name 的默认值将始终为 DEVEL_ROOT_DIR。如果使用一个 <name>指定此属性,则该 <name> 将用作路径变量名称。

默认值是 DEVEL_ROOT_DIR

hew.import.pathvar.value=<path>指定路径变量值。默认情况下,C++test 计算所有链接文件夹的通用根。
hew.import.config=<name>指定要使用的构建配置的名称。

其他设置

设置目的
report.rules=[url_path_to_rules_directory]

指定规则 html 文件的目录(通过单击【测试配置】的【静态分析】标签中的可打印文档按钮生成)。 

示例:

report.rules=file:///C:/Temp/Burt/parasoft/xtest/gendoc/

report.rules=../gendoc/

默认: none

tasks.clear=true|false

在 cli 模式下启动时清除现有任务。这样可以避免在【加载现有结果】上花费过多的时间。 

默认: true

console.verbosity.level=low|normal|high

指定控制台视图的详细程度。可用的设置是:

low: 配置控制台视图,以显示有关当前步骤名称和状态(完成、失败、最新)的错误和基本信息。

normal: 还显示了在测试和分析期间报告的命令行和问题。

high: 还显示警告。

默认: low

cpptest.custom.rules.dir=[directory]

指示用户定义规则的保存位置。

cpptest.custom.configs.dir=[directory]

指示用户定义的测试配置的保存位置。

custom.compilers.dir=[directory]重写自定义编译器目录设置(可 Parasoft>配置>自定义编译器在中找到),并使用定义的目录搜索自定义编译器。
exec.env=[env1; env2; ...]指定描述执行测试会话环境的标签列表。标签可以描述操作系统(例如 Windows、Linux),体系结构(例如 x86、x86_64)、编译器、浏览器等。这些标签描述了完整的测试会话;还可以通过服务器端 API 在测试套件,测试或测试用例级别添加更多环境详细信息。
issue.tracking.tags=[value]

指定自定义问题跟踪标签。多个标签可以用逗号分隔。示例:

issue.tracking.tags=@custom,@pr ,@fr

有关详细信息,请参见指示代码和测试的关联

parallel.mode=Manual|Auto|Disabled

确定以下哪个模式处于活动状态: 

  • Auto: 允许 C/C++test 控制并行处理设置。
  • Manual: 允许您手动配置并行处理设置以满足您的特定需求。
  • Disabled: 将 C/C++test 配置为仅使用可用的 CPU 之一。

有关此选项和其他并行处理选项的更多详细信息,请参见 配置并行处理

默认Auto

parallel.max_threads=<number>

指定可以同时执行的最大并行线程数。  并行线程的实际数量是根据 CPU 数量、可用内存和许可证设置确定的。

默认[available_processors]

parallel.free_memory_limit=[percentage]

指定在低内存条件下应保持空闲的内存量(表示为应用程序可用总内存的百分比)。这用于确保可用内存可用于其他进程。

默认25

parallel.no_memory_limit=true|false

表示您不希望对 Parasoft Test 可用的内存施加任何限制(超出现有系统限制)。 

默认: false

cpptest.fail.setup.problems=true|false

启用或禁用返回0x40 退出代码,该代码指示在进程失败时报告了安装问题;有关详细信息,请参见命令行退出代码

默认: false

cpptest.advanced.settings.file=[path]指定高级设置文件的路径;请参见配置高级选项

在本地设置(选项)文件中使用变量

以下变量可以在报告、电子邮件、Parasoft DTP、Team Server 和许可证设置中使用。

(warning) 会话标签值不得包含任何 ':’ 字符。

env_var

示例:${env_var:HOME}

输出在冒号之后指定的环境变量的值。

project_name

示例:${project_name}

输出测试项目的名称。如果提供了多个项目作为输入,它将首先输出经过测试的项目名称,然后输出"..."。

workspace_name

示例:${workspace_name}

输出 一个空字符串。 

config_name

$ 示例: ${config_name}

输出执行的测试配置的名称; 仅适用于报告和电子邮件设置。

分析类型

$ 示例: ${analysis_type}

输出以逗号分隔的已启用分析类型的列表(例如:静态,生成,执行);仅适用于报告和电子邮件设置。

tool_name

$ 示例: ${tool_name}

输出工具名称(例如:C/C++test)。

示例

示例 1

# Report settings
report.developer_errors=true 
report.developer_reports=true 
report.format=html
session.tag=<project name>
 
# Mail settings:
report.mail.enabled=true
report.mail.cc=<[email protected];[email protected]> 
report.mail.server=mail.company.com
report.mail.domain=company.com
report.mail.subject=<Static Analysis results on Project X> 
report.mail.attachments=true

示例 2

# Parasoft DTP settings   
dtp.enabled==true
dtp.server=server1.mycompany.com
dtp.port=32323
dtp.user=smith
dtp.password=?1q2W3e4R5t6Y7u8I9o!  

# Mail settings
report.mail.enabled=true
report.mail.server=mail.mycompany.com   
report.mail.domain=mycompany.com   
report.mail.cc=project_manager   
report.mail.subject=Coding Standards   

示例 3

# REPORTS
 
#Determines whether reports are emailed to developers and to the additional recipients specified with the cc setting.
#Remember that if the team is using CVS for source control and each developer's email address matches his or her CVS username + the mail domain, each developer that worked on project code will automatically be sent a report that contains only the errors/results related to his or her work.

report.mail.enabled=true
 
#Exclude developers emails (true/false) 
report.mail.exclude.developers=false
 
# Append developers errors to manager emails (true/false) 
report.developer_errors=true
 
# Send reports to developers (true|false) 
report.developer_reports=true
 
# Append suppressed messages (true|false) 
report.suppressed_msgs=false
 
#Determines where to mail complete test reports.
#This setting is typically used to send reports to managers or architects.
#It can also be used to send reports to developers if developer reports
#are not sent automatically (for example, because the team is not using CVS). 
[email protected]; ${env_var:USERNAME} @domain.com
 
# mail target for unknown developer errors 
[email protected]
 
#Specifies the mail server used to send reports. 
report.mail.server=mail_server.domain.com
 
#Specifies the mail domain used to send reports. 
report.mail.domain=domain.com
 
#Specify mali from 
report.mail.from=nightly
 
#Specifies any email addresses you do not want to receive reports.
#This setting is used to prevent from automatically sending reports to someone that worked on the code, but should not be receiving reports. This setting is only applicable if the team is using CVS for source control and developer reports are being sent automatically.
report.mail.exclude=developer1;developer2
 
# Specifies the subject line of the emails sent.
report.mail.subject= ${tool_name} Report - ${config_name}
 
# Report test params include (true|false) 
report.test_params=true
 
# Team Server
 
#Determines whether the current installation is connected to the Team Server. 
tcm.server.enabled=true
 
#Specifies the machine name or IP address of the machine running Team Server. 
tcm.server.name=team_server.domain.com
 
#Specifies the Team Server port number. 
tcm.server.port=18888
 
tcm.server.accountLogin=true 
tcm.server.username=user 
tcm.server.password=password 
session.tag= ${config_name}
 
 
# SCOPE
 
#code authorship based on CVS 
scope.sourcecontrol=true
 
#code authorship based on author tag 
scope.author=false
 
#code authorship based on local user 
scope.local=false
 
# LICENSE

#network license retrieved from DTP
dtp.enabled=true
dtp.server=onya.mycompany.com
dtp.port=443
dtp.user=user1
dtp.password=mypassword
cpptest.license.use_network=true
 
# SOURCE CONTROL
 
scontrol.rep1.type=cvs
scontrol.rep1.cvs.root=:pserver:developer@cvs_server.domain.com:/home/cvs/scontrol.rep1.cvs.pass=mypassword 
  • No labels