...

关于变更指导助手

变更指导助手可以自动识别服务变更（例如，重命名的操作、添加的元素或类型、变更空间名称等）如何影响现有测试或服务虚拟化资产发送的消息。它还基于一个更新现有测试或响应程序套件或新建的变更模板自动重构受影响的工具（单独地或者是批量）。查看和完善自动定义的映射来创建变更模板，这些映射解释了原始定义中的元素、操作、资源和模式与当前定义中的元素、操作、资源和模式之间的关系。这确保您的资产得到尽可能快速、准确和智能的更新。

Workflow

如果您怀疑服务已变更，则通常的工作流程为：

1. 从 Parasoft 变更指导助手角度运行变更影响分析。
2. 创建一个变更模板。

3. 逐个应用变更模板（以解决变更影响分析报告的特定变更影响）或批量重构（以快速更新项目，套件等中所有受影响的工具），来更新现有套件或创建一个新的变更模板。

测试影响分析

运行变更影响分析时，变更指导助手报告相关定义文件（例如 WSDL、架构、WADL、OpenAPI、Swagger、RAML）中的更改如何影响资产的信息。分析也可以： 

...

分析的结果可帮助您评估更新资产信息所需的更改的范围和性质。

重构

确定应更新的内容后，可以应用更改模板来自动重构信息以适合修改后的服务定义。该模板可以以多种方式应用： 

• 以  test-by-test or responder-by-responder basis
•  以一组选定的测试或响应体上
• 以适应的测试或者套件中的响应体
• 以所有测试或者套件中的响应体

变更模板定义

从服务目录自动生成变更模板，该服务目录会在变更影响分析期间填充。

...

生成变更模板后，可以逐案应用（解决变更影响分析报告的特定变更影响）以及批量重构（以快速更新项目、套件等所有受影响的工具）

它涵盖哪些变化？

变更指导助手可以应用于消息响应程序如果将工具设置为限制成 WSDL 或 Schema，或者服务定义中指定了 RAML、WADL（SOAtest）或 OpenAPI 、 Swagger，则变更指导助手会对表单输入指定的消息进行操作。如果服务定义指定了 RAML，WADL（SOAtest）或 OpenAPI 、 Swagger，则它将对 JSON 表单指定的消息进行操作。 如果以一种不支持的格式指定工具信息，则会在分析和重构时跳过该信息。用 Parasoft 搜索和替换来更新格式、工具中其他非信息字段中的值或变更指导助手不支持的工具中的值。请参阅使用搜索替换工具更新工具值。定义文件的简单更改（重新排列元素，更改类型等）将自动更新。

变更指导助手 UI

变更指导助手透视图专门用于识别和解决变更影响。 

打开变更指导助手透视图：

...

• The standard asset explorer: 以便您可以选择要分析或重构的资产（应用下面描述的工具栏按钮）。

• Toolbarbuttons: 添加了三个按钮：Run (用于重新运行变更影响分析以检查资产是否已正确重构) Perform Change Impact Analysis (如下所述), and Refactor Using a Change Template (如下所述)。

• The Service Catalog view: 它存储有关每个服务的不同版本的信息，以及定义一个服务版本的结构与另一个服务版本的结构进行比较的变更模板。
• The Properties view:  提供变更模板编辑器中选择的项目的详细信息。
• The Change Impact progress view: 报告变更影响分析的进度和结果。
• The Quality Tasks view: 您可以在此处查看便更影响并使用可用的变更模板重构相关工具。

Anchor
Identifying Changes with Change Impact Analysis Identifying Changes with Change Impact Analysis

通过变更影响分析识别变更

关于变更影响分析

变更影响分析比较了最初用于构建工具信息的服务定义 

...

变更影响分析仅报告与您正在分析的工具相关的变更。例如，如果服务不再包含工具从未使用过的可选元素，则不会报告更改影响。

运行变更影响分析

从变更指导助手运行变更影响分析：

1. 在资源管理器中，指示要分析的资产。您可以选择单个工具、套件、项目等。如果同时安装了 SOAtest 和 Virtualize，请选择 .tst files 或者.pva files。
2. 在变更指导助手工具栏中，单击 Perform Change Impact Analysis 按钮。
3. 完成打开的对话框：
   • To analyze vs. existing definition(s): 如果要分析所有选定资产与其相关服务定义的实时版本，请选择第一个按钮，然后单击 Finish。
   • To analyze vs. a different definition: 如果要分析选定资产和相关服务定义的其他版本，请选择第二个按钮，指定当前和更新的服务定义的位置，然后单击 Finish。
     
      

例如，假设您选择了一个包含基于 3 种不同服务定义的资产的套件。用 Scan the selected assets against their current service description 选项进行分析，将所有这些资产与其相关服务定义的当前版本进行比较。如果选择 Scan the selected assets against a specified service description，并且指定这些资产使用的3个服务定义中的1个的现有和更新版本的位置，则该分析将仅实用于用该指定服务的资产描述。基于其他两个定义的资产将不进行分析。

