章节目录:

概要

您可以通过在设置文件中配置首选项来配置 SOAtest 如何连接其他 Parasoft 系统、报告错误、判断代码作者以及执行其他功能。如果此文件中指定的参数与 GUI 首选项面板(请参阅跨团队配置 SOAtest)中的参数相同,那设置参数将覆盖 GUI 中指定的参数。也可以通过命令行将设置导入 GUI;有关该流程的更多信息,请参阅 CLI 选项页面的“-settings”或“-property”。

设置可用于:

  • 将 GUI 特定的和手动指定的设置输入到 Parasoft DTP 中,集中化整个团队的报告和首选项分配。
  • 配置和使用不同项目的不同设置配置。
  • 根据需求扩展或覆盖团队设置(例如:涉及本地路径的设置)。
  • 无需打开 GUI 即可调整设置。
  • 分享整个团队的首选项,并将不同的设置组应用到不同的项目和测试运行。 

定义设置

设置在 .properties 配置文件中定义。在一个简单的文本文件中手动输入。没有任何名称或位置要求。每个设置应该在一行中输入。

您还可以根据将 GUI 首选项导出到设置文件中所述导出 GUI 首选项,以快速创建文件并根据需求进行调整或扩展。

在首选项设置中使用变量

您可以在首选项配置设置中使用以下变量。会话标记值不能包含任何冒号字符(:)。

env_var

此变量指定环境变量的值。在关闭花括号之前使用冒号后跟系统环境变量的值来输出环境变量的值。

示例:

session.id=${env_var:HOME}

project_name

输出测试项目名称。如果提供多个项目作为输入,则打印测试项目的名称,并在后面加上省略号(...)。

示例:

build.id=${dtp_project}-${time}

general_project

输出结果链接到一般 DTP 项目的名称。只适用于连接到DTP。 

示例:

build.id=${general_project}

workspace_name

输出空间名称或 Visual Studio 解决方案名称。

示例:

report.mail.subject=Code Review Scanner Results for ${workspace_name}

config_name

输出执行测试项目的名称。仅适用于报告和邮箱设置。

示例:

report.mail.subject=Findings from running ${config_name} on the ${project_name}

analysis_type

输出一个逗号分隔的已启用分析类型列表(例如: Static、Execution)。仅适用于报告和邮箱设置。

示例:

report.mail.subject=${analysis_type} findings

tool_name

输出工具名称。

示例:

report.mail.subject=Tests executed by ${tool_name}


time

输出当前时间。默认为 yyyy-MM-dd。您可以自定义格式,例如:

${time:yyyy-MM-dd-HH.mm}

指定要使用的设置

您可以将设置存储在 DTP 中,从而自动应用到连接的工具,或是存储在本地文件中,然后通过命令行指定。 

针对单个测试运行可激活多层设置。

有关如何存储和应用设置的详情,请参阅跨团队配置 SOAtest。 

其他说明

  • 每个设置应该在一行中输入。
  • 如果一个参数已在设置中指定,它将覆盖 GUI 中指定的相关参数。如果一个参数未在设置中指定,将使用 GUI 中指定的参数。
  • 如果引入了 DTP 中指定设置的首选项,并且您想覆盖 GUI 中的这些设置,那么您可以禁止相应页面上的使用 DTP 设置选项,然后手动配置设置。
  • 如果在测试运行期间检测到任何设置问题,则将在命令行输出中报告细节。
  • 如果您正在从开发人员或测试人员桌面端(而不是服务器机器)运行 cli 模式,请使用 tasks.clear=false 选项,以确保保存之前运行的结果。

报告设置

设置目的
build.id

指定用于标记结果的构建标识符。对于每个构建,它可能是独一无二的,但也可能标记在指定的构建期间执行的多个测试会话。构建 ID 的最大长度为 128 个字符。

默认:  ${dtp_project}-${time:yyyy-MM-dd}

report.active_rules=true|false

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

默认:false

report.archive=true|false

