%# {{{ BEGIN BPS TAGGED BLOCK
%# 
%# COPYRIGHT:
%#  
%# This software is Copyright (c) 1996-2004 Best Practical Solutions, LLC 
%#                                          <jesse@bestpractical.com>
%# 
%# (Except where explicitly superseded by other copyright notices)
%# 
%# 
%# LICENSE:
%# 
%# This work is made available to you under the terms of Version 2 of
%# the GNU General Public License. A copy of that license should have
%# been provided with this software, but in any event can be snarfed
%# from www.gnu.org.
%# 
%# This work is distributed in the hope that it will be useful, but
%# WITHOUT ANY WARRANTY; without even the implied warranty of
%# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
%# General Public License for more details.
%# 
%# You should have received a copy of the GNU General Public License
%# along with this program; if not, write to the Free Software
%# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
%# 
%# 
%# CONTRIBUTION SUBMISSION POLICY:
%# 
%# (The following paragraph is not intended to limit the rights granted
%# to you to modify and distribute this software under the terms of
%# the GNU General Public License and is only of importance to you if
%# you choose to contribute your changes and enhancements to the
%# community by submitting them to Best Practical Solutions, LLC.)
%# 
%# By intentionally submitting any modifications, corrections or
%# derivatives to this work, or any other work intended for use with
%# Request Tracker, to Best Practical Solutions, LLC, you confirm that
%# you are the copyright holder for those contributions and you grant
%# Best Practical Solutions,  LLC a nonexclusive, worldwide, irrevocable,
%# royalty-free, perpetual, license to use, copy, create derivative
%# works based on those contributions, and sublicense and distribute
%# those contributions and any derivatives thereof.
%# 
%# }}} END BPS TAGGED BLOCK
%# REST/1.0/search/ticket
%#
<%ARGS>
$query
$format => undef
$orderby => undef
$fields => undef
</%ARGS>
<%INIT>
my $output = "";
my $status = "200 Ok";
my $tickets = new RT::Tickets $session{CurrentUser};

# Parse and validate any field specifications.
my $field  = '[a-zA-Z][a-zA-Z0-9_-]*';
my (%fields, @fields);
if ($fields) {
    $format = "l";
    unless ($fields =~ /^(?:$field,)*$field$/) {
        $status = "400 Bad Request";
        $output = "Invalid field specification: $fields";
        goto OUTPUT;
    }
    @fields = map lc, split /,/, $fields;
    @fields{@fields} = ();
    unless (exists $fields{id}) {
        unshift @fields, "id";
        $fields{id} = ();
    }
}

$format ||= "s";
if ($format !~ /^[isl]$/) {
    $status = "400 Bad request";
    $output = "Unknown listing format: $format. (Use i, s, or l.)\n";
    goto OUTPUT;
}

my ($n, $s);
eval {
    ($n, $s) = $tickets->FromSQL($query);
};
my $sortstring = "";
if ($orderby) {
    $sortstring = 'FIELD => ';
    my $order = substr($orderby, 0, 1);
    if ($order eq '+' || $order eq '-') {
	$sortstring .= 'substr($orderby, 1)';
	if ($order eq '+') {
	    $sortstring .= ", ORDER => 'ASC'";
	} elsif ($order eq '-') {
	    $sortstring .= ", ORDER => 'DESC'";
	}
    } else {
	$sortstring .= '$orderby';
    }
    my $foo = 'FIELD => ';
    $foo .= '$orderby';
    $tickets->OrderBy(eval $sortstring);
}
if ($@ || $n == 0) {
    $s ||= $@;
    $status = "400 Bad request";
    $output = "Invalid query: '$s'.\n";
    goto OUTPUT;
}

$n = 0;
my @output;
while (my $ticket = $tickets->Next) {
    $n++;

    if ($format eq "i") {
        $output .= "ticket/" . $ticket->Id . "\n";
    }
    elsif ($format eq "s") {
        $output .= $ticket->Id . ": ". $ticket->Subject . "\n";
    }
    else {
	my $id = $ticket->Id;
        my $d = $m->comp("$RT::WebPath/REST/1.0/Forms/ticket/default", id => $id, format => $format, fields => \%fields);
        my ($c, $o, $k, $e) = @$d;
	push @output, [ $c, $o, $k ];
    }
}
if ($n == 0 && $format ne "i") {
    $output = "No matching results.\n";
}

$output = form_compose(\@output) if @output;

OUTPUT:
$m->out("RT/". $RT::VERSION . " " . $status);

$m->out($output );
</%INIT>