UDDI API - save_tModel

Description

The save_tModel API call adds or updates one or more registered tModel elements.

This API returns a tModelDetail message containing the final results of the call that reflects the new registered information for the effected tModel elements. If multiple tModel elements were passed in the save_tModel request, the order of the response will exactly match the order the elements appeared in the save. If the same tModel, determined by matching key, is listed more than once in the save_tModel message, it may be listed once in the result for each appearance in the save_tModel message. If so, the last appearance in the results represents the final saved state.

Version 2.0 Syntax

<save_tModel generic = "2.0" 
   xmlns = "urn:uddi-org:api_v2" >
   <authInfo/>
   <tModel/> [<tModel/>.]
</save_tModel>

Arguments

authInfo − This required argument is an element that contains an authentication token. Authentication tokens are obtained using the get_authToken API call.

tModel − One or more complete tModel elements can be passed. If adding a new tModel, the tModelKey value should be passed as an empty element.

Error Returned

If any error occurs in processing this API call, a dispositionReport element will be returned to the caller within a SOAP Fault. The following error number information will be relevant −

E_authTokenExpired − It signifies that the authentication token value passed in the authInfo argument is no longer valid because the token has expired.

E_authTokenRequired − It signifies that the authentication token value passed in the authInfo argument is either missing or is not valid.

E_invalidKeyPassed − It signifies that the request cannot be satisfied because one or more uuid_key values specified is not a valid key value. This will occur if a uuid_key value is passed in a tModel that does not match with any known tModel key. The key value that causes an error will be indicated clearly in the error text.

E_userMismatch − It signifies that one or more of the uuid_key values passed refers to data that is not controlled by the individual who is represented by the authentication token. The key causing the error will be clearly indicated in the error text.

E_invalidValue − A value that was passed in a keyValue attribute did not pass validation. This applies to checked categorizations, identifiers and other validated code lists. The error text will clearly indicate the key and value combination that failed validation.

E_requestTimeout − It signifies that the request could not be carried out because a needed validate_values service did not respond in a reasonable amount of time. Details identifying the failing service will be included in the dispositionReport element.

E_valueNotAllowed − Restrictions have been placed by the taxonomy provider on the types of information that should be included at that location within a specific taxonomy. A validate_values service chosen by the Operator Site has rejected this businessEntity for at least one specified category.

E_accountLimitExceeded − It signifies that user account limits have been exceeded.

uddi_api_references.htm