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

章节目录：

关于设置

设置可以控制报告、Parasoft DTP、错误作者等配置。您可能想要创建一个包含设置的文件来：

  • 配置和使用不同项目的不同设置配置。
  • 根据需求扩展或覆盖团队设置（例如：涉及本地路径的设置）。
  • 将 GUI 指定和手动指定的设置输入 Parasoft DTP，集中处理整个团队的首选项分配和更新。
  • 无需打开 GUI 即可调整设置。
  • 如果在设置文件和 GUI 中都配置了某个选项，这些设置将覆盖 GUI 中的配置。

指定和存储设置

有两种方法可以指定设置：

  • 在一个简单的文本文件中手动输入。没有任何名称或位置要求。

  • 根据将 GUI 首选项导出到设置文件中的说明导出您的 GUI 首选项，然后根据需要调整或扩展。

    通过导出 GUI 首选项创建设置（选项）文件

    创建选项文件最便捷的方法是从 GUI 导出首选项。

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

设置可以存储在 Parasoft DTP 上（可以自动应用到连接的 C/C++test 安装程序）或本地文件中（可以通过命令行指定）。  有关如何存储和应用设置的详细信息，请参阅 C/C++test 配置概述。 

其他信息

    • 每个设置应在单独一行中输入。
    • 我们强烈建议您使用经过编码的密码，以确保身份验证成功并提高安全级别；请参阅创建编码密码。
    • 如果要从 DTP 上指定的设置导入首选项，并在 GUI 中覆盖这些设置，可以清除使用 DTP 设置选项，然后手动配置设置。
    • 如果在测试运行期间检测到任何设置问题，则将在命令行输出中报告细节。

    • 如果您正在通过开发人员或测试人员桌面端（而不是服务器机器）运行 cli 模式，应使用 tasks.clear=false 选项，以确保保存之前运行的结果。

      • 如果您在命令行运行（CLI）和 IDE 之间复用配置文件（.properties），在指定文件路径时，应考虑使用绝对路径而非相对路径，以避免由于 CLI 和 IDE 的工作目录可能不同而导致的错误配置。要想共享配置文件，您可以使用变量（作为此类文件路径的一部分）实现，例如： cpptest.custom.rules.dir=${env_var:HOME}/custom/rules

可用设置

报告设置

设置目的
build.id=[id]

指定用于标记结果的构建标识符。可以针对每个构建唯一标记，也可以标记在指定的构建期间执行的多个测试会话。构建 ID 的最大长度为 128 个字符。

默认为  ${dtp_project}-${time:yyyy-MM-dd}。例如，对于 ATM 项目，报告中包含的构建 ID 可能类似于：ATM-2017-07-07。 

以下配置指定了自定义构建 ID，该 ID 由项目名称和通过环境变量 BUILD 传递的构建编号组成：

build.id=${dtp_project}-${env_var:BUILD}

例如 ABC 项目和 CI 服务器上的构建编号 114 可以解析为 ABC-114。

report.active_rules=true|false

控制报告是否包含为测试启用的规则列表。

默认：false

report.archive=true|false

启用在指定报告位置中生成额外压缩包（.zip）的功能。该 ZIP 文件包含生成的用于构建报告的所有文件。 

此选项可以为任何报告格式生成一个压缩包（例如，HTML、PDF、SARIF 等）。 

通过生成压缩包，还可以执行报告的自定义转换，因为所有元素都会生成到指定目标文件夹。

默认：false

report.associations=true|false

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

默认：false

report.authors_details=true|false

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

默认：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

确定系统是否为所有团队成员生成详细报告（除了管理者的总结报告）。 

默认：true

report.dtp.publish.src=off|min|full

指定是否将被测源代码发布到 DTP 服务器。  

如果设置为 off，则源代码不会发布到 DTP。

如果设置为 min，则发布源代码中最小的一部分（在大多数情况下，发布没有引用源码控制的源代码，例如自动生成的代码）。

如果设置为 full，指定范围内的所有源代码都将发布到 DTP。

默认值：full（启用report.dtp.publish选项时的默认值。）

report.format=[html|html_ut_details|pdf|sarif|sarif-azure|sast-gitlab|sast-gitlab-v14|sate|cppunit|xunit|custom]

指定报告格式。要为单次运行生成不同格式的多个报告，可输入逗号分隔的列表。如果启用了“Automation”许可证功能，除了指定的报告格式之外，还会生成和保存 XML 报告。例如：

