Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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 consistency, as well as streamline the process of creating and managing requirements.

Organize and Structure your 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.

...

(lightbulb) Types of properties

Quick side note on the types of properties you can set in your requirement types:

  • String: a sequence of characters, this basically allows any value;

  • Integer: a whole number;

  • Float: a number, optionally with a decimal part;

  • Boolean: true or false;

  • Enum: a list of allowed values.

If the type of a property is not respected, then the requirement will be marked as invalid. You can find more information about Compliance here: https://confluence.intranet.requirementyogi.com/wiki/spaces/RYC/pages/edit-v2/2436202497#Ensure-Compliance.

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.

...

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.

...

Ensure Compliance

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 (in RY Tabs).

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

...

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

...

Streamline requirement creation:

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

...

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.

...