启用指定报告位置中生成其他压缩存档(.zip)。ZIP 文件包含生成用于构建报告的所有文件。 

此选项可以为任何报告格式生成一个压缩包(如:HTML、CSV、PDF等等)。 

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

默认:false

report.associations

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

默认:false

report.authors_details

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

默认:true

report.contexts_details

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

默认:false

report.coverage.version 

指定 XML 覆盖率报告的版本。可接受的值:

1 - 基础版(旧版)覆盖率报告。

2 - 优化的 XML 报告。 

默认为 2

report.custom.extension

report.custom.xsl.file

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

有关详情和示例,请参阅配置报告设置

report.developer_errors=true|false

确定管理员报告是否包含团队成员任务的细节。

默认:false

report.developer_reports=true|false

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

默认:true

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

指定报告格式。

默认:html

report.generate_htmls=true|false

确定是否生成 HTML 报告,并将其保存在本地文件系统上。不管该设置的值是多少,都会生成和保存 XML 报告。

默认:true

report.location_details=true|false

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

默认:false

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.port=[port]

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

默认:25

report.mail.security=[SL| STARTTLS| NONE]指定所需安全性。可用设置为 SSL、STARTTLS、NONE。SSL 不适合用于 Visual Studio。
report.mail.server=[server]指定用于发送报告的邮箱服务器。
report.mail.subject=My New Subject

指定邮件发送的主题行。主题行默认为 ${tool_name} Report - ${config_name}。例如,如果您想要更改主题行为 "SOAtest Report for Project A",您可以使用

report.mail.subject=SOAtest 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.organize_security_findings_by=CWE|OWASP2021

指定 API 安全报告是按 CWE 还是 OWASP 2021 Top 10 排序

默认:CWE

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.setup.problems=top|bottom|hidden

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

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

hidden - 防止添加“设置问题”部分。

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

默认:底部

report.suppressed_msgs=true|false

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

默认:false

report.test_params=true|false

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

默认:false

report.test_suites_only=true|false

确认测试套件汇总报告部分是只列出 .tst 文件(需要启用该选项),还是显示每个 .tst 文件中的树状视图(需要禁用该选项)。仅用于 SOAtest

默认:true

report.ue_coverage_details_htmls=[coverage_type]

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

以下值可用于 [coverage_type]:

LC - 行覆盖率

session.tag=[name]

指定用于标记这些结果的会话标签。标签是在分析过程中检查模块的标识符。不同模块的报告应该用不同的标签标记。

默认:${config_name}

tasks.source.control.details=true|false

此设置指示报告中是否包含来自源码控制中的附加信息,如修订和评论。

DTP 设置

设置目的
dtp.autoconfig=true|false

使用 DTP 中存储的设置启用自动配置。该设置不适用于 GUI,在导入过程中会被忽略(有关该流程的更多信息,请参阅 CLI 选项页面的 “-settings”或“-property”)。

默认:false

dtp.enabled=true|false

确定 SOAtest 或 Virtualize 是否连接到 DTP。 

默认:false

dtp.url=[url]指定 DTP 服务器的 URL。包括协议和主机名或 IP 地址,如果适用,还需包括端口号和上下文路径。
dtp.user=[username]指示用于 DTP 用户身份验证的用户名。
dtp.password=[password]

指示用于 DTP 用户身份验证的密码。

强烈建议对密码进行编码,以保证成功进行身份验证和安全连接。可以使用 -encodepass 标志运行 SOAtest 的命令行实例对密码进行编码。命令行工具将生成编了码的字符串,并且可在配置文件中使用。 

更多信息,请参阅CLI 选项

report.dtp.publish=true启用或禁用将测试结果数据发布到 DTP。
dtp.project=[project_name]

指定要将这些结果连接的 DTP 项目名称。 

有关整个项目的详情,请参阅连接到 DTP

默认:默认项目

应用程序覆盖率设置

设置目的
application.coverage.enabled=true|false

指定是否启用应用程序覆盖率。

默认:false

application.coverage.agent.url=[url]

