![]() |
![]()
| ![]() |
![]()
NAMENet::Trac::Ticket - Create, read, and update tickets on a remote Trac instance SYNOPSISmy $ticket = Net::Trac::Ticket->new( connection => $trac ); $ticket->load( 1 ); print $ticket->summary, "\n"; DESCRIPTIONThis 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 $stampAccept's a timestamp in Trac's somewhat idiosyncratic format and returns a DateTime object METHODSnew HASHTakes a key "connection" with a value of a Net::Trac::Connection. Returns an empty ticket object. load IDLoads 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 HASHCreates and loads a new ticket with the values specified. Returns undef on failure and the new ticket ID on success. update HASHUpdates the current ticket with the specified values. Returns undef on failure, and the ID of the current ticket on success. comment TEXTAdds a comment to the current ticket. Returns undef on failure, true on success. historyReturns a Net::Trac::TicketHistory object for this ticket. commentsReturns 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 PARAMHASHAttaches the specified "file" with an optional "description". Returns undef on failure and the new Net::Trac::TicketAttachment object on success. attachmentsReturns an array or arrayref (depending on context) of all the Net::Trac::TicketAttachment objects for this ticket. ACCESSORSconnectionidsummarytypestatuspriorityseverityresolutionownerreporterccdescriptionkeywordscomponentmilestoneversioncreatedReturns a DateTime object last_modifiedReturns a DateTime object basic_statusesReturns 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_propsReturns a list of the valid properties of a ticket. add_custom_propsAdds custom properties to valid properties list. valid_create_propsReturns a list of the valid properties specifiable when creating a ticket. valid_update_propsReturns a list of the valid updatable properties. Valid property valuesThese accessors are loaded from the remote Trac instance with the valid values for the properties upon instantiation of a ticket object. LICENSECopyright 2008-2009 Best Practical Solutions. This package is licensed under the same terms as Perl 5.8.8.
|