# 22. Virtuoso Functions Guide - soap_wsdl_import

Chapter Contents | Prev | Next
Keyword Search:
www.openlinksw.com
docs.openlinksw.com
Book Home
Contents
Preface
Virtuoso Functions Guide
Administration
Aggregate Functions
Array Manipulation
BPEL APIs
Backup
Compression
Cursor
Date & Time Manipulation
Debug
Dictionary Manipulation
Encoding & Decoding
File Manipulation
Free Text
Hashing / Cryptographic
LDAP
Locale
Mail
Miscellaneous
Number
Remote SQL Data Source
Replication
SOAP
http_body_read
soap_box_structure
soap_box_xml_entity
soap_call
soap_client
soap_current_url
soap_dt_define
soap_make_error
soap_print_box
soap_sdl
soap_server
soap_wsdl
soap_wsdl_import
wst_cli
SQL
String
Transaction
Type Mapping
UDDI
User Defined Types & The CLR
Virtuoso Java PL API
Virtuoso Server Extension Interface (VSEI)
Web Server & Internet
XML
XPATH & XQUERY
Functions Index

## soap_wsdl_import

array DB.DBA.SOAP_WSDL_IMPORT (in target_url varchar);
Description

The soap_wsdl_import() function is used to import operations and types definitions from an WSDL file on a remote server. The retrieved file will be parsed and PL (procedure language) wrappers will be generated for each SOAP operation that is described. The SOAP service will be represented by a PL module which will be the overall container the generated PL wrappers. Once the WSDL file has been imported the PL wrappers are automatically generated and available for use.

Parameters
target_url – A URL to a WSDL file.
Return Types

soap_wsdl_import() returns an array that consists of the name of module, the name of PL wrapper, and a vector of parameter name/type pairs. An example of the result is: vector ([module name], [wrapper1], vector ([param1], [type1], [param2], [tyep2] ...), [wrapper2] vector (...))

Examples
Importing and using a Web Services description file

     SQL> soap_wsdl_import('http://[host:port]/chemistry.wsdl');

     Done. -- 1286 msec.
     SQL> select xml_tree_doc (Chemistry.getElementBySymbol('Ni'));
     callret
     VARCHAR
     _______________________________________________________________________________

     <getElementBySymbolResponse>
       <return>
         <atomicnumber>28</atomicnumber>
         <symbol>Ni</symbol>
         <name>Nickel</name>
         <mass>58.69</mass>
         <meltingPoint>1726.0</meltingPoint>
         <boilingPoint>3005.0</boilingPoint>
         <found>1751</found>
      </return>
     </getElementBySymbolResponse>

     Note: the namespaces from response are ommited for better reading.

See Also

soap_wsdl()