_Adding a Data Source at the Test Suite, Project, or Global Level

配置资源库数据源

Parasoft 的数据资源库旨在帮助团队定义、扩展和查看大型和/或层次数据集，以便在 Parasoft 消息工具中使用。有关配置资源库数据源的详情，请参阅使用大层次数据集。

配置 CSV 文件数据源

若要配置 CSV 文件数据源： 

1. （可选项）在数据源配置选项的名称字段中更改数据源标签。
2. 使用行控件，以指明要使用行的范围。
   • 如果只希望使用所选定行，请点击范围按钮，然后通过将值键入到从和到字段，输入所需范围（假定索引从一开始）。例如，若只使用前 10 行，在从字段输入 1，到字段输入 10。若只使用第五行，在从字段输入 5，到字段输入 5。

3. 在文件路径字段中指定 CSV 文件的路径。可以使用以下变量：
   
   test_suite_loc:  相对于 .tst 或 .pva 文件的文件路径。例如：  ${test_suite_loc}/../files/myCSVFile.csv
   project_loc: 项目的相对路径。例如：${project_loc:MyProject}/myCSVFile.csv

   workspace_loc：SOAtest 工作空间的相对路径。例如：${workspace_loc}/../files/myCSVFile.csv

   

   还可以使用环境变量。请参阅在测试中使用环境变量和配置虚拟化环境。

4. 指定文件使用的分隔符和引号的类型。
5. 如果需要，更改其他选项：
   • 修剪前导/尾随空格 - 指定是否删除值开始和结尾处出现的空白。
   • 第一行指定列名 - 指定是否考虑将 CSV 文件第一行作为列名。如果第一行指定列名，则表单 XML 中的元素将列名显示为每个值的名称。  如果第一行未指定列名，则表单 XML 中的元素将“value”显示为每个值的名称。
6. 如果希望查看该数据源中列的列表，点击显示列。第一行值被识别为列标题。如果希望使用不同的列标题，更新数据源的第一行，然后点击显示列按钮。

配置数据库数据源

必须指定连接到数据库的 JDBC 驱动器。 详情请参阅配置 JDBC 驱动程序。 

1. （可选项）在数据源配置选项的名称字段中更改数据源标签。
2. 使用行控件，以指明要使用行的范围。可以启用范围按钮，并指定行的特定范围（索引从一开始）。例如，若只使用前 10 行，在从字段输入 1，到字段输入 10。若只使用第五行，在从字段输入 5，到字段输入 5。默认指定所有数据库行。
3. 从下拉菜单中选择驱动器类，并配置数据库连接设置。有关配置常用数据库连接的详情，请参阅配置 JDBC 驱动程序。如果在下拉菜单中没有看见您的驱动类，请选择自定义。
   • MySQL 用户：MySQL 驱动程序类需要 MySQL 驱动程序 6.0 或更高版本。如果您使用的是早期版本的 MySQL，请选择自定义并将驱动程序类设置为 org.gjt.mm.mysql.Driver。

点击显示列如果要检查使用了哪些列名。

现有行若要使用不同的行标题，请更新数据库列名，然后点击显示列按钮。

如果希望使用不同行，请更新 SQL 查询以便检索合适的列，然后点击显示列按钮。 

配置 Excel 电子表格数据源

若要配置 Excel 表数据源： 

1. （可选项）在数据源配置选项的名称字段中更改数据源标签。
2. 使用行控件，以指明要使用行的范围。
   • 如果只希望使用所选定行，请点击范围按钮，然后通过将值键入到从和到字段，输入所需范围（假定索引从一开始）。例如，若只使用前 10 行，在从字段输入 1，到字段输入 10。若只使用第五行，在从字段输入 5，到字段输入 5。

3. 在文件路径字段中指定 Excel 文件的路径。可以使用以下变量：
   
   test_suite_loc:  相对于 .tst 或 .pva 文件的文件路径。例如：  ${test_suite_loc}/../files/myspreadsheet.xls

