Manually migrate RY Property macro

Manually migrate RY Property macro

Context

The main goal of this page is to present every details of the Data Center macro: requirement-property, and its equivalent in the Cloud.

As explained in https://confluence.intranet.requirementyogi.com/wiki/x/CgyPaw, the requirement-property macro can be added to your Confluence page with the shortcut /req. In Data Center, you need to put the requirement-property macro in each column of your table, whereas in the Cloud, you can put a single RY configuration macro at the top of your page to configure all columns of your table.

image-20250820-072031.png

Feature details and migration

Now let see the different features of this macro and how to migrate it in Requirement Yogi Cloud. In a few words, the manual migration implies that you go into each of your requirement-property macros on DC and manually reproduce the same settings on the Cloud.

Feature

Description

How to use in Data Center

How to use in the Cloud

Migration from DC to Cloud

Feature

Description

How to use in Data Center

How to use in the Cloud

Migration from DC to Cloud

Rename a property

Goal: Rename a property so the text in the header can be different than the property name in the requirement’s detail.

In this example: Rename the PropertyName to something like PropertyRename.

In a Confluence page, in the column header containing the name of the property, add the following macro: /ry property.

image-20250820-072042.png

In a Confluence page, before the table containing the property to rename add the following macro: /requirement yogi configuration.

image-20250820-073148.png

(Assuming the property to rename is defined in the column n°3)

Every DC requirement-property defined in a table header can be replaced with a single RY Configuration before the table. Each property can be renamed in the RY Configuration by filling the Override name of the proper column number.

Note :
- You can configure each column within one macro, whereas in DC, the macro only configured one column.

Define a default property and its value

Goal: Add a new property with a default value. User will be able to define a new property not present in the Confluence page.

In this example: Add a PropertyRenamed&Default with the value DefaultValue.

 

Note:
- Filling the Property value without the property Name has no effect because the Property name field as not been set.

In a Confluence page, in the column header containing the name of the property, add the following macro /ry property.

image-20250820-072059.png

There is no configuration equivalent in the Cloud.

However you can add a new column to your table and fill the header with the property name and all the cells with the property value.

Also, Requirement Types allow you to define a new property with a default value.

image-20250820-091834.png

 

You can add a new column to define this property and set all the cells to the wanted value.

 

For more advanced users with a lot of structure in their key naming, you can use the Requirement type feature to define, for this set of requirements, a new property with its default value.

Mark a property as title

Goal: This configuration allows to define a property as title (DC phrasing) /description (Cloud phrasing).

In a Confluence page, in the column header containing the name of the property to index as title/description, add the following macro.

In a Confluence page, before the table, add the following macro /Requirement Yogi Configuration. Tick the description to index it as title/description.

RY Configuration Migration Cloud Equivalent.png

 

(Assuming the property to index as Description is defined in the column n°5 - see )

Each property defined as title/description can be set in the RY Configuration by ticking the Description checkbox of the proper column number.

Every DC RY property defined in a table header can be replaced with a single RY Configuration before the table.

Ignore a property while indexing

Goal: This configuration lets you add columns in the Confluence table without us indexing its content as a property of the requirement.
This configuration still indexes dependencies.

In a Confluence page, in the column header containing the name of the property to ignore, add the following macro /RY Property.

image-20250820-072130.png

In a Confluence page, before the table, add the following macro: Requirement Yogi Configuration. Untick the box property for the columns you want us to ignore.

RY Configuration Migration Cloud Equivalent.png

 

(Assuming the property to ignore is defined in the column n°3 - see )

Each property ignored can be set in the RY Configuration by unticking the Property checkbox of the proper column number.

Every DC RY property defined in a table header can be replaced with a single RY Configuration before the table.

Ignore dependency while indexing

Goal: This configuration lets you define columns in the Confluence table without us indexing links as dependencies of the requirement.
This configuration ignores dependencies but will still index content as a property.

In a Confluence page, in the column header containing the name of the dependencies to ignore, add the following macro /RY Property.

image-20250820-072136.png

In a Confluence page, before the table, add the following macro /Requirement Yogi Configuration. Untick the dependency box to ignore.

RY Configuration Migration Cloud Equivalent.png

 

(Assuming the dependencies to ignore are defined in the column n°4 - see )

Each property with the ignored dependencies can be set in the RY Configuration by unticking the Denpendency checkbox of the proper column number.

Every DC RY property defined in a table header can be replaced with a single RY Configuration before the table.

Apply to whole document

Goal: This DC option is useful when the macro has been added outside of a table. In this condition, it impacts all requirements defined in the page.

In a Confluence page, in the column header or outside of a table, add the following macro /RY Property.

You can set up a default Property and Property value and apply it to the whole page.

In a Confluence page, before the table, add the following macro /Requirement Yogi Configuration. Set up your configuration, and tick Apply to all following tables.

Note that this will configure requirements defined in tables only, and not requirements put in paragraphs.

Note that the checkbox Whole document in the Data Center RY Property macro can be used all requirements (in or outside of tables). Whereas in the Cloud, the configuration can only be applied to requirements in tables.

To replace the Whole document configuration, you can add the Cloud Configuration macro on top of your Confluence page with the checkbox Apply to all following tables checked.

Test Relationship

Goal: This configuration let you set the relationship used for test results when the plugin RY Testing & Compliance is installed.

image-20250820-072202.png

There is no configuration equivalent in the Cloud because the RY Testing & Compliance plugin is not available in the Cloud.

Limits

This manual migration applies to the general context where the requirement-property macro from DC is set up in a table. If you are using it outside of tables, there may be some specific tweaks. If you want to get to know more about other equivalents on the Cloud, please feel free to check this documentation, or reach out on the support.