NAME

WebService::ClinicalTrialsdotGov - Wrapper around the clinicaltrials.gov API

SYNOPSIS

For a generic search:

   use WebService::ClinicalTrialsdotGov;

   my $rh_params = {
      'term'  => 'cancer',
      'start' => 0,
      'count' => 10,
      'mode'  => 'search',   
   };

   my $CT = 
      WebService::ClinicalTrialsdotGov->new( $rh_params );

   my $Results = $CT->results;

   my $ra_all = 
      $Results->get_search_results;

   foreach my $Study ( @$ra_all ) {
      print $Study->title;
   }
   

For obtaining the details of a specific study:

   use WebService::ClinicalTrialsdotGov;

  my $rh_params = {
     'id'    => 'NCT00622401',
     'mode'  => 'show',   
  };

  my $CT = 
     WebService::ClinicalTrialsdotGov->new( $rh_params );

  my $Results = $CT->results;

  my $Study = 
     $Results->get_study;

FUNCTIONS

new

Creates a new instance of the module.

   my $rh_params = {
        'term'  => 'cancer',
        'start' => 0,
        'count' => 10,
        'mode'  => 'search',   
     };

  my $CT = 
     WebService::ClinicalTrialsdotGov->new( $rh_params );

The mode parameter can either be search for a generic search using the contents of the term parameter as the query or be study using the contents of the id paramter for identifying the study's ncd_id.

One can additionally specific a stating offset using start and a max results offset using count. By default, the API will return 20 results.

This function returns undef on error.

results

   my $ResultsObject = $CT->results;

This function returns a WebService::ClinicalTrialsdotGov::Reply object which can be interrogated to obtain the results in some form or shape.

This function returns undef on error.

AUTHOR

Spiros Denaxas, <s.denaxas at gmail.com>

BUGS

Please report any bugs or feature requests to bug-webservice-clinicaltrialsdotgov at rt.cpan.org, or through the web interface at http://rt.cpan.org/NoAuth/ReportBug.html?Queue=WebService-ClinicalTrialsdotGov. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

SUPPORT

You can find documentation for this module with the perldoc command.

    perldoc WebService::ClinicalTrialsdotGov

You can also look for information at:

• RT: CPAN's request tracker

  http://rt.cpan.org/NoAuth/Bugs.html?Dist=WebService-ClinicalTrialsdotGov

• AnnoCPAN: Annotated CPAN documentation

  http://annocpan.org/dist/WebService-ClinicalTrialsdotGov

• CPAN Ratings

  http://cpanratings.perl.org/d/WebService-ClinicalTrialsdotGov

• Search CPAN

  http://search.cpan.org/dist/WebService-ClinicalTrialsdotGov/

COPYRIGHT & LICENSE

Copyright 2010 Spiros Denaxas, all rights reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.