Use the Composer to update and modify your test. The following sections provide information about the Composer, and how to use it.

About the Composer
Using the editor
Adding a component
Editing a component
Moving components
Transforming a component
Deleting a component

About the Composer

If you are not on the Composer page, or you want to modify a different test, follow the instructions in Opening a test in the Composer to find the test that you want to modify, and open it in the Composer.

Image of composer

The Composer shows all of the components that make up the test. In our getting started example, the first component is the request to the API endpoint - which in this case is a GET to ${endpointUrl}. When the test was generated, it extracted the URL that you provided into a variable. To see any variables that were generated, click the Data Sets icon Image of data sets icon in the left navigation pane.

Image of composer datasets

After the request line, you will see the assertions and other components, for example Aeq, Ai, Ae, for each in and so on. For more information about assertion components, see Assertion components.

Using the editor

The test can be edited by using either the code (text) editor, or the visual (graphical) editor. Toggle between these two editors by clicking the CODE and VISUAL tabs in the upper right of the Composer. The visual editor is the default editor.

Image of composer code visual links

The following instructions describe how to make changes by using the visual editor.

Adding a component

You can add a component by using one of the following options:

  • By clicking the add component icon Image of add component icon in the upper left of the Composer.

  • By clicking a component at the location where you want to add a new component, then clicking the menu icon Image of menu icon, and selecting Add component before or Add component after, depending on where you want the new component to be positioned.

A list of component types is displayed.

Image of component types dialogue

After you’ve chosen your component type, carry out the following steps to add the component to your test. Note that you can hover over each component to see a description of what that component does.

  1. Click the component type that you want to add.

  2. Configure the new component’s parameters in the component dialogue box.

  3. Click the Confirm changes icon Image of check mark icon to apply the changes.

  4. If your new component is in the wrong location, you can drag it to the correct location. Note that you can drag any component in your test.

  5. Click Save to save your changes.

Editing a component

You can edit a component in any one of the following ways:

  1. Double-click the component to be edited.

  2. Click the component, and then click the Edit component icon Image of edit component icon in the upper left of the Composer.

  3. Click the component, then click the menu icon Image of menu icon and select Edit component.

  4. Click the component, then click Edit on the right of the component pane.

The edit dialogue box is displayed. Each component dialogue box will look different, as they all have different sets of parameters.

In the edit dialogue box, you can make the following changes:

  • Modify any of the component’s parameters.
  • Clone the component by clicking the Clone component icon Image of clone component icon.
  • Delete the component by clicking the Remove component icon Image of remove component icon.
  • Cancel changes by clicking the Cancel changes icon Image of cancel changes icon.
  • Apply changes by clicking the Confirm changes icon Image of confirm changes icon.

Click Save to save your changes.

Moving components

Simply drag-and-drop any component from one position within the test to another position in the visual editor.

Remember to click Save to save your changes.

Transforming a component

You can transform a request component to be a different type of request, and an assertion component to be a different type of assertion.

  1. Click the request or assertion component to be transformed, then click the Transform component icon Image of transform component icon in the upper left of the Composer.

  2. Select the type of request or assertion that you require.

  3. Complete the edit dialogue box for the new type of component.

  4. Apply the changes by clicking the Confirm changes icon Image of confirm changes icon.

  5. Click Save to save your changes.

Deleting a component

You can delete a component in any one of the following ways:

  • Click the component to be deleted, and click the Remove selected component icon Image of remove selected component icon in the upper left of the Composer.
    • This technique can also be used to delete a block of components. Click the first component in the block, and press the shift key while clicking the last component in the block. Then click the Remove selected component icon Image of remove selected component icon.
  • Click the component to be deleted, then click the menu icon Image of menu icon, and select Remove component.

  • Click the component to be deleted, then click Edit on the right of the component pane, and then click the Remove component icon Image of remove component icon.

Remember to click Save to save your changes.

What to do next