...
- Run a change impact analysis from the Parasoft Change Advisor perspective.
- Create a change template.
Apply that change template—on a case by case basis (to resolve specific change impacts reported by the change impact analysis) or for batch refactoring (to rapidly update all impacted tools across a project, suite, etc.)—to update your existing suite or create a new one.
...
...
SOAtest
...
can catch unexpected service changes as soon as they occur:
- Update your preferred test execution Test Configuration to perform change impact analysis as it executes tests.
- If change impacts are reported:
- Create a change template.
- Apply that change template—on a case by case basis (to resolve specific change impacts reported by the change impact analysis) or for batch refactoring (to rapidly update all impacted tools across a project, suite, etc.) —to update your existing test suite or create a new one.
Change Impact Analysis
When a Change Impact Analysis is run, Change Advisor reports how assets’ messages are impacted by a change in the related definition file (e.g., WSDL, schema, WADL, Swagger, RAML). This analysis can either:
...
What Changes Does it Cover?
...
...
Change Advisor can be applied to messaging tools (SOAP Client, REST Client, EDI Client, Fixed Length Client, Message Stub).
...
Change Advisor operates on the messages specified via Form Input if the tool is set to be constrained to WSDL or Schema, or if the Service Definition has a RAML, WADL (SOAtest), or Swagger specified. It operates on the messages specified via Form JSON if the Service Definition has a RAML, WADL (SOAtest), or Swagger specified.
...
For the REST Client, Change Advisor applies to path and query parameters, as well as XML or JSON payloads.
...
If If a tool’s message is specified in a non-supported format, it will be skipped during analysis and refactoring. To update values in these formats, values in other non-message fields in these tools, or values in tools not supported by Change Advisor, use Parasoft Search and Replace. See
...
Parasoft Search and Replace. SeeUpdating Tool Values with Search and Replace.
...
Simple changes to the definition file (elements are reordered, types are changed, etc.) are updated automatically.
...
Change impact analysis will report only changes that are relevant to the tools you’re analyzing. For example, if the service no longer includes an optional element that your tools never used, a change impact will NOT be reported.
...
Typical use cases for running change impact analysis in SOAtest are:
- If you suspect that the service changed, run it from Change Advisor to identify what changed and see the scope and nature of the updates that will be required to address that change.
- If you’re not expecting any changes, run it alongside normal test execution. This way, if a test fails, you can immediately determine if that failure might be related to a change in the service.
Running Change Impact Analysis
...
For instance, assume you have selected a suite that includes assets based on 3 different service definitions. Analysis with the Scan the selected assets against their current service description option will compare all of those assets vs. the current version of their correlated service definitions. If you select Scan the selected assets against a specified service description—and you specify the location of the existing and updated version of 1 of the 3 service definitions used by those assets— the analysis will be applied to only the assets that use that specified service description. Assets based on the 2 other definitions will not analyzed.
...
not analyzed.
To run change impact analysis (vs. the current version of the assets’ existing service definitions) during regular test execution:
- Configure your preferred execution Test Configuration to perform change impact analysis. Change impact analysis is enabled/disabled in the Execution> Change Impact tab.
- Run test execution with that Test Configuration
Reviewing Analysis Results
...
The results are organized by service, suite/location, and the type of change:
...
Exploring the Change Impacts
...
If your team wants to share change templates, either share the project that contains that template, or copy the template from one workspace to another.
...
...
Tutorial
For a tutorial on using Change Advisor, see Updating Tests as Services Change 1.