Skip to main content
Skip table of contents

Search Jira Issues

The Search Jira Issues Flow Screen Component, lets user search for Issues in Jira and link them to the specified Salesforce record Id. It can also be used to display a list of Jira Issues from a pre-defined JQL query.

Field

Type

Required

Description

API Name

String

  (tick)

The API name of the component. It can include underscores and alphanumeric characters without spaces.

Results Height

Number

 (tick)

Height of the component in pixels.

Initial rows

Number

 (tick)

Number of initial visible rows.

Title

String

Title for the component.

Record Id

Id

The record Id that Issues listed in the search result can be linked to.

Column 1

String

Jira Issue field id to show in the first column in search results.

Column 2

String

Jira Issue field id to show in the second column in search results.

Column 3

String

Jira Issue field id to show in the third column in search results.

Column 4

String

Jira Issue field id to show in the 4th column in search results.

Column 5

String

Jira Issue field id to show in the 5th column in search results.

Restrict by JQL

String

JQL used to restrict the search in Jira. It can also be used a the pre-defined JQL query for auto search.

Enable Search by JQL

Boolean

Flag to enable or disable the advanced search using Jira Query Language (JQL).

Disable Search Input

Boolean

Hides the search input box.

Auto search

Boolean

Perform a search in Jira automatically when rendering the component.

Jira Connection

String

 

The Alias identifier for the Jira connection (when Salesforce is connected to multiple Jira instances). Leave blank to use the default connection.

Example Screen Flow to list Issues Released in Jira

The following example flow uses the “Search Jira Issues“ screen component to show all the Jira Issues that have been released in Jira (meaning its fix Version has been released in the corresponding Jira Project) for all the Open Cases of the current Salesforce User. This is useful for example for Salesforce agents to send notification to customers that a new software version has been released and addresses some Bugs reported by the customer.

In Salesforce → Flows create a new Screen Flow

Add a “Get Records“ element to query all the Open Cases whose Owner is the current user

Add a “Transform“ element to collect all the Case Ids from the previous query and set them in a Text Collection

Add another “Get Records“ element to query all the related Issues (Case Issues junction object) for the Open Cases Ids

Add a Text Variable resource to concatenate the Issue Keys into a String

Add a Loop element to iterate over all the Related Issue relationships records

Add an Assignment element in the Loop to append the “Key“ (Issue Key) field from the loop current iteration and also append a Blank space to the Issue Keys text variable

Add a new Text Formula to trim (last blank space) and substitute with ',' (spaces between Issue Keys) from the IssueKeys text variable.

CODE
SUBSTITUTE(TRIM({!IssueKeys}), ' ', ',')

Add a Text Template resource to build the Jira JQL query string. This JQL query filters only the Issues where its fix Version(s) has been released in the Project in Jira for all the Issue Keys we are passing (Issue keys related to ”My” Open Cases)

CODE
Issue in ({!IssueKeysFormula}) AND fixVersion in releasedVersions()

Add a Screen element after the Loop element, hide the header and footer and add the “Search Jira Issues“ component

Select which columns (Issue fields) to display and pass the “jql“ text template variable in the “Restrict by JQL“ field. Make sure to enable the “Auto Search“ and to have this component as read only you may want to “Disable the Search Input“.

Finally Save and Activate the flow.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.