# 22. Virtuoso Functions Guide - uddi_find_tModel

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
SQL
String
Transaction
Type Mapping
UDDI
uddi_delete_binding
uddi_delete_business
uddi_delete_service
uddi_delete_tmodel
uddi_discard_authtok...
uddi_find_binding
uddi_find_business
uddi_find_service
uddi_find_tmodel
uddi_get_authtoken
uddi_get_bindingdeta...
uddi_get_businessdet...
uddi_get_businessdet...
uddi_get_registeredi...
uddi_get_servicedeta...
uddi_get_tmodeldetai...
uddi_save_binding
uddi_save_business
uddi_save_service
uddi_save_tmodel
User Defined Types & The CLR
Virtuoso Java PL API
Virtuoso Server Extension Interface (VSEI)
Web Server & Internet
XML
XPATH & XQUERY
Functions Index

## uddi_find_tModel

locate list of tModel entries matching supplied criteria
Syntax

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

Description

This uddi_find_tModel message is for locating a list of tModel entries that match a set of specific criteria. The response will be a list of abbreviated information about tModels that match the criteria (tModelList).

Attributes & Children

The arguments to this call are mutually exclusive except findQualifiers

maxRows – This optional integer value allows the requesting program to limit the number of results returned.
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. The returned tModelList contains tModelInfo structures for businesses whose name matches the value passed (leftmost match).
IdentifierBag – This is a list of business identifier references. The returned tModelList contains tModelInfo structures matching any of the identifiers passed (logical OR).
categoryBag – This is a list of category references. The returned tModelList contains tModelInfo structures matching all of the categories passed (logical AND).
Return Types

This function returns a tModelList on success. In the event that no matches were located for the specified criteria, an empty tModelList structure will be returned (e.g. will contain zero tModelInfo structures). 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 tModelList will contain the truncated attribute with the value of this attribute set to true.

Errors

If an error occurs in processing this message, a dispositionReport structure will be returned to the caller in a SOAP Fault. The following error information will be relevant:

Error Code | Description
--- | ---
E_nameTooLong | signifies that the partial name value passed exceeds the maximum name length designated by the UDDI-enabled 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.