...

对扫描进行配置

扫描测试是执行测试用例时抓取指定 web UI 的测试。若要配置 SOAtest 扫描 web UI，则如下添加扫描测试：

1. 请进行下列其中一项操作：
   • 若要添加 "Scanning Test” 到新的 .tst 文件：右键单击想将要添加 .tst 文件的项目节点，然后选择 New Test ( .tst) file。为新的 .tst 文件输入名称，单击 Next，然后选择 Web> Scan web application。
   • 若要添加 "Scanning Test” 到现有项目：选择要添加新测试的测试套件节点，并单击 Add Test 或 Output.
     
     
     
     在打开的 Add Test 向导中，选择左侧的 Standard Test ，右侧的 Scanning Tool ，然后单击 Finish。
2. 指定是否要从 HTTP、FTP 或本地源进行扫描。

   • 如果选择 FTP 或 Local，请填写可用字段，然后才能完成配置。可以跳过以下选项：

     Info
     icon false title FTP 选项
     在指定 FTP 源时，存在以下选项： Case Insensitive Server：指明您的服务器不区分大小写。 Follow Symbolic Links：如果选择此项，它会告诉 SOAtest 去扫描符号链接，就像这些链接是 ftp 站点上的实际文件或文件夹一样。如果链接指向文件夹，则 SOAtest 将扫描该文件夹的内容。

   • 如果选择 HTTP，则按照下面的详细步骤继续指定设置。
3. 选择 HTTP Tool Settings 的 Required Basic Settings 选项卡，并完成以下内容：
   • Start URL：在字段中指定 URL 或 .urls 文件。

     • 如果 URL 的用户名和密码作为‘*’输入，则 SOAtest 将首先尝试使用最近 URL 的相同凭证，最近 URL 与此 URL 前面并属于同一个域的。如果该凭证没有用于此 URL，则 SOAtest 将打开域密码对话框，询问您输入的凭证是否正确？

       Info
       icon false title 使用 .urls 文件
       Anchor Using .urls Files Using .urls Files 如果计划将积极的限制添加到项目，然后启动将文件中指定的 URL 上所有合适的站点加载到 Project Creation 面板中指定的默认深度，则使用 .urls 文件。如果为受保护的 URL 指定用户名和密码，则凭证将自动添加到项目中。 .urls 文件的格式为：URL 在单独行上指定；如果为 URL 指定凭证，则它必须按照 url 的顺序放在同一行：url、username、password。Url、user-name、password 以逗号分割。如果三个中的任何一项存在逗号，则该项都必须放在一对双引号内。如果任何项包含双引号，则每个双引号必须使用另一个双引号进行转义，并且将所有项放在双引号内。例如， http://url1.com/ http://url2.com/, username, password http://url3.com/, "user,name", ",password," http://url4.com/, "username", "pass""word"

   • Limit loading depth：如果不想要 SOAtest 尝试加载整个站点，使用此控件限制加载深度。深度设置决定加载站点点击深度（链接）的数量。加载深度为 0 意味着只加载初始页面。如果希望只测试站点中所选定路径，或者如果希望 SOAtest 根据日志文件项中记录的流量自动构建站点结构和路径，那么该选项尤其有用。
   • Restrict scanning to deepest subdirectory of start URL：如果希望 SOAtest 只加载初始启动 URL 的子目录，请选择此选项。有关更多详情，请查阅 限制扫描到Start URL 的最深子目录 。
   • Follow redirects not specified as restrictions in the table: 如果希望 SOAtest 遵循重定向未指定为允许 URL 的站点，请选择此选项。有关重定向处理的更多详情，请查阅 配置 SOAtest 以扫描 Web UI Understanding and Configuring Redirect Handling。
   • Allowable/Restricted URLs: 如果访问某些页面（例如，日志输出页面）可能防止 SOAtest 正确地和/或完整地加载站点，通过在表中将它们标记为受限制的 URL 来提示 SOAtest 避免这些页面；有关详细说明，请查阅 配置 SOAtest 以扫描 Web UI Preparing SOAtest to Load Sites that Use JavaScript 。
   • Form Options：可使用以下选项：
     • Scan Forms With Default Input：默认关闭
     • Fill Active Inputs Manually：默认开启
