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.
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 |
---|---|---|---|---|
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 | In a Confluence page, in the column header containing the name of the property, add the following macro: | In a Confluence page, before the table containing the property to rename add the following macro: (Assuming the property to rename is defined in the column n°3) | Every DC Note : |
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
Note: | In a Confluence page, in the column header containing the name of the property, add the following macro |
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.
| 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 | In a Confluence page, in the column header containing the name of the property to index as | In a Confluence page, before the table, add the following macro
(Assuming the property to index as Description is defined in the column n°5 - see ) | Each property defined as Every DC |
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. | In a Confluence page, in the column header containing the name of the property to ignore, add the following macro | In a Confluence page, before the table, add the following macro:
(Assuming the property to ignore is defined in the column n°3 - see ) | Each property ignored can be set in the Every DC |
Ignore dependency while indexing | Goal: This configuration lets you define columns in the Confluence table without us indexing links as dependencies of the requirement. | In a Confluence page, in the column header containing the name of the dependencies to ignore, add the following macro | In a Confluence page, before the table, add the following macro
(Assuming the dependencies to ignore are defined in the column n°4 - see ) | Each property with the ignored dependencies can be set in the Every DC |
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 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 Note that this will configure requirements defined in tables only, and not requirements put in paragraphs. | Note that the checkbox To replace the |
Test Relationship | Goal: This configuration let you set the relationship used for test results when the plugin |
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.