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