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
RDF data
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_get_bindingDetail

Request run-time bindingTemplate location information.
Syntax
<uddi_get_bindingDetail
  generic="1.0"
  xmlns="urn:uddi-org:api" >
	<bindingKey/>
	[ <bindingKey/> ...]
</uddi_get_bindingDetail>
  
Description

The uddi_get_bindingDetail message requests the run-time bindingTemplate information for the purpose of invoking a registered business API.

Attributes & Children
bindingKey – One or more uuid_key values that represent specific instances of known bindingTemplate data.
Behavior – In general, it is recommended that bindingTemplate information be cached locally by applications so that repeated calls to a service described by a bindingTemplate can be made without having to make repeated round trips to a registry. In the event that a call made with cached data fails, the uddi_get_bindingDetail message can be used to get fresh bindingTemplate data. This is useful in cases such as when a service you are using relocates to another server or is restored at a disaster recovery site.
Return Types

This function returns a bindingDetail message on successful match of one or more bindingKey values. If multiple bindingKey values were passed, the results will be returned in the same order as the keys passed.

In the event of a large number of matches, a server may truncate the result set. If this occurs, the bindingDetail result 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_invalidKeyPassed signifies that one of the uuid_key values passed did not match with any known bindingKey key values. No partial results will be returned; if any bindingKey values passed are not valid bindingKey values, this error will be returned.