4. 如果想要输入连接密码，则选择 Realm Passwords 选项卡并单击 Add 来指定密码。
5. 如果想要指定高级扫描选项，则选择 Advanced Settings 选项卡，然后完成以下内容：
   • Default Pages：* （这是默认的设置）
   • Obey Robot Restrictions：关闭（前提条件是站点的 Wedmaster 授权您忽略机器人限制）
   • Pass Cookies：开启
   • Invoke CGI For All Arguments：开启
   • Case Insensitive Server：取决于您的服务器
   • Aliases：取决于您的站点。如果您的站点使用别名，则通过单击 Add 按钮在此书进行输入。Alias 是希望 SOAtest 要考虑的一个域，相当于项目中其中一个站点的域。例如， http://www.parasoft.com 可能拥有别名 parasoft.com 和 www.parasoft.com。
6. 单击 Save。

...

如果选择了推荐的 HTTP 配置选项，并且您的站点包含表格，则 SOAtest 允许您使用表单输入对话框填充表单。如果在 SOAtest 加载您的站点时打开表单输入对话框，则请按照 配置 SOAtest 以扫描 Web UI Populating Forms中所述将其完成。

对特殊加载问题进行处理

本章节解释了如何处理以下特殊的加载问题：

• 准备 SOAtest 在扫描期间限制和/或允许 URL
• 配置 SOAtest 以扫描 Web UI
• 配置 SOAtest 以扫描 Web UI
• Preparing SOAtest to Load Sites that Use JavaScript
• Populating Forms
• Managing Authentication During Loading配置 SOAtest 以扫描 Web UI

准备 SOAtest 在扫描期间限制和/或允许 URL

Anchor
Preparing SOAtest to Restrict and Preparing SOAtest to Restrict and

 

可以通过在 Allowed/Restricted URLs 表中添加限制和/或允许来控制 SOAtest 可以加载哪些站点 URL 和忽略哪些站点 URL。

...

如果 URL 标记为受允许，则 SOAtest 将加载在扫描期间遇到的 URL。对于Start URL 字段中指定的 URL，最深目录 URL 模式自动添加为受允许的 URL；此处使用的 URL 被称为 Allowed Subdirectories URL. http(s)://... ，以便允许或限制指定 URL 的 HTTP 和 HTTPS 版本。有关更多详情，请查阅 配置 SOAtest 以扫描 Web UI URL Restriction Examples。

还可以指定其他受允许的 URL。对于配置 SOAtest 来加载 相关站点，这一点特别有用。相关站点是链接到其中一个项目站点的任何站点，但没有与项目站点相同的主机名。例如，您的主要项目来源是 http://www.parasoft.com ，并且该站点链接到 http://forums.parasoft.com 和 http://www2.parasoft.com，这两个站点都是当前项目的相关站点。如果希望 SOAtest 在当前项目上下文中遇到相关站点时自动它们，则需要指明它们是受允许的 URL。

...

1. 单击 Add。将添加新的一行到 Allowed/Restricted URLs 表中。
2. 在新添加行的文本字段中，输入想要限制或允许的 URL。
   • 通配符星号（*）可以在 URL 中的任何位置使用，以匹配 0 个或更多字符。“*” 意味着任何字符组合。它适用于构造 Allowed/Restricted URLs 表条目的任何组合方式。有关示例，请查阅 Wildcard Examples 。
   • 如果 URL 以斜杠‘/’结尾，则在比较之前删除斜杠。
3. 如果需要，可切换 +/- 符号以指明应该允许指定的 URL，还是限制它。
   • + 号用于标记受允许的 URL。
   • - 号用于标记受限制的 URL。

...

若要删除 Allowed/Restricted URLs 表条目：

• 选择要删除的条目，单击 Remove。

URL 限制示例

Anchor
URL Restriction Examples URL Restriction Examples

下面的例子解释了关于 http(s)://... 限制的一些细节：

• 默认的 http(s)://... 限制允许 URL 匹配 http:// 或 https://。例如，使用默认的限制：
  http(s)://www.google.com/*
  可能匹配
  http://www.google.com/amazing_page.html 和 https://www.google.com/amazing_page.html