指定托管被测应用程序和覆盖率代理的 URL。包括协议(HTTP/HTTPS)和端口。用分号(;)分隔多个条目。

示例:http\://<AGENT_HOST>\:8050;http\://<AGENT_HOST>\:9050

application.coverage.user.id=[username]

指定用户 ID,以便将覆盖率结果与特定用户关联。只有当覆盖率代理被配置为以多用户模式运行时,才应该指定用户 ID。

详情请参阅 DTP 引擎文档。

application.coverage.dtp.publish=true|false

指定是否将覆盖率报告上传到 DTP。如果配置了多个覆盖率代理,它们的覆盖率报告将合并为一份 DTP 覆盖率报告。

默认为 report.dtp.publish 的值,或者如果向 soatestcli 传递了 -publish,则默认为 true

application.coverage.binaries=[file|URL] 指定包含被测应用程序(AUT)二进制文件的 URL 或本地文件。您可以指定文件夹或 .war、.jar、.zip 或 .ear 文件的路径。可选项。如果静态覆盖率文件单独上传到 DTP,则不需要。如果指定了 application.coverage.static.file,则不应使用。
application.coverage.binaries.exclude=[pattern]

指定以逗号分隔的二进制文件形式,以便在 AUT 扫描期间将其排除在外。可选项。如果不使用,二进制文件的分析时间会更长,分析的应用程序也会超出需要。如果指定了 application.coverage.static.file,则不应使用。默认情况下,接受所有二进制文件。支持以下通配符:

* 匹配零个或多个字符

示例: *HelpPage*

application.coverage.binaries.include=[pattern]

指定以逗号分隔的二进制文件形式,以便在 AUT 扫描期间将其包括在内。可选项。如果不使用,二进制文件的分析时间会更长,分析的应用程序也会超出需要。如果指定了 application.coverage.static.file,则不应使用。默认情况下,接受所有二进制文件。支持以下通配符:

* 匹配零个或多个字符

示例: *qademo_webapp*

application.coverage.static.file=[file|URL]

指定使用 dotTEST 或 Jtest 生成的静态覆盖文件的 .xml 或 .data 格式 URL 或本地文件。可选项。如果静态覆盖率文件单独上传到 DTP,则不需要。如果指定了 application.coverage.binaries,则不应使用。

更多信息,请参阅创建自定义测试配置

示例:static_coverage.xml

application.coverage.images=$[dtp_project]

指定一组标签,用于在 DTP 中创建覆盖率图像。覆盖率图像为唯一标识符,用于汇总具有相同构建 ID 的各个运行的覆盖率数据。用分号(;)分隔多个条目。

详情请参阅 Parasoft DTP 用户指南。

示例: ${dtp_project};${dtp_project}_Functional Test

application.coverage.runtime.dir=[directory]指定保存运行时覆盖率数据副本的目录。如果未指定目录,则处理后不会保存运行时覆盖率数据。可选项。
application.coverage.test.associations=true|false

启用测试关联与运行时覆盖率数据的存储功能。如果设置为 false,运行时覆盖率数据将只记录覆盖了哪些行,而不记录哪些测试用例覆盖了哪些行

默认:true

许可证设置

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

启用/禁用基于网络的许可证。

设为 true 并配置许可证服务器设置(license.network.url)或 Parasoft DTP Settings以使用网络许可证。  

使用本地许可证,请将此选项设置为 false,并且配置 soatest.license.local.password 设置。

例如:soatest.license.use_network=true

默认:true

license.network.url=[url]

指定许可证服务器 URL。包括协议和主机名或 IP 地址,如果适用,还需包括端口号和上下文路径。

示例:https://10.9.1.63:8443

license.network.user=[username] 

指定通过 license.network.url 选项指定的次要 DTP 服务器上用于身份验证的用户名。

此选项要求将 license.network.use.specified.serverlicense.network.auth.enabled 选项设置为 true

示例:license.network.user=JohnDoe

license.network.password=[password] 

