GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NET::TRAC::TICKET (3)

.ds Aq ’

NAME

Net::Trac::Ticket - Create, read, and update tickets on a remote Trac instance

CONTENTS

SYNOPSIS



    my $ticket = Net::Trac::Ticket->new( connection => $trac );
    $ticket->load( 1 );
   
    print $ticket->summary, "\n";



DESCRIPTION

This class represents a ticket on a remote Trac instance. It provides methods for creating, reading, and updating tickets and their history as well as adding comments and getting attachments.

timestamp_to_datetime CW$stamp

Accept’s a timestamp in Trac’s somewhat idiosyncratic format and returns a DateTime object

METHODS

    new HASH

Takes a key connection with a value of a Net::Trac::Connection. Returns an empty ticket object.

    load ID

Loads up the ticket with the specified ID. Returns the ticket ID loaded on success and undef on failure.

    load_from_hashref HASHREF [SKIP]

You should never need to use this method yourself. Loads a ticket from a hashref of data, optionally skipping metadata loading (values of valid_* accessors).

    create HASH

Creates and loads a new ticket with the values specified. Returns undef on failure and the new ticket ID on success.

    update HASH

Updates the current ticket with the specified values.

Returns undef on failure, and the ID of the current ticket on success.

    comment TEXT

Adds a comment to the current ticket. Returns undef on failure, true on success.

    history

Returns a Net::Trac::TicketHistory object for this ticket.

    comments

Returns an array or arrayref (depending on context) of history entries which have comments included. This will include history entries representing attachments if they have descriptions.

    attach PARAMHASH

Attaches the specified file with an optional description. Returns undef on failure and the new Net::Trac::TicketAttachment object on success.

    attachments

Returns an array or arrayref (depending on context) of all the Net::Trac::TicketAttachment objects for this ticket.

ACCESSORS

    connection

    id

    summary

    type

    status

    priority

    severity

    resolution

    owner

    reporter

    cc

    description

    keywords

    component

    milestone

    version

    created

Returns a DateTime object

    last_modified

Returns a DateTime object

    basic_statuses

Returns a list of the basic statuses available for a ticket. Others may be defined by the remote Trac instance, but we have no way of easily getting them.

    valid_props

Returns a list of the valid properties of a ticket.

    add_custom_props

Adds custom properties to valid properties list.

    valid_create_props

Returns a list of the valid properties specifiable when creating a ticket.

    valid_update_props

Returns a list of the valid updatable properties.

    Valid property values

These accessors are loaded from the remote Trac instance with the valid values for the properties upon instantiation of a ticket object.
valid_milestones
valid_types
valid_components
valid_priorities
valid_resolutions - Only loaded when a ticket is loaded.
valid_severities - May not be provided by the Trac instance.

LICENSE

Copyright 2008-2009 Best Practical Solutions.

This package is licensed under the same terms as Perl 5.8.8.

Search for    or go to Top of page |  Section 3 |  Main Index


perl v5.20.3 NET::TRAC::TICKET (3) 2011-04-02

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.