...
| Table of Contents | ||
|---|---|---|
|
概要
你可以通过在 您可以通过在 localsettings 文件中配置首选项来配置 SOAtest 如何连接到其他 Parasoft 系统、报告错误、决定代码来源以及执行其他功能。如果此文件中指定的参数与 GUI 首选项面板（请查阅 跨团队配置 SOAtest）中的参数相同，那 localsettings 中的参数将覆盖 GUI 中指定的参数。Localsettings 可用于：
...
在 .properties 配置文件中定义 localsettings。在一个简单的文本文件中手动输入它们。没有任何名称或位置要求。每个本地设置应该在一行中输入。
你还可以如 您还可以如 Exporting GUI Preferences to a localsettings File 所述导出 GUI 首选项，以快速创建文本并根据需求对它们进行调整或扩展。
在首选项设置中使用变量
你可以在首选项配置设置中使用以下变量：会话标记值不能包含任何冒号字符（您可以在首选项配置设置中使用以下变量：会话标记值不能包含任何冒号字符（:）。
| Scroll Table Layout | ||
|---|---|---|
|
| env_var | 此变量指定环境变量的值。在关闭花括号之前使用冒号后跟系统环境变量的值来输出环境变量的值。 例如：
|
|---|---|
| project_name | 输出测试项目名称如果提供多个项目作为输入，则打印测试项目的名称，并在后面加上省略号（...）。 例如：
|
| general_project | 输出结果链接到一般 DTP 项目的名称。只适用于连接到DTP。 例如：
|
| workspace_name | 输出空间名称或 Visual Studio 解决方案名称。 例如：
|
| config_name | 输出执行测试项目的名称仅适用于报告和邮箱设置。 例如：
|
| analysis_type | 输出一个逗号分隔的已启用分析类型列表（例如: Static、Execution）。仅适用于报告和邮箱设置。 例如：
|
| tool_name | 输出工具名称。输出测试项目名称 例如：
|
指定要使用的 localsettings
你可以将 您可以将 localsettings 存储在 DTP 中，它会自动将其应用到连接的工具；或者是，存储在本地文件中，可以从命令行指定它们。
...
- 每个设置应该在一行中输入。
- 如果一个参数已在 localsettings 中指定，则它将覆盖 GUI 中指定的相关参数。如果一个参数未在 localsettings 中指定，则将使用 GUI 中指定的参数。
- 如果引入了 DTP 中指定 localsettings 中的首选项，并且你想覆盖 中的首选项，并且您想覆盖 GUI 中的这些设置，那么你可以禁止正确页面上的中的这些设置，那么您可以禁止正确页面上的 Use DTP settings 选项，然后手动配置。
- 如果在测试运行期间检测到任何 localsettings 问题，则将在命令行输出中报告细节。
- 如果你正在从开发人员或测试人员的桌面（而不是服务器机器）运行 如果您正在从开发人员或测试人员的桌面（而不是服务器机器）运行 cli 模式,请使用
tasks.clear=false选项，以确保保存以前运行的结果。
...
| 设置 | 目的 |
|---|---|
build.id | 指定用于标记结果的生成标识符。对于每个构建，它可能是独一无二的，但也可能标记在指定的构建期间执行的多个测试会话。 默认：build-yyyy-MM-dd HH:mm:ss |
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 |
| 为自定义格式指定 XSL 文件的位置和扩展名。同 有关更多详情和示例，请查阅配置报告设置 |
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.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 | 确定报告是否发送给团队成员和 记住，每个分配任务的团队成员都会自动收到一份只包含分配任务的报告。 默认：false |
report.mail.exclude=[email_addresses] | 指定不希望接收到报告的邮箱地址。此设置防止将报告自动发送给处理代码的人，但他不应接收报告。 |
report.mail.exclude.developers=true|false | 指定报告是否应该发送给 默认：false |
report.mail.format=html|ascii | 指定邮件格式。 默认：html |
report.mail.from=[email_address OR user_name_of_the_same_domain] | 指定邮件发送 “from” 行。 默认： |
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.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 服务器身份验证指定设置。
|
report.metrics_details=true|false | 确定是否生成带度量汇总信息（以及适用的个别类和方法详细数据）的 XML 报告。只有在运行启用度量标准的测试配置时才会生成此报告。HTML 和 PDF 报告中将显示度量详情。 默认：true |
report.setup.problems=top|bottom|hidden | 确定报告是否包含关于配置问题的部分。
默认：底部 |
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] | 指定用于标记这些结果的会话标签。该值用于上传汇总结果到团队服务器。 标记是在分析过程中检查模块的标识符。不同模块的报告应该用不同的标签标记。 默认： |
tasks.source.control.details=true|false | 此设置指示报告中是否包含来自源代码控制中的附加信息，如修订和评论。 |
...
| 设置 | 目的 |
|---|---|
dtp.autoconfig=true|false | 使用 DTP 中存储的设置启用自动配置 默认：false |
dtp.enabled=true|false | 确定 SOAtest 或 Virtualize 是否连接到 DTP。 默认：false |
dtp.user=[username] | 指示用于 DTP 用户身份验证的用户名。 |
dtp.password=[password] | 指示用于 DTP 用户身份验证的密码。 |
report.dtp.publish=true | 启用或禁用将测试结果数据发布到 DTP。 |
dtp.server=[host] | 指定 Paradsoft DTP 服务器的主机名。 |
dtp.project=[project_name] | 指定要将这些结果连接的 DTP 项目名称。 有关整个项目的更多详情，请查阅 连接到 DTP 默认：默认项目 |
concerto.user_defined_attributes=[attributes] | 指定项目中心的用户定义属性。 使用格式 有关属性的更多详情，请查阅 连接到 DTP |
concerto.log_as_nightly=true|false | 确定发送到项目中心的结果是否标记为来自夜间构建。 默认：false |
concerto.use_resource_attributes=true|false | 确定是否应该使用项目级别 GUI 中指定的项目中心属性。这允许你禁用项目级别的项目中心属性。中指定的项目中心属性。这允许您禁用项目级别的项目中心属性。 默认：true |
concerto.data.port=[port] | 指定项目中心端口。 默认：32323 |
concerto.reporting=true|false | 确定当前安装是否连接到项目中心。 默认：false |
...
| 设置 | 目的 |
|---|---|
tcm.server.enabled=true|false | 启用或禁用到 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] | 确定连接团队服务器是否提交用户名和密码。并不总是需要用户名和密码，这取决于你的团队设置。 确定连接团队服务器是否提交用户名和密码。并不总是需要用户名和密码，这取决于您的团队设置。 如果第一个设置为 请注意，在使用这些设置之前，团队服务器必须已经启用了用户名和密码设置。 tcm.server.accountLogin default: false |
...
| 设置 | 目的 |
|---|---|
techsupport.auto_creation=true|false | 确定在发生测试问题时是否自动准备了存档。 默认：false |
techsupport.send_email=true|false | 确定准备的存档是否发送给 Parasoft 支持部门。如果启动该功能，请确保从 GUI 或 Reporting Settings中选项的指定邮箱设置。 默认：false |
techsupport.archive_location=[directory] | 指定存档存储的位置。 |
techsupport.verbose=true|false | 确定存档中是否包含详细日志。请注意，如果日志系统存在自定义配置，则不可启用该功能。
默认：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.mappings.location=team|local|shared | 指定存储原创作者映射文件的位置。此设置默认指定为 如果设置为 如果设置为 不建议使用
默认： team |
authors.mapping{n}=[from_user, to_user] | 如上所述，为 例如：
|
authors.user{n}=[username, email, full_name] | 为 例如：
|
authors.mappings.file=[path] | 指定上述 例如：
|
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 | 确定如何为每个团队成员选择推荐的任务。可以设置以下模式：
|
scope.xmlmap=true|false | 确定是否基于 XML 文件计算任务分配，该文件定义了如何为特定文件或文件集分配任务（可以在 GUI 中指定这些映射，然后将其保存在 XML 文件中）。 默认：true |
scope.xmlmap.file=[file] | 指定 XML 文件的名称，该文件定义了如何为特定文件或文件集分配的任务。 |
...
| 属性 | 说明 |
|---|---|
scontrol.rep.type=starteam | StarTeam 存储库类型标识符。 |
scontrol.rep.starteam.host= | StarTeam 服务器主机。 |
sscontrol.rep.starteam.port= | StarTeam 服务器端口。默认端口为 49201。 |
scontrol.rep.starteam.login= | 登录名。 |
scontrol.rep.starteam.password= | 登录密码（未编码的）。 |
scontrol.rep.starteam.path= | 当使用大型多项目存储库时，你可以通过制定项目、视图或当前使用的文件夹来提高性能。 当使用大型多项目存储库时，您可以通过制定项目、视图或当前使用的文件夹来提高性能。 你可以表明一个简单的项目名称（搜索存储库路径时将扫描所有视图），或一个项目您可以表明一个简单的项目名称（搜索存储库路径时将扫描所有视图），或一个项目/视图（将只扫描给定的视图），或项目/视图/文件夹（将只扫描指定的 Star Team 文件夹）。 例如：
|
scontrol.rep.starteam.workdir= | 如果 例如：
|
...
| 设置 | 目的 |
|---|---|
fileencoding.mode=default|user|auto | 定义如何计算文件编码。
默认：默认 |
fileencoding.user-encoding=<name_of_encoding> | 如果 有效名称有 ASCII-US、UTF-8、UTF-16、UTF-16LE、UTF-16BE 或 java.nio 规范名。 它应该以形式 |
fileencoding.auto-language=<language’s numeric_code> | 如果
|
...
| 设置 | 目的 |
|---|---|
report.rules=[url_path_to_rules_directory] | 为规则 html 文件指定目录（通过单击测试配置的静态分析选项卡中的 例如：
默认：none |
tasks.clear=true|false | 在 cli 模式下启动时清除现有任务。这可以防止花费过多的时间“加载现有结果”。 默认：true |
console.verbosity.level=low|normal|high | 为控制台视图指定冗长级别。可用设置有：
默认：低 |
soatest.custom.rules.dir=[directory] | 指示用户定义规则保存的位置。 |
soatest.custom.configs.dir=[directory] | 指示用户定义规则测试配置保存的位置。 |
exec.env=[env1; env2; ...] | 指定描述执行测试会话环境的标签列表。标签可以描述操作系统（如：Windows、Linux）、体系结构（如：x86、x86_64）、浏览器等等。这些标签描述了一个完整的测试会话；还可以通过服务 API 在测试套件、测试或测试用例级别上添加更多的环境细节。 |
issue.tracking.tags=[value] | 指定自定义问题跟踪标签。多个标签可以用逗号分隔。例如：
有关更多详情信息，请查阅 指示代码和测试相关性. |
parallel.mode=Manual|Auto|Disabled | 确定激活以下哪个模式：
有关此和其他并行处理选项的更多详情，请查阅 配置并行处理 默认：自动模式 |
parallel.max_threads=<number> | 指定可并发执行的并行线程的最大数。并行线程的实际数量是根据 CPU 数量、可用的内存和许可证设置。 默认：[available_processors] |
parallel.free_memory_limit=<percentage> | 指定低内存条件下应保持空闲的内存数量（用应用程序可用的总内存的百分比来表示）。这用来确保其他进程可用的闲置内存。 默认：25 |
parallel.no_memory_limit=true|false | 指示不希望对可用内存施加任何限制（超出现有系统限制）。 默认：false |
...
| 设置 | 目的 |
|---|---|
| 指示 JDBC 驱动器 jar 文件和类文件夹的位置。 特殊符号（空格、斜线、冒号等等）必须转义；例如： %20 = SPACE 如果列出多个 jar，使用 \n 作为分隔符。 例如， 变成
|
scripting.jython.home | 指定 Jython 安装目录。这必须是单个目录。使用转义斜线（/）或反斜线转义特殊字符。 |
scripting.jython.path | 用来添加到不在 jython.home/Lib 目录的路径模块可以列出多个路径。使用转义斜线（/）或反斜线转义特殊字符。 |
scripting.timeout.minutes | 指示产品试图停止无响应的脚本并记录错误消息的分钟数。 |
| 指定类路径中的 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 应该停止等待页面加载并将其视为“超时”的默认延迟长度（以秒为单位）。 |
| 指定 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 处理了哪些事件、可能生成的任何定位器，以及在录制期间发生的任何异常的消息。 |
| 允许在流量视图器和输出中使用具有指定扩展名的二进制文件。默认情况下，仅允许文本文件。扩展列表以逗号分割。 |
| 允许在流量视图器和输出中使用具有指定 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 受信任证书供应商的标准列表中的证书。 |
...
| 设置 | 目的 |
|---|---|
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 |
...