Work with application modules

To track product quality, use the application module tree in the Quality module and the dashboard.

Plan the application module structure

When deciding how to structure your application models, consider the following:

  • How you currently manage the quality of your product. In particular, focus on the areas of the product whose quality you want to track.


    • End-to-end user processes

    • Overall flow and consistency of navigation within the product

    • Comprehensive shortcuts for all functionality of the product

    • Consistency and syntax of messages and warnings

    • Performance and load

    • Regression

  • The testing you perform on a release-by-release basis (performance, regression). These are tests that run for many releases and determine overall product quality. These are not tests run for a particular release, such as sanity.

  • How you prefer to judge overall quality: by number of outstanding defects, test results, or feature status

Use this information to design your application module tree in the next step.

For meaningful analysis of overall product quality, you do not want the tree to change that much between releases.

Tip: After you create the initial application module tree, you can drag items to new parent items to reorganize as needed.

Create the application module tree

Leader permissions are required.

  1. Open the Quality module.

  2. Click the pencil to start working with the Application Modules tree.

  3. Navigate to a node in the tree. Position in the tree matters, so navigate accordingly. Application modules are created under the currently-selected application module.

    Tip: Did you create an application module at the wrong place in the tree? You can modify the location by clicking the pencil and updating the Parent field or drag items to new parent items to reorganize as needed.

  4. Add or remove nodes.

  5. Click OK to stop editing the application module tree.

Back to top

Select which application modules to display

Depending on your role in product development, you may not want all the application module trees visible when you work.

  1. Open the Quality module.

  2. In the toolbar above the application module tree, click the down arrow on the Define subset button .

  3. From the dropdown list, select the application modules you want to display.

    You can select only the first level application modules.

    Tip: If you do not see or cannot find your specific application modules by navigating through the application module tree, enter the name of the module in the search field. ALM Octane searches the available application modules and displays relevant results you can select.

All other details in the other tabs (Overview tab graphs, Features, Tests, and Defects are updated to reflect only the selected application modules.

Back to top

Assign items to application modules

In order for application modules to be useful, you must add features, tests, and defects to the application modules. Once the items are assigned, ALM Octane can begin to assess product quality.

If you assign an item (such as a feature) to an application module, other associated items (such as tests or defects) are assigned to the same application module.

Do one of the following:

When creating a single item

In the item's details, in the Application modules field, select a relevant application module:

For multiple items from the grid
  1. Do one of the following:

    • In the Backlog module, select tests in the Tests tab, features in the Features tab, or defects in the Stories tab

    • In the Quality module, select items in the Defects, Features, or Tests tab

  2. In the toolbar, click Assign to Application Modules.
  3. In the dialog, select the relevant application modules and click OK.

If you select a single application module, the Create Rule button is displayed. This enables you to create a rule that assigns automated tests which match a filter (that you specify) to the selected application module. For details, see

Back to top

Automatically assign automated tests to application modules

To assist in adding items to your application modules, you can create rules that assign automated tests to a specific application module. The rule runs when you save it initially and each time a new automated test is discovered.

  1. In the Tests tab (either in the Backlog or Quality modules), select a test.

  2. Click Assign to Application Modules.

  3. Select a single application module.

  4. Click Create Rule.

  5. Give the rule a meaningful name, such as End2End Tests.

  6. Optionally, add additional application modules to be assigned by this rule, and/or add a Test owner to assign.

  7. Click Add filter to add conditions to the filter, or edit the existing conditions.

    The conditions can be based on the values of the following fields: Class name, Component, Name, and Package.

    Filters can be multipart and complex, and can include '*' as a wildcard. If necessary, click the Add filter button multiple times to add multiple items to the filter.

    All conditions must be met for the rule to assign the selected values to an automated test.

    Note: By default, the filter in the Create Assignment Rule dialog box matches the filter you were using in the Tests tab. It is not affected by the tests you select on the page.

  8. Select whether the rule should assign application modules and/or a test owner even if those fields already have values, or only if they are empty.

  9. Click Save. The rule affects all current and future tests that match the filter. This includes tests currently in the system, as well as new automated tests detected in pipelines in the future.

For more details on test assignment rules, see Create and manage test assignment rules.

Back to top

Next steps: