Purge
The
purge
performs a physical delete of entities in the application that has previously been marked for deletion through the
delete
operation.
The associated child or parent entities are not deleted by this operation.
The entities to be purged can be controlled by setting additional input parameters on the request.Users must have one of the following permissions for the respective action (delete item or party) to call this operation:
PERM_PURGE_ITEM
- PERM_PURGE_PARTY
The following table describes the performance implications of using this operation:
Activity | Impact | Description |
---|---|---|
Purging multiple parties in a single operation call | Low | The more parties that are purged in a single call, the longer the operation takes to complete. Purging multiple parties in a single call takes less time than purging each party individually using separate operation calls. |
Purging by lastUpdatedDate or using purgeAll | Medium | Purging using these options requires a query against the database before purging objects. |
Purge Request
This message is sent by the client application to the TIBCO Product and Service Inventory system.
Element | Type | Cardinality | Description |
---|---|---|---|
lastUpdateDate | DateQueryType | Choice | This is a range of dates for the purge. |
lastUpdateDate/afterDate | dateTime | Optional | The search is referring to elements modified after the specified date. |
lastUpdateDate/beforeDate | dateTime | Optional | The search is referring to elements modified before the specified date. |
entityId | String | Choice | This is the unique identifier for the deleted entity. |
purgeAll | Boolean | Choice | This indicates purging all logically deleted entities. |
Purge Response
This message is sent by the TIBCO Product and Service Inventory system to the requesting application to return the results of the operation invocation.
Element | Type | Cardinality | Description |
---|---|---|---|
resultStatus | ResultStatusType | Mandatory | This is the result of the request. |
count | long | Optional | This is the number of purged entities. |
entity | Mandatory | This is the entity type returning the individual result status.
If none of the entities could be purged due to a system error, this set is empty. If any of the entities could be deleted, there is one entity for each requested delete entity. |
|
entity/id | String | Mandatory | This is the unique identifier for the purged entity. |