SOAtest can automatically create a .tst based on the endpoints found in an OpenAPI/Swagger description. Each .tst generated using the OpenAPI/Swagger wizard will contain REST Clients for all of the defined endpoints.
The following specifications are supported:
- Swagger 1.0 - 2.0. This includes any Swagger core versions that are compatible with these specs (for example, Swagger core 1.0.0, 1.2.4, 1.3.12, 1.5.0-M1, 1.5.0).
- OpenAPI/Swagger 3.0.
To automatically create a test suite from a valid OpenAPI/Swagger definition:
- Right-click the project in the Test Case Explorer and choose Add New > Test (.tst)...
- Specify a name for the file and click Next.
- Choose the REST > OpenAPI/Swagger option and click Next. For details on accessing the wizards, see Adding a New .tst File to an Existing Project and Adding a New Test Suite.
- Enter the absolute URI for the OpenAPI/Swagger definition file or click Browse to find it on the local machine.
- Choose a Test Suite Type:
- Individual clients: Generates individual test clients grouped by API resource. A test suite is generated for each resource containing test clients for every method available for that resource.
- Test scenarios: Generates test scenarios containing different sequences of API resources. A test suite is generated for each scenario. Uses the OpenAI API with the account information configured in your OpenAI preferences.
- If you choose this option, click Next to advance to the Test Scenario Generation page. Enter brief instructions for the AI regarding the test scenarios you would like to create (see Writing AI Prompts; you can also view examples and recent prompts using the menus above the field) and click Generate (this can take a few seconds). If you want the AI to create more scenarios, click Generate More. If you want the AI to discard all the scenarios and start over, click Regenerate. You can change the prompt for the AI before you do either. Enable the scenarios you want to use and disable the ones you don't.
- Note: This feature depends on OpenAI, which may produce inaccurate information.
- Click Next. The Create Environment page opens.
- (Optional) Specify whether you want to reference an existing environment or create a new one.
- To create a new environment:
- Enable Create a new environment for your project.
- Enter an Environment Name and Variable Prefix.
- To reference an existing environment, enable Reference an existing environment then specify the appropriate environment file.
- For more information on environments, see Configuring Testing in Different Environments.
- To create a new environment:
- Click Finish.
When a .tst is generated, it includes one REST Client for each resource/method pair in the OpenAPI/Swagger definition.
- Each REST Client is set to be constrained to the specified service definition and schema (if applicable).
- Its resource URL, HTTP method, and payload (if applicable) are configured accordingly.
- The service's base URL is configured as a "BASEURL" variable, and each resource URL is parameterized with the "BASEURL" variable.
- Query parameters are included with default or sample values (if available) as defined by the service definition.
- If the service definition includes a schema, a sample payload is constructed from (and constrained to) that schema.
Additionally, test scenarios created with OpenAI will automatically have applicable smart test templates applied to them.
