Web Services Essentials

Name

find_business

Synopsis

The find_business function searches for businesses that match the specified criteria. The response includes a root businessList element, and one businessInfo element for each matching company. If the UDDI operator returns only a partial list of matching results, the businessList element’s truncated attribute will be set to true. If no matches are found, a businessList element with zero subelements is returned.

Version: 1.0 and 2.0

1.0 syntax:

<find_business generic="1.0" [maxRows="nn"] 
   xmlns="urn:uddi-org:api">
   [<findQualifiers/>]
   [<name/>]
   [<identifierBag/>]
   [<categoryBag/>]
   [<tModelBag/>]
   [<discoveryURLs>]
</find_business>

2.0 syntax:

<find_business generic="2.0" [maxRows="nn"] 
   xmlns="urn:uddi-org:api_v2">
   [<findQualifiers/>]
   [<name/> [<name/>]...]
   [<discoveryURLs/>]
   [<identifierBag/>]
   [<categoryBag/>]
   [<tModelBag/>]
</find_business>

Arguments:

maxRows

Optional attribute to specify the maximum number of rows to be returned; if maxRows is exceeded, the businessList element’s truncated attribute will be set to true.

findQualifiers

Optional element to override the default search functionality. For example, the find qualifier exactNameMatch will match exact business names.For details, see the “Find Qualifiers” section, later in this chapter.

name

The full or partial name of the business. UDDI 2.0 enables you to specify up to five business names. The default behavior is to perform an exact left-to-right lexical search. Use % to specify wildcard options; ...