Name

uddi_find_service — Retrieves serviceList message matching search criteria

Syntax

<uddi_find_service
  businessKey="uuid_key"
  generic="1.0"
  [ maxRows ="nn" ]
  xmlns="urn:uddi-org:api" >
        [<findQualifiers/>]
        <name/> | <categoryBag/> | <tModelBag/>
</uddi_find_service>
  

Attributes & Children

The name , categoryBag , and tModelBag arguments are mutually exclusive.

maxRows

This optional integer value allows the requesting program to limit the number of results returned.

businessKey

This uuid_key is used to specify a particular BusinessEntity instance.

findQualifiers

This collection of findQualifier elements can be used to alter the default behavior of search functionality.

name

This string value represents a partial name. Any businessService data contained in the specified businessEntity with a matching partial name value gets returned.

categoryBag

This is a list of category references. The returned serviceList contains businessInfo structures matching all of the categories passed (logical AND).

tModelBag

This is a list of tModel uuid_key values that represent the technical fingerprint the server should locate within a bindingTemplate structure contained within any businessService contained by the businessEntity specified. If more than one tModel key is specified in this structure, only businessServices that contain bindingTemplate information that matches all of the tModel keys specified will be returned (logical AND).

Return Types

This function returns a serviceList on success. In the event that no matches were located for the specified criteria, the serviceList structure returned will contain an empty businessServices structure. This signifies zero matches.

In the event of a large number of matches, a UDDI-enabled server may truncate the result set. If this occurs, the serviceList will contain the truncated attribute with the value of this attribute set to true.

Searching using tModelBag will return serviceInfo structures for all qualifying businessService data, including matches due to hostingRedirector references. In other words, if the businessEntity whose businessKey is passed as an argument contains a bindingTemplate with a hostingRedirector value, and that value references a bindingTemplate that matches the tModel search requirements, then the serviceInfo for the businessService containing the hostingRedirector will be returned.

Errors

Table24.93.Errors signalled by uddi_find_service

Error Code Description
E_invalidKeyPassed signifies that the uuid_key value passed did not match with any known businessKey or tModel key values. The error structure will signal which condition occurred first.
E_nameTooLong signifies that the partial name value passed exceeds the maximum name length designated by the server.
E_tooManyOptions signifies that more than one mutually exclusive argument was passed.
E_unsupported signifies that one of the findQualifier values passed was invalid.