Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

NameArgumentsDescription
linkFinder

query or filter, association (optional)

The function returns issues that meet the criteria defined in the query or filter and have a linked issue corresponding to the type of association. The first argument must be a valid JQL query or a defined filter name. Second argument is association defined in Jira. More information about associations in Jira you can find here. You can use association as name, outward or inward description. This argument must accurately comply with this defined in Jira. Please also note that this function will return these issues which have exactly this association, eg. if you give "blocks" as argument, function will return issues which block other ones.


Examples:


Returns all issues which are blocked by other:

issue in linkFinder("project = CRM", "is blocked by")


linkFinderForIssuesquery or filter, association, issue_1, issue_2, ...

The function returns list of issues which are in association with issues given as list. The first argument must be a valid JQL query or a defined filter name. Second argument is association defined in Jira or * (asterisk). More information about associations in Jira you can find here. You can use association as name, outward or inward description. This argument must accurately comply with this defined in Jira. Third (or next) argument is issue which fulfill association condition, eg. if your association is "is blocked by" and issue is "IS-3" then result will be issues which are blocked by IS-3 issue. If you provide more than one issue as this argument, result will be logical OR operation.


Examples:


Example below returns issues from project CRM which are linked (no matter how) with issue CRM-8

issue in linkFinderForIssues("project = CRM", "*", "CRM-8")


Example below returns issues from project CRM which blocks issues CRM-8 and CRM-6:

issue in linkFinderForIssues("project = CRM", "blocks", "CRM-8", "CRM-6")


linkFinderByConditionquery or filter, condition

The function that searches all linked issues. The first argument must be a valid JQL query or a defined filter name. Second argument is simple condition. This condition takes as first argument association defined in Jira. Next part is operation <,>,=,<=,=>, and the last one is number, eg. "is depended by < 3". This example condition returns all associations which number is lower than 3. More information about associations in Jira you can find here. You can use association as name, outward or inward description. This argument must accurately comply with this defined in Jira. Please also note that this function will return these issues which have exactly this association, eg. if you give "blocks" as argument, function will return issues which block other ones.


Examples:


Below is example which returns issues which are in project CRM, have status Done and are blocked by more than one issue:

issue in linkFinderByCondition("project = CRM and status = Done", "is blocked by >= 1")


linkFinderForEmptyLinksquery or filter

The function takes one argument query or filter and returns issues without associations (links).The first argument must be a valid JQL query or a defined filter name.


Examples:


Returns issues without linked issues in project CRM:

issue in linkFinderForEmptyLinks("project = CRM")


linkFinderForAllStatuses query or filter, association, status_1, status_2, ...

The function searches for issues that have linked issues in the given status or statuses. This function takes as arguments query or filter, association or * (asterisk) and list of statuses. The first argument must be a valid JQL query or a defined filter name. More information about associations in Jira you can find here. Second argument is association defined in Jira or * (asterisk). You can use association as name, outward or inward description. This argument must accurately comply with this defined in Jira.


Examples:


Example below returns all issues which link issues has status To do - association doesn't matter:

issue in linkFinderForAllStatuses("project = CRM", "*", "to do")


Example below returns all issues which blocks other issues which have status To do and In progress:

issue in linkFinderForAllStatuses("project = CRM and status = Done", "blocks", "to do", "in progress")


linkFinderForAnyStatuses query or filter, association, status_1, status_2, ...

The function searches for issues that have linked issues in the given status or statuses. This function takes as arguments query or filter, association or * (asterisk) and list of statuses. The first argument must be a valid JQL query or a defined filter name. More information about associations in Jira you can find here. Second argument is association defined in Jira or * (asterisk). You can use association as name, outward or inward description. This argument must accurately comply with this defined in Jira. This function is similar to linkFinderForAllStatuses but has one important difference related to the interpretation of statuses. In this function linked issues doesn't have to be exactly in given statuses.


Examples:


Example below returns all issues which have linked issues with status To do or In progress (important in here is word or):

issue in linkFinderForAnyStatuses("project = CRM", "blocks", "to do", "in progress") 


linkFinderForLinkTypesquery or filter, association_1, association_2, ...

The function searches for linked issues that have one or more association. This function takes as arguments query or filter and association or list of associations. The first argument must be a valid JQL query or a defined filter name. More information about associations in Jira you can find here. Second argument is association defined in Jira or list of associations. You can use association as name, outward or inward description. This argument must accurately comply with this defined in Jira.

Examples:

Example below returns list of issues from CRM project which have at least one linked issue with "blocks" association.

issue in linkFinderForLinkTypes("project = CRM", "blocks")


Example below returns list of issues from CRM project which have at least one linked issue with "blocks" or "is related to" association.

issue in linkFinderForLinkTypes("project = CRM", "blocks", "is related to")


...

It is specific functionality of this plugin app that broaden standard functionality of Jira adding to link additional information - please take a look at below picture:

...