指定通过 license.network.url 选项指定的次要 DTP 服务器上用于身份验证的密码。

此选项要求将 license.network.use.specified.serverlicense.network.auth.enabled 设置为 true,并且 license.network.user 已经配置。

强烈建议对密码进行编码,以保证成功进行身份验证和安全连接。可以使用 -encodepass 标志运行 SOAtest 的命令行实例对密码进行编码。命令行工具将生成编了码的字符串,并且可在配置文件中使用。 

更多信息,请参阅CLI 选项

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

此选项允许 SOAtest 连接 DTP 或许可证服务器,或同时出现的两个 DTP 实例。

如果要检索使用Parasoft DTP Settings指定的 DTP 服务器的许可证,请将此选项设置为 false。 

如果设置为 true,SOAtest从 license.network.url 选项指定的服务器上获取许可证。 

license.network.auth.enabled=true|false

启用或禁用通过 license.network.url 选项指定的次要 DTP 服务器上的身份验证。

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

soatest.license.network.edition=[edition_name]

指定从许可证服务器检索的许可证类型。 

[edition_name] 可以是 server_edition。如要使用自定义版本,请不要在 "="; 设置任何内容,只是让值未空即可。

示例:

soatest.license.network.edition=desktop_edition

soatest.license.network.edition=server_edition

默认: custom_edition

soatest.license.autoconf.timeout=[seconds]

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

默认:20

soatest.license.local.password=[password]

指定 Parasoft 提供的本地许可证。 

soatest.license.wait.for.tokens.time=[time in minutes]

指定在当前许可证不可使用时,等待许可证的时间。 

示例:

soatest.license.wait.for.tokens.time=3.

默认:0

OIDC 设置

设置目的
oidc.enabled=true|false

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

默认:false


oidc.issuer.uri=[uri]

指定 OpenID Connect 服务器的 URI。

示例:

oidc.issuer.uri=http://server.com/

oidc.client.id=[user]

指定 OpenID Connect 服务器提供的 ID。


oidc.client.secret=[password]

指定应用程序连接 OpenID Connect 服务器的密码。


oidc.scopes=[list of scopes]

指定以空格分隔的范围列表,用于在身份验证过程中授权访问用户的详细信息。

默认:openid profile offline_access


oidc.cli.mode=devicecode|certificate

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

默认:devicecode


oidc.devicecode.token.file=[path]

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

示例:

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

技术支持设置

设置目的
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:
    • <USER>\AppData\Local\Temp\parasoft\techsupport
  • 在 macOS 上会生成随机路径:
    • var/folders/<PATH>/<USER>/parasoft/techsupport
  • Linux:
    • /tmp/<USER>/parasoft/techsupport

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

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

默认: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]指定技术团队要求您输入的任何高级选项。

原创作者及范围设置

设置目的
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.ignore.case=true|false

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

默认:false

scope.sourcecontrol=true|false

确定是否基于所支持的源码控制系统的数据计算代码作者。 

默认:false

scope.local=true|false

确定是否基于本地用户计算代码作者。

默认:true

scope.recommended.computation=first|random

确定如何为每个团队成员选择推荐的任务。可以设置以下模式:

random:(默认)分配随机数任务。

first:每天向每个团队成员显示报告的第一个任务。

scope.xmlmap=true|false

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

默认:true

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

源码控制设置

对相同类型的多个资源库进行定义

如果要定义相同类型的多个资源库,必须在前缀上添加索引(从 1 到 n 的数字)。例如: 

scontrol.rep1.type=ccase
scontrol.rep1.ccase.vob=/vobs/myvob1

scontrol.rep2.type=ccase
scontrol.rep2.ccase.vob=/vobs/myvob2

如果只定义一个资源库,则不需要使用索引。例如:

scontrol.rep.type=ccase
scontrol.rep.ccase.vob=/vobs/myvob1

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.tfs.sdk.path=

TFS SDK 解压后根目录的路径。这对于在您的计算机上运行 TFS 支持而言是必需的。

