rt/html/REST/1.0/Forms/ticket/links

   1 %# BEGIN BPS TAGGED BLOCK {{{
   2 %#
   3 %# COPYRIGHT:
   4 %#
   5 %# This software is Copyright (c) 1996-2007 Best Practical Solutions, LLC
   6 %#                                          <jesse@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/copyleft/gpl.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/links
  49 %#
  50 <%ARGS>
  51 $id
  52 $format => 's'
  53 $changes => undef
  54 </%ARGS>
  55 <%INIT>
  56 my @data;
  57 my $ticket = new RT::Ticket $session{CurrentUser};
  58
  59 $ticket->Load($id);
  60 if (!$ticket->Id) {
  61     return [ "# Ticket $id does not exist.", [], {}, 1 ];
  62 }
  63
  64 my ($c, $o, $k, $e) = ("", [], {}, 0);
  65 my @fields = qw(DependsOn DependedOnBy RefersTo ReferredToBy Members MemberOf);
  66 my %fields = map { lc $_ => $_ } @fields;
  67
  68 my %lfields = (
  69     Members      => { Type => 'MemberOf',  Mode => 'Base'   },
  70     ReferredToBy => { Type => 'RefersTo',  Mode => 'Base'   },
  71     DependedOnBy => { Type => 'DependsOn', Mode => 'Base'   },
  72     MemberOf     => { Type => 'MemberOf',  Mode => 'Target' },
  73     RefersTo     => { Type => 'RefersTo',  Mode => 'Target' },
  74     DependsOn    => { Type => 'DependsOn', Mode => 'Target' },
  75 );
  76
  77 if ($changes) {
  78     my ($get, $set, $key, $val, $n, $s);
  79     my %data = %$changes;
  80     my @comments;
  81
  82     foreach $key (keys %data) {
  83         $val = $data{$key};
  84         $key = lc $key;
  85         $n = 1;
  86
  87         if (exists $fields{$key}) {
  88             $key = $fields{$key};
  89
  90             my %old;
  91             my $field = $lfields{$key}->{Mode};
  92             while (my $link = $ticket->$key->Next) {
  93                 $old{$link->$field} = 1;
  94             }
  95
  96             my %new;
  97             foreach my $nkey (@{vsplit($val)}) {
  98                 if ($nkey =~ /^\d+$/) {
  99                     my $uri = new RT::URI $session{CurrentUser};
 100                     my $tick = new RT::Ticket $session{CurrentUser};
 101                     $tick->Load($nkey);
 102                     if ($tick->Id) {
 103                         $nkey = $uri->FromObject($tick);
 104                     }
 105                     else {
 106                         $n = 0;
 107                         $s = "Ticket $nkey does not exist.";
 108                         goto SET;
 109                     }
 110                 }
 111                 $new{$nkey} = 1;
 112             }
 113
 114             foreach my $u (keys %old) {
 115                 if (exists $new{$u}) {
 116                     delete $new{$u};
 117                 }
 118                 else {
 119                     my $type = $lfields{$key}->{Type};
 120                     my $mode = $lfields{$key}->{Mode};
 121                     ($n, $s) = $ticket->DeleteLink(Type => $type, $mode => $u);
 122                     goto SET;
 123                 }
 124             }
 125             foreach my $u (keys %new) {
 126                 my $type = $lfields{$key}->{Type};
 127                 my $mode = $lfields{$key}->{Mode};
 128                 ($n, $s) = $ticket->AddLink(Type => $type, $mode => $u);
 129                 goto SET;
 130             }
 131         }
 132         elsif ($key ne 'id' && $key ne 'type') {
 133             $n = 0;
 134             $s = "Unknown field: $key";
 135         }
 136
 137     SET:
 138         if ($n == 0) {
 139             $e = 1;
 140             push @comments, "# $key: $s";
 141             unless (@$o) {
 142                 @$o = ("id", @fields);
 143                 %$k = %data;
 144             }
 145         }
 146     }
 147
 148     push(@comments, "# Links for ticket $id updated.") unless @comments;
 149     $c = join("\n", @comments) if @comments;
 150 }
 151 else {
 152     my @data;
 153
 154     push @data, [ id => "ticket/".$ticket->Id."/links" ];
 155     foreach my $key (@fields) {
 156         my @val;
 157
 158         my $field = $lfields{$key}->{Mode};
 159         while (my $link = $ticket->$key->Next) {
 160             push @val, $link->$field;
 161         }
 162         push(@val, "") if (@val == 0 && $format eq 'l');
 163         push @data, [ $key => [ @val ] ] if @val;
 164     }
 165
 166     my %k = map {@$_} @data;
 167     $o = [ map {$_->[0]} @data ];
 168     $k = \%k;
 169 }
 170
 171 return [ $c, $o, $k, $e ];
 172 </%INIT>