ProForma features

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community


Feature

ProForma

ProForma Lite

Environment



Data Center

ProForma is available for Jira Data Center products: Jira Software Data Center and Jira Service Management Data Center.

View in Atlassian Marketplace

(tick)

(tick)

Jira project type



Business

All standard ProForma features of are available for Business projects: Jira Core or Jira Service Management Data Center.

(tick)

(tick)

Software

All standard ProForma features of are available for Software projects: Jira Software or Jira Service Management Data Center.

(tick)

(tick)

Service

In addition to the standard features, ProForma offers additional functionality for Service projects:

  • Publish form to the Jira Service Management portal. When the form is submitted, a request, including the form, will be created.
  • Add multiple forms to a single request to manage complex, multi-step processes via the portal.
  • Reopen existing forms so requests can be edited/updated from the portal.

(tick)

(tick)

Forms



Number of form templates

Build as as many form templates as you need, adding questions and information sections to ensure that you collect all of the information your need. 

ProForma Lite is limited to three form templates; however, there is no limit to the number of forms based off these form templates.

UNLIMITED

3 ONLY

Number of forms

There is no limit to the number of forms that can be included on a single Jira issue or request. Likewise, there is no limit to the number of times a given form may be used.


UNLIMITED

UNLIMITED

PDF of a form

Download a PDF, either from the issue or from the Jira Service Management portal, of any submitted form. Or use forms settings to automatically generate a PDF of the form and attach it to the issue.

Lite: Can only download a basic PDF

Full: Can download a rich PDF with the layout of the form preserved.


(tick)


BASIC ONLY

Form states

ProForma forms can be in one of three states, allowing you to see how the user has interacted with the form:

  • Open – Open forms can be filled out by the user. A user can save a form in progress to be submitted later. 
  • Submitted – When a form is submitted it indicates that the user has finished filling out the form. Submitted forms can be reopened to allow the responses to be edited.
  • Locked – ProForma includes a setting that locks forms on submission, ensuring that the responses on the form can't be changed. Locked forms can't be reopened for editing.


(tick)

(tick)

Example form templates

ProForma includes a library with hundreds of ready-to-use form templates. You can use them as is, modify them to meet your teams' practices, or embed them in another form.


200+

200+

Dynamic fields (conditional logic)

Use conditional logic to dynamically show or hide form sections based on the user’s response to a previous question.


(tick)

(tick)

Confluence-style form building

Use page layouts, tables, rich text formatting and insert panels to create beautiful, user friendly forms. It's like having Confluence editing capabilities in a Jira environment.


(tick)

(tick)

Multilingual support

ProForma has full multilingual support on the issue/request forms pages and on the Jira Service Management portal. You can write forms templates and responses in any language. Validation messages and the user interface are also multilingual.

If we don't currently support your required language, contact us and we can work on providing the relevant translation. 


(tick)

(tick)

Link directly to forms

Link directly to a form that can be used by logged-in Jira users to create issues. For example, include links in Confluence pages, a Jira sidebar, or notifications.


(tick)

(tick)

Include images on forms

Add images to ProForma forms for branding, illustrated instructions, or simply to make your forms more attractive. Check out how to add an image

Early release

This feature is in early access and we aim to improve it. We're working on uploading an image directly into a form, rather than having to use a link to an image.

(tick)

(tick)

Configuration



Enable for specific projects

Enable or disable ProForma on any project.

(tick)

(tick)

Bulk project toggle

For instances with a high volume of Jira projects, use the bulk toggle button to quickly enable or disable ProForma on all projects.


(tick)

(tick)

Project-level administration

Project administrator can create, edit, and maintain their forms, and can also set up most form automation rules without the assistance of Jira Administrators.

(tick)

(tick)

Control use of clickable links and HTML

Control whether or not:

  • HTML can be included on forms
  • entries in URL fields will be rendered as clickable links when the form is in view mode


(tick)

(tick)

Custom fields



Reduce custom fields

Form fields allow you to collect additional data without creating Jira custom fields. Teams can collect all of the information they need without burdening the Jira administrator or impacting Jira performance.

(tick)

(tick)

Link form fields to Jira fields

Form fields can be linked to Jira fields (standard or custom), making the data available for reports, JQL queries, or automation. The value entered in the form field will populate the Jira field and vice versa.


(tick)

(tick)

Preserve original form value if Jira field updated

If a form is SUBMITTED or LOCKED, the contents of the form will not change even if linked Jira fields are updated. This allows Jira to be used as a system of record.  

(tick)

(tick)

Jira Service Management portal



Use form to create requests

ProForma forms can be published to the Jira Service Management portal, allowing service teams to collect the exact information they need for a given request type. When the customer submits the form, a new request is created, with the form include.


(tick)

(tick)

Multiple forms

Service agents can add additional forms to the request. Forms can be added for internal service team use, or to collect additional information from the customer. Forms that were added for internal processing can later be made external to share the results with the customer.


(tick)

(tick)

Update requests

Service agents can reopen submitted forms, allowing customers to edit or update their responses. This ensures that the most up-to-date data is in the appropriate field, not buried in a comment chain.


(tick)

(tick)

Leave form open after request created

