/
Issue

Issue

This is the baseline class for all Jira issue events such as Post functions and Listeners

This Issueclass encapsulates functionality for interacting with one Jira issue.

It includes properties and methods for various actions such as checking if an issue is a subtask, if it has a parent, attachments, comments, links, subtasks, etc.

It also provides methods for editing issues, deleting them, linking them to other issues, transitioning their status, and fetching comments. Additionally, it allows adding comments, setting properties, and provides a string representation of the issue. The class utilizes threading for certain operations to run asynchronously.

Usage

Below you can check examples of usage for this class.

Expression

Type

Parameters

Example Output

Expression

Type

Parameters

Example Output

issue.is_subtask

property

none

True or False bool

issue.has_parent

property

none

True or False bool

issue.has_attachments

property

none

True or False bool

property

none

True or False bool

property

none

True or False bool

property

none

True or False bool

property

none

True or False bool

property

none

True or False bool

property

none

True or False bool

property

none

[<Issue Object>, <Issue Object> … N] (list[Issue])
if issue has linked issues, if not - returns an empty list []

property

none

"Find Replicants” str

property

none

<Issue Object> object

property

none

[<Issue Object>, <Issue Object> … N] (list[Issue])
if issue has child issues, if not - returns an empty list []

property

none

[<Issue Object>, <Issue Object> … N] (list[Issue])
if issue has siblings issues, if not - returns a list with the trigger issue inside.

property

none

"Done", "In Progress”, “To Do" str

properties

none

any

property

none

[<Dict of changelog items>, … ]

Example of one changelog item:

property

none

[<Dict of comment items>, … ]

Example of one comment object

function

source_issue_key (str)
fieldKey (str)

none
Copies the value of another issue if this issue exists

function

source_field (str)
target_field (str)

none
Copies the value from a field to another in the same issue

function

user.accountId (str)
user (dict)

none
Assigns an issue if user has assignable user permission

Information on the “Value" should match expected data by the field type.

function

field (str)
value (any)

none

function

 

 

function

related_issue (str)
link type name (str)

response

function

target_status_name (str)
**kwargs(any)

none

function

message (str)
internal (bool)

none

function

key (str)
value (any)

none

function

key (str)

any
Value set previously on issue.set_property

function

none

dict status and seconds the issue spent in that status
{“Done": 120304, “In Progress": 20012}

function

label (str)

none

Users must be a list of accountIds ["accountId1", "accountId2"... etc]

function

subject (str)
html (str)
text (str)
users (list[str])
assignee (bool)
reporter (bool)
voters (bool)
watchers (bool)

none

function

none

none

Examples

 

Easy for Jira - Python Automations, 2023