NAME

Redmine::Fetch - It's new $module

SYNOPSIS

use Redmine::Fetch;

my $rf = Redmine::Fetch->new( $server_uri, $api_key, $project_id, $filter);
my $ticket = $rf->get_ticket_by_id(555);

DESCRIPTION

This module provides API access to the Redmine REST API

Please reference the Redmine API docs to determine Parameters for Filters etc.

You can find the docs here: http://www.redmine.org/projects/redmine/wiki/Rest_api

new

Creates a new Object. Handle over the Redmine Config

• param: $api_key String - API Key for Redmine
• param: $project_id Integer - Redmine Project ID
• param: $filter String - Redmine filter string
• returns: $self Object - Redmine::Fetch object

ua_config

Returns a config hashref for the Redmine REST API.

• returns: $c Hash - Config Hash for the Redmine REST API

redmine_ua

Redmine Useragent. Abstracts PUT und GET Requests for the Redmine Rest API. Will dump errors per Data::Printer

• param: $mode String - 'get' || 'put' || 'delete' || 'post'
• param: $call String - calling API path
• param: $payload Hash || JSON - payload for PUT or GET request
• returns: $response Mojo::UserAgent Response - Antwort Objekt der Transaktion oder leerer String

update_or_create_wiki_page

Update or create Wiki pages in Redmine Wiki

• param: $path String - Path to Wiki page
• param: $name String - name of Wiki page
• param: $content String - Content of the Wiki Page in Textile Markup
• param: $parent_titel - Title of the parent Wiki Page
• returns: $response Mojo::UserAgent Response - Server answer, for further processing or empty String

delete_wiki_page

deletes Wiki Page

• param: $path String - path to delete
• returns: $response Mojo::UserAgent Response - Server answer, for further processing or empty String

create_ticket

create ticket in Redmine Tracker

• param: $subject String - Subject of the Ticket
• param: $description String - Description of the Ticket
• param: $payload String - additional Ticket parameters as a hash (e.g. tracker_id, priority, etc.)
• returns: $response Mojo::UserAgent Response - Server answer, for further processing or empty String

delete_ticket

delete a ticket in the Redmine Tracker

• param: $ticket_id Integer - Ticket ID of the Redmine Ticket
• returns: $response Mojo::UserAgent Response - Server answer, for further processing or empty String

get_tickets

get list of Tickets

• param: $type String - Tracker Typ - e.g. [ bugs, features, updates, faq ]
• param: $limit Scalar - maximal number of Listitems - default 500
• param: $sort String - sort for Redmine API as String
• returns: $ticket Hash - From json decoded hashref with ticket_data

get_ticket_by_id

gets a Ticket by ID including the related Tickets

• param: $ticket_id Scalar - Ticket ID in Redmine
• param: $build_link_callback - Anonymus function for URI generating
• returns: $ticket Hash - From json decoded hashref with ticket_data

LICENSE

Copyright (C) Jens Gassmann Software Entwicklung.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR

• Jens Gassmann jg@itnode.de
• Patrick Simon ps@itnode.de