report.format=html,pdf,sarif

默认：html

report.mail.attachments=true|false

指定报告是否作为附件发送。所有组件都作为附件被包含在内；必须将所有附件都保存到磁盘才能查看带有图像的 HTML 报告。

默认：false

report.mail.cc=[email_addresses]指定发送管理者综合报告的邮件地址。该设置后必须有一列以分号分隔的电子邮件地址。此设置通常用于向管理者或架构师发送报告。如果此类报告没有自动发送（例如，团队没有使用支持的源码控制系统），该设置还可以用于向团队成员发送综合报告。
report.mail.compact=trends|links

指定通过电子邮件发送简洁报告或链接而非完整报告。 

如果使用 trends，电子邮件将包含概述表和其他简洁数据，不会包含详细数据。

如果使用 links，电子邮件仅包含报告的链接（可在 DTP 服务器上查看）。

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]

指定发送邮件的 "from" 行。

默认：<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} Report - ${config_name}。例如，如果您想要将主题行更改为“Report for Project 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 服务器身份验证指定设置。

realm 仅对使用 SASL 域进行身份验证的服务器是必需的。

report.metrics_details=true|false

指定是否生成带指标汇总信息（以及适用情况下各个类和方法的详细数据）的 XML 报告。只有在运行启用了指标的测试配置时才会生成此报告。HTML 和 PDF 报告中将显示指标详细信息。

默认：true

report.ref.report.file=[path]指定将在分析期间创建参考报告文件的位置的路径。请参阅配置任务报告首选项。
report.additional.report.dir=[directory]指定将为当前执行的测试配置生成附加 C/C++test Standard 兼容 XML 报告文件的目录路径。附加的 XML 报告文件可包含静态分析、指标、单元测试和行覆盖率结果，具体取决于执行的测试配置。此设置仅在命令行模式（CLI）下可用。
report.rules=[url_path_to_rules_directory]

此设置指定包含静态分析规则 HTML 文件目录的路径。根据该路径，HTML 报告中会添加规则文档链接。
规则 HTML 文件由工具提供，也可通过点击测试配置的静态选项卡中的打印文件按钮生成。

要在 GUI 中应用此设置，需要在 .properties 文件中进行定义，然后在报告并发布窗口的选项文件字段中提供该文件的路径。更多详细信息，请参阅生成报告。

例如：

report.rules=file:///C:/Temp/Burt/parasoft/xtest/gendoc/
report.rules=../gendoc/
report.rules=file:///<TOOL_INSTALL>/rules/docs/

默认：none

report.scontrol=off|min|full

指定报告中是否包含来自源码控制的其他信息以及包含多少信息。

如果设置为 off，报告中将不会包含源码控制的信息。

如果设置为 min，报告将包含有关资源库、文件路径以及修订的信息。

如果设置为 full，报告将包含有关资源库、文件路径、修订以及任务修订和注释的信息。

默认值：off

report.setup.problems=top|bottom|hidden

指定报告是否包含关于设置问题的部分。 

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

hidden - 不会添加“设置问题”部分。

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

默认：bottom

report.suppressed_msgs=true|false

指定报告是否包含被抑制的消息。

默认：false

report.test_params=true|false

指定报告是否包含测试参数细节。

默认：false


report.xml.param{n}.key=[id]

此设置指定一个添加到 xml 报告根元素中的自定义参数 Id。要求该 Id 具有唯一性。必须为要添加的自定义参数指定 report.xml.param{n}.key 和 report.xml.param{n}.value。

例如，以下配置指定，一个具有给定键和值的属性将被添加到 xml 报告的根元素中：

report.xml.param1.key=customId

report.xml.param1.value=12345

report.xml.param{n}.value=[value]

此设置指定一个添加到 xml 报告根元素中的自定义参数值。必须为要添加的自定义参数指定 report.xml.param{n}.key 和 report.xml.param{n}.value。

例如，以下配置指定，一个具有给定键和值的属性将被添加到 xml 报告的根元素中：

report.xml.param1.key=customId

report.xml.param1.value=12345

report.ue_coverage_details_htmls=[coverage_type]

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

可为 [coverage_type] 使用以下值：

LC - 行覆盖率
SC - 语句覆盖率
BCC - 代码块覆盖率
DC - 判定覆盖率
SCC - 简单条件覆盖率
MCDC - MC/DC 覆盖率

session.tag=[name]