• 字符串 "http(s)://” 在 URL 限制中除了在开头外没有意义。例如，不可能有以下的限制：
  http(s)://www.google.com/* ，并让其匹配 http://www.google.com/amazing_page.html
  字符串 "http(s)://” 区分大小写。因此，不可能：HTTP(S)://www.google.com/* ，并让其匹配 http://www.google.com/amazing_page.html
• 特殊字符是 "http(s)://" ，而不是字符串的其他部分。例如，不可能有以下的限制：
  http://www.para(s)oft.com/* ，并让其匹配 http://www.parasoft.com/* 或 http://www.paraoft.com/*

通配符示例

Anchor
Wildcard Examples Wildcard Examples

下表显示了如何使用通配符来实现不同的目标：

...

direc*ry/*  将匹配 directory/dir2、 direcHELLOry/dir2/dir3和 direc12345fry/images。

了解 SOAtest 启发式扫描

项目扫描和更新期间，每个可能的 URL 都与 Allowed/Restricted URLs 表匹配，以确定是否应该访问 URL。确定 URL 是否应该访问的过程如下：

...

Allowed/Restricted URLs 表（如 Preparing SOAtest to Restrict and/or Allow URLs During Scanning中所述）允许控制站点的哪些部分被扫描。例如，它允许在允许扫描的部分站点内将某些 URL 指定为“禁区（off-limits）”。或者，允许在不应被扫描的站点区域内对特定 URL 进行扫描。

示例 1

URL http://www.dev.parasoft.com/products/dir/page.html 将匹配来自上表的以下 URL：

...

最后一个匹配的 URL 是 http(s)://www.dev.parasoft.com/products/*。因为该 URL 的符号为负（-，表示该 URL 受到限制），将限制 URL http://www.dev.parasoft.com/products/soap.html 。

示例 2

站点 http://www.dev.parasoft.com 有关于几千种类型的硬件。希望将站点扫描限制为两种类型的硬件：路由器和磁盘。除了站点的旧部分，还希望处理站点的所有其他部分。

...

-  http(s)://www.dev.parasoft.com/olddir/*

这就是完成操作后表格的样子。

限制扫描到Start URL 的最深子目录

Anchor
Restricting Scanning to the Deepest Subdirectory of the Start URL Restricting Scanning to the Deepest Subdirectory of the Start URL

当选中 Restrict scanning to deepest subdirectory of Start URL Http 扫描选项时，SOAtest 将自动启用 URL，为最深子目录创建一个允许访问的 URL，并将其添加到 Allowed/Restricted URLs 表中第一行。如果清除了该选项，SOAtest 将自动将默认允许的子目录 URL 添加到 Allowed/Restricted URLs 表中第一行。在第一重定向到具有相同完全限定域名的 URL 时，SOAtest 也会这样做。

...

了解配置并重定向处理

Anchor
Understanding and Configuring Redirect Handling Understanding and Configuring Redirect Handling

如果特定的Start URL 为重定向，则 SOAtest 将加载其重定向和任何连续的后续重定向。此外，SOAtest 将自动为每个重定向添加一个允许的子目录 URL。重定向的所有添加条目都将被添加到 Allowed/Restricted URLs 表的顶部。

如果希望 SOAtest 遵循未添加为“允许 URL”的重定向，则选择 Follow redirects not specified as restrictions in the table 选项。当选中此选项时，如果 SOAtest 在扫描期间遇到了重定向，并且该重定向未在 Allowed/Restricted URLs 表中指定，则它将被加载。SOAtest 将为重定向到 Allowed/Restricted URLs 表添加一个允许的子目录 URL。

准备 SOAtest 以加载使用 JavaScript 的站点

Anchor
Preparing SOAtest to Load Sites that Use JavaScript Preparing SOAtest to Load Sites that Use JavaScript

加载包含 JavaScript 的站点之前，请验证是否启用加载 JavaScript 选项。（该选项默认启用）。当启用该选项时，SOAtest 将执行 JavaScript 并加载相关链接、

...

1. 选择 Parasoft> Preferences。
2. 选择 Parasoft> Scanning。
   
   

自定义 JavaScript 事件模拟

如果希望自定义 SOAtest 如何模拟 JavaScript 事件（如打开和关闭其他窗口、运行计时器等），可以通过在选项卡中更改 JavaScript 选项实现这一点。使用以下表来确定选择哪些选项。

使用警告、确认和提示信息

每次在 SOAtest 扫描站点时遇到 JavaScript 警告、确认和提示信息时，它都会将消息打印到结果区域（在右侧 GUI 面板），并执行默认操作。SOAtest 默认打印以下消息并执行下面的操作：

...

如果希望 SOAtest 以不同方式处理这些信息，您可以使用脚本定义自定义行为。有关更多详情，请查阅 Customizing Scanning with Scripting Hooks 。

对表单进行填充

Anchor
Populating Forms Populating Forms

如果选择了 Fill Active Inputs Manually HTTP 配置面板多选框（默认启用），则 SOAtest 会在每次检测要求用户输入的表单打开一个表单输入对话框。如果希望 SOAtest 分析表单提交后返回的页面，则需要告诉 SOAtest 如何填充表单不同的输入元素（文本字段、多选框、单选框等）。可以通过在加载过程中在这些对话框中指定固定输入来实现这一点。

...

了解表单输入目的和选项

如果您的站点使用表单，并且您希望 SOAtest 加载并测试这些表单提交后返回的页面，则需要告诉 SOAtest 如何填充表单不同的输入元素（文本字段、多选框、单选框等）。要测试的页面实例越多，则需要填充表单的信息就越多。

...

• 通过输入将在每次 SOAtest 遇到相关表单时使用的固定值。（我们将引用这些作为 fixed inputs）。
• 通过配置 SOAtest 使用默认的输入（如代码中所指定）。（我们将引用这些作为 default inputs）。
• 通过配置 SOAtest 从表单出现的页面中提取值。例如，如果正确的表单是由 JavaScript 动态设置的。（我们将引用这些作为 extracted inputs）。
• 通过完全禁用输入。
• 通过配置 SOAtest 来使用自定义方法的返回值。（我们将引用这些作为 script inputs）。

完成表单输入面板

若要添加或更改 SOAtest 打开的表单输入面板中的固定输入：

1. （可选项）更改 Form Test Name 字段中的输入标签名。
2. （可选项）更改 Form Action 字段中的表单操作。
   • 如果希望使用默认的表单操作（如代码中所指定），则选择 Default 选项。注意，如果默认值更改，SOAtest 将会自动更新表单操作；您将不需要手动更新表单测试。
   • 如果您希望指定固定值，请选择 Fixed 选项，然后在文本字段中指定需要的表单操作。
3. 使用表单输入控件来为每个表单输入元素添加或更改输入。
   • 如果希望使用默认输入（如代码中所指定），则选择 Default 选项。注意，如果默认值更改，SOAtest 将会自动更新表单测试值；您将不需要手动更新表单测试。
   • 如果您希望指定固定值，请选择 Fixed 选项，然后使用可用的控件指定需要的值。
     • 多选框、单选框和选择输入有一个 User-Defined 选项，它允许指定字符串作为该输入的值发送。
     • 单选按钮和选择输入还有一个 Index 选项，它允许指定单选按钮或选择选项的索引。如果指定了一个索引，则无论该选项进行了怎样的更改，都将发送单选按钮或选项的值。索引从 0 开始。例如，如果希望一直选择第二个选项，则您可以选择索引选项并选择所以“1”。对于单选按钮，每个索引都显示该索引处单选按钮的当前值。对于选择输入，选项的当前显示值与每个索引一起显示。
     • 选择输入存储显示值，该值用于选择，而不是发送给服务器。因此，当提交值更改时，您将不需要更改测试。
   • 如果希望 SOAtest 从表单出现的页面上提取表单输入值。例如，如果正确的表单值是通过 JavaScript 动态设置的，选择 Extracted，使用经常出现在要提取的值左侧的文本字符串填充 Left-hand text 字段，然后使用通常出现在希望提取的值右侧的文本字符串填充 Right-hand text 字段。例如，若要从文本 pre123post中提取值 123 ，则可以在 左侧的 text 字段中输入 pre，在 右侧的 text 输入 post 。
   • 如果希望禁用一个启用的输入，请选择 Disable 选项。如果希望启用一个禁用的输入，请选择 Enable 选项。
   • 如果希望使用自定义方法的返回值，请选择 Script 选项。单击 Edit 按钮来创建或编辑方法，然后选择需要的方法以便在弹出对话框的 Method 下拉菜单中使用。如果存在两个或多个方法，您还可以选择不同的方法，以便在表单面板中下拉菜单中使用。
4. （如果表单有一个 OnSubmit 处理程序）根据是否希望在测试期间使用处理程序来启用或禁用 Process OnSubmit Handler When Submitting Form 选项。
   • 如果表单有个一 OnSubmit 处理程序，则该选项默认设置为 true。除非该表单测试在使用浏览器记录路径时已经创建。在这种情况下，它被设置为 false，因为在 SOAtest 记录仪浏览器中的路径时，SOAtest 会以这样的方式来配置表单测试，该方式为 OnSubmit 不需要被处理（并且，事实上，以这种方式处理这个处理程可能会导致路径执行期间发生问题）
5. （可选项）更改默认的表单提交方法。
   • 如果希望模拟一个简单的 JavaScript 提交，或者是模拟用户通过按 Enter 键提交表单，则选择 Implied Submit 选项。
   • 如果希望模拟用户通过单击提交按钮进行表单提交，可以选择代表提交按钮（例如，Image: "Anonymous”）的选项，也可以点击提交图像特定区域（如果在表单输入面板中可用）。

对加载期间的身份验证进行管理

如果 SOAtest 访问了需要身份验证的页面，则将打开一个密码对话框，需要您输入有效用户名和密码。

...

在合适的字段中输入有效的用户名和密码，请指定是否希望 SOAtest 在该项目文件中保存密保，然后单击 OK。

关于加载和站点扫描的 FAQ

...

...

使用脚本挂钩（Hooks）自定义扫描

Anchor
Customizing Scanning with Scripting Hooks Customizing Scanning with Scripting Hooks

可以通过在 SOAtest 项目中发生与“挂钩”相关联的事件时执行自定义脚本，进而自定义 SOAtest 的扫描行为。

了解挂钩概念

自定义的 hooks 可用来记录或更改扫描工具执行（例如，警示对话框打开时、提示用户进行响应时、提示用户输入密码时等）过程中特定点上传递的值。

...

有关常用挂钩选项的完整说明，请查阅 SOAtest 扩展 API。选择 Parasoft> 帮助，然后查询标题为 "Parasoft SOAtest Extensibility API” 的书。

了解可用挂钩

SOAtest 允许在脚本中定义和操作以下特定挂钩：

• 配置 SOAtest 以扫描 Web UIAlert
• 确认和提示
• 域密码
• URL 日志

警告

Anchor
Alert Alert

当 SOAtest 遇到 JavaScript alert() 方法时，其默认的行为是单击 OK 按钮，然后打印 JavaScript Alert："message” 到 SOAtest 控制台视图中。可以通过 Alert 挂钩更改此行为。

...

#Script to return text of result window named "Alert Messages" from soaptest.api import *
def return(): 
    return SOAPUtil.getResultWindowText("Alert Messages")
#Script to clear text of result window named "Alert Messages" from soaptest.api import *
def clear(): 
    SOAPUtil.clearResultWindow("Alert Messages")

确认和提示

Anchor
Confirm and_Prompt Confirm and_Prompt

当 SOAtest 遇到 JavaScript confirm() 方法时，其默认的行为是单击 Cancel 按钮，返回 false，然后打印 JavaScript Confirm："message” 到 SOAtest 控制台视图中。当 SOAtest 遇到 JavaScript prompt() 方法时，其默认的行为是单击 Cancel 按钮，返回 null，然后打印 JavaScript Prompt："message” 到控制台视图中。可以通过使用脚本更改这些行为来定义并自定义 Confirm 挂钩或 Prompt 挂钩（具体使用的挂钩取决于要更改哪个 JavaScript 方法的返回值）。

...

def myPromptHook(msg, defaultMsg):
  if msg == "Enter a URL":
    return "http://www.parasoft.com"
elif msg == "Enter your name":
  return "John"
else:
  return None

域密码

Anchor
Realm_Password Realm_Password

当以下所有条件都满足时，调用 Realm Password 挂钩：

...

URL 日志

Anchor
URL_Logging URL_Logging

每次 SOAtest 访问 URL 时，调用 URL Logging 挂钩。它可以用来提示 SOAtest 打印访问的每个 URL。

...