# 22. Virtuoso Functions Guide - uddi_save_binding

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_save_binding

save or update a complete bindingTemplate structure
Syntax

    <uddi_save_binding
      generic="1.0"
      xmlns="urn:uddi-org:api" >
    	<authInfo/>
    	<bindingTemplate/>
    	[<bindingTemplate/>...]
    </uddi_save_binding>

Description

The uddi_save_binding message is used to save or update a complete bindingTemplate structure. This message can be used to add or update one or more bindingTemplate structures to one or more existing businessService structures.

Attributes & Children
authInfo – This required argument is an element that contains an authentication token, obtained using the get_authToken call.
bindingTemplate – One or more complete bindingTemplate structures. The order in which these are processed is not defined. To save a new bindingTemplate, pass a bindingTemplate structure with an empty bindingKey attribute value.
Behavior – Each bindingTemplate structure passed must contain a serviceKey value that corresponds to a registered businessService controlled by the same identity saving the bindingTemplate data. The effect of this call is to establish the parent businessService relationship for each bindingTemplate affected by this call. If the same bindingTemplate (determined by matching bindingKey value) is listed more than once, any relationship to the containing businessService will be determined by processing order, which is determined by the position of the bindingTemplate data in first-to-last order.
Return Types

This message returns a bindingDetail message that reflects the newly registered information for the affected bindingTemplate structures.

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 the request cannot be satisfied because one or more uuid_key values specified is not a valid key value, or that a hostingRedirector value references a bindingTemplate that itself contains a hostingRedirector value.
E_authTokenExpired | signifies that the authentication token value passed in the authInfo argument is no longer valid because the token has expired.
E_authTokenRequired | signifies that the authentication token value passed in the authInfo argument is either missing or is not valid.
E_userMismatch | signifies that one or more of the uuid_key values passed refers to data that is not controlled by the entity represented by the authentication token.
E_operatorMismatch | signifies that one or more of the uuid_key values passed refers to data that is not controlled by the server that received the request for processing.
E_keyRetired | signifies that the request cannot be satisfied because one or more uuid_key values specified has previously been hidden or removed by the requester. This specifically applies to the tModelKey values passed.
E_invalidURLPassed | an error occurred with one of the uploadRegister URL values.
E_accountLimitExceeded | signifies that user account limits have been exceeded.