指定用于标记这些结果的会话标签。该值用于将概要结果上传到 DTP。 

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

默认：${config_name}

tasks.source.control.details=true|false
此设置指定报告中是否包含来自源码控制中的附加信息，如修订和注释。


Parasoft DTP 设置

设置目的
dtp.enabled=true|false

指定当前 C/C++test 安装程序是否连接到 DTP。

dtp.url=[url]指定 DTP 服务器的 URL。 

如果 DTP 部署到主机服务器根目录以外的位置，则该 URL 应包括上下文路径（主机名的相对路径）。如果您的组织使用反向代理，则可能会是这种情况。有关反向代理服务器配置和上下文路径配置的更多信息，请参阅 DTP 文档。

示例：dtp.url=https://ada.mycompany.com:8443

包括上下文路径的示例：dtp.url=https://aurelia.mycompany.com:8443/contextPath

dtp.user=[username]指定用于 DTP 服务器身份验证的用户名。
dtp.password=[password]指示用于 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 设置自动配置的功能。

许可证设置

更多注意事项和示例，请参阅在本地文件或 DTP 项目中设置许可证。

设置目的
parasoft.eula.accepted=true|false

指定接受 Parasoft 最终用户许可协议（EULA）的条款。

默认：false

cpptest.license.use_network=true|false

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

示例：cpptest.license.use_network=true

默认：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]

指定将从许可证服务器检索的网络许可证的类型。此设置要求 cpptest.license.use_network 设置为 true。

可接受的版本名称：

  • desktop_edition：该许可证针对桌面端使用进行了优化。
  • desktop_compliance_edition：该许可证针对桌面端使用进行了优化，并配置为符合相应的编码标准。
  • server_edition：该许可证针对在服务器命令行模式下的高性能使用配置。
  • server_compliance_edition: 该许可证针对在服务器命令行模式下的高性能使用配置，并符合相应的编码标准。
  • custom_edition: 需要指定可用功能列表的自定义许可证。使用 cpptest.license.custom_edition_features 指定功能列表。

默认：custom_edition

示例：

以下配置将启用针对桌面端使用优化的许可证。
cpptest.license.use_network=true
cpptest.license.network.edition=deskop_edition

cpptest.license.custom_edition_features=[feature name]

指定要在自定义版 C/C++test 许可证中启用的功能。可以使用逗号分隔的列表来指定多个功能。

可接受的功能名称：

  • Assembly Coverage
  • Automation
  • AUTOSAR Rules
  • Code Dependency Export
  • Static Analysis
  • Coverage
  • Coverage Advisor
  • CWE Rules
  • Desktop Command Line
  • DISA STIG Rules
  • DTP Publish
  • Embedded Support
  • 流分析
  • HIC++ Rules
  • JSF Rules
  • MISRA C 2012 Rules
  • MISRA Rules
  • OWASP Rules
  • Requirements Traceability
  • Rule Wizard
  • Runtime Error Detection
  • Security Rules
  • SEI CERT C Rules
  • SEI CERT C++ Rules
  • Unit Test
cpptest.license.wait.for.tokens.time=[以分钟为单位的时间]

指定在当前许可证不可使用时，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

启用或禁用从自定义许可证服务器（独立服务器或部署在 DTP 服务器的另一个实例上的服务器）获取许可证的功能，该服务器通过 license.network.url 选项指定。

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

默认：false

license.network.url=[url]

指定用于获取许可证的许可证服务器（独立服务器或部署在 DTP 服务器的另一个实例上的服务器）的 URL。此选项要求将 license.network.use.specified.server 选项设置为 true。

如果 DTP 部署到主机服务器根目录以外的位置，则该 URL 应包括上下文路径（主机名的相对路径）。如果您的组织使用反向代理，则可能会是这种情况。独立许可证服务器不支持上下文路径。有关反向代理服务器配置和上下文路径配置的更多信息，请参阅 DTP 文档。独立许可证服务器不支持上下文路径。

示例：license.network.url=https://jade.mycompany.com:8443

包括上下文路径的示例：license.network.url=https://aurelia.mycompany.com:8443/contextPath

license.network.auth.enabled=true|false

启用或禁用使用 license.network.url 选项指定的许可证服务器的身份验证。

此选项要求将 license.network.use.specified.server 选项设置为 true。

license.network.user=[username]

指定使用 license.network.url 选项指定的许可证服务器的身份验证用户名。此选项要求将 license.network.use.specified.server 和 license.network.auth.enabled 选项设置为 true。

