Content Comparison

...

Frequently Asked Questions

What is included in the RY for Confluence migration ?

The migration of our Confluence app only includes External Properties, and a transformation of requirement definition and requirement link macros from Server / Data Center to Cloud format.

What is not included in the Requirement Yogi migration ?

1. Some RY macros are not migrated and cannot be transformed with the migration / transformation wizard:

   1. For reports (requirement-report, requirement-report-pages), you’ll have to remove old macros and replace them manually with the RY Report.

   2. Requirement-property, you’ll have to remove those macros, and use the RY Configuration instead.

   3. requirement-baseline macros will not get migrated because we do not have an equivalent on the cloud.

2. Traceability Matrices and Requirement Types are also not migrated.

3. Baselines are not migrated within the CCMA, but they can be manually exported and reimported if necessary. Please find the documentation for more information.

What is included in the RY for Jira migration ?

The migration of our Jira app includes requirement links to Jira issues, also applying the relationships.

How to make sure permissions are correct in Confluence Cloud?

On the cloud, if you install an app, an “app user" is automatically created. This user is called Requirement Yogi for Confluence Cloud. Here are the steps to check the user can view and create pages in your spaces:

1. In your Confluence Cloud instance (not Atlassian admin) → Settings → Security → Global Permissions:

   • Requirement Yogi for Confluence Cloud is expected to be in a user group in the User groups tab,

   • Requirement Yogi for Confluence Cloud is expected to be listed in the Apps tab,

   • If you need help, see the screenshots below.

...

...

Image Removed

2. In Confluence Cloud → Settings → Security → Space Permissions:

   • The user group assigned to Requirement Yogi in the previous step is expected to be listed in the Default Space Permissions, with permissions to view and add pages.

   • Personal spaces where you want to use Requirement Yogi may not include the Default space permissions. You can make sure the permissions are correct by clicking on 'Manage access'.

   • If you need help, see the screenshots below.

Expand
title Screenshots for Space permissions:
Image Removed

How to make sure permissions are correct in Jira Cloud?

How do I make sure RY has the correct permissions for restricted pages?

If some pages are restricted, here are the possible solutions:

...

On Server / Data Center, remove all page restrictions by going into the Space Settings > Permissions > Restricted pages.

...

you

...

1. We only need to edit pages during the migration. Once the migration is over, you can remove the pages permission for the app. Requirement Yogi uses the user’s permissions to transform the pages in the Transformation Wizard.

How can I find non-migrated pages?

Most of the time, migration errors are caused by restricted pages, which prevent us from applying the transformation from Server / Data Center macros to Cloud format.

1. Using CQL

To find pages where the migration has failed navigate to Requirements > Pages tab. Use the search (advanced CQL) and use this query: type=page AND macro=requirement AND ryc_isMigrated != true. Note that it is possible to. migrate all those pages manually in the future with the Transformation Wizard.

2. Using the Rest API

You can use the Rest API to do a search on the whole space using this query: https://your-domain.atlassian.net/wiki/rest/api/content/search?cql=type=page AND macro=requirement AND ryc_isMigrated !=true

See more information here: https://developer.atlassian.com/cloud/confluence/advanced-searching-using-cql/

3. If you want to know on which spaces requirements are defined

In your Data Center instance > Requirement Yogi Administration > Usage metrics, you will be able to find spaces where requirements are defined. This can be useful if you want to know on which spaces you should expect requirements to be created on your Confluence Cloud instance.

I have errors in my migration and they are not listed here

If you are encountering some issues in the migration, please check this other documentation for possible solutionshave any questions regarding the migration, please find more information here: https://confluence.intranet.requirementyogi.com/wiki/spaces/RY/pages/1907065151/FAQ+-+Troubleshooting?atlOrigin=eyJpIjoiODdiZjU5NzkzMmYyNDVkMzkzNWVkYTE1NjU2NWJmOTkiLCJwIjoiYyJ9eyJpIjoiY2M3ZGJiNjFmYWE3NDhlZWEzNDEzMGY3NjE2NGU4YzEiLCJwIjoiYyJ9 .