Requirements types

Managing requirements effectively is essential for the success of a project. However, ensuring that your requirements are consistent, well-structured, and meet specific criteria can be a complex task. In the past, this often required manual checks, extensive reviews, creating a lot of validation rules or external tools.

With requirement types, you can now define and enforce the structure of your requirements in a declarative way. This allows you to:

Organize requirements: Organize your requirements into meaningful categories.
Standardize requirements: Define the key pattern, properties, and external properties for each requirement type, ensuring every requirement meets your project's standards.
Ensure compliance: Quickly identify requirements that don’t comply with your specifications, making it simple to address issues.
Streamline requirement creation: Quickly create requirements using generated page templates tailored to each requirement type, making it simple to create requirements that meet your project’s standards from the start.

By using requirement types, you can bring consistency and clarity to your requirements management. This approach simplifies project organization, reduces errors, and ensures that every requirement aligns with your project’s standards. Whether you're starting a new project or improving existing workflows, requirement types empower you to maintain structure and streamline the process of creating and managing requirements.

How to create a requirement type?

To create a requirement type:

Navigate to the Management section.
Navigate to the Requirement types tab.
Click the Create requirement type button.
You’ll be able to provide a name, a description and the key pattern of requirements that should belong to the requirement type. You can use % as a wildcard (for example, BR-% to match all requirements that start with the BR- prefix).
Then, you’ll be able to define the optional/required properties and the optional/required external properties of requirements belonging to the requirement type.

How to access requirements belonging to a requirement type?

To access requirements belonging to a specific requirement type:

Navigate to the Management section.
Navigate to the Requirement types tab.
Each requirement type is displayed as a small card.
Click the link displayed next to the key pattern.
This will redirect you to the Search tab with the appropriate search query.

What happens when a requirement is invalid?

When requirements don’t comply with the defined specifications:

They are displayed in red throughout the application.
There are error messages when viewing the requirement popup.
There are error messages when viewing the requirement page.
You can find invalid requirements using the search syntax (e.g. ruleStatus = false).

How to manually validate requirements?

In general, when requirements are updated they are automatically revalidated.

However, there are still somes cases where requirements are not automatically revalidated.

To force the validation of all requirements belonging to a requirement type:

Navigate to the Management section.
Navigate to the Requirement types tab.
Each requirement type is displayed as a small card.
Click the Validate button on the top right corner of the requirement type.
This will trigger the asynchronous validation of all requirements belonging to a requirement type.

How to create a requirement page?

Once you have created a requirement type, you can quickly create pages using the generated page template (containing a table with valid requirement macros, all the configured properties, etc.).

The page template of a requirement type is automatically updated each time the requirement type is updated.

You can use this page template either from the Requirement types tab or directly from the Confluence page editor.

Option 1: From the “Requirement types” tab

Option 2: From the Confluence page editor

How to edit a requirement type?

To edit a requirement type:

Navigate to the Management section.
Navigate to the Requirement types tab.
Each requirement type is displayed as a small card.
Click the More button on the top right corner of the requirement type.
Click the Edit button in the menu.
You’ll be able to edit the name, description, properties, external properties, etc.

How to delete a requirement type?

To delete a requirement type:

Navigate to the Management section.
Navigate to the Requirement types tab.
Each requirement type is displayed as a small card.
Click the More button on the top right corner of the requirement type.
Click the Delete button in the menu.
This only deletes the requirement type, the existing requirements are not impacted.