/ 
App-Gitc-0.60
River stage zero No dependents
/ App::Gitc::Its::Jira

NAME

App::Gitc::Its::Jira - Support for Atlassian JIRA ITS (Issue Tracking System)

VERSION

version 0.60

DESCRIPTION

Uses a mix of both SOAP and REST APIs.

Eventually this should be migrated to fully use the REST API once it is mature.

METHODS

label_service label_issue

Return strings used to label the service and issue for (error) reporting purposes

get_jira_object

Returns a JIRA object used to access the SOAP API

get_jira_rest_object

Returns a JIRA object used to access the REST API

get_issue

Returns an object representing this changeset's JIRA issue.

If this changeset has no JIRA issue or there was an error locating it, returns undef. Normally this will cache the object, and return it on subsequent calls. If the reload parameter is set, it will reload the object and reset the cache.

transition_state

Change an issue's status from one value to another by progressing using a JIRA action to progress the workflow.

The following named arguments are understood:

message   - required message to put in JIRA's Internal Comments
issue     - optional JIRA issue object
            (defaults to an Issue for the currently checked out changeset)
command   - optional name of the command that's changing the status
            (by default, it's inferred from the top-level script)
target    - optional name of a promotion target (when $command is 'promote')
flag      - a emoticon used for JIRA comments to flag the action

The old and new statuses are specified through the project configuration. They are keyed on the value of the command argument.

issue_*

These return the correct field based on being passed in an jira issue object. Think of it as $issue->* - Should be replaced with a facade for issues

issue_state

Returns the current issue 'state' (usually status), this may or may not match the config from/target states

issue_number

Returns the JIRA issue number for a given changeset name OR given an JIRA issue object

AUTHOR

Grant Street Group <developers@grantstreet.com>

COPYRIGHT AND LICENSE

This software is Copyright (c) 2013 by Grant Street Group.

This is free software, licensed under:

The GNU Affero General Public License, Version 3, November 2007