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 service_tickets {
 101   warn "service_tickets not available with RT_External.\n";
 102   return;
 103 }
 104
 105 sub comments_on_tickets {
 106   my ($self, $custnum, $limit, $time ) = @_;
 107   $limit ||= 0;
 108
 109   my( $from_sql, @param) = $self->_from_customer( $custnum );
 110   my $sql = qq{
 111     SELECT transactions.*, Attachments.content, Tickets.subject
 112     FROM transactions
 113       JOIN Attachments ON( Attachments.transactionid = transactions.id )
 114       JOIN Tickets ON ( Tickets.id = transactions.objectid )
 115       JOIN Links  ON ( Tickets.id    = Links.LocalBase
 116                        AND Links.Base LIKE '%/ticket/' || Tickets.id )
 117
 118
 119     WHERE ( Status = 'new' OR Status = 'open' OR Status = 'stalled' )
 120       AND Target = 'freeside://freeside/cust_main/$custnum'
 121        AND transactions.type = 'Comment'
 122        AND transactions.created >= (SELECT TIMESTAMP WITH TIME ZONE 'epoch' + $time * INTERVAL '1 second')
 123      LIMIT $limit
 124   };
 125   cluck $sql if $DEBUG > 0;
 126   #AND created >
 127   $dbh->selectall_arrayref( $sql, { Slice => {} } ) or die $dbh->errstr . " $sql";
 128 }
 129
 130 sub _from_customer {
 131   my( $self, $custnum, $priority ) = @_;
 132
 133   my @param = ();
 134   my $join = '';
 135   my $where = '';
 136   if ( defined($priority) ) {
 137
 138     my $queue_sql = " ObjectCustomFields.ObjectId = ( SELECT id FROM Queues
 139                                                        WHERE Queues.Name = ? )
 140                       OR ( ? = '' AND ObjectCustomFields.ObjectId = 0 )";
 141
 142     my $customfield_sql =
 143       "customfield = (
 144         SELECT CustomFields.Id FROM CustomFields
 145                   JOIN ObjectCustomFields
 146                     ON ( CustomFields.id = ObjectCustomFields.CustomField )
 147          WHERE LookupType = 'RT::Queue-RT::Ticket'
 148            AND Name = ?
 149            AND ( $queue_sql )
 150        )";
 151
 152     push @param, $priority_field,
 153                  $priority_field_queue,
 154                  $priority_field_queue;
 155
 156     if ( length($priority) ) {
 157       #$where = "
 158       #  and ? = ( select content from TicketCustomFieldValues
 159       #             where ticket = tickets.id
 160       #               and customfield = ( select id from customfields
 161       #                                    where name = ?
 162       #                                      and ( $queue_sql )
 163       #                                 )
 164       #          )
 165       #";
 166       unshift @param, $priority;
 167
 168       $join = "JOIN ObjectCustomFieldValues
 169                  ON ( Tickets.id = ObjectCustomFieldValues.ObjectId )";
 170
 171       $where = " AND Content = ?
 172                  AND ObjectCustomFieldValues.Disabled != 1
 173                  AND ObjectType = 'RT::Ticket'
 174                  AND $customfield_sql";
 175
 176     } else {
 177
 178       $where =
 179                "AND 0 = ( SELECT COUNT(*) 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