Versions Compared

Key

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

...

Excerpt
hiddentrue
nameRequirement Properties admin

Read this documentation page to learn how to use the requirement configuration macro and change the way your requirements are indexed.

It is absolutely not mandatory to use a Configuration macro, but it will help you customize your requirement detail with property and dependency names.

Follow this tutorial to know how to add properties to requirements, and dependencies. And how to customize their names to simplify your requirement detail:

https://youtu.be/891Q3OpCiLA?si=iaWgX2gN_TQj5L0Q

To add a configuration macro, in the page edit mode, type /requi  or /config, or click on the + dropdown like you would to add any other Confluence macro.

Image Modified

After adding a macro to the page, you can edit it simply by clicking on the macro:

Image Removed

...

Image Added

It is also possible to add a Configuration macro from the view mode, with the Transformation wizard.

Table Configuration

If your requirements are in tables, it is absolutely not mandatory. The Requirement Yogi configuration macro is useful to change the way your requirements are indexed and override column titles, or choose to put the 3rd column as the description instead of the 2nd.

When you define requirements in table, by default, the requirement key

...

will be in the first column, with a description in the second column, and properties and dependencies in the following columns.

It also works for vertical tables: rows will be identified as columns. (Ex: 1st row in your vertical table will be mapped as the 1st column in the Configuration macro, 2nd row to the 2nd column, and so on.).

This table:

...

Gets indexed as:

...

Image Added

Image Added

Here is the default configuration for requirements in tables:

With the configuration macro, you can:

  • Rename properties.

  • Change the column type.

...

Image Added
  1. Here, I changed the column of "Author" in "Original Author".

...

  1. The "Dependencies" column was indexed both as a dependency and as a property, so

...

  1. we added a 4th column to

...

  1. the configuration macro

...

  1. and unchecked the indexing as a property, and

...

  1. set

...

  1. it to Dependency

  2. We ticked “Apply to all the following tables in the document

...

  1. ", if this is unticked, the configuration will only apply to the following table. This configuration is not global, you need to add the macro to every Confluence page with requirements

...

  1. .

...

Image Added

After inserting the macro and publishing the edited Confluence page, my requirement is now indexed with the changed properties as:

...

Image Added

You can quickly "unindex" the requirements in a page by adding a configuration macro at the top of the document and uncheck the requirements column. It can be useful when you have duplicated requirement definitions.

In paragraphs and headings

Info

New feature

Paragraph Configuration

When you define requirements in paragraph or headings, by default, the description of the requirement is the following text.

...

Requirement keys in paragraphs:

...

Image Added

Here are my requirements:

...

Image Added

...

Image Added

...

Image Added

With the configuration macro, you can:

  • Change the property name.

  • Treat the bold text as normal text.

  • Change the dependency name.

  • Ignore the numbering in headings.

...

Image Added

After inserting the macro and publishing the document, here is my requirement again:

Image Removed

Image Added

When requirements are in headings

You can ignore the numbered headings by passing a regular expression specifying the numbering format.

My headings:

...

Image Added

will get saved as:

...

Image Added

Here are a few common ways to number headings and their regexes:

Numbering

Example

Regex

Decimal

1.2.

^(\d+\.)+\s*

ISO-2145

1.2

^(\d+\.?)+\s*

Lower-latin

a.b.

^([a-z]+\.?)+\s*

Upper-latin

A.B.

^([A-Z]+\.?)+\s*

Upper-roman

I.II.III.

^([IVXLC]+\.?)+\s*

Document Configuration

Info

New Feature 🚀

This is the evolution of the paragraph configuration. We call this feature Linear Documents. It is best suited when requirements are written outside of tables, when you reuse public standards or your customer’s requirements.

Instead of only having the following line in the description, each heading of your paragraph will be indexed as a requirement, with its whole body as a description, dependencies to higher and lower level titles.

Read the documentation, or watch the tutorial.

What your document looks like:

What we index:

Image AddedImage Added

Image Added