Installation Instructions

• Log into your Jira instance as an admin.

• Click the Cog Icon and choose Manage Apps.

The Manage add-ons screen loads.

• Click Find new apps from the left-hand side of the page.
• Locate Herzum Approval via search.

The appropriate app version appears in the search results.

• Click Try free to begin a new trial or Buy now to purchase a license for Herzum Approval.

You're prompted to log into MyAtlassian. Herzum Approval begins to download.

• In order to purchase a license for Herzum Approval enter your information and click Generate license when redirected to MyAtlassian.

• Click Apply license.

If you're using an older version of UPM, you can copy and paste the license into your Jira instance.

 To find older Herzum Approval versions compatible with your instance, you can look through our version history page.

 You can extend your app trial up to 5 times - in other words, for up to six months.

Upgrade Notes

On upgrading the app to an up to date version, it's recommended to upload the app in order to maintain active the configured Approval Mail Handler.

Consider that on uninstalling and installing the app it's possible that configured Approval Mail Handler doesn't register so that approval via e-mail doesn't work.

If you encounter this problem you need to delete the existing Mail System configuration and re-create it as detailed on Configure Jira application emails to allow approval response via email .

Downgrade app version

Downgrade app version from v.6.0 to v.5.X

We are not aware of any critical issue related to downgrade app version from v.6.0 to v.5.X.

Downgrade app version from v. 5.0 to v. 4.X

We are not aware of any critical issue related to downgrade app version from v.5.0 to v.4.X.

The only known issue is trivial and can be fixed via UI.

Known Issue

The issue has been introduced by 

Cause: the CUSTOM_COMMENT field into the Global Configuration table has been updated from Varchar(255) to @StringLength(value=StringLength.UNLIMITED).

The following steps cause the error 

1. install version 5.0
2. Insert into the Global Configuration → "Approval Log Text" a Body with length> 255
3. Uninstall version 5 and install version 4

Result:

Approvals Administration screens, Panels and navigation items are broken

Workaround:

1. install version 5.0
2. Update the text of the CUSTOM_COMMENT field  so that it has length< 255 i
3. Uninstall version 5 and install version 4

Downgrade app version from v. 4.0 to v. 3.X

On downgrading app version from v. 4.0 to v.3.X, you can encounter the following error:

If you encounter this problem you need to run the following script:

The query above was written in MySQL syntax, so you may need to tweak it depending on the database you are using.

Supported platforms

Jira Version 

Version 6.x are compatible with Jira Server and Data Center from v. 8.X to 9.X.

All environments that meet Jira Server and Data center applications installation requirements are supported.

Databases

The supported databases include the following:

• Oracle
• MySQL
• PostgreSQL
• Microsoft SQL Server

Web Browsers

The supported Web Browsers include the following Desktop browsers:

• Chrome
• Microsoft Edge 
• Mozilla Firefox
• Safari