project_loc: 项目的相对路径。例如：${project_loc:MyProject}/myspreadsheet.xls 

   还可以使用环境变量。 例如，${project_loc:MyProject}/DataSource/${soa_env:XLS_DIR}/myspreadsheet.xls。请参阅在测试中使用环境变量。

   请参阅在测试中使用环境变量和配置虚拟化环境。

4. 从工作表菜单中选择要使用的特定 Excel 文件的工作表。
5. 如果希望 SOAtest 将 Excel 数据源中每一列的大小限制为行数最少的一列的大小（换句话说，如果希望在遇到空单元格时停止处理数据），则启用在第一个空行处停止处理电子表格。

重要项：SOAtest 假定第一行值代表行标题。如果不是这样的话，可能会导致您在 SOAtest 中标识和选择数据源行时出现问题。如果希望 SOAtest 使用不同的列标题，请更新第一行数据源，然后点击显示列按钮。 

配置表数据源

若要通过输入或粘贴数据源值到内部表编辑器中来指定数据源值：

1. （可选项）在数据源配置选项的名称字段中更改数据源标签。
2. 使用行控件，以指明要使用行的范围。
   • 如果只希望使用所选定行，请点击范围按钮，然后通过将值键入到从和到字段，输入所需范围（假定索引从一开始）。例如，若只使用前 10 行，在从字段输入 1，到字段输入 10。若只使用第五行，在从字段输入 5，到字段输入 5。
3. 如果希望指定列名（而不是使用默认的 A、B、C、D 等等），请选择第一行指定列名。
4. 通过键入或粘贴数据源值到表中来添加数据源值。可以复制 Excel 等主流工作表。注意，表编辑器包括标准的复制、剪切、粘贴编辑命令（当选中单元格时），以及插入行或表的命令。若要添加更多的行，请使用向下箭头键或向下箭头滚动条按钮。若要添加更多的列，请使用向右箭头键或向右箭头滚动条按钮。

配置组合多个数据源的聚合数据源

可以创建聚合数据源。在该数据源中，您可以将其他可用数据源的值组合到单个数据源中。如果想执行需要绘制来自不同数据源的值的功能测试，这一点尤其有用。例如，在向服务器发送请求的过程中，您可能希望发送包含用户信息（如姓和名）的数据源中的值，也可能希望发送包含用户登录和密码信息的单个数据源中的值。  通过将两个数据源合并到一个聚合数据源中，您可以创建一个测试，而不必为每个数据源创建单独的测试。

关于聚合数据源如何与数据组之间进行比较的讨论，请参阅 了解 SOAtest 中的数据组和聚合数据源和/或了解 Virtualize 中的数据组和聚合数据源。若要将多个数据源合并到一个聚合数据源中：

1. （可选项）在数据源配置选项的名称字段中更改数据源标签。
2. 使用行控件，以指明要使用行的范围。
   • 如果只希望使用所选定行，请点击范围按钮，然后通过将值键入到从和到字段，输入所需范围（假定索引从一开始）。例如，若只使用前 10 行，在从字段输入 1，到字段输入 10。若只使用第五行，在从字段输入 5，到字段输入 5。
3. 从可用框中选择所需数据源，然后点击添加按钮，将它们添加到已选框中。
   • 可用框包含添加到测试套件或响应套件的所有数据源。选择并将所需数据源添加到已选框之后，已添加数据源中包含的列名在列框中显示。

配置允许在多个数据源之间切换的数据组数据源

数据组包含相似数据源的数量，该数据源至少有一列相同；它允许您选择在任何给定时间应用哪个数据组。如果要为同一工具动态指定不同的数据源，这一点尤其有用。运行时，在不需编辑工具或数据源的情况下，您可以快速切换使用哪个数据源。若要使用数据组，需要将具有共享列的数据源分组在一起，然后指定应该让哪个数据源活跃。

