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.

  6. To apply text formatting, see Create manual tests.
  7. To add attachments, click Attach to add files and navigate to the required file or paste an image directly into the test.

    ALM Octane adds the attachment as a separate step in the test.

    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.

  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 create tables with parameters and parameter values for re-use in manual tests. When you run a test, it runs in multiple iterations using a different set of parameter values each time.

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

To work with parameters: 

  1. When creating a test that will use parameters, click the Parameters Table button.

  2. In the pane that opens on the right, either create a new table, or choose a saved table from the dropdown options.

  3. Enter a name for the table, and click on each column header to rename the column. Each column represents a parameter.

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

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

  5. 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.

  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: