rt/share/html/REST/1.0/Forms/ticket/comment

   1 %# BEGIN BPS TAGGED BLOCK {{{
   2 %#
   3 %# COPYRIGHT:
   4 %#
   5 %# This software is Copyright (c) 1996-2017 Best Practical Solutions, LLC
   6 %#                                          <sales@bestpractical.com>
   7 %#
   8 %# (Except where explicitly superseded by other copyright notices)
   9 %#
  10 %#
  11 %# LICENSE:
  12 %#
  13 %# This work is made available to you under the terms of Version 2 of
  14 %# the GNU General Public License. A copy of that license should have
  15 %# been provided with this software, but in any event can be snarfed
  16 %# from www.gnu.org.
  17 %#
  18 %# This work is distributed in the hope that it will be useful, but
  19 %# WITHOUT ANY WARRANTY; without even the implied warranty of
  20 %# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  21 %# General Public License for more details.
  22 %#
  23 %# You should have received a copy of the GNU General Public License
  24 %# along with this program; if not, write to the Free Software
  25 %# Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
  26 %# 02110-1301 or visit their web page on the internet at
  27 %# http://www.gnu.org/licenses/old-licenses/gpl-2.0.html.
  28 %#
  29 %#
  30 %# CONTRIBUTION SUBMISSION POLICY:
  31 %#
  32 %# (The following paragraph is not intended to limit the rights granted
  33 %# to you to modify and distribute this software under the terms of
  34 %# the GNU General Public License and is only of importance to you if
  35 %# you choose to contribute your changes and enhancements to the
  36 %# community by submitting them to Best Practical Solutions, LLC.)
  37 %#
  38 %# By intentionally submitting any modifications, corrections or
  39 %# derivatives to this work, or any other work intended for use with
  40 %# Request Tracker, to Best Practical Solutions, LLC, you confirm that
  41 %# you are the copyright holder for those contributions and you grant
  42 %# Best Practical Solutions,  LLC a nonexclusive, worldwide, irrevocable,
  43 %# royalty-free, perpetual, license to use, copy, create derivative
  44 %# works based on those contributions, and sublicense and distribute
  45 %# those contributions and any derivatives thereof.
  46 %#
  47 %# END BPS TAGGED BLOCK }}}
  48 %# REST/1.0/Forms/ticket/comment
  49 %#
  50 <%ARGS>
  51 $id
  52 %changes
  53 </%ARGS>
  54 <%INIT>
  55 use MIME::Entity;
  56 use RT::Interface::REST;
  57
  58 $RT::Logger->debug("Got ticket id=$id for comment");
  59 $RT::Logger->debug("Got args @{[keys(%changes)]}.");
  60
  61 my $ticket = RT::Ticket->new($session{CurrentUser});
  62 my ($c, $o, $k, $e) = ("", [], {}, 0);
  63
  64 # http://.../REST/1.0/ticket/1/comment
  65 $ticket->Load($id);
  66 if (!$ticket->Id) {
  67     $e = 1;
  68     $c = "# Ticket $id does not exist.";
  69     goto OUTPUT;
  70 }
  71
  72 my $action;
  73 ($action = $changes{Action}) =~ s/^(.)(.*)$/\U$1\L$2\E/;
  74 unless ($action =~ /^(?:Comment|Correspond)$/) {
  75     $e = 1;
  76     $c = "# Invalid action: `$action'.";
  77     goto OUTPUT;
  78 }
  79
  80 my $text = $changes{Text};
  81 my @atts = @{ vsplit($changes{Attachment}) };
  82
  83 if (!$changes{Text} && @atts == 0) {
  84     $e = 1;
  85     $c = "# Empty comment with no attachments submitted.";
  86     goto OUTPUT;
  87 }
  88
  89 my $ent = MIME::Entity->build(
  90     Type => "multipart/mixed",
  91     'X-RT-Interface' => 'REST',
  92 );
  93 $ent->attach(
  94     Type    => $changes{'Content-Type'} || 'text/plain',
  95     Charset => "UTF-8",
  96     Data    => Encode::encode("UTF-8", $changes{Text} ),
  97 ) if $changes{Text};
  98
  99
 100 {
 101     my ($status, $msg) = process_attachments($ent, @atts);
 102     unless ( $status ) {
 103         $e = 1;
 104         $c = "# $msg";
 105         goto OUTPUT;
 106     }
 107 }
 108
 109 unless ($ticket->CurrentUserHasRight('ModifyTicket') ||
 110         ($action eq "Comment" &&
 111          $ticket->CurrentUserHasRight("CommentOnTicket")) ||
 112         ($action eq "Correspond" &&
 113          $ticket->CurrentUserHasRight("ReplyToTicket")))
 114 {
 115     $e = 1;
 116     $c = "# You are not allowed to $action on ticket $id.";
 117     goto OUTPUT;
 118 }
 119
 120 my $cc = join ", ", @{ vsplit($changes{Cc}) };
 121 my $bcc = join ", ", @{ vsplit($changes{Bcc}) };
 122 my ($n, $s) = $ticket->$action(MIMEObj => $ent,
 123                                CcMessageTo => $cc,
 124                                BccMessageTo => $bcc,
 125                                TimeTaken => $changes{TimeWorked} || 0);
 126 $c = "# ".$s;
 127 if ($changes{Status}) {
 128    my  ($status_n, $status_s) = $ticket->SetStatus($changes{'Status'} );
 129   $c .= "\n# ".$status_s;
 130 }
 131
 132 OUTPUT:
 133
 134 return [ $c, $o, $k, $e ];
 135 </%INIT>