RMsis provides the following categories of macros for embedding information in confluence :
- Single Macro : Using this macro, a single entity (e.g requirement, test case, release, test run) can be imported from RMsis into Confluence.
- List Macro : Using this macro, a group of entities (e.g requirements, test cases, releases, test runs) can be imported from RMsis into Confluence.
Following table summarizes list of macros supported by RMsis :-
S.No. | Macro Name | Supported Category | Description |
---|---|---|---|
1 | Planned Requirement | Single | Embeds selected fields of a given planned requirement in confluence. |
2 | Planned Requirement | List | Embeds list of planned requirements based on filter selection in confluence. |
2 | Unplanned Requirement | Single | Embeds selected fields of a given unplanned requirement in confluence. |
2 | Unplanned Requirement | List | Embeds list of unplanned requirements based on filter selection in confluence. |
3 | Release | List | Embeds list of releases based on filter selection in confluence. |
4 | Test Case | List | Embeds list of test cases based on filter selection in confluence. |
5 | Test Run | List | Embeds list of test run based on filter selection in confluence. |
6 | Traceability | List | Embeds traceability table based on filter selection in confluence. |
7 | Reverse Traceability | List | Embeds reverse traceability based on filter selection in confluence. |
Using Single Macro
In order to use any single macro (planned OR unplanned requirement) process is similar. Below example demonstrate embedding a single planned requirement into confluence.
- Open a page in Confluence in edit mode
- Click on "Insert" menu and select "Other Macros" from document menu (OR press key board short cut "Ctrl+Shift+A").
- Search for "RMsis" in search bar and select "RMsis Requirement".
- Click on "RMsis Requirement" macro
- Specify requirement ID in "Requirement Key" field.
- Specify version of requirement to be displayed in "Requirement Version" field.
- Select "Requirement Display Type" as "Full" OR "Brief".
- "Full" option will show all attributes of requirements
- "Brief" option will display requirement ID and summary.
- Select "Content Type" as "Static" OR "Dynamic".
- "Static" option will display contents and will not change even if contents are changed in RMsis.
- "Dynamic" option will update the contents in confluence page as soon as they are changed in RMsis.
- Click on "Insert" button to insert macro.
Using List Macro
In order to use RMsis list macro, user needs to define a Named Public Filter in RMsis , as described here : http://docs.optimizory.com/display/preview/Named+Filters). Below example demonstrates using planned requirement list macro to embed planned requirements in confluence.
- Open a page in Confluence in edit mode
- Click on "Insert" menu and select "Other Macros" from document menu (OR press key board short cut "Ctrl+Shift+A").
Search for "RMsis" in search bar and select "RMsis Requirement"
- Select "RMsis Requirement List" macro.
- Specify JIRA project key in "Project Key" field.
- Specify name of filter from RMsis planned requirement named filter section in "Filter Name" field.
- List the comma separated name of columns to be displayed in "List of Columns to Display" field.
- Select "Content Type" as "Static" OR "Dynamic". "Static" option will embed current contents and will not change even if contents are changed in RMsis. However "Dynamic" option will update the contents in confluence page as soon as they are changed in RMsis.
Click on "Insert" button to insert macro.