Troubleshooting

There is a permission error on a lot of pages

You can click on the page link to view the page. You will see unmigrated macros in yellow.

• Either you did not allow the app to edit pages, as seen above,

• Either you did, but there are page-level restrictions, and pages can’t be processed,

• In either case, you can process pages later on, after the end of the migration. The upside of transforming the pages manually, is that this action is performed using the current user’s credentials, instead of the app's credentials.

To process pages manually:

• Create a transformation named, for example, “Migration”:

  • Go to a non-migrated page in the space,

  • In the top-right “…” menu, click “Requirement Yogi”. A dialog appears.

  • Click “Add step” → “Migration from Server to Cloud”,

  • Before executing this step, there should be an input box named “Transformation name:”. If there is a value, it will save this transformation for the current space, so that you can repeat it.

  • Click Transform.

  • You will have to create this transformation in each space.

• Transform the pages in bulk:

  • Go to the Requirements tab in the sidebar,

  • Open the “Pages” tab, so reach the same screen as the screenshot above,

  • Tick “Use CQL query”,

  • Enter the CQL: type=page AND macro=requirement AND ryc_isMigrated != true

  • Select all pages and click Transform,

  • Do it until there are no unmigrated pages left in the space.

• Repeat on other spaces.

• Again, the upside of this method is, as an external consultant you don’t need to fiddle with the permissions, you can just ask your customer to perform this operation with their own permissions.

My app doesn’t process any pages?

Verify that the app user has view and edit permissions on the page. (Permission settings are handled by Atlassian)

The migration of requirement macros to the cloud format involves searching for pages containing requirement macros. Unfortunately, the search sometimes returns incomplete results and mistakenly assumes that no more pages need to be migrated. In that case, you can run the migration job again by clicking the “Retry” button in the Queue tab.

You can also manually run the transformation wizard (Transformation wizard: Transform your pages ) to transform server macros to cloud macros.

I cannot find my requirements after a migration?

Indexation is triggered by an event on page modifications sent by Atlassian. Events can take a few minutes, or rarely hours before we receive them.

You can also queue the indexation of a page by clicking on the “Refresh” icon in the Requirement Yogi byline.