FS/FS/TicketSystem/RT_External.pm

   1 package FS::TicketSystem::RT_External;
   2
   3 use strict;
   4 use vars qw( $DEBUG $me $conf $dbh $default_queueid $external_url
   5              $priority_reverse
   6              $priority_field $priority_field_queue $field
   7            );
   8 use URI::Escape;
   9 use FS::UID qw(dbh);
  10 use FS::Record qw(qsearchs);
  11 use FS::cust_main;
  12 use Carp qw(cluck);
  13
  14 $me = '[FS::TicketSystem::RT_External]';
  15 $DEBUG = 0;
  16
  17 FS::UID->install_callback( sub {
  18   $conf = new FS::Conf;
  19   $default_queueid = $conf->config('ticket_system-default_queueid');
  20   $priority_reverse = $conf->exists('ticket_system-priority_reverse');
  21   $priority_field =
  22     $conf->config('ticket_system-custom_priority_field');
  23   if ( $priority_field ) {
  24     $priority_field_queue =
  25       $conf->config('ticket_system-custom_priority_field_queue');
  26
  27     $field = $priority_field_queue
  28                   ? $priority_field_queue. '.%7B'. $priority_field. '%7D'
  29                   : $priority_field;
  30   } else {
  31     $priority_field_queue = '';
  32     $field = '';
  33   }
  34
  35   $external_url = '';
  36   $dbh = dbh;
  37   if ($conf->config('ticket_system') eq 'RT_External') {
  38     my ($datasrc, $user, $pass) = $conf->config('ticket_system-rt_external_datasrc');
  39     $dbh = DBI->connect($datasrc, $user, $pass, { 'ChopBlanks' => 1 })
  40       or die "RT_External DBI->connect error: $DBI::errstr\n";
  41
  42     $external_url = $conf->config('ticket_system-rt_external_url');
  43   }
  44
  45   #kludge... should *use* the id... but good enough for now
  46   if ( $priority_field_queue =~ /^(\d+)$/ ) {
  47     my $id = $1;
  48     my $sql = 'SELECT Name FROM Queues WHERE Id = ?';
  49     my $sth = $dbh->prepare($sql) or die $dbh->errstr. " preparing $sql";
  50     $sth->execute($id)            or die $sth->errstr. " executing $sql";
  51
  52     $priority_field_queue = $sth->fetchrow_arrayref->[0];
  53
  54   }
  55
  56 } );
  57
  58 sub num_customer_tickets {
  59   my( $self, $custnum, $priority ) = @_;
  60
  61   my( $from_sql, @param) = $self->_from_customer( $custnum, $priority );
  62
  63   my $sql = "SELECT COUNT(*) $from_sql";
  64   warn "$me $sql (@param)" if $DEBUG;
  65   my $sth = $dbh->prepare($sql) or die $dbh->errstr. " preparing $sql";
  66   $sth->execute(@param)         or die $sth->errstr. " executing $sql";
  67
  68   $sth->fetchrow_arrayref->[0];
  69
  70 }
  71
  72 sub customer_tickets {
  73   my( $self, $custnum, $limit, $priority ) = @_;
  74   $limit ||= 0;
  75
  76   my( $from_sql, @param) = $self->_from_customer( $custnum, $priority );
  77   my $sql = "
  78     SELECT Tickets.*,
  79            Queues.Name AS Queue,
  80            Users.Name  AS Owner,
  81            position(Tickets.Status in 'newopenstalledresolvedrejecteddeleted')
  82              AS svalue
  83            ". ( length($priority) ? ", ObjectCustomFieldValues.Content" : '' )."
  84       $from_sql
  85       ORDER BY svalue,
  86                Priority ". ( $priority_reverse ? 'ASC' : 'DESC' ). ",
  87                id DESC
  88       LIMIT $limit
  89   ";
  90   warn "$me $sql (@param)" if $DEBUG;
  91   my $sth = $dbh->prepare($sql) or die $dbh->errstr. "preparing $sql";
  92   $sth->execute(@param)         or die $sth->errstr. "executing $sql";
  93
  94   #munge column names???  #httemplate/view/cust_main/tickets.html has column
  95   #names that might not make sense now...
  96   $sth->fetchall_arrayref({});
  97
  98 }
  99
 100 sub comments_on_tickets {
 101   my ($self, $custnum, $limit, $time ) = @_;
 102   $limit ||= 0;
 103
 104   my( $from_sql, @param) = $self->_from_customer( $custnum );
 105   my $sql = qq{
 106     SELECT transactions.*, Attachments.content, Tickets.subject
 107     FROM transactions
 108       JOIN Attachments ON( Attachments.transactionid = transactions.id )
 109       JOIN Tickets ON ( Tickets.id = transactions.objectid )
 110       JOIN Links  ON ( Tickets.id    = Links.LocalBase
 111                        AND Links.Base LIKE '%/ticket/' || Tickets.id )
 112
 113
 114     WHERE ( Status = 'new' OR Status = 'open' OR Status = 'stalled' )
 115       AND Target = 'freeside://freeside/cust_main/$custnum'
 116        AND transactions.type = 'Comment'
 117        AND transactions.created >= (SELECT TIMESTAMP WITH TIME ZONE 'epoch' + $time * INTERVAL '1 second')
 118      LIMIT $limit
 119   };
 120   cluck $sql if $DEBUG > 0;
 121   #AND created >
 122   $dbh->selectall_arrayref( $sql, { Slice => {} } ) or die $dbh->errstr . " $sql";
 123 }
 124
 125 sub _from_customer {
 126   my( $self, $custnum, $priority ) = @_;
 127
 128   my @param = ();
 129   my $join = '';
 130   my $where = '';
 131   if ( defined($priority) ) {
 132
 133     my $queue_sql = " ObjectCustomFields.ObjectId = ( SELECT id FROM Queues
 134                                                        WHERE Queues.Name = ? )
 135                       OR ( ? = '' AND ObjectCustomFields.ObjectId = 0 )";
 136
 137     my $customfield_sql =
 138       "customfield = (
 139         SELECT CustomFields.Id FROM CustomFields
 140                   JOIN ObjectCustomFields
 141                     ON ( CustomFields.id = ObjectCustomFields.CustomField )
 142          WHERE LookupType = 'RT::Queue-RT::Ticket'
 143            AND Name = ?
 144            AND ( $queue_sql )
 145        )";
 146
 147     push @param, $priority_field,
 148                  $priority_field_queue,
 149                  $priority_field_queue;
 150
 151     if ( length($priority) ) {
 152       #$where = "
 153       #  and ? = ( select content from TicketCustomFieldValues
 154       #             where ticket = tickets.id
 155       #               and customfield = ( select id from customfields
 156       #                                    where name = ?
 157       #                                      and ( $queue_sql )
 158       #                                 )
 159       #          )
 160       #";
 161       unshift @param, $priority;
 162
 163       $join = "JOIN ObjectCustomFieldValues
 164                  ON ( Tickets.id = ObjectCustomFieldValues.ObjectId )";
 165
 166       $where = " AND Content = ?
 167                  AND ObjectCustomFieldValues.Disabled != 1
 168                  AND ObjectType = 'RT::Ticket'
 169                  AND $customfield_sql";
 170
 171     } else {
 172
 173       $where =
 174                "AND 0 = ( SELECT COUNT(*) FROM ObjectCustomFieldValues
 175                            WHERE ObjectId    = Tickets.id
 176                              AND ObjectType  = 'RT::Ticket'
 177                              AND $customfield_sql
 178                         )
 179                ";
 180     }
 181
 182   }
 183
 184   my $sql = "
 185     FROM Tickets
 186       JOIN Queues ON ( Tickets.Queue = Queues.id )
 187       JOIN Users  ON ( Tickets.Owner = Users.id  )
 188       JOIN Links  ON ( Tickets.id    = Links.LocalBase
 189                        AND Links.Base LIKE '%/ticket/' || Tickets.id )
 190       $join
 191
 192     WHERE ( ". join(' OR ', map "Status = '$_'", $self->statuses ). " )
 193       AND Target = 'freeside://freeside/cust_main/$custnum'
 194       $where
 195   ";
 196
 197   ( $sql, @param );
 198
 199 }
 200
 201 sub statuses {
 202   #my $self = shift;
 203   my @statuses = grep { ! /^\s*$/ } $conf->config('cust_main-ticket_statuses');
 204   @statuses = (qw( new open stalled )) unless scalar(@statuses);
 205   @statuses;
 206 }
 207
 208 sub href_customer_tickets {
 209   my( $self, $custnum ) = ( shift, shift );
 210   my( $priority, @statuses);
 211   if ( ref($_[0]) ) {
 212     my $opt = shift;
 213     $priority = $opt->{'priority'};
 214     @statuses = $opt->{'statuses'} ? @{$opt->{'statuses'}} : $self->statuses;
 215   } else {
 216     $priority = shift;
 217     @statuses = $self->statuses;
 218   }
 219
 220   #my $href = $self->baseurl;
 221
 222   #i snarfed this from an RT bookmarked search, then unescaped (some of) it with
 223   #perl -npe 's/%([0-9A-F]{2})/pack('C', hex($1))/eg;'
 224
 225   #$href .=
 226   my $href =
 227     "Search/Results.html?Order=ASC&".
 228     "Query= MemberOf = 'freeside://freeside/cust_main/$custnum' ".
 229     #" AND ( Status = 'open'  OR Status = 'new'  OR Status = 'stalled' )"
 230     " AND ( ". join(' OR ', map "Status = '$_'", @statuses ). " ) "
 231   ;
 232
 233   if ( defined($priority) && $field && $priority_field_queue ) {
 234     $href .= " AND Queue = '$priority_field_queue' ";
 235   }
 236   if ( defined($priority) && $field ) {
 237     $href .= " AND 'CF.$field' ";
 238     if ( $priority ) {
 239       $href .= "= '$priority' ";
 240     } else {
 241       $href .= "IS 'NULL' "; #this is "RTQL", not SQL
 242     }
 243   }
 244
 245   #$href =
 246   uri_escape($href);
 247   #eventually should unescape all of it...
 248
 249   $href .= '&Rows=100'.
 250            '&OrderBy=id&Page=1'.
 251            '&Format=%27%20%20%20%3Cb%3E%3Ca%20href%3D%22'.
 252            $self->baseurl.
 253            'Ticket%2FDisplay.html%3Fid%3D__id__%22%3E__id__%3C%2Fa%3E%3C%2Fb%3E%2FTITLE%3A%23%27%2C%20%0A%27%3Cb%3E%3Ca%20href%3D%22'.
 254            $self->baseurl.
 255            'Ticket%2FDisplay.html%3Fid%3D__id__%22%3E__Subject__%3C%2Fa%3E%3C%2Fb%3E%2FTITLE%3ASubject%27%2C%20%0A%27__Status__%27%2C%20';
 256
 257   if ( defined($priority) && $field ) {
 258     $href .= '%0A%27__CustomField.'. $field. '__%2FTITLE%3ASeverity%27%2C%20';
 259   }
 260
 261   $href .= '%0A%27__QueueName__%27%2C%20%0A%27__OwnerName__%27%2C%20%0A%27__Priority__%27%2C%20%0A%27__NEWLINE__%27%2C%20%0A%27%27%2C%20%0A%27%3Csmall%3E__Requestors__%3C%2Fsmall%3E%27%2C%20%0A%27%3Csmall%3E__CreatedRelative__%3C%2Fsmall%3E%27%2C';
 262
 263   if ( defined($priority) && $field ) {
 264     $href .=   '%20%0A%27__-__%27%2C';
 265   }
 266
 267   $href .= '%20%0A%27%3Csmall%3E__ToldRelative__%3C%2Fsmall%3E%27%2C%20%0A%27%3Csmall%3E__LastUpdatedRelative__%3C%2Fsmall%3E%27%2C%20%0A%27%3Csmall%3E__TimeLeft__%3C%2Fsmall%3E%27';
 268
 269   #$href =
 270   #uri_escape($href);
 271
 272   $self->baseurl. $href;
 273
 274 }
 275
 276 sub href_params_new_ticket {
 277   my( $self, $custnum_or_cust_main, $requestors ) = @_;
 278
 279   my( $custnum, $cust_main );
 280   if ( ref($custnum_or_cust_main) ) {
 281     $cust_main = $custnum_or_cust_main;
 282     $custnum = $cust_main->custnum;
 283   } else {
 284     $custnum = $custnum_or_cust_main;
 285     $cust_main = qsearchs('cust_main', { 'custnum' => $custnum } );
 286   }
 287
 288   # explicit $requestors > config option > invoicing_list
 289   $requestors = $conf->config('ticket_system-requestor')
 290       if !$requestors;
 291   $requestors = $cust_main->invoicing_list_emailonly_scalar
 292       if (!$requestors) and defined($cust_main);
 293
 294   my %param = (
 295     'Queue'       => ($cust_main->agent->ticketing_queueid || $default_queueid),
 296     'new-MemberOf'=> "freeside://freeside/cust_main/$custnum",
 297     'Requestors'  => $requestors,
 298   );
 299
 300   ( $self->baseurl.'Ticket/Create.html', %param );
 301 }
 302
 303 sub href_new_ticket {
 304   my $self = shift;
 305
 306   my( $base, %param ) = $self->href_params_new_ticket(@_);
 307
 308   my $uri = new URI $base;
 309   $uri->query_form(%param);
 310   $uri;
 311
 312 }
 313
 314 sub href_ticket {
 315   my($self, $ticketnum) = @_;
 316   $self->baseurl. 'Ticket/Display.html?id='.$ticketnum;
 317 }
 318
 319 sub queues {
 320   my($self) = @_;
 321
 322   my $sql = "SELECT id, Name FROM Queues WHERE Disabled = 0";
 323   my $sth = $dbh->prepare($sql) or die $dbh->errstr. " preparing $sql";
 324   $sth->execute()               or die $sth->errstr. " executing $sql";
 325
 326   map { $_->[0] => $_->[1] } @{ $sth->fetchall_arrayref([]) };
 327
 328 }
 329
 330 sub queue {
 331   my($self, $queueid) = @_;
 332
 333   return '' unless $queueid;
 334
 335   my $sql = "SELECT Name FROM Queues WHERE id = ?";
 336   my $sth = $dbh->prepare($sql) or die $dbh->errstr. " preparing $sql";
 337   $sth->execute($queueid)       or die $sth->errstr. " executing $sql";
 338
 339   my $rows = $sth->fetchrow_arrayref;
 340   $rows ? $rows->[0] : '';
 341
 342 }
 343
 344 sub baseurl {
 345   #my $self = shift;
 346   $external_url. '/';
 347 }
 348
 349 sub _retrieve_single_value {
 350   my( $self, $sql ) = @_;
 351
 352   warn "$me $sql" if $DEBUG;
 353   my $sth = $dbh->prepare($sql) or die $dbh->errstr. "preparing $sql";
 354   $sth->execute                 or die $sth->errstr. "executing $sql";
 355
 356   my $arrayref = $sth->fetchrow_arrayref;
 357   $arrayref ? $arrayref->[0] : $arrayref;
 358 }
 359
 360 sub transaction_creator {
 361   my( $self, $transaction_id ) = @_;
 362
 363   my $sql = "SELECT Name FROM Transactions JOIN Users ON ".
 364             "Transactions.Creator=Users.id WHERE Transactions.id = ".
 365             $transaction_id;
 366
 367   $self->_retrieve_single_value($sql);
 368 }
 369
 370 sub transaction_ticketid {
 371   my( $self, $transaction_id ) = @_;
 372
 373   my $sql = "SELECT ObjectId FROM Transactions WHERE Transactions.id = ".
 374             $transaction_id;
 375
 376   $self->_retrieve_single_value($sql);
 377 }
 378
 379 sub transaction_subject {
 380   my( $self, $transaction_id ) = @_;
 381
 382   my $sql = "SELECT Subject FROM Transactions JOIN Tickets ON ObjectId=".
 383             "Tickets.id WHERE Transactions.id = ".  $transaction_id;
 384
 385   $self->_retrieve_single_value($sql);
 386 }
 387
 388 sub transaction_status {
 389   my( $self, $transaction_id ) = @_;
 390
 391   my $sql = "SELECT Status FROM Transactions JOIN Tickets ON ObjectId=".
 392             "Tickets.id WHERE Transactions.id = ".  $transaction_id;
 393
 394   $self->_retrieve_single_value($sql);
 395 }
 396
 397 sub access_right {
 398   warn "WARNING: no access rights available w/ external RT";
 399   0;
 400 }
 401
 402 sub create_ticket {
 403   return 'create_ticket unimplemented w/external RT (write something w/RT::Client::REST?)';
 404 }
 405
 406 1;
 407