A form setting allows you keep forms open (editable) even after the customer creates the request. Use this feature for long forms that need to be filled out in stages, or for iterative processes with a lot of feedback going back and forth.


(tick)

(tick)

Issues and requests



Create issues and requests from forms

Use ProForma forms published to the portal to create requests in Service projects. 

For Software or Business projects, enable the Issue Forms feature to allow users to access and submit forms directly from the Jira navigation menu. When the form is submitted, an issue – with the form included – will be created. Include links to these forms in notifications, Confluence pages or your Jira sidebar.


(tick)

(tick)

Add forms to issues or requests

Manually add forms to existing issues or requests with the click of a button. Select from all available forms or from a list of forms recommended for the indicated issue type or request type.


(tick)

(tick)

Multiple forms per issue or request

Organize data by including as many forms on an issue or request as needed. Add multiple copies of the same form to capture the state of an issue at a particular point in time. You can also add different forms to collect different pieces of information or data from different users.


(tick)


(tick)

Submit/lock form

Set forms to lock on submit, ensuring that responses can't be changed once the form has been submitted. Alternatively, leave forms unlocked to allow for future editing.


(tick)

(tick)

Reopen forms

Any form on an issue or request, that has not been set to lock on submit, can be reopened for editing and updating.


(tick)

(tick)

Integrations



Third-party APIs

Connect to third-party APIs to load live data into choice questions on ProForma forms.


(tick)

(error)

Configuration Manager for Jira

Supports for Configuration Manager for Jira (version 6.3.4+) makes it easy to migrate form designs from one project or instance to another, or from one Jira instance to another. 

(tick)

(tick)

Refined structure and theme for Jira Service Management

Combining ProForma portal forms with Refined Structure and Theme allows you to create a useful, branded portal that collect all the data service agents need. 


(tick)

(tick)

Question types

Learn more about question types



User lookup

In Jira Service Management, select one or more users and link to Reporter or Approver fields.


(tick)

(error)

Short text

Use single line text questions for collecting short, open-ended responses.


(tick)

(tick)

Long text

Use single line text questions for collecting short, open-ended responses.


(tick)

(tick)

Paragraph

Paragraph questions allow users to enter in-depth, multi-line responses.

(tick)

(tick)

Email

Use email fields to ensure properly formatted email addresses.


(tick)

(tick)

URL

Collect relevant links with URL fields.


(tick)

(tick)

Number

Collect numerical values, whole or decimal.


(tick)

(tick)

Choice (single, multi-select, or dropdown)

Use choice question to present specific options to uses. You can use choice question to trigger conditional logic in subsequent form sections.


(tick)

(tick)

Date and time

Insert a calendar picker or time picker. Collect just a date, just a time, or both.


(tick)

(tick)

Question properties



Labels

Create clear, concise questions in terms your users will understand.


(tick)

(tick)

Description

Add hints or examples to any field.


(tick)

(tick)

Default values

Make filling out a form simple by providing a default value as a direction to your customers.


(tick)

(tick)

Question key

Enter a question key to replace the label when exporting responses to a spreadsheet.


(tick)

(tick)

Validation



Text: pattern (regex) matching

Collect exactly the information you want in the just the right format.


(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

(tick)

Automation



Add form on status change

Automatically add a ProForma forms to an issue when the issue changes to a new status.


(tick)

(tick)

Change issue status on form submission

Automatically change an issue to a new status when a ProForma form is submitted.


(tick)

(tick)

Prevent issues from changing status

Prevent an issue from changing to a new status unless a ProForma form(s) is included and submitted on the issue.


(tick)

(tick)

Add forms with Jira automation

Create a custom Jira automation rule to automatically add a ProForma form to an issue.


(tick)

(tick)

Jira automation

Use Jira automation to copy forms between issues and requests. Trigger an automation rule based on a change to field or form and use form data in automation rules.


(tick)

(error)

Reporting



JQL queries and Jira reports

Link form fields to Jira fields to access form data via JQL queries or include the data in Jira reports.


(tick)

(tick)

Spreadsheet of form responses

Download a form spreadsheet with all of responses that have been submitted for a form.



(tick)

(tick)

Export form response with Jira fields

Filter down specific issues and select Jira fields to include in an export of form data.


(tick)

(error)

Search

Currently, to include ProForma form data in searches, you must link the field to a Jira field. Alternatively, you can download a spreadsheet of form responses and use Excel’s search function.

Improving ProForma’s search capacity is a priority and is slated for development shortly.

(info)

(info)

API



APIs

ProForma APIs can be used for:

  • Adding a form to an issue
  • Changing the internal and external form setting
  • Copying a form from one issue to another
  • Exporting ProForma data
  • Reopening forms
  • Submitting forms
  • Unlocking forms

(tick)

(error)

Resources



eBooks & Whitepapers

We’ve published a number of eBooks to assist administrators get the most out of Jira. The books include:

1. Effective Jira administration
2. Battling Jira custom field bloat
3. From ITSM to ESM: Enterprise Service Management with Jira Service Management

(tick)

(tick)

Hundreds of example form templates

ProForma includes a library with hundreds of ready-to-use form templates. These templates can be used as is, modified to meet your teams' practices or embedded in another form. Check out the form templates in our ProForma Form Builder demo


(tick)

(tick)

Last modified on Jun 28, 2024

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.