<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html>
<head profile="http://internetalchemy.org/2003/02/profile">
<link rel="foaf" type="application/rdf+xml" title="FOAF" href="http://www.openlinksw.com/dataspace/uda/about.rdf" />
<link rel="schema.dc" href="http://purl.org/dc/elements/1.1/" />
<meta name="dc.title" content="15. Web Services" />
<meta name="dc.subject" content="15. Web Services" />
<meta name="dc.creator" content="OpenLink Software Documentation Team ; " />
<meta name="dc.copyright" content="OpenLink Software, 1999 - 2009" />
<link rel="top" href="index.html" title="OpenLink Virtuoso Universal Server: Documentation" />
<link rel="search" href="/doc/adv_search.vspx" title="Search OpenLink Virtuoso Universal Server: Documentation" />
<link rel="parent" href="webservices.html" title="Chapter Contents" />
<link rel="prev" href="syncml.html" title="SyncML" />
<link rel="next" href="expwsmodules.html" title="Exposing Persistent Stored Modules as Web Services" />
<link rel="shortcut icon" href="../images/misc/favicon.ico" type="image/x-icon" />
<link rel="stylesheet" type="text/css" href="doc.css" />
<link rel="stylesheet" type="text/css" href="/doc/translation.css" />
<title>15. Web Services</title>
<meta http-equiv="Content-Type" content="text/xhtml; charset=UTF-8" />
<meta name="author" content="OpenLink Software Documentation Team ; " />
<meta name="copyright" content="OpenLink Software, 1999 - 2009" />
<meta name="keywords" content="" />
<meta name="GENERATOR" content="OpenLink XSLT Team" />
</head>
<body>
<div id="header">
<a name="uddi" />
<img src="../images/misc/logo.jpg" alt="" />
<h1>15. Web Services</h1>
</div>
<div id="navbartop">
<div>
<a class="link" href="webservices.html">Chapter Contents</a> | <a class="link" href="syncml.html" title="SyncML">Prev</a> | <a class="link" href="expwsmodules.html" title="Exposing Persistent Stored Modules as Web Services">Next</a>
</div>
</div>
<div id="currenttoc">
<form method="post" action="/doc/adv_search.vspx">
<div class="search">Keyword Search: <br />
<input type="text" name="q" /> <input type="submit" name="go" value="Go" />
</div>
</form>
<div>
<a href="http://www.openlinksw.com/">www.openlinksw.com</a>
</div>
<div>
<a href="http://docs.openlinksw.com/">docs.openlinksw.com</a>
</div>
<br />
<div>
<a href="index.html">Book Home</a>
</div>
<br />
<div>
<a href="contents.html">Contents</a>
</div>
<div>
<a href="preface.html">Preface</a>
</div>
<br />
<div class="selected">
<a href="webservices.html">Web Services</a>
</div>
<br />
<div>
<a href="soap.html">SOAP</a>
</div>
<div>
<a href="wsdl.html">WSDL</a>
</div>
<div>
<a href="vfoafssl.html">WebID Protocol Support</a>
</div>
<div>
<a href="voauth.html">OAuth Support</a>
</div>
<div>
<a href="vwsssupport.html">WS-Security (WSS) Support in Virtuoso SOAP Server</a>
</div>
<div>
<a href="ws-routing.html">Web Services Routing Protocol (WS-Routing)</a>
</div>
<div>
<a href="warm.html">Web Services Reliable Messaging Protocol (WS-ReliableMessaging)</a>
</div>
<div>
<a href="vwstrust.html">Web Services Trust Protocol (WS-Trust)</a>
</div>
<div>
<a href="xmlxmla.html">XML for Analysis Provider</a>
</div>
<div>
<a href="xmlrpc.html">XML-RPC support</a>
</div>
<div>
<a href="syncml.html">SyncML</a>
</div>
<div class="selected">
<a href="uddi.html">UDDI</a>
<div>
<a href="#uddiconcepts" title="Concepts">Concepts</a>
<a href="#uddisoap" title="Dealing with SOAP">Dealing with SOAP</a>
<a href="#uddiapisupport" title="Supported API Calls">Supported API Calls</a>
<a href="#uddiauthmech" title="Authorization Mechanism">Authorization Mechanism</a>
<a href="#uddiapicalls" title="UDDI API Calls">UDDI API Calls</a>
<a href="#uddiexamples" title="Examples">Examples</a>
</div>
</div>
<div>
<a href="expwsmodules.html">Exposing Persistent Stored Modules as Web Services</a>
</div>
<div>
<a href="vsmx.html">Testing Web Published Web Services</a>
</div>
<div>
<a href="bpel.html">BPEL Reference</a>
</div>
<div>
<a href="xsql.html">XSQL</a>
</div>
<br />
</div>
<div id="text">
<a name="uddi" />
<h2>15.12. UDDI</h2>
<a name="uddiconcepts" />
<h3>15.12.1. Concepts</h3>
<p>
Universal Description, Discovery and Integration (UDDI) is the name of a
web-based service that exposes information about a business or other entities
and its technical interfaces or APIs. These services are run by UDDI-enabled
servers, and can be used by any business that wants to make their information
available, as well as anyone who wants to find that information. There is no
charge for using the basic services of these sites.
</p>
<p>
By accessing any of the public sites, anyone can search for
information about web services that are made available by or on behalf
of a business. This provides a mechanism that allows others to
discover what technical programming interfaces are provided for
interacting with a business for such purposes as electronic commerce.
The benefit to the individual business is increased exposure in an
electronic commerce enabled world.
</p>
<p>
Businesses can register several kinds of simple data to help others
answer questions of "who, what, where and how." Simple
information about a business - information such as name, business
identifiers (D&B D-U-N-S Number(R), etc.), and contact information
answers the question "Who." "What" involves classification
information including industry codes and product classifications,
as well as descriptive information about the services that are
available for electronic interchange. Answering the question "Where"
involves registering information about the URL or email address (or
other address) through which each type of service may be accessed.
Finally, the question "How" is answered by registering references to
information about specifications that describe how a particular
software package or technical interface functions. These references
are called '<span class="computeroutput">tModels</span>' in the documentation.
</p>
<br />
<a name="uddisoap" />
<h3>15.12.2. Dealing with SOAP</h3>
<p>
UDDI API functions are exposed as SOAP v1.1 messages over the HTTP
protocol. In version 1, the <span class="computeroutput">SOAPAction</span> HTTP Header
is required. The value passed in this HTTP Header must be an empty
string that is surrounded by double quotes.
</p>
<a name="ex_uddisoap" />
<div class="example">
<div class="exampletitle">UDDI and Soap</div>
<div>
<pre class="programlisting">
POST /UDDI/inquiry HTTP/1.1
Host: www.foo.com
Content-Type: text/xml
Content-Length: nnnn
SOAPAction: ""
.... body follows ....
</pre>
</div>
</div>
<p>
SOAP is used in conjunction with HTTP to provide a simple mechanism for
passing XML messages to UDDI-enabled servers using a standard HTTP-POST
protocol. Unless specified, all responses will be returned in the normal HTTP
response document.
</p>
<div class="tip">
<div class="tiptitle">See Also:</div>
<p>
For more information about Virtuoso's SOAP Implementation see the
<a href="soap.html">SOAP Services</a> section.</p>
</div>
<br />
<a name="uddiapisupport" />
<h3>15.12.3. Supported API Calls</h3>
<p>
The UDDI APIs always return a SOAP entity body which contains messages
as described in UDDI v1 XML Schema (uddi_1.xsd).
</p>
<ul>
<li>
<p>
<strong>Authorization API</strong> - Used to establish
authentication mechanism (tokens), dropping already established connections.</p>
<ul>
<li>
<strong>discard_authToken:</strong> Used to inform a UDDI
enabled server that a previously provided authentication token is no longer valid.
</li>
<li>
<strong>get_authToken:</strong> Used to request an authentication
token from a UDDI-enabled server. Authentication tokens are required to use all
other APIs defined in the publishers API. This function serves as the
program's equivalent of a login request.
</li>
<li>
<strong>get_registeredInfo:</strong> Used to request an
abbreviated synopsis of all information currently managed by a given individual.
</li>
</ul>
</li>
<li>
<p>
<strong>Searching API</strong> The publicly accessible queries are:</p>
<ul>
<li>
<strong>find_binding:</strong> Used to locate specific bindings
within a registered businessService. Returns a bindingDetail message.
</li>
<li>
<strong>find_business:</strong> Used to locate information
about one or more businesses . Returns a businessList message.
</li>
<li>
<strong>find_service:</strong> Used to locate specific services
within a registered businessEntity. Returns a serviceList message.
</li>
<li>
<strong>find_tModel:</strong> Used to locate one or more tModel
information structures. Returns a tModelList structure.
</li>
<li>
<strong>get_bindingDetail:</strong> Used to get full bindingTemplate
information suitable for making one or more service requests. Returns a
bindingDetail message.
</li>
<li>
<strong>get_businessDetail:</strong> Used to get full
businessEntity information for one or more businesses. Returns a businessDetail
message.
</li>
<li>
<strong>get_businessDetailExt:</strong> Used to get extended
businessEntity information. Returns a businessDetailExt message.
</li>
<li>
<strong>get_serviceDetail:</strong> Used to get full details
for a given set of registered businessService data. Returns a serviceDetail
message.
</li>
<li>
<strong>get_tModelDetail:</strong> Used to get full details for
a given set of registered tModel data. Returns a tModelDetail message.
</li>
</ul>
</li>
<li>
<p>
<strong>Repository Manipulation API</strong>
</p>
<ul>
<li>
<strong>delete_binding:</strong> Used to remove an existing bindingTemplate
from the bindingTemplates collection that is part of a specified businessService
structure.
</li>
<li>
<strong>delete_business:</strong> Used to delete registered businessEntity
information from the registry.
</li>
<li>
<strong>delete_service:</strong> Used to delete an existing businessService
from the businessServices collection that is part of a specified businessEntity.
</li>
<li>
<strong>delete_tModel:</strong> Used to delete registered information about a
tModel. If there are any references to a tModel when this call is made, the tModel
will be marked deleted instead of being physically removed.
</li>
<li>
<strong>save_binding:</strong> Used to register new bindingTemplate information
or update existing bindingTemplate information. Use this to control information
about technical capabilities exposed by a registered business.
</li>
<li>
<strong>save_business:</strong> Used to register new businessEntity information
or update existing businessEntity information. Use this to control the overall
information about the entire business. Of all the save APIs this one has the broadest
effect.
</li>
<li>
<strong>save_service:</strong> Used to register or update complete information
about a businessService exposed by a specified businessEntity.
</li>
<li>
<strong>save_tModel:</strong> Used to register or update complete information
about a tModel.
</li>
</ul>
</li>
</ul>
<br />
<a name="uddiauthmech" />
<h3>15.12.4. Authorization Mechanism</h3>
<p>
The Publishers API describes the messages that are used to control the content
contained within a UDDI-enabled server, and can be used by compliant non-operator
implementations that adhere to the behaviors described in this programmer's reference
specification.
</p>
<p>
All calls made to UDDI-enabled servers that use the messages defined in the
publisher's API will be transported using SSL encryption. UDDI-enabled servers
will each provide a service description that exposes a <span class="computeroutput">bindingTemplate</span> that
makes use of HTTPS and SSL to secure the transmission of data.
</p>
<a name="uddiauth" />
<h4>15.12.4.1. Authentication</h4>
<p>
Each of the calls in the publisher's API that change information at a given
UDDI-enabled server requires the use of an opaque authentication token. These
tokens are generated by or provided by each UDDI-enabled server independently,
and are passed from the caller to the UDDI-enabled server in the element
named <span class="computeroutput">authInfo</span>.
</p>
<p>
These tokens are meaningful only to the UDDI-enabled server that provided
them and are to be used according to the published policies of a given
UDDI-enabled server.
</p>
<p>
Each party that has been granted publication access to a given UDDI-enabled
server will be provided a token by the site. The methods for obtaining this token are
specific to each UDDI-enabled server.
</p>
<br />
<a name="uddiestcreds" />
<h4>15.12.4.2. Establishing Credentials</h4>
<p>
Before any party can publish data within a UDDI-enabled server,
credentials and permission to publish must be supplied with the
individual operator. Generally, you will only need to interact with
one UDDI-enabled server because all data published at any UDDI-enabled
server are replicated automatically to all other such servers.
Establishing publishing credentials involves providing some verifiable
identification information, contact information, and establishing
security credentials with the individual server. The specifics of
these establishing credentials is server-dependent, and all valid
UDDI-enabled servers provide a Web-based user interface through which
you can establish an identity and secure permission to publish data.
</p>
<p>
Every registry implementation that adheres to these specifications
establishes its own mechanism for token generation and authentication.
The only requirement placed on token generation for use with the publisher's
API is that the tokens themselves must be valid string text that can be placed
within the <span class="computeroutput">authInfo</span> XML element. Given that binary-to-string translations are
well-understood and in common use, this requirement will not introduce hardships.
</p>
<p>
Authentication tokens are not required to be valid except at the UDDI-enabled server
or implementation from which they originated. These tokens need only have meaning
at a single UDDI-enabled server or implementation, and should not be expected
to work across sites.
</p>
<br />
<a name="genauthtokens" />
<h4>15.12.4.3. Generating Authentication Tokens</h4>
<p>
Many implementations are expected to require a login step. The
<span class="computeroutput">get_authToken</span> message is provided to accommodate implementations that
desire a login step. Security schemes based on
exchanging User ID and password credentials fall into this category. For
implementations that desire this kind of security, the <span class="computeroutput">get_authToken</span> API is
provided as a means of generating a temporary authentication token.
</p>
<p>
Certificate-based authentication and similar security mechanisms do not
require this additional step of logging in. Instead, they can pass
compatible authentication token information such as a certificate value
within the <span class="computeroutput">authInfo</span> element provided on each of the
publisher's API messages. If certificate-based authentication or similar
security is employed the use of the <span class="computeroutput">get_authToken</span>
and <span class="computeroutput">discard_authToken</span> messages is optional.
</p>
<br />
<br />
<a name="uddiapicalls" />
<h3>15.12.5. UDDI API Calls</h3>
<p>
This section describes the Virtuoso UDDI-related messages. These messages
are divided into APIs for authentication, inquiry, and publication.
</p>
<a name="authapis" />
<h4>15.12.5.1. Authorization API</h4>
<div class="funcsynopsis">
</div>
<p>Obtain authentication token.</p>
<div class="funcsynopsis">
</div>
<p>Retrieve an abbreviated list of all businessEntity keys.</p>
<div class="funcsynopsis">
</div>
<p>Inform a UDDI server that the authentication token can be discarded.</p>
<br />
<a name="uddisearchapi" />
<h4>15.12.5.2. Inquiry API Functions</h4>
<p>
The inquiry API messages <span class="computeroutput">find_binding</span>,
<span class="computeroutput">find_business</span>, <span class="computeroutput">find_service</span>,
and <span class="computeroutput">find_tModel</span> all accept an optional element
named <span class="computeroutput">findQualifiers</span>. This argument provides a
means to allow the caller to override default search behaviors.
</p>
<p>
The messages in this section represent inquiries that anyone can make of
any UDDI-enabled server at any time. These messages all behave synchronously
and are required to be exposed via HTTP POST only. Other synchronous or
asynchronous mechanisms may be provided at the discretion of the individual
UDDI-enabled server or compatible registry.
</p>
<p>
The publicly accessible queries are:
</p>
<ul>
<li>
<strong>find_binding:</strong> Used to locate specific bindings
within a registered businessService. Returns a bindingDetail message.
</li>
<li>
<strong>find_business:</strong> Used to locate information
about one or more businesses. Returns a businessList message.
</li>
<li>
<strong>find_service:</strong> Used to locate specific
services within a registered businessEntity. Returns a serviceList message.
</li>
<li>
<strong>find_tModel:</strong> Used to locate one or more
tModel information structures. Returns a tModelList structure.
</li>
<li>
<strong>get_bindingDetail:</strong> Used to get full
bindingTemplate information suitable for making one or more service requests.
Returns a bindingDetail message.
</li>
<li>
<strong>get_businessDetail:</strong> Used to get the full
businessEntity information for a one or more businesses. Returns a
businessDetail message.
</li>
<li>
<strong>get_businessDetailExt:</strong> Used to get extended
businessEntity information. Returns a businessDetailExt message.
</li>
<li>
<strong>get_serviceDetail:</strong> Used to get full details
for a given set of registered businessService date. Returns a serviceDetail
message.
</li>
<li>
<strong>get_tModelDetail:</strong> Used to get full details
for a given set of registered tModel data. Returns a tModelDetail message.
</li>
</ul>
<div class="funcsynopsis">
</div>
<p>Retrieves matching bindings</p>
<div class="funcsynopsis">
</div>
<p>Retrieves a businessList message matching supplied criteria.</p>
<div class="funcsynopsis">
</div>
<p>Retrieves serviceList message matching search criteria</p>
<div class="funcsynopsis">
</div>
<p>locate list of tModel entries matching supplied criteria</p>
<div class="funcsynopsis">
</div>
<p>Request run-time bindingTemplate location information.</p>
<div class="funcsynopsis">
</div>
<p>returns complete businessEntity information for one or more specified businessEntities</p>
<div class="funcsynopsis">
</div>
<p>Returns extended businessEntity information for one or more specified businessEntities.</p>
<div class="funcsynopsis">
</div>
<p>request full information about a known businessService structure</p>
<div class="funcsynopsis">
</div>
<p>Request full information about a known tModel structure.</p>
<br />
<a name="uddipublishingfuncs" />
<h4>15.12.5.3. Publishing API Functions</h4>
<p>
The messages in this section represent inquiries that require authenticated access
to an operator site. Each business should initially select one UDDI-enabled server
to host their information. Once chosen, information can only be updated at the site
originally selected.
</p>
<p>
The messages defined in this section all behave synchronously and are only
callable via HTTP-POST. HTTPS is used exclusively for all the calls
defined in this publisher's API.
</p>
<ul>
<li>
<strong>save_binding:</strong> Used to register new bindingTemplate information
or update existing bindingTemplate information. Use this to control information about
technical capabilities exposed by a registered business.
</li>
<li>
<strong>save_business:</strong> Used to register new businessEntity information
or update existing businessEntity information. Use this to control the overall information
about the entire business. Of all the save messages, this one has the broadest effect.
</li>
<li>
<strong>save_service:</strong> Used to register or update complete information
about a businessService exposed by a specified businessEntity.
</li>
<li>
<strong>save_tModel:</strong> Used to register or update complete
information about a tModel.
</li>
<li>
<strong>delete_binding:</strong> Used to remove an existing bindingTemplate
from the bindingTemplates collection that is part of a specified businessService
structure.
</li>
<li>
<strong>delete_business:</strong> Used to delete registered businessEntity
information from the registry.
</li>
<li>
<strong>delete_service:</strong> Used to delete an existing businessService
from the businessServices collection that is part of a specified businessEntity.
</li>
<li>
<strong>delete_tModel:</strong> Used to delete registered information about
a tModel. If there are any references to a tModel when this call is made, the tModel
will be marked deleted instead of being physically removed.
</li>
</ul>
<div class="funcsynopsis">
</div>
<p>save or update a complete bindingTemplate structure</p>
<div class="funcsynopsis">
</div>
<p>Save or update information about a complete businessEntity structure.</p>
<div class="funcsynopsis">
</div>
<p>Adds or updates one or more businessService structures.</p>
<div class="funcsynopsis">
</div>
<p>Adds or updates one or more tModel structures.</p>
<div class="funcsynopsis">
</div>
<p>Causes one or more bindingTemplate
structures to be deleted.</p>
<div class="funcsynopsis">
</div>
<p>Remove one or more businessEntity structures.</p>
<div class="funcsynopsis">
</div>
<p>Remove one or more businessService structures.</p>
<div class="funcsynopsis">
</div>
<p>Remove or retire one or more tModel structures.</p>
<br />
<br />
<a name="uddiexamples" />
<h3>15.12.6. Examples</h3>
<a name="ex_uddi_genfind" />
<div class="example">
<div class="exampletitle">Generic Find</div>
<p>Finds all registry entries for names beginning with 'M':</p>
<div>
<pre class="programlisting">
select http_get ('http://localhost:6666/SOAP', null, 'POST',
'Content-Type: text/xml\r\nSOAPAction: ""',
'<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<find_business xmlns="urn:uddi-org:api" generic="1.0">
<name>M</name>
</find_business>
</Body>
</Envelope>');
</pre>
</div>
</div>
<a name="ex_uddi_findbyname1" />
<div class="example">
<div class="exampletitle">Find By Name 1</div>
<p>Find by name with sort options by name and date, both ascending:</p>
<div>
<pre class="programlisting">
select http_get ('http://localhost:6666/SOAP', null, 'POST',
'Content-Type: text/xml\r\nSOAPAction: ""',
'<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<find_business xmlns="urn:uddi-org:api" generic="1.0">
<findQualifiers>
<findQualifier>sortByNameAsc</findQualifier>
<findQualifier>sortByDateAsc</findQualifier>
</findQualifiers>
<name></name>
</find_business>
</Body>
</Envelope>');
</pre>
</div>
</div>
<a name="ex_uddi_findbyname2" />
<div class="example">
<div class="exampletitle">Find By Name 2</div>
<p>Find by name, sorted by name descending and date ascending:</p>
<div>
<pre class="programlisting">
select http_get ('http://localhost:6666/SOAP', null, 'POST',
'Content-Type: text/xml\r\nSOAPAction: ""',
'<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<find_business xmlns="urn:uddi-org:api" generic="1.0">
<findQualifiers>
<findQualifier>sortByNameDesc</findQualifier>
<findQualifier>sortByDateAsc</findQualifier>
</findQualifiers>
<name></name>
</find_business>
</Body>
</Envelope>');
</pre>
</div>
</div>
<a name="ex_uddi_findbynameematch" />
<div class="example">
<div class="exampletitle">Find By Name 3</div>
<p>Find by exact name match, case-sensitive, and sorted by name and
date ascending:</p>
<div>
<pre class="programlisting">
select http_get ('http://localhost:6666/SOAP', null, 'POST',
'Content-Type: text/xml\r\nSOAPAction: ""',
'<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<find_business xmlns="urn:uddi-org:api" generic="1.0">
<findQualifiers>
<findQualifier>exactNameMatch</findQualifier>
<findQualifier>caseSensitiveMatch</findQualifier>
<findQualifier>sortByNameAsc</findQualifier>
<findQualifier>sortByDateAsc</findQualifier>
</findQualifiers>
<name>Microsoft Corporation</name>
</find_business>
</Body>
</Envelope>');
</pre>
</div>
</div>
<a name="ex_uddi_findbyidbay" />
<div class="example">
<div class="exampletitle">Find By identifierBag Element 'DUNS':</div>
<div>
<pre class="programlisting">
select http_get ('http://localhost:6666/SOAP', null, 'POST',
'Content-Type: text/xml\r\nSOAPAction: ""',
'<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<find_business xmlns="urn:uddi-org:api" generic="1.0">
<findQualifiers>
<findQualifier>exactNameMatch</findQualifier>
<findQualifier>caseSensitiveMatch</findQualifier>
<findQualifier>sortByNameAsc</findQualifier>
<findQualifier>sortByDateAsc</findQualifier>
</findQualifiers>
<identifierBag>
<keyedReference keyName="D-U-N-S" keyValue="08-146-6849"
tModelKey="UUID:8609C81E-EE1F-4D5A-B202-3EB13AD01823"/>
</identifierBag>
</find_business>
</Body>
</Envelope>');
</pre>
</div>
</div>
<a name="ex_uddi_findbytmodel" />
<div class="example">
<div class="exampletitle">Find by tModel</div>
<div>
<pre class="programlisting">
select http_get ('http://localhost:6666/SOAP', null, 'POST',
'Content-Type: text/xml\r\nSOAPAction: ""',
'<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<find_business xmlns="urn:uddi-org:api" generic="1.0">
<findQualifiers>
<findQualifier>exactNameMatch</findQualifier>
<findQualifier>caseSensitiveMatch</findQualifier>
<findQualifier>sortByNameAsc</findQualifier>
<findQualifier>sortByDateAsc</findQualifier>
</findQualifiers>
<tModelBag>
<tModelKey>UUID:68DE9E80-AD09-469D-8A37-088422BFBC36</tModelKey>
</tModelBag>
</find_business>
</Body>
</Envelope>');
</pre>
</div>
</div>
<a name="ex_uddi_findbydiscovery" />
<div class="example">
<div class="exampletitle">Find by discovery URL</div>
<div>
<pre class="programlisting">
select http_get ('http://localhost:6666/SOAP', null, 'POST',
'Content-Type: text/xml\r\nSOAPAction: ""',
'<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<find_business xmlns="urn:uddi-org:api" generic="1.0">
<findQualifiers>
<findQualifier>exactNameMatch</findQualifier>
<findQualifier>caseSensitiveMatch</findQualifier>
<findQualifier>sortByNameAsc</findQualifier>
<findQualifier>sortByDateAsc</findQualifier>
</findQualifiers>
<discoveryURLs>
<discoveryURL>
http://uddi.microsoft.com/discovery?businessKey=D94B25A4-BD6D-4426-AEAC-1087DCC21421
</discoveryURL>
</discoveryURLs>
</find_business>
</Body>
</Envelope>');
</pre>
</div>
</div>
<a name="ex_uddi_getauth" />
<div class="example">
<div class="exampletitle">Get authentication token</div>
<div>
<pre class="programlisting">
select http_get ('http://localhost:6666/SOAP', null, 'POST',
'Content-Type: text/xml\r\nSOAPAction: ""',
'<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<get_authToken xmlns="urn:uddi-org:api" generic="1.0">
<userID>dav</userID>
<cred>dav</cred>
</get_authToken>
</Body>
</Envelope>');
</pre>
</div>
</div>
<a name="ex_uddi_discardauth" />
<div class="example">
<div class="exampletitle">Discard Authentication Token</div>
<div>
<pre class="programlisting">
select http_get ('http://localhost:6666/SOAP', null, 'POST',
'Content-Type: text/xml\r\nSOAPAction: ""',
'<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns="http://schemas.xmlsoap.org/soap/envelope/">
<Body>
<discard_authToken xmlns="urn:uddi-org:api" generic="1.0">
<authInfo>71255ffc5b0a22b4699bfcee74cba97f</authInfo>
</discard_authToken>
</Body>
</Envelope>');
</pre>
</div>
</div>
<br />
<div class="tip">
<div class="tiptitle">See Also:</div>
<p>
<a href="systemtables.html#uddischema">UDDI System Tables</a>
</p>
</div>
<table border="0" width="90%" id="navbarbottom">
<tr>
<td align="left" width="33%">
<a href="syncml.html" title="SyncML">Previous</a>
<br />SyncML</td>
<td align="center" width="34%">
<a href="webservices.html">Chapter Contents</a>
</td>
<td align="right" width="33%">
<a href="expwsmodules.html" title="Exposing Persistent Stored Modules as Web Services">Next</a>
<br />Exposing Persistent Stored Modules as Web Services</td>
</tr>
</table>
</div>
<div id="footer">
<div>Copyright© 1999 - 2009 OpenLink Software All rights reserved.</div>
<div id="validation">
<a href="http://validator.w3.org/check/referer">
<img src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0!" height="31" width="88" />
</a>
<a href="http://jigsaw.w3.org/css-validator/">
<img src="http://jigsaw.w3.org/css-validator/images/vcss" alt="Valid CSS!" height="31" width="88" />
</a>
</div>
</div>
</body>
</html>
distrib
>
Fedora
>
14
>
x86_64
>
media
>
updates
>
by-pkgid
>
71d40963b505df4524269198e237b3e3
>
files
>
904