查看分析结果

在运行分析时，报告分析进度显示在进度视图以及控制台视图中。注意如果资产报告为 "skipped"，则表明它没有以受支持的格式（例如，表单输入）指定信息。

分析结果将在质量任务视图中报告。变更影响布局可以帮助您查看变更影响。如果质量视图尚未使用此布局，则可以在结果视图中单击 Change Impact Layout 工具栏按钮来启用它：

 

 您也可以从该视图的下拉菜单中打开此布局。
 

结果顺序为服务、套件、位置和更改类型： 

探索变更影响

要打开其信息需要更新的工具：

• 右击变更影响信息然后选择 View Associated Editor.

...

• 右击变更影响信息然后选择 Show Source in Explorer。
  

使用变更模板进行重构

变更模板按照所述创建_使用变更指导助手更新报文Defining a Change Template。应用更改模板有两种方法：

• At the change-impact level: 将其应用于变更影响分析报告的特定变更影响。如果您只是进行了变更影响分析并且想要逐一查看和处理所报告的影响，通常会使用此方法。
• At the project or suite level: 执行批处理在浏览器中选择的套件、工具或项目。如果您想要快速地将更改模板应用到一组资产中，那么通常会使用这种方法。

...

重构将更新变更模板中定义的消息。禁用删除操作的工具，但不会删除。

Anchor
Defining a Change Template Defining a Change Template

定义一个变更模板

创建一个变更模板

更改模板指定如何将元素、操作、资源和模式（XML 或 JSON）从一个服务版本映射到另一个服务版本。定义变更模板后，就可以将其应用于更新受服务变更影响的资产：纠正变更影响分析后报告的特定变更影响，或者对选定的工具，套件或项目执行批量更新。例如，如果在更改模板中将 FundPrepaid 映射到 FundPrepaidRequest，则应用此模板会将所选工具消息中的 FundPrepaid 更新为 FundPrepaidRequest。

从 Parasoft 变更指导助手角度创建、检查和修改变更模板。

创建一个变更模板:

1. 如果尚未这样做，请按照_使用变更指导助手更新报文Identifying Changes with Change Impact Analysis中所述进行变更影响分析。
2. 确保服务目录显示已更改的服务，并包含原始服务定义和当前服务定义的版本信息。
   • 要将服务添加到目录，请在服务目录视图中的任意位置上单击鼠标右键，选择 Add Service to Catalog,填写可用字段（这些字段根据所选的工件类型而有所不同），然后单击 Finish。
   • 要将版本添加到目录，请右键单击相关服务，选择 Add Version to Catalog, 然后指定必要的版本详细信息。

   • 要重命名服务或版本，请右键单击其服务目录节点，然后选择适当的 Rename 命令。此处指定的名称将在使用变更模板进行重构向导中使用。
     
     

     Info
     icon false title 为什么服务目录中有两个操作节点？
     注意如果同时安装了 SOAtest 和 Virtualize，则 Operations 节点将分为两个节点： • Client View: SOAtest 消息传递客户端（包含请求参数） • Responder View: Virtualize 消息响应程序（包含响应参数）

3. 请进行下列其中一项操作：
   • 选择 File> New > Change Template。
   • 在服务目录中，选择原始版本和新版本的节点，右键单击所选内容，然后选择合适的 Add Change Template 命令。
   • 在服务目录中，右键单击原始版本的 Change Templates，然后选择 Add ChangeTemplate。
4. 在打开的向导中：
   1. 指定有关变更模板的基本信息。
      • 注意如果同时安装 SOAtest 和 Virtualize，则将看到一个为客户端或响应体创建更改模板的选项。如果希望此变更模板定义如何在 SOAtest 信息传递客户端工具中更新请求，请选择 Client。如果希望此变更模板定义如何在 Virtualize 信息传递响应体工具中更新请求，请选择 Responder。
   2. 单击 Next。
   3. 指定将要创建的更改模板文件的名称和位置。
   4. 单击 Finish。

然后将创建一个更改模板，并在更改模板编辑器中将其打开。

查看和修改更改模板

更改模板会根据 Parasoft 的启发式自动将元素、操作、资源及其架构从原始服务定义映射到新服务：

...

映射时检查属性

映射元素、操作、资源和架构时，可以参考属性视图以获取有关要映射的项目的详细信息。例如：

 

更改 XML 的模板图标描述

以下图标用于在变更模板编辑器中标记 XML 项目：

变更 JSON 的模板图标说明

以下图标用于在变更模板编辑器中标记 JSON 项目：

Sharing Change Templates

如果您的团队想要共享变更模板，请共享包含该模板的项目，或者将该模板从一个工作空间复制到另一个工作空间。