本主题介绍如何在 SOAtest 和 Virtualize 服务器中使用测试配置。章节目录:

前言

测试配置是确定如何执行和报告测试的设置集合。SOAtest 和 Virtualize 服务器提供以下默认配置: 

  • Run Automated Server Tests.properties 位于 <INSTALL>/soavirt/WEB-INF/configs/builtin 文件夹中。在此配置中,启用了报告所有测试通讯报文的选项。它旨在用于执行持续测试平台的测试。
  • Example Configuration.properties 位于 <WORKSPACE>/TestAssets/configs/user 文件夹中。已禁用报告所有测试通讯报文选项。 

可以在测试配置文件中启用或禁用属性,根据需要进行自定义。还可以创建自定义测试配置,并将其添加到工作空间中,用于在项目中执行测试。 

内置测试配置

可以在调用时指定 builtin:// 和测试配置名称来运行内建测试配置。在下面的示例中,测试将按照默认的 Run Automated Server Tests 配置执行:

{
  "general": {
    "config": "builtin://Run Automated Server Tests",

有关可在测试配置中自定义的属性信息,请参阅Test Configuration Properties。如果文件夹中没有指定名称的测试配置,测试将无法运行。

用户自定义测试配置

可以在调用时指定 user:// 和测试配置名称,从而运行用户自定义测试配置。在下面的示例中,测试将按照默认的示例配置执行:

{
  "general": {
    "config": "user://Example Configuration",

可以在 <WORKSPACE>/TestAssets/configs/user 文件夹中添加其他测试配置,并使用 user://<TEST_CONFIG_NAME> 语法执行。您可以通过创建默认配置的副本来添加测试配置,对其进行修改,以不同的方式进行测试。有关可在测试配置中自定义的属性信息,请参阅Test Configuration Properties

如果文件夹中没有指定名称的测试配置,测试将无法运行。

测试配置属性

可以修改 Run Automated Server Tests.properties 文件的以下设置,以及您想要创建的任何自定义用户配置(请参阅User Configurations)。

功能测试属性

com.parasoft.xtest.execution.api.web.execute_functional_tests

此设置启用/禁用功能测试执行。将该属性设置为 true,启用功能测试执行。默认是 true

示例

com.parasoft.xtest.execution.api.web.execute_functional_tests=true

com.parasoft.xtest.execution.api.web.report_successful_traffic

该设置启用/禁用 API 覆盖率报告中的“测试通讯报文 [所有测试]”部分。该部分包含所有测试执行的通讯报文,无论测试是否成功。将该属性设置为 true 以在报告中包含测试通讯报文[所有测试]部分。默认是 true

示例

com.parasoft.xtest.execution.api.web.report_successful_traffic=true

com.parasoft.xtest.execution.api.web.report_traffic_limit

此设置指定在测试执行会话期间存储的通讯报文数据总量(以 KB 为单位),而不是每个测试存储的数据量。必须启用 com.parasoft.xtest.execution.api.web.report_successful_traffic 设置,该属性才能生效。如果启用了 com.parasoft.xtest.execution.api.web.report_successful_traffic 属性,则只有成功测试的数据才会计入限额。默认为 500

示例

com.parasoft.xtest.execution.api.web.report_traffic_limit=500

API 覆盖率属性

com.parasoft.xtest.execution.api.web.coverage_ref_by_tests

此设置确定服务定义中的可覆盖资源是否包含在 API 覆盖率报告中。如果受限制 SOAP 客户端、REST 客户端或消息传送客户端工具触及可覆盖资源,覆盖率信息将与合适的资源或操作相关联。支持以下服务定义:

  • OpenAPI/Swagger
  • RAML
  • WADL
  • WSDL

默认为 false。 

示例

com.parasoft.xtest.execution.api.web.coverage_ref_by_tests=true

com.parasoft.xtest.execution.api.web.perform_service_coverage_calculation

此设置启用/禁用用户定义的可覆盖资源列表的 API 覆盖率计算。您可以在 com.parasoft.xtest.execution.api.web.service_coverage_table 设置中指定资源。 

覆盖率可以计算在自动计算的可覆盖资源之外,也可以计算在可覆盖资源之外。默认为 false

com.parasoft.xtest.execution.api.web.service_coverage_table

此设置指定了一个资源列表,这些资源应该包含在 API 覆盖率计算中。使用以下格式指定以分号分隔的定义列表:

<definition_type>@<URI>

支持以下定义类型:

  • OpenAPI/Swagger
  • RAML
  • WADL
  • WSDL

示例

com.parasoft.xtest.execution.api.web.service_coverage_table=WSDL@http://soatest.parasoft.com/calculator.wsdl;OpenAPI/Swagger@file:///C:/openapi3.0/examples/v3.0/petstore.yaml;OpenAPI/Swagger@http://localhost:8080/soavirt/api/v5/def

在本例中,属性将包含以下资源的覆盖率信息:

  • WSDL@http://soatest.parasoft.com/calculator.wsdl
  • OpenAPI/Swagger@file:///C:/openapi3.0/examples/v3.0/petstore.yaml
  • OpenAPI/Swagger@http://localhost:8080/soavirt/api/v5/def

应用程序覆盖率属性

com.parasoft.xtest.execution.api.web.collect_application_coverage

此设置可启用/禁用覆盖率代理收集应用程序覆盖率数据的功能。默认为 false。 

示例

com.parasoft.xtest.execution.api.web.collect_application_coverage=true

com.parasoft.xtest.execution.api.web.application_coverage_host

此设置指定覆盖率代理所在机器的主机名或 IP 地址。

示例

com.parasoft.xtest.execution.api.web.application_coverage_host=myserver1.mycompany.com

com.parasoft.xtest.execution.api.web.application_coverage_port

此设置指定覆盖率代理的端口。默认为 8050

示例

com.parasoft.xtest.execution.api.web.application_coverage_port=8050

com.parasoft.xtest.execution.api.web.application_coverage_user_id

此设置可指定用户 ID,以便将覆盖率结果与特定用户关联。只有当覆盖率代理被配置为以多用户模式运行时,才应该指定用户 ID。详情请参阅 https://docs.parasoft.com 中提供的 Parasoft 代码分析工具(Parasoft Jtest 或 Parasoft dotTEST)的用户指南。

示例

com.parasoft.xtest.execution.api.web.application_coverage_user_id=user_qa21

com.parasoft.xtest.execution.api.web.application_coverage_report_as_test_failure

当覆盖率代理连接失败或静态覆盖率文件位置配置错误时,此设置可启用/禁用报告测试失败功能。否则连接问题将报告给控制台,但不会导致测试失败。默认为 false。 

示例

com.parasoft.xtest.execution.api.web.application_coverage_report_as_test_failure=true

com.parasoft.xtest.execution.api.web.application_coverage_upload_to_dtp

此设置可启用/禁用向 DTP 发送应用程序覆盖率结果。要求启用 com.parasoft.xtest.execution.api.web.collect_application_coverage 选项。默认为 true

此外,向 DTP 发送结果需要配置以下设置:

  • com.parasoft.xtest.execution.api.web.application_coverage_host
  • com.parasoft.xtest.execution.api.web.application_coverage_port
  • com.parasoft.xtest.execution.api.web.application_coverage_static_coverage_file
  • com.parasoft.xtest.execution.api.web.application_coverage_image_tags

示例

com.parasoft.xtest.execution.api.web.application_coverage_upload_to_dtp=true

com.parasoft.xtest.execution.api.web.application_coverage_static_coverage_file

此设置指定 Parasoft 代码分析工具(Parasoft Jtest 或 Parasoft dotTEST)以 .xml 或 .data 格式生成的静态覆盖率文件的路径。详情请参阅 https://docs.parasoft.com 中提供的 Parasoft Jtest 或 Parasoft dotTEST 的用户指南。

示例

com.parasoft.xtest.execution.api.web.application_coverage_static_coverage_file=C:\projects\MyApp\target\jtest\monitor\static_coverage.xml

com.parasoft.xtest.execution.api.web.application_coverage_image_tags

此设置指定了一组标签,用于在 DTP 中创建覆盖率图像。覆盖率图像为唯一标识符,用于汇总具有相同构建 ID 的各个运行的覆盖率数据。详情请参阅 https://docs.parasoft.com 中的 Parasoft DTP 用户指南。

示例

com.parasoft.xtest.execution.api.web.application_coverage_image_tags=FT;AppCov;Aggregate

API 安全属性

com.parasoft.xtest.execution.api.web.api_security_policy

此设置指定使用默认扫描策略还是自定义扫描策略。该值必须是 default 或 custom。默认为 default

示例

com.parasoft.xtest.execution.api.web.api_security_policy=custom

com.parasoft.xtest.execution.api.web.api_security_custom_policy_location

此设置指定自定义扫描策略文件的位置。如果将 com.parasoft.xtest.execution.api.web.api_security_policy 设为 default,则此属性值将被忽略。

示例

com.parasoft.xtest.execution.api.web.api_security_custom_policy_location=C:\projects\soatest\security\custom_security_policy.xml

com.parasoft.xtest.execution.api.web.api_security_timeout

此设置以分钟为单位指定渗透测试工具的超时时间。默认为 15

示例

com.parasoft.xtest.execution.api.web.api_security_timeout=15

com.parasoft.xtest.execution.api.web.api_security_includes

此设置指定正则表达式,用于确定渗透测试工具应扫描的 URL。包含项在排除项之前处理。如果没有定义包含项,则在考虑排除项之前,假定所有内容都包含在测试范围内。使用分号(;)分隔多个正则表达式。

示例

com.parasoft.xtest.execution.api.web.api_security_includes=https?:\/\/localhost:8080\/parabank\/.*;https?\/\/www\.domain\.com\.*

com.parasoft.xtest.execution.api.web.api_security_excludes

此设置指定正则表达式,用于确定应排除在渗透测试工具扫描范围之外的 URL。排除项在包含项之后处理。使用分号(;)分隔多个正则表达式。

示例

com.parasoft.xtest.execution.api.web.api_security_excludes=.*\/(login|logout).*;.*\.gif;http:\/\/localhost:8080\/parabank\/index\.htm


  • No labels