有关数据组如何与聚合数据源进行比较的讨论，请参阅 了解数据组和聚合数据源和了解数据组和聚合数据源。若要将多个数据源合并到一个数据组中：

1. （可选项）在数据源配置选项的名称字段中更改数据源标签。
2. 使用行控件，以指明要使用行的范围。
   • 如果只希望使用所选定行，请点击范围按钮，然后通过将值键入到从和到字段，输入所需范围（假定索引从一开始）。例如，若只使用前 10 行，在从字段输入 1，到字段输入 10。若只使用第五行，在从字段输入 5，到字段输入 5。
3. 从可用框中选择所需数据源，然后点击添加按钮，将它们添加到已选框中。
   • 可用框包含添加到测试套件或响应套件的所有数据源。
   • 如果数据源与当前选定数据源没有任何共同的列，则无法添加。
   • 如果添加数据源将减少整个数据源中共享列的数量，则将显示一个警告。
   • 选择并将所需数据源添加到已选框之后，所有选定数据源中出现的相同列都将在列框中显示。

4. 在活动数据源下指定要使用的数据源。也可以根据活动环境选择组的活动数据源。可以将环境变量（使用 ${var_name} 符号）输入到活动数据源字段中，并指定运行时所需环境。有关在命令行上或在 UI 中使用运行时环境的详情，请参阅 在不同的环境中配置测试 和配置虚拟化环境。

配置文件数据源

若要配置文件数据源：

1. （可选项）在数据源配置选项的名称字段中更改数据源标签。
2. 使用行控件，以指明要使用行的范围。
   • 如果只希望使用所选定行，请点击范围按钮，然后通过将值键入到从和到字段，输入所需范围（假定索引从一开始）。例如，若只使用前 10 行，在从字段输入 1，到字段输入 10。若只使用第五行，在从字段输入 5，到字段输入 5。
3. 指定从哪个文件或目录中导入文件。指定位置中可用的所有文件都将显示在表中。右键点击选项还有剪切、复制和粘贴值操作。
   • 若要过滤文件数据源使用的文件，请在文件过滤器字段中输入字符串。例如：
     
     • * = 任何字符串的通配符
     • *.*= 所有文件（默认）
     • *.txt = 所有文本文件
     • data* = 所有文件名以“data”开始的文件
     • data*.txt = 所有文件名以“data”开始的文本文件
     • *data* = 所有文件名包含字符串“data”的文件
4. 如果希望文件数据源使用文件数据源时导入目录中的所有文件，请启用基于上次导入动态刷新选项。  如果不启用该选项，则文件数据源将只使用文件数据源表中所列出的文件，即使导入目录中存在其他文件。为了确保 .tst 文件的可移植性，在以下情况中必须启用该选项：
   • 当 .tst 文件需要在多台机器上执行时。
   • 当 .tst 文件将在使用多个负载测试生成器机器的负载测试中使用时。

在运行时，每个文件的内容都用作数据源值。

配置可编写数据源

为了在后续测试中重复使用数据源，配置一个捕获运行时数据的可编写数据源：

1. （可选项）在数据源配置选项的名称字段中更改数据源标签。
2. 使用行控件，以指明要使用行的范围。
   • 如果只希望使用所选定行，请点击范围按钮，然后通过将值键入到从和到字段，输入所需范围（假定索引从一开始）。例如，若只使用前 10 行，在从字段输入 1，到字段输入 10。若只使用第五行，在从字段输入 5，到字段输入 5。
