The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

App::Gitc::Its::Jira

VERSION

version 0.58

NAME

App::Gitc::Its::Jira;

Synopsis

Support for Atlassian JIRA ITS (Issue Tracking System)

Uses a mix of both SOAP and REST APIs.

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

Description

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

    Copyright 2012 Grant Street Group, All Rights Reserved.

    This program is free software: you can redistribute it and/or modify
    it under the terms of the GNU Affero General Public License as
    published by the Free Software Foundation, either version 3 of the
    License, or (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU Affero General Public License for more details.

    You should have received a copy of the GNU Affero General Public License
    along with this program.  If not, see <http://www.gnu.org/licenses/>.

AUTHOR

Grant Street Group

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