# 22. Virtuoso Functions Guide - uddi_delete_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_delete_tModel

Remove or retire one or more tModel structures.
Syntax

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

Attributes & Children
authInfo – This required argument is an element that contains an authentication token obtained using the get_authToken call.
tModelKey – One or more URN-qualified uuid_key values that represent specific instances of known tModel data. All tModelKey values begin with a uuid URN qualifier (e.g. "uuid:" followed by a known tModel UUID value.)
Return Types

Upon successful completion, a dispositionReport structure is returned with a single success indicator.

Behavior – If a tModel is deleted and any other managed data references that tModel by uuid_key (e.g. within a categoryBag, identifierBag or within a tModelInstanceInfo structure) then the tModel will not be physically deleted as a result of this call. Instead it will be marked as hidden. tModels hidden in this way are still accessible to their owner, via the get_registeredInfo call; however, they will be omitted from any results returned by calls to find_tModel. The details associated with a hidden tModel are still available to anyone who uses the get_tModelDetail message. Publishers who want to remove all details about a tModel from the system should call save_tModel, passing empty values in the data fields, before using uddi_delete_tModel. A hidden tModel can be restored and made universally visible by invoking save_tModel at a later time, passing the key of the hidden tModel.
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 URN-qualified uuid_key values passed did not match with any known tModelKey values. No partial results will be returned; if any tModelKey values passed are not valid, this error will be returned. Any tModelKey values passed without a uuid URN qualifier will be considered invalid.
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 tModelKey values passed refers to data not controlled by the entity the authentication token represents.
E_operatorMismatch | signifies that one or more of the tModelKey values passed refers to data that is not controlled by the server that received the request for processing.