TestModeller.io - API Fortress Tutorial

Welcome to the TestModeller.io API Fortress tutorial !

In this tutorial we'll be covering how to get started with TestModeller.io for API Fortress.

This is aimed for first-time users along with users who have existing projects in API Fortress.

A demonstration of Test Modeller for API Fortress covered in this tutorial.

1. How it works

TestModeller.io is a browser-based solution that enables users to:

  • Model a system under test as BPMN-style flowcharts.
  • Automatically generate test cases from the model, optimising testing for time and risk.
  • Define test data at the model-level and generate data at the same time as test cases.
  • Define test automation, automatically executing tests generated in Test Modeller.
  • Analyse test results and manage existing artefacts, with visual dashboards and a file management system that introduces traceability between test assets.

This quick start guide provides an overview for new users to get started with creating coverage based data driven API tests in API Fortress.

TestModeller.io a modelling tool which creates the perfect set of tests into a wide array of test case management systems, and automation frameworks. Along with overlaying the right test data to support your testing.

This section is by no means comprehensive and intended as a quick start guide. If you wish to learn more about modelling we recommend you review our knowledge base along with our video tutorials for a comprehensive guide to creating models and test automation.

The goal is to equip the reader with the working knowledge needed to get started with creating API tests to test their own web services. With TestModeller.io, this means automatically generating complete automated API tests in API Fortress from models that are quick to build and easy to maintain.

2. Prerequisites

Install Prerequisites

Here we'll be installing all the prerequisites you need to get started with API Testing through TestModeller.io.

  1. Create a free TestModeller.io account
  2. Create a free API Fortress account
  3. Install an automation server for importing and exporting to API Fortress. Documentation is available here to walkthrough installing your server.
3. Create an API Fortress Test

Create an API Fortress Test

Here we'll be creating a parameterised test in API fortress for consumption in TestModeller.io.

4. Import API Tests

Import an API Fortress Test Definition

Import your parameterised API Fortress test definitions.

5. Model Data Scenarios

Build a Model

Start creating a data model of the web service under test.

If you'd like to learn more about building models we recommend reviewing our knowledge base articles on creating models here.
6. Export API Tests

Generate API Tests and Export

Generate associated API Fortress data scenarios for your model.

Generate Coverage Focused Tests

Test cases are equivalent to paths through the model of a system under test. They are generated automatically from a model, with or without test data and test automation associated with them. Coverage techniques are also available to generate the smallest set of test cases needed to test given features with a required level of rigour.

  1. To generate test cases, navigate to the Generate tab of the menu and click “Generate”
  2. TestModeller.io will provide status updates as the tests are generated.
  3. To browse the generated tests, click “Tests” in the Generate tab of the menu. This will open the Test Cases side bar, displaying any created tests.
  4. Clicking on a test will highlight the path through a model’s logic which that test reflects.
Test Coverage

The tests generated by TestModeller.io are the optimal set of tests to maximise coverage across the model. You can learn more about test coverage and how to edit coverage settings within TestModeller.io at our knowledge base here.

Export API Fortress Tests

Once you have created a model with overlaid API fortress functions, and a test suite containing associated paths, you are ready to create data scenarios for API Fortress to consume.

  1. Click the execute button in the test path side bar.
  2. Select the automation server you have configured.
  3. Select the job 'API Fortress Generate' from the dialog window and specify the API Fortress connector to utlise for exporting.
  4. Once the job is complete and successful you can navigate back to your tests and see the expanded data sets available and ready for execution.