Your ProForma forms and form templates will be preserved when you migrate to Cloud. However, please note the following limitations:

  • You must migrate all projects

  • There are minor feature differences (listed below) between ProForma Server and ProForma Cloud

  • You must contact us so that we can reset an internal key to ensure linked fields continue working correctly

Feature Parity 

We strive to maintain feature parity across all hosting options. (Visit our Roadmap to see features currently in development.) However, there are some differences due to limitations Atlassian or third party apps. These include:


Migration Instructions

Instructions for migrating from Server to Cloud can be found here.

Instructions for migrating from Cloud to Cloud can be found here.

Site Import Migration

You can do a Site Import migration to Atlassian Cloud following the instructions here. However, we need to manually reset the HMAC Secret key in order for your linked fields on ProForma forms to work.

Updating HMAC Secret key to re-enable linked fields

We need to manually change a secret key in order for your linked fields on migrated issues to work after a Site Import migration to Cloud. The HMAC Secret key must be updated after migration.

Please contact us when your migration is complete so we can update your HMAC Secret key to restore linked field functionality.

For customers performing test migrations

The HMAC Secret must be updated after every migration.

Customers performing test migrations should contact us following each test to update the key each time if needing to test linked fields. Customers do not strictly need to update the key with each test. ProForma will continue to work fine except for linked fields.

We recommend customers contact us after their final migration so we can update the HMAC Secret key and ensure linked fields are working.

We recommend that you submit this form as soon as you have completed migration to your Cloud account. This will ensure that migrated data will work. Note that if new forms are created in the new Cloud instance, before the key has been updated, links to Jira fields will break when the key is changed.

To obtain the HMAC Secret key in your instance:

  1. Log in as a Jira administrator, and go to Jira Administration > Add-ons > Manage Apps.

  2. Click on ProForma: Forms for Jira to expand the details section.

  3. Click on the ‘xxx of xxx modules enabled' link (the numbers will vary depending on your version and configuration).

  4. Hover over the Admin - Manual Configuration item and click the ‘Enable’ button. 

  5. Refresh the page.

  6. Click on the Manage Configuration in the left-hand navigation bar under ProForma. 

  7. A screen showing the HMAC Secret will be displayed showing.

Migrating Individual Projects

Currently, it is not possible to migrate individual projects due to limitations in the Atlassian cloud migration tool.