From: Christopher Burger Date: Wed, 15 Nov 2017 19:04:22 +0000 (-0500) Subject: RT# 29295 - added package_list and package_status to backend API. Also added two... X-Git-Url: http://git.freeside.biz/gitweb/?p=freeside.git;a=commitdiff_plain;h=483528c704363ae7d0318a9651a8416ff07e946d RT# 29295 - added package_list and package_status to backend API. Also added two new test files in bin to test new apis --- diff --git a/FS/FS/API.pm b/FS/FS/API.pm index 17587443b..75948a3e3 100644 --- a/FS/FS/API.pm +++ b/FS/FS/API.pm @@ -650,6 +650,102 @@ sub location_info { return \%return; } +=item list_customer_packages OPTION => VALUE, ... + +Lists all customer packages. + +=over + +=item secret + +API Secret + +=item custnum + +Customer Number + +=back + +Example: + + my $result = FS::API->list_packages( + 'secret' => 'sharingiscaring', + 'custnum' => custnum, + ); + + if ( $result->{'error'} ) { + die $result->{'error'}; + } else { + # list packages returns an array of hashes for packages ordered by custnum and pkgnum. + print Dumper($result->{'pkgs'}); + } + +=cut + +sub list_customer_packages { + my( $class, %opt ) = @_; + return _shared_secret_error() unless _check_shared_secret($opt{secret}); + + my $sql_query = FS::cust_pkg->search({ 'custnum' => $opt{custnum}, }); + + $sql_query->{order_by} = 'ORDER BY custnum, pkgnum'; + + my @packages = qsearch($sql_query) + or return { 'error' => 'No packages' }; + + my $return = { + 'packages' => [ map $_->hashref, @packages ], + }; + + $return; +} + +=item package_status OPTION => VALUE, ... + +Get package status. + +=over + +=item secret + +API Secret + +=item pkgnum + +Package Number + +=back + +Example: + + my $result = FS::API->package_status( + 'secret' => 'sharingiscaring', + 'pkgnum' => pkgnum, + ); + + if ( $result->{'error'} ) { + die $result->{'error'}; + } else { + # package status returns a hash with the status for a package. + print Dumper($result->{'status'}); + } + +=cut + +sub package_status { + my( $class, %opt ) = @_; + return _shared_secret_error() unless _check_shared_secret($opt{secret}); + + my $cust_pkg = qsearchs('cust_pkg', { 'pkgnum' => $opt{pkgnum} } ) + or return { 'error' => 'No packages' }; + + my $return = { + 'status' => $cust_pkg->status, + }; + + $return; +} + =item order_package OPTION => VALUE, ... Orders a new customer package. Takes a list of keys and values as paramaters diff --git a/bin/xmlrpc-customer_package-status.pl b/bin/xmlrpc-customer_package-status.pl new file mode 100644 index 000000000..589c42af4 --- /dev/null +++ b/bin/xmlrpc-customer_package-status.pl @@ -0,0 +1,27 @@ +#!/usr/bin/perl + +## example +# perl xmlrpc-customer_package-status.pl +## + +use strict; +use Frontier::Client; +use Data::Dumper; + +my $uri = new URI 'http://localhost:8008/'; + +my $server = new Frontier::Client ( 'url' => $uri ); + +my $result = $server->call( + 'FS.API.package_status', + 'secret' => 'MySecretCode', + 'pkgnum' => $ARGV[0], +); + +die $result->{'error'} if $result->{'error'}; + +print $result->{status}; + +print "\nAll Done\n"; + +exit; \ No newline at end of file diff --git a/bin/xmlrpc-customer_packages-list.pl b/bin/xmlrpc-customer_packages-list.pl new file mode 100644 index 000000000..745d30fbd --- /dev/null +++ b/bin/xmlrpc-customer_packages-list.pl @@ -0,0 +1,31 @@ +#!/usr/bin/perl + +## example +# perl xmlrpc-customer_packages-list.pl +## + +use strict; +use Frontier::Client; +use Data::Dumper; + +my $uri = new URI 'http://localhost:8008/'; + +my $server = new Frontier::Client ( 'url' => $uri ); + +my $result = $server->call( + 'FS.API.list_customer_packages', + 'secret' => 'MySecretCode', + 'custnum' => $ARGV[0], +); + +die $result->{'error'} if $result->{'error'}; + +my @packages = @{$result->{packages}}; + +print Dumper(@packages); + +print "\n total: " . scalar @packages; + +print "\nAll Done\n"; + +exit; \ No newline at end of file