Atlassian Jira: Jira - Issues

Summary

This module contains actions for viewing & managing Jira Issues.

Actions

atlassian_jira.issues.

get_all

Get all Issues for a Project

Minimum Plugin Version: 1.0.0

Input

• access_details: an AccessDetails dictionary

• project_name: a Project name

Output

A list of Issue dictionaries.

Example

- atlassian_jira.issues.get_all:
  project_name: ppa
  load:
    access_details: access_details
  save: all_issues

atlassian_jira.issues.

get_by_id

Get Issue by ID

Minimum Plugin Version: 1.0.0

Input

• access_details: an AccessDetails dictionary

• issue_id: an Issue ID

Output

An Issue dictionary.

Example

- atlassian_jira.issues.get_by_id:
  issue_id: ppa-123
  load:
    access_details: access_details
  save: issue

atlassian_jira.issues.

input_table

Display a list of Issues in a table, & allow the task operator to make a selection.

The table will have the following columns:

• ID
• Issuetype
• Priority
• Status
• Summary
• Reporter
• Assignee

Minimum Plugin Version: 1.0.0

Input

• text: the title of the table

• issues: a list of Issue dictionaries to display in the table

• minimum: The minimum number of acceptable selections

• maximum: The maximum number of acceptable selections

Output

A list of Issue dictionaries.

Tip

• If neither a minimum or maximum is provided, the task operator will be able to submit 0 selections.

• If minimum or maximum are provided, the operation will repeat until a valid number of selections is made.

Example

Finding issues with get_all, saving them as issues, & waiting for a single selection:

- atlassian_jira.issues.get_all:
  project_name: ppa
  load:
    access_details: access_details
  save: all_issues

- atlassian_jira.issues.input_table:
    text: Choose an issue
    minimum: 1
    maximum: 1
  load:
    issues: all_issues
  save: selected_issue

atlassian_jira.issues.

output_table

Display a list of Issues in a table.

The table will have the following columns:

• ID
• Issuetype
• Priority
• Status
• Summary
• Reporter
• Assignee

Minimum Plugin Version: 1.0.0

Input

• text: the title of the table

• issues: a single or list of Issue dictionaries

Output

Nothing is outputted by this action.

Single Issue

Finding an issue with get_by_id, saving it as issue, & displaying it:

- atlassian_jira.issues.get_by_id:
    issue_id: ppa-123
  load:
    access_details: access_details
  save: issue

- atlassian_jira.issues.output_table:
    text: Issue ppa-123
  load:
    issues: issue

Multiple Issues

Finding all issue with get_all, saving them as all_project_issues, & displaying them:

- atlassian_jira.issue.get_all:
    project_name: ppa
  load:
    access_details: access_details
  save: all_project_issues

- atlassian_jira.issue.output_table:
    text: All Issues
  load:
    issues: all_project_issues

atlassian_jira.issues.

transition_issue

Update Issue status

Minimum Plugin Version: 1.0.0

Input

• access_details: an AccessDetails dictionary

• issue_id: an Issue ID

• status_name: Issue status name

Output

An Issue dictionary.

Example

- atlassian_jira.issues.transition_issue:
  issue_id: ppa-123
  status_name: Done
  load:
    access_details: access_details