Update

Update modifies one-to-many existing items in the application. The operation specifies a delta of what to change on the current entity rather than a full snapshot. Only fields that need updating need to be included on the request.

This operation also provides the option of locking the updated entity using a defined lock key. The order of operations for locking and unlocking using this operation will determine whether or not other elements of the update will be applied correctly:
  1. Lock the entity using the specified key.

    If the entity could not be locked, then the remainder of the update will not occur. An exception will be returned.

  2. Validate if all specified unlock keys exist.

    If any of the unlock keys do not exist, then the remainder of the update will not occur. An exception will be returned.

  3. Apply all other field updates with the exception of unlock.
  4. Unlock the item using the specified keys
Users must have one of the following permissions for the respective action (update item or party) to call this operation:
  • PERM_UPDATE_ITEM
  • PERM_UPDATE_PARTY
The following table describes performance implications of using this operation:
Activity Impact Description
Updating multiple items in a single operation call Low The more entities that are updated in a single call, the longer the operation will take to complete. Updating multiple entities in a single call still takes less time than updating each entity individually using separate operation calls.

Update performance is slower than create performance.

Updating items with large numbers of characteristics, orders, and relationships Medium The more characteristics, orders, and relationships that are updated on an item, the longer the processing time is.

Update Request

This message is sent by the client application to the TIBCO Fulfillment Subscriber Inventory system.

Update Item Request Payload
Update Party Request Payload
Update Request Body Details for Item and Party
Element Type Cardinality Description
batchId String Optional This is the ID of the batch this update belongs to.
entity Type Mandatory (1..N) This defines the updates to perform.
entity/Id String Mandatory This is the unique identifier for the updated entity.
entity/version Long Optional This field must represent the current version of the entity. If there is a version mismatch, the update will fail.
entity/ref Nullable String Optional This is the reference of the entity being updated.
entity/name Nullable String Optional This is the name of the updated entity.
entity/type String Optional This is the type of the updated entity.
entity/subtype Nullable String Optional This the sub type of the updated entity.
entity/status String Optional This the status of the updated entity.
entity/characteristic N/A Optional This defines characteristics of the entity being updated. See the "Update Characteristic" section in Update Sub Elements for more details on the sub elements of this element.
entity/lock LockType Optional This is the lock information for the entity. See the "Update Lock" section in Update Sub Elements for more details on the sub elements of this element.
entity/unlock UnlockType Optional This is the unlock information for the entity. See the "Update Lock" section in Update Sub Elements for more details on the sub elements of this element.
entity/ownedBy String Optional This is the owner of the updated entity.
entity/undelete Boolean Optional This indicates to logically undelete the entity.
Update Request Body Details for Item Only
Element Type Cardinality Description
entity/productid String Optional This is the product ID for the updated item.
entity/productVersion Nullable String Optional This is the product version for the updated item.
entity/party Nullable String Optional This is the party the updated item belongs to. (no referential integrity)
entity/order N/A Optional This is the order or orders related to this item. See the "Update Order" section in Update Sub Elements for more details on the sub elements of this element.
entity/relationship N/A Optional This is the relationship for the item. See the " Update Relationship" section in Update Sub Elements for more details on the sub elements of this element.
entity/startDate dateTime Optional This is the start date for the updated item.
entity/endDate dateTime Optional This is the end date for the updated item.
Update Request Body Details for Party Only
Element Type Cardinality Description
entity/parentPartyid Nullable String Optional This is the parent party ID for the updated party.

Update Response

This message is sent by the TIBCO Fulfillment Subscriber Inventory system to the requesting application to return the results of the operation invocation.

Update Item Response Payload
Update Party Response Payload
Update Response Body Details for Item and Party
Element Type Cardinality Description
resultStatus ResultStatusType Mandatory This is the result status type and the operation invocation status of the query.
batchId String Optional This is the ID of the batch this update belongs to.
entity BaseEntityResultType Mandatory (1..N)

This is the entity type returning the individual result status.

If none of the entities could be updated due to a system error, then this set will be empty.

If any of the entities could be updated, then there will be one entity for each requested update entity. The returned entity order is the same as the original requested item entity.

entity/Id String Mandatory This is the unique identifier for the updated entity.