示例:scontrol.tfs.sdk.path=C:\Users\user\parasoft\libraries\TFS-SDK-14.134.0 

注意:要求 TFS SDK 14.134 版本。

scontrol.rep.tfs.url=TFS 资源库 URL(如:http://localhost:8080/tfs)。
scontrol.rep.tfs.login=TFS 用户名。
scontrol.rep.tfs.password=TFS 密码。

文件编码设置

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

定义如何计算文件编码。 

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

user 指示您将显示指定编码名称(使用以下设置)。

auto 启动自动检查 fileencoding.autolanguage指定的 Far-East 语言。

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

Miscellaneous 设置

设置目的
tasks.clear=true|false

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

默认:true

console.verbosity.level=low|normal|high

为控制台视图指定冗长级别。可用设置有:

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

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

high:同时还显示警告。

默认:normal

soatest.custom.rules.dir=[directory]

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

soatest.custom.configs.dir=[directory]

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

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

确定激活以下哪个模式: 

  • 自动:SOAtest 控制并行处理设置。
  • 手动:允许您手动配置并行处理设置以满足您的特定需求。
  • 无效的:仅使用其中一个 CPU。

有关此和其他并行处理选项的详情,请参阅配置并行处理

默认:自动模式

parallel.max_threads=<number>

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

默认:[available_processors]

parallel.free_memory_limit=<percentage>

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

默认:25

parallel.no_memory_limit=true|false

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

默认:false

usage.reporting.enabled=true|false

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

默认:false

SOAtest/Virtualize 的其它选项

设置目的

datasources.jdbc.classpath=[path1];[path2];[path3] ...

指示 JDBC 驱动器 jar 文件和类文件夹的位置。

特殊符号(空格、斜线、冒号等等)必须转义;例如: 

%20 = SPACE
%3A = :
%5C = \
%7B = {
%7D = }
%24 = $

如果列出多个 jar,使用 \n 作为分隔符。

例如,C:\temp\withspace\${example}\jar.jar

变成

C%3A%5Ctemp%5Cwith%20space%5C$2 4%7Bexample%7D%5Cjar.jar\n 

scripting.jython.path添加一个目录列表,用于搜索尚未包含在 Jython 中的 Python 模块。可以使用操作系统默认的路径分隔符(Windows 为“;”,Linux 和 macOS 为“:”)列出多个路径。
scripting.timeout.minutes指示产品试图停止无响应的脚本并记录错误消息的分钟数。

system.properties.classpath=[path1];[path2];[path3] ...

指定 classpath 中的 jar 文件和类文件夹。例如:

system.properties.classpath=C\:\\myjars\\myLib1.jar;C\:\\myjars\\myLib2.jar

xml.conversion.data.model.directories注册数据模型,该模型指定如何将定长的数据转换为 XML 或从 XML 转换为 XML。输入一个分号分隔的目录列表,其中包含适当的数据模型。
browsertesting.chrome_executable_path指定 Chrome 可执行文件路径。 
browsertesting.firefox_executable_path=[path]指定 Firefox 可指定的路径。
browsertesting.proxy_port=[port]指定代理端口。更多详情和提示,请参阅 SOAtest 用户指南 > 代理配置详情。
browsertesting.browser_communication_port=[port]指定浏览器通讯端口。
browsertesting.startup_timeout=[seconds]指定 SOAtest 应该停止等待浏览器启动并将其视为“超时”的延迟长度(以秒为单位)。
browsertesting.user_action_timeout=[seconds]指定 SOAtest 应该停止等待用户操作并将其视为“超时”的延迟长度(以秒为单位)。
browsertesting.page_load_timeout=[seconds]指定 SOAtest 应该停止等待页面加载并将其视为“超时”的默认延迟长度(以秒为单位)。

browsertest-
ing.asynchronous_request_timeout=[seconds]

指定 SOAtest 应该停止等待异步请求并将其视为“超时”的默认延迟长度(以秒为单位)。
browsertesting.element_timeout=[seconds]指定 SOAtest 应该停止等待元素并将其视为“超时”的延迟长度(以秒为单位)。
browsertesting.dialog_timeout=[seconds]指定 SOAtest 应该停止等待打开对话框并将其视为“超时”的默认延迟长度(以秒为单位)。
browsertesting.http_traffic_timeout=[seconds]

指定 SOAtest 应该停止等待完成加载的通讯报文并将其视为
“超时”的默认延迟长度(以秒为单位)。

browsertesting.print_debug_info=true|false在录制浏览器功能测试场景过程中,SOAtest 有可能不会记录所进行的操作。启用此选项将允许消息在录制期间打印到控制台,其中包含了关于 SOAtest 处理了哪些事件、可能生成的任何定位器,以及在录制期间发生的任何异常的消息。

browsertest-
ing.allowable_binary_extensions=[extensions]

允许在通讯报文查看器和输出中使用具有指定扩展名的二进制文件。默认情况下,仅允许文本文件。扩展列表以逗号分割。

browsertest-
ing.allowable_binary_mimetypes=[mime_types]

允许在通讯报文查看器和输出中使用具有指定 MIME;类型的二进制文件。默认情况下,仅允许文本文件。MIME 类型列表以逗号分割。
browsertesting.content_fetch_mode=all.con-tent|non.hidden.iframes能够确定隐藏框架内容是否在 pre- 和 post- 操作的查看器中显示。  有关此设置的详情,请参阅 SOAtest 用户指南。
security.trust.all.certificates指示要接受的任何证书。这对于加载证书不被“信任的”页面而言非常有用。
security.use.default.java.cacerts指示只接受来自 Java 受信任证书供应商的标准列表中的证书。

仅用于 Virtualize 的其他选项

请注意,SOAtest/Virtualize 的其他选项中包含的选项也适用于 Virtualize。

设置目的
server.startup确定服务器是否在 Virtualize 启动时自动启动。
server.port.http指定 Virtualize 服务器用于 HTTP 的端口。
server.port.https指定 Virtualize 服务器用于 HTTPS 的端口。
server.port.monitoring指定 Virtualize 服务器用于监控的端口。
traffic.wizard.xpath.ignores

格式中指定的排除: 

traffic.wizard.xpath.ignores=[element name 1]:[value pattern 1];[element name 2]:[value pattern 2];[element name 3]:[value pattern 3]

例如:

traffic.wizard.xpath.ignores=*:[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0- 9]{2}:[0-9]{2}([.][0-9]{1,3})?(([+-][0-9]{2}:[0- 9]{2})|Z)?;uuid:[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}

请注意,当在正则表达式中使用反斜杠(\)时,需要进行转义。例如,表示单个数字的正则表达式 [\d],应输入为 [\\d]。

持续测试平台(CTP)的其他选项

设置目的
env.manager.server

指示 CTP 服务器的位置。必须

例如:env.manager.server=http://em_hostname:8080/

env.manager.server.name

指定将用于在 CTP 中标识该服务器的名称。可以指定任何有助于识别此服务器的值。可选

例如:env.manager.server.name=MyVirtServerLabel

env.manager.notify

确定 Virtualize 服务器在部署虚拟资产时是否通知 CTP。可选

例如:env.manager.notify=true

env.manager.username

指定登录到 CTP 的用户名。可选

例如:env.manager.username=me

env.manager.password

指定登录到 CTP 的密码。可选

例如:env.manager.password=12345

强烈建议对密码进行编码,以保证成功进行身份验证和安全连接。可以使用 -encodepass 标志运行 SOAtest 或 Virtualize 的命令行实例对密码进行编码。命令行工具将生成编了码的字符串,并且可在配置文件中使用。

更多信息,请参阅CLI 选项

样本设置

示例 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

# 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
 
#override license settings
#soatest.license.autoconf.timeout=40
soatest.license.use_network=true
soatest.license.network.url=http://license_server.domain.com:2222
soatest.license.network.edition=server_edition
 
# 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