3. 指定编写到数据源的首选编写模式。可以选择以下其中一项：
   • Set-Up 测试模式> 附加：如果希望 Set-Up 测试在以前编写的任何值之后附加新数据，选择该选项。这是默认的模式。只有 Set-Up 测试才能以这种模式编写入数据源。
   • 标准测试模式> 覆盖：如果希望标准测试（非 Set-Up 测试）使用新数据重写以前编写的任何值，选择该选项。只有标准测试才能以这种模式写入数据源。
   • Set-Up 测试模式> 附加：如果希望标准测试（非 Set-Up 测试）在以前编写的任何值之后附加新数据，选择该选项。只有标准测试才能以这种模式写入数据源。如果启用该选项，还可以指定重置频率设置，以确定数据源将如何重置（即清除）之前编写的任何数据。
     • 每次迭代：配置数据源，以每次它所在的测试套件或响应套件开始遍历新数据源行时进行重置。

     • 每次写入访问：配置数据源，以在每个新的写入访问（只适用于在单个写入访问中附加数据）之前进行重置。

4. 如果希望指定列名（而不是使用默认的 A、B、C、D 等等），请选择第一行指定列名。
5. 为可写数据源设置填充（如，通过让一个数据库工具写入它）。
    

例如，在 Virtualize 中填充可编写数据源的一个方法是：

1. 添加 XML 数据库工具作为工具输出。
2. 练习该套件以填充 XML 数据库。
3. 向 XML 数据库 GUI 中选择的 XPaths 添加一个节点。
4. 双击 XML 数据库 GUI 中数据源列名列下的条目行。将显示修改对话框。
5. 选择位于左侧的数据源列，然后选择位于右侧的可写数据源列，指定要包含存储值的列名。

在该示例中，对于 SOAtest，这个过程将非常类似：

1. 将 SOAP 客户端工具作为 Set-Up 测试添加到测试套件。有关设置的更多信息，请参阅添加 Set-Up 和 Tear-Down 测试。
2. 将 XML 数据库工具作为输出添加到 SOAP 客户端 Set-Up 测试。
3. 运行 SOAP 客户端 Set-Up 测试，以填充 XML 数据库。
4. 向 XML 数据库 GUI 中所选元素列添加一个节点。
5. 双击 XML 数据库 GUI 中数据源列名列的条目行。将显示修改对话框。
6. 在修改对话框中选择可写数据源列，然后点击OK。现在，当运行 Set-Up 测试时，将填充可编写数据源。每次运行父测试套件时，可编写数据源将会自动重置。

使用 Bean Wizard 配置数据源表单 Java Bean 字段

请参阅Using Interpreted Data Sources。

设置“一对多”数据源映射关系

还可以设置 SOAtest 使用一个数据源（例如，包含登录信息的全局数据源）的单行值，和使用另一个数据源的多行值，如下所示：

1. 添加可编写数据源，然后按照Configuring a Writable Data Source中的说明配置。可编写数据源允许 SOAtest 独立于其他数据源进行迭代。
2. 如果数据源中存在多个“global”参数，则右键点击单个可编写数据源列并选择插入列。将列重命名为与原始数据源列匹配的内容。
3. 添加扩展工具作为 Set-Up 测试（详情请参阅添加 Set-Up 和 Tear-Down 测试）。这将充当到您的“全局”数据源的接口。

4. 按照用于自定义脚本的扩展工具中所描述配置此扩展工具。假定要访问的列名为数据源“凭据”中的“用户名”和“密码”，您将在工具配置面板中选择凭据数据源，并选择使用数据源，然后添加以下代码：

   from soaptest.api import *
   def getCredentials(input, context):
   	username = context.getValue("Credentials", "username")
   	password = context.getValue("Credentials", "password")   
   	return SOAPUtil.getXMLFromString( [ username, password ] )

5. 右键点击扩展工具并选择添加输出，然后选择 XML 数据库工具选项将 XML 数据库链接到扩展工具输出。
6. 运行测试一次，以填充 XML 数据库。
7. 双击 XML 数据库工具，打开配置面板。
8. 选择与第一参数相对应的元素，点击添加。
9. 点击修改，选择数据源列名。
10. 选择可写数据源列，然后选择相应的名称。
11. 对与第二个参数相对应的元素重复步骤 8-10。