Name
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:
Table24.89.Errors signalled by uddi_delete_tModel
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. |