Set up rules

You can set up rules that trigger actions in ALM Octane when certain conditions are met.


Rules contain an action and usually a condition.

You set the action that should occur when the condition is true.

  • Actions

    Examples of actions include making fields required, making fields read-only, setting a default value for a field, and so on.

  • Conditions

    When conditions are met, the rule's action is performed. For example, a rule can make the Fixed in Release field required if the Status field is changed to Fixed. Status=Fixed is the condition.

    If you don't specify a condition, the rule's action is always performed. For example, you may want a field to always be required.

Sharing rules between spaces

Rules can be defined for shared spaces and workspaces.

  • When defined for shared spaces, the rule applies to all associated workspaces. The shared space admin can create and modify these rules.

  • When defined for a specific workspace, the rule applies to that individual workspace only. The workspace admin can create and modify these rules.

Individual workspace rules run first, and then shared space rules . For details, see Do shared space rules or workspace rules take precedence? .

Back to top

Define rules

Rules can be defined for shared spaces and workspaces.

Shared space admin or workspace admin permissions are required.

See how to define rules

Watch a slideshow that shows you how to work with rules:

Create a rule

  1. Plan ahead.

    Depending on the rule you are defining, there may be some preliminary steps to take before starting.

    For example, if you are creating a rule with the Call URL action, you may want to define credentials before creating the rule.

  2. In Settings , click Spaces and select a space or a workspace.

  3. Click Entities and select the item for which you want to create a rule.

  4. Click Rules.

  5. You can create a new rule or use an existing one as a basis:

    • Click + to create a new rule.

    • Select a rule and click Duplicate Rule.

Define an action

Click Action and choose the action for the rule to perform.

Enter the relevant values for that action.

Define a condition

A condition is made up of a field, an operator and a value.

  1. Click Condition to start creating the condition.

    Only one condition can be defined for each rule. But the condition can be a complex condition: This means that you can have one condition with several parts, separated by And and Or operators.

    If necessary, add AND/OR expressions to the condition.

    As you build the condition, a textual representation of the condition is displayed in the Description box.

    Note: Conditions can evaluate to false if ALM Octane encounters a field in a rule definition that it cannot process because the field does not exist. Sometimes this is because a field was removed from the project. There are situations where this is not an error, but part of the logic necessary to implement your organization's policy.

    By default, rules are activated. For details, see Understand rule activation and performance.

    After you save the rules, ALM Octane automatically runs them.

Back to top


Examples of creating rules are listed below.

Back to top

Next steps: