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