rt/share/html/REST/1.0/Forms/queue/default

   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/Forms/queue/default
  49 %#
  50 <%ARGS>
  51 $id
  52 $format => 's'
  53 $fields => undef # these are the fields passed to the rt "-f" flag.
  54 $changes => {}
  55 </%ARGS>
  56 <%perl>
  57 my @comments;
  58 my ($c, $o, $k, $e) = ("", [], {}, 0);
  59 my %data = %$changes;
  60 my $queue = RT::Queue->new($session{CurrentUser});
  61 my @fields = qw(Name Description CorrespondAddress CommentAddress
  62                 InitialPriority FinalPriority DefaultDueIn);
  63 my %fields = map { lc $_ => $_ } @fields;
  64
  65 if ($id ne 'new') {
  66     $queue->Load($id);
  67     if (!$queue->Id) {
  68         return [ "# Queue $id does not exist.", [], {}, 1 ];
  69     }
  70 }
  71 else {
  72     if (keys %data == 0) {
  73         return [
  74             "# Required: Name",
  75             [ "id", @fields ],
  76             {
  77                 id => 'queue/new',
  78                 Name => '<queue name>',
  79                 Description => "",
  80                 CommentAddress => "",
  81                 CorrespondAddress => "",
  82                 InitialPriority => "",
  83                 FinalPriority => "",
  84                 DefaultDueIn => "",
  85             },
  86             0
  87         ];
  88     }
  89     else {
  90         my %v;
  91         my %create = %fields;
  92
  93         foreach my $k (keys %data) {
  94             if (exists $create{lc $k}) {
  95                 $v{$create{lc $k}} = delete $data{$k};
  96             }
  97         }
  98
  99         if ($v{Name} eq '<queue name>') {
 100             my %o = keys %$changes;
 101             delete @o{"id", @fields};
 102             return [
 103                 "# Please set the queue name.",
 104                 [ "id", @fields, keys %o ], $changes, 1
 105             ];
 106         }
 107
 108         $queue->Create(%v);
 109         unless ($queue->Id) {
 110             return [ "# Could not create queue.", [], {}, 1 ];
 111         }
 112
 113         delete $data{id};
 114         $id = $queue->Id;
 115         push(@comments, "# Queue $id created.");
 116         goto DONE if keys %data == 0;
 117     }
 118 }
 119
 120 if ( keys %data == 0) {
 121     my @data;
 122
 123     push @data, [ id => "queue/".$queue->Id ];
 124     foreach my $key (@fields) {
 125         push @data, [ $key => $queue->$key ];
 126     }
 127
 128     # Custom fields
 129     my $CustomFields = $queue->CustomFields;
 130     while ( my $CustomField = $CustomFields->Next() ) {
 131         next
 132             unless ( !%$fields
 133             || exists $fields->{ lc "CF-" . $CustomField->Name } );
 134         next unless $CustomField->CurrentUserHasRight('SeeCustomField');
 135         my $CFvalues = $queue->CustomFieldValues( $CustomField->Id );
 136         my @CFvalues;
 137         while ( my $CFvalue = $CFvalues->Next() ) {
 138             push @CFvalues, $CFvalue->Content;
 139         }
 140         push @data, [ "CF-" . $CustomField->Name => \@CFvalues ];
 141     }
 142
 143     my %k = map {@$_} @data;
 144     $o = [ map {$_->[0]} @data ];
 145     $k = \%k;
 146 }
 147 else {
 148     my ($get, $set, $key, $val, $n, $s);
 149     my $updated;
 150     foreach $key (keys %data) {
 151         $val = $data{$key};
 152         $key = lc $key;
 153         $n = 1;
 154
 155         if (exists $fields{$key}) {
 156             $key = $fields{$key};
 157             $set = "Set$key";
 158
 159             next if $val eq $queue->$key;
 160             ($n, $s) = $queue->$set($val);
 161         }
 162         elsif ($key ne 'id') {
 163             $n = 0;
 164             $s = "Unknown field.";
 165         }
 166
 167     SET:
 168         if ($n == 0) {
 169             $e = 1;
 170             push @comments, "# $key: $s";
 171             unless (@$o) {
 172                 my %o = keys %$changes;
 173                 delete @o{"id", @fields};
 174                 @$o = ("id", @fields, keys %o);
 175                 $k = $changes;
 176             }
 177         }
 178         else {
 179             $updated ||= 1;
 180         }
 181     }
 182
 183     push(@comments, "# Queue $id updated.") if $updated;
 184 }
 185
 186 DONE:
 187 $c ||= join("\n", @comments) if @comments;
 188 return [ $c, $o, $k, $e ];
 189 </%perl>