NAME

run_query - Query UMLS web services with the query arguments like query term and method name.

SYNOPSIS

Basic Usage

  use WebService::UMLS::run_query;
  use WebService::UMLS::authenticate_user;

  my $query = new Query;
  my $c = new Connect;
  my $method_name = 'findCUIByExact';
  
  $cui = $query->runQuery(
                $service,
                $method_name,
                {
                        casTicket => $c->get_pt(),
                        searchString => SOAP::Data->type(string => $term),
                        language     => 'ENG',
                        release      => '2009AA',
                        includeSuppressibles => 'false',
                },
        );

  $query -> runQuery($service, $query_term, $method_name, @params);

DESCRIPTION

This module has package Query which has many subroutines like 'new', 'runQuery' and serialization methods. This module takes $service object, query term, method name and different parameters of query as arguments. For valid CUI, it queries UMLS and gets back the hash reference of the information.

Methods

new: This sub creates a new object of Query.

runQuery: This sub takes $service object, query term, method name and different parameters of query as arguments. It returns empty if the term does not exist in database or if the web services are not working correctly. It returns CUI if the query input was a term. If the query input is CUI, it displays preferred term, definitions with source information and CUI for it.

Serialization subs: These are SOAP methods for serializing UMLS specific types. There is one SOAP::Serializer::as_XXX method for each complex type XXX found in the UMLSKS Web Service methods.

SEE ALSO

get_validate_term.pm get_user_details.pm authenticate_user.pm ws-getUMLSInfo.pl ws-getShortestPath.pl

AUTHORS

Mugdha Choudhari University of Minnesota Duluth <chou0130 at d.umn.edu>

Ted Pedersen, University of Minnesota Duluth <tpederse at d.umn.edu>

COPYRIGHT

Copyright (C) 2010, Mugdha Choudhari, Ted Pedersen

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program 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., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.