Difference between RY Property macro and RY Configuration 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.
Data Center | Cloud |
---|---|
Migration of RY Property macros into the RY Configuration macro
When doing CCMA to migrate your Confluence instance, the migration of Requirement Yogi applies a Transformation that will transform server / data center macros to cloud format. This transformation is done automatically in the CCMA and requirements, requirement links, and all
requirement-properties
macros will be transformed.If some requirements are not migrated within CCMA, it is always possible for you to apply the Transformation manually following this documentation: Transformation - Migrate Server macros to Cloud .
The use of the requirement-properties on DC is different than the RY configuration macro on Cloud, so here is the exact description of each feature present in the requirement-properties
macro, and its equivalent in the RY Config:
Feature comparison and equivalence
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 | Manual 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.‘Apply to whole document’: this feature is not completely replaced by the Config macro. Besides applying one property to the whole page, on DC, you could set up a property name and value for all requirements in a page, without being a column. This replacement does not exist on the Cloud.
'Default value': It is not possible to set up default values for requirements using the RY Config macro, However, you can set up default values with the Requirement Types.