示例：license.network.user=JohnSnow

license.network.password=[password]

指定使用 license.network.url 选项指定的许可证服务器的身份验证密码。此选项要求将 license.network.use.specified.server 和 license.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.cli.mode=devicecode|certificate

指定用于在 OpenID Connect 服务器上验证用户身份的方法。

如果设置为 devicecode，将在 OpenID Connect 服务器上使用设备代码进行身份验证

如果设置为 certificate，将在 OpenID Connect 服务器上使用证书进行身份验证。

默认：devicecode

oidc.devicecode.token.file

指定包含用户身份验证信息的自定义令牌文件的路径。

例如：

oidc.devicecode.token.file=C:\\parasoft\\token

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

指定压缩包中是否包含详细日志。请注意，如果日志系统存在自定义配置，则不能启用该功能。

  • 详细日志存储在位于用户主目录临时位置（在 Windows 上为 <drive>:\Documents and Settings\<user>\Local Settings\Temp\parasoft\xtest）的 xtest.log 文件中。

  • 详细日志记录状态在不同会话之间保持不变（在应用程序启动时恢复）。

  • 该日志文件是一个滚动文件：它不会超过指定大小，并且每次达到最大大小时，都将创建一个备份。

默认：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.mapping{n}=[from_user, to_user]

指定特定的作者映射。

例如：

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

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

指定具体的作者姓名和电子邮件。

例如：

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

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 中指定的值，则不需要此设置。

默认：true

scope.recommended.computation=first|random指定 C/C++test 如何为每个团队成员选择推荐任务——可以随机选择 n 个任务（默认），也可以选择报告的前 n 个任务（n 是 C/C++test 根据配置每天向每个团队成员显示的最大任务数）
scope.xmlmap=true|false

指定是否根据定义了如何为特定文件或文件集分配任务的 XML 文件进行任务分配（可以在 GUI 中指定这些映射，然后将其保存在 XML 文件中）。

默认：true

scope.xmlmap.file=[file]指定定义了如何为特定文件或文件集分配任务的 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=远程资源库 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 Server 资源库定义属性 

属性说明
scontrol.rep.type=tfsTFS 资源库类型标识符。 
scontrol.rep.tfs.url=TFS 资源库 URL（如：http://localhost:8080/tfs）。
scontrol.rep.tfs.login =TFS 用户名。确保您提供的用户名与在机器上配置 TFS 资源库时使用的用户名相同。
scontrol.rep.tfs.password=TFS 密码。

文件编码设置

设置目的
fileencoding.mode=default|user|auto

定义如何计算文件编码。 

default 指定您希望使用的系统属性。

user 指示您将显式指定编码名称（使用以下设置）。

auto 自动检查使用 fileencoding.autolanguage 指定的语言的编码。

默认：default

fileencoding.user-encoding=<name_of_encoding>

如果 fileencoding.mode 设置为 user，则会指定编码名称 

有效名称有 ASCII-US、UTF-8、UTF-16、UTF-16LE、UTF-16BE 或 java.nio 规范名。 

应以 parasoft-dotNET-[codepagenumber] 形式指定

fileencoding.auto-language=<language’s numeric_code>

如果 fileencoding.mode 设置为 auto，则指定语言的数字代码。有效代码有：

  • JAPANESE = 1
  • CHINESE = 2
  • SIMPLIFIED CHINESE = 3
  • TRADITIONAL CHINESE = 4
  • KOREAN = 5

杂项设置

设置目的
console.verbosity.level=low|normal|high

为控制台视图指定详细级别。可选设置有：

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

normal：同时还显示命令行以及测试和分析期间报告的问题。

high：同时还显示警告。

默认：low

tasks.clear=true|false

在 cli 模式下启动时清除现有任务。这可以防止花费过多的时间“加载已有的结果”。 

默认：true

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]指定高级设置文件的路径；请参阅配置高级选项。

usage.reporting.enabled=true|false

启用或禁用收集匿名使用信息并发送给 Parasoft 的功能。更多信息，请阅读我们的隐私声明：https://www.parasoft.com/privacy-policy。

默认：false

在设置文件中使用变量

有关可在报告、电子邮件、Parasoft DTP 和许可证设置中使用的变量的信息，请参阅常规变量。

示例

示例 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.url=https://server1.mycompany.com:8443
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
 
# 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.url=https://onya.mycompany.com:8443
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

Need assistance? Visit our support page