Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Table of Contents

...


Info
iconfalse

You must have the Jira System Administrators global permission before you can carry out the instructions on this page.


Info
iconfalse

The Troubleshooting and Support screen allows:

  • refreshing all

...

  • app data (Integrity Checker tab)
  • check on issues pending automatic transitioning because of an automatic transition failure (Check Auto-Transition tab)
  • creating a zip file containing useful information about your instance

...

  • to send via email when requesting Herzum support (Support Request tab)

...

  • running the removal of the Approval Condition automatically added to all

...

  • workflow when installing the

...

  • app (Workflow Cleaning tab)

Info

Notice that it is expected that on uninstalling the

...

app the Approval Conditions

...

Do not remove the Approval Condition from the workflows to allow the add-on working properly.

 are automatically removed and this operation is suggested for troubleshooting exclusively.

...

If you have erroneously removed the

...

Approval Conditions from the workflows

...

, you can restore

...

Take care to enable the Jira Outgoing Mail and Incoming Mail logs in order to allow the add-on retrieving these information.

...

them by running a re-indexing.

Reindexing

Navigate the Reindexing tab on the Troubleshooting and Support screen.

Image Removed

When clicking Re-index the add-on will perform a check on add-on data in order to fix eventual inconsistencies.

In particular the performed actions consist in the follwowing:

  • Workflow Cleaning - for each workflow, exception made for the Default JIRA Workflow, the routine removes the approval condition on each transition.
  • Restore Approval Conditions on the Workflows - for each workflow, exception made for the Default JIRA Workflow, the routine adds the approval condition on each transition.
  • update the user list separatorFor each Approval, the routine checks, on the Users field, if the user list separator is the comma. If the check returns true, the separator ',' is replaced by the separator '&'.
  • grant the user set on AWT global setting with permission to run workflow transition  on all projects.
  • check  Approval Mapping data consistency - if any Approval Mapping  has Issue Type id, Project id, Source status id  or Transition id  that do not exist anymore in JIRA database, the Approval Mapping is deleted. 
  • check Issue Approval data consistency.- if any Issue Approval has a Source status ,id Approval id or Transition id that do not exist anymore in JIRA database, the Issue Approval is cleaned.
  • check the Permissions -> Approval Request -> Projects which have been enabled via the Permissions administration screen showed below - If the Project doesn't exist anymore in JIRA database, data are cleaned.
    Image Removed
  • check the Permissions -> Define approval for single issue - Projects  via the Permissions administration screen showed below  If the Project doesn't exist anymore in JIRA database, data are cleaned.
    Image Removed
  • check the Permissions to notify an Approval Request - If the Project and/or the Issue Type don't exist anymore in JIRA database, data are cleaned.
  • check the Permissions to view the Single Issue Approval button - If the Project and/or the Issue Type don't exist anymore in JIRA database, data are cleaned
  • check if existing condition/s and/or validator/s on same workflow/s have not allowed to automatically transition one/more issue/s. If any issue exists, the number of affected issues is displayed and it's allowed bulk transitioning all issues.
    Image Removed

WorkFlow Cleaning

Navigate the Workflow Cleaning tab on the Troubleshooting and Support screen.

Image Removed

Jus click Remove Approval Condition to automatically run a routine that for each workflow, exception made for the Default JIRA Workflowremoves the approval condition on each transition.

If all workflows have been successful cleaned a message informing is returned.

If any workflow has not been successful cleaned a message reports the list of workflows still affected by Approval Conditions.

Support Request

Navigate the Support Request tab on the Troubleshooting and Support screen.

Image Removed

Accomplish the suggested steps to generate a file reporting information extracted from your JIRA allowing to investigate any problem with Herzum Approval add-on.

Image Removed

The file will include the following information: 




Info
iconfalse

Page Tree
root@self