Troubleshooting service projects
If you run into issues with your service project, refer to the information below.
Approvers not receiving notifications
When a ProForma field is linked to the Jira Approvers field, it allows users to assign approvers for an issue or request entirely within a ProForma form. However, these approvers will often not receive a notification or email requesting their attention. This is due to the order of operations and Jira attempts to send the notice before ProForma has had a chance to tell Jira who the approver is.
There are three possible workarounds:
Move the approver field off of the ProForma form and handle it using a Jira custom field instead.
Add an interim status.
Create a Jira automation rule that scans recent issues based on a schedule and JQL query, and notifies approvers who need to look at an issue.
Compatibility with refined structure and theme
When there is a dropdown at the bottom of the form, or when conditional logic means no other sections are displayed, only the first option of the dropdown is displayed, and the rest are obscured by the create button. The workaround is to add extra white space at the bottom of the form (which is always, rather than conditionally, shown). This provides space for the dropdown menu.
If you are using the Legacy form builder, you will need to use an Information section and several empty line break tags to add the blank space:
<br />
<br />
<br />
<br />
Duplicate forms on Jira Service Management portal
Duplicate forms may appear on the Jira Service Management portal if both ProForma and ProForma Lite are installed. To resolve this error, uninstall ProForma Lite. Form templates created with ProForma Lite will continue to be available.
Forms not loading on Jira Service Management portal
An incompatibility issue can cause ProForma forms not to display on the Jira Service Management portal if Calendar for Jira – Plan Team Activities is installed on Jira 4.7.1. Upgrading to Jira 4.10.0 or above resolves the incompatibility.
Completed forms not visible on Jira Service Management portal
An incompatibility issue with Theme Extension for Jira can cause only the description field is displayed under the Details section after a customer has created a request with a ProForma form.
The solution is to:
Go to Jira Administration>Manage Apps > Theme Extension.
Use the toggle to disable the Request Details View.
Jira history tab and audit tracking
Changes to ProForma form fields are not recorded in the issue history tab. Likewise, if a ProForma form makes a status change to a Jira issue using a form automation rule, there will also be limited information regarding that in the issue history. Improving ProForma’s history and audit tracking will be addressed in future development. In the meantime, it’s possible to integrate with the issue history tab by using linked Jira fields on the form for the specific data whose changes you would like to track. Data in linked Jira fields is available for Jira reports, JQL queries, and the history tab.
Unsupported content
An error message "Unsupported Content" may display when viewing forms on the Jira Service Management portal in Internet Explorer 11. To resolve the error, switch to another browser. If your users are dependent on Internet Explorer, you'll need to revert to version 7.3.x of ProForma.