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-2013 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 LWP::MediaTypes;
  57 use RT::Interface::REST;
  58 use File::Temp qw(tempfile);
  59 my @tmp_files;
  60
  61 $RT::Logger->debug("Got ticket id=$id for comment");
  62 $RT::Logger->debug("Got args @{[keys(%changes)]}.");
  63
  64 my $ticket = RT::Ticket->new($session{CurrentUser});
  65 my ($c, $o, $k, $e) = ("", [], {}, 0);
  66
  67 # http://.../REST/1.0/ticket/1/comment
  68 $ticket->Load($id);
  69 if (!$ticket->Id) {
  70     $e = 1;
  71     $c = "# Ticket $id does not exist.";
  72     goto OUTPUT;
  73 }
  74
  75 my $action;
  76 ($action = $changes{Action}) =~ s/^(.)(.*)$/\U$1\L$2\E/;
  77 unless ($action =~ /^(?:Comment|Correspond)$/) {
  78     $e = 1;
  79     $c = "# Invalid action: `$action'.";
  80     goto OUTPUT;
  81 }
  82
  83 my $text = $changes{Text};
  84 my @atts = @{ vsplit($changes{Attachment}) };
  85
  86 if (!$changes{Text} && @atts == 0) {
  87     $e = 1;
  88     $c = "# Empty comment with no attachments submitted.";
  89     goto OUTPUT;
  90 }
  91
  92 my $cgi = $m->cgi_object;
  93 my $ent = MIME::Entity->build(
  94     Type => "multipart/mixed",
  95     'X-RT-Interface' => 'REST',
  96 );
  97 $ent->attach(Data => $changes{Text}) if $changes{Text};
  98
  99 my $i = 1;
 100 foreach my $att (@atts) {
 101     local $/=undef;
 102     my $file = $att;
 103     $file =~ s#^.*[\\/]##;
 104
 105     my $fh = $cgi->upload("attachment_$i");
 106     if ($fh) {
 107         my $buf;
 108         my ($w, $tmp) = tempfile();
 109         my $info = $cgi->uploadInfo($fh);
 110         push @tmp_files, $tmp;
 111
 112         while (sysread($fh, $buf, 8192)) {
 113             syswrite($w, $buf);
 114         }
 115
 116         $ent->attach(
 117             Path => $tmp,
 118             Type => $info->{'Content-Type'} || guess_media_type($tmp),
 119             Filename => $file,
 120             Disposition => "attachment"
 121         );
 122     }
 123     else {
 124         $e = 1;
 125         $c = "# No attachment for $att.";
 126         goto OUTPUT;
 127     }
 128
 129     $i++;
 130 }
 131
 132 unless ($ticket->CurrentUserHasRight('ModifyTicket') ||
 133         ($action eq "Comment" &&
 134          $ticket->CurrentUserHasRight("CommentOnTicket")) ||
 135         ($action eq "Correspond" &&
 136          $ticket->CurrentUserHasRight("ReplyToTicket")))
 137 {
 138     $e = 1;
 139     $c = "# You are not allowed to $action on ticket $id.";
 140     goto OUTPUT;
 141 }
 142
 143 my $cc = join ", ", @{ vsplit($changes{Cc}) };
 144 my $bcc = join ", ", @{ vsplit($changes{Bcc}) };
 145 my ($n, $s) = $ticket->$action(MIMEObj => $ent,
 146                                CcMessageTo => $cc,
 147                                BccMessageTo => $bcc,
 148                                TimeTaken => $changes{TimeWorked} || 0);
 149 $c = "# ".$s;
 150 if ($changes{Status}) {
 151    my  ($status_n, $status_s) = $ticket->SetStatus($changes{'Status'} );
 152   $c .= "\n# ".$status_s;
 153 }
 154
 155 OUTPUT:
 156
 157 unlink @tmp_files;
 158 return [ $c, $o, $k, $e ];
 159 </%INIT>