Create manual tests

Create manual tests in ALM Octane.

Create tests and add test steps

Tests can be created from the Quality and Team Backlog modules, either from the Tests page or from a Test Suite.

You can compose a test script using either the Text Editor or the Visual Editor. Typically, tests are created using the Text Editor, however, you can also use the Visual Editor. The Visual Editor includes all of the functionality provided by the Text Editor, except for text formatting.

To create manual tests:

  1. Create the test.

    • From Team Backlog or Quality modules, click Tests, click the down arrow next to the + icon, and click Manual Test .
    • From a Test Suite, click Tests, click the down arrow next to the Add Existing Test button, and then click Manual Test.
  2. In the Add Manual Test dialog box, assign test attributes:

    Name The name of the test.
    Test type The type of test, such as acceptance, end-to-end, regression, sanity, security, and performance.
    Estimated duration (minutes) The time it takes to run the test.
    Backlog coverage The backlog items the test will cover. This helps you track the release quality.
    Application modules The product's application modules. This helps you track product quality, regardless of release.
    Description The test description.
  3. Click Add & Edit.

  4. Click Steps, and then click Text Editor .

    Note: To use the Visual Editor, to add or edit steps, click the Visual Editor button.

  5. Use the buttons in the toolbar to add steps.

    If you are entering the entire test manually, make sure to use the correct syntax. For details, see Manual test syntax.

    Add Step

    Add a setup step (an action in the application).

    Enter the step text. For example: Create a new Epic.

    Add Validation Step

    Check something in the application.

    Enter the step text. For example: Verify that the current phase is New.

    During the test run, you specify a pass or fail status for each validation step.

    Add Call Step

    Add steps from an existing test to your script.

    In the Add Tests dialog box, select the test or test that you want to call, and then click Add.

    The step is added as a hyperlink to the original test. Click the View test steps button to display the steps of the test that you called.

    Note: ALM Octane uses the latest version of the called test at run time, and not the latest version at the time of planning.

  6. To apply text formatting, see Format text in the test script.
  7. To add attachments, select a step and click Attach to add files and navigate to the required file or paste an image directly into the test. (When working with Internet Explorer, use the Attach button and not the copy/paste option.)

    In the text editor, ALM Octane seems to add the attachment as a separate step in the test. If you check the visual editor, you will see the attachment is actually associated with the selected step.

    You can view the file in the Attachments tab of the test, the Manual Runner when starting a test run, or the test run report.

    Note: If you rename a test's attachment after it is already included in a step, you must manually update the link to the attachment in the step.

  8. Save your test.

    Tip: While you work, save and label versions of your manual test. As you work with the test over time, compare versions to view modifications. For details, see Use versions of test scripts.

    Back to top

Use parameters in tests

You can use parameters in tests in order to run a single test several times with different values.

To use parameters you must create a data table, define the parameters, and create at least one data set with values. The number of rows in your data set determines the number of iterations the test will run.

If you create multiple data sets, when you run the test, you will be able to select the data set with which to run the test.

Here's an example showing a list of users and passwords. Each iteration will use a different set of values:

Data tables are shared, so you can use a single data table for multiple tests.

To work with parameters: 

  1. In the Steps tab of the test, click Data Table.

  2. In the pane that opens on the right, click Create a new table.

  3. Enter a name for the table and rename the parameters. , and add or remove columns as required.

    To add or remove rows or columns, click the dropdown arrow next to the row or column name. The arrow is visible when you hover over a cell or column header.

    Parameter names cannot contain empty spaces or angle brackets (< >).

  4. In each row, enter a set of parameter values.

  5. To add data sets, click the menu and then click Add Set. Enter parameter values for this set.

    Note: The first data set that you create is the default data set. When a data set is not explicitly selected, the default data set is used.

  6. Click Save when your table is ready.
  7. You can use the menu options next to the Save button to manage your parameter tables. If you select Remove from test, you disconnect the table from the current test but it is still saved in ALM Octane. If you select Delete table, it is removed from all tests that are using this parameter table. ALM Octane shows you which tests use the table before you delete it.

  8. In the relevant test step, enter parameter names using the following syntax: <parameter name>.

    Tip: You can also quickly access the list of parameters by pressing CTRL-SPACE. Use the keyboard arrows to navigate the list, and Enter to select a parameter.

  9. When you run the test, it runs in multiple iterations. Each iteration uses a different set of parameter values from the table.

    Using the above example, here are the results of a run:

Back to top

Next steps: