/ 
RT-Client-REST-0.17
River stage one • 4 direct dependents • 4 total dependents
/ RT::Client::REST::Ticket

NAME

RT::Client::REST::Ticket -- this object represents a ticket.

SYNOPSIS

my $rt = RT::Client::REST->new(
  server  => $ENV{RTSERVER},
  username=> $username,
  password=> $password,
);

my $ticket = RT::Client::REST::Ticket->new(
  rt  => $rt,
  id  => $id,
  priority => 10,
)->store;

DESCRIPTION

RT::Client::REST::Ticket is based on RT::Client::REST::Object. The representation allows to retrieve, edit, comment on, and create tickets in RT.

ATTRIBUTES

id

This is the numeric ID of the ticket.

queue

This is the name of the queue (not numeric id).

owner

Username of the owner.

creator

Username of RT user who created the ticket.

subject

Subject of the ticket.

status

The status is usually one of the following: "new", "open", "resolved", "stalled", "rejected", and "deleted". However, custom RT installations sometimes add their own statuses.

priority

Ticket priority. Usually a numeric value.

initial_priority
final_priority
requestors

This is a list attribute (for explanation of list attributes, see LIST ATTRIBUTE PROPERTIES in RT::Client::REST::Object). Contains e-mail addresses of the requestors.

cc

A list of e-mail addresses used to notify people of 'correspond' actions.

admin_cc

A list of e-mail addresses used to notify people of all actions performed on a ticket.

created

Time at which ticket was created.

starts
started
due
resolved
told
time_estimated
time_worked
time_left
last_updated

DB METHODS

For full explanation of these, please see "DB METHODS" in RT::Client::REST::Object documentation.

retrieve

Retrieve RT ticket from database.

store

Create or update the ticket.

Search for tickets that meet specific conditions.

TICKET-SPECIFIC METHODS

comment(message = $message, %opts)>

Comment on this ticket with message $message. %opts is a list of key-value pairs as follows:

cc

List of e-mail addresses to send carbon copies to (an array reference).

bcc

List of e-mail addresses to send blind carbon copies to (an array reference).

correspond(message = $message, %opts)>

Add correspondence to the ticket. Takes exactly the same arguments as the comment method above.

attachments

Get attachments associated with this ticket. What is returned is an object of type RT::Client::REST::SearchResult which can then be used to get at objects of type RT::Client::REST::Attachment.

transactions

Get transactions associated with this ticket. Optionally, you can specify exactly what types of transactions you want listed, for example:

my $result = $ticket->transactions(type => [qw(Comment Correspond)]);

Please reference RT::Client::REST documentation for the full list of valid transaction types.

Return value is an object of type RT::Client::REST::SearchResult which can then be used to iterate over transaction objects (RT::Client::REST::Transaction).

INTERNAL METHODS

rt_type

Returns 'ticket'.

SEE ALSO

RT::Client::REST, RT::Client::REST::Object, RT::Client::REST::Attachment, RT::Client::REST::SearchResult, RT::Client::REST::Transaction.

AUTHOR

Dmitri Tikhonov <dtikhonov@yahoo.com>

LICENSE

Perl license with the exception of RT::Client::REST, which is GPLed.