Help Centre › Functions & Formulas
This article describes the RPA Jira connector function to search issues using JQL.
For a full list of available functions, please read JIRA functions.
Description
The JQL search function searches Jira issues using JQL (Jira Query Language) with auto-pagination. JQL supports filtering by project, status, assignee, labels, dates, custom fields, and more.
Setting it up
{{popups:rpas/add:action=jira-search}}
Once on a process map:
- Navigate to the process where you would like to add the function
- Click on the green button’s drop-down (right side of the green button labelled “Process”)
- On the menu that appears, click on the “+ Activity” item
- From here you can select the JIRA JQL search option
- Click "Add" once you are done
Input parameters
| Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
| Connector | Yes | Select | - | Select the Jira connector to use |
| JQL | Yes | Textarea | - | JQL query (e.g. project = PROJ AND status = Open ORDER BY created DESC) |
| Variable | Yes | Text | - | Variable to store the search results |
Output variables
| Variable | Type | Description |
|---|---|---|
| Variable | Array | Array of issue objects with key, fields (summary, status, assignee, etc.) |
Errors
- Invalid JQL – the JQL syntax is incorrect
- Field not found – a field referenced in the JQL does not exist
Tips
- Use variables in JQL: project = {project_key} AND assignee = {user_id}
- Results are auto-paginated – all matching issues are returned
- Access issue fields via {variable.0.fields.summary}, {variable.0.key}
- Common JQL: project = PROJ AND status != Done AND updated >= -7d
Related functions
- Get issue – Get full issue details by key
- Create issue – Create a new issue
- Transition issue – Change issue status