share/html/REST/1.0/ticket/link

   1 %# BEGIN BPS TAGGED BLOCK {{{
   2 %#
   3 %# COPYRIGHT:
   4 %#
   5 %# This software is Copyright (c) 1996-2014 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/ticket/link
  49 %#
  50 <%ARGS>
  51 $id => undef
  52 $del => 0
  53 $rel
  54 $to
  55 </%ARGS>
  56 <%INIT>
  57 use RT::Interface::REST;
  58
  59 my $output;
  60 my $status = "200 Ok";
  61 my $ticket = RT::Ticket->new($session{CurrentUser});
  62 my $object = $r->path_info;
  63
  64 my @fields = qw(DependsOn DependedOnBy RefersTo ReferredToBy HasMember MemberOf);
  65 my %fields = map { lc $_ => $_ } @fields;
  66 my %lfields = (
  67     HasMember    => { Type => 'MemberOf',  Mode => 'Base'   },
  68     ReferredToBy => { Type => 'RefersTo',  Mode => 'Base'   },
  69     DependedOnBy => { Type => 'DependsOn', Mode => 'Base'   },
  70     MemberOf     => { Type => 'MemberOf',  Mode => 'Target' },
  71     RefersTo     => { Type => 'RefersTo',  Mode => 'Target' },
  72     DependsOn    => { Type => 'DependsOn', Mode => 'Target' },
  73 );
  74
  75 # http://.../REST/1.0/ticket/link/1
  76
  77 $object =~ s#^/REST/1.0/ticket/link##;
  78 if ($id && $object && $id != $object) {
  79     $output = "Different ids in URL (`$object') and submitted form (`$id').\n";
  80     $status = "400 Bad Request";
  81     goto OUTPUT;
  82 }
  83 $id ||= $object;
  84 unless ($id =~ /^\d+$/) {
  85     $output = $r->path_info. "\n";
  86     $output .= "Invalid ticket id: '$id'.\n";
  87     $status = "400 Bad Request";
  88     goto OUTPUT;
  89 }
  90 unless (exists $fields{lc $rel}) {
  91     $output = "Invalid link: '$rel'.\n";
  92     $status = "400 Bad Request";
  93     goto OUTPUT;
  94 }
  95 $rel = $fields{lc $rel};
  96
  97 $ticket->Load($id);
  98 unless ($ticket->Id) {
  99     $output = "Couldn't load ticket id: '$id'.\n";
 100     $status = "404 Ticket not found";
 101     goto OUTPUT;
 102 }
 103
 104 my $type = $lfields{$rel}->{Type};
 105 my $mode = $lfields{$rel}->{Mode};
 106
 107 my $n = 1;
 108 my $op = $del ? "DeleteLink" : "AddLink";
 109
 110 ($n, $output) = $ticket->$op(Type => $type, $mode => $to);
 111 if ($n == 0) {
 112     $status = "500 Error";
 113 } else {
 114     my $action = $del ? "Deleted" : "Created";
 115     $output .= " $action link " . $ticket->Id . " $rel $to";
 116 }
 117
 118 OUTPUT:
 119 </%INIT>
 120 RT/<% $RT::VERSION %> <% $status %>
 121
 122 <% $output |n %>