undoCollapseMultipleProducts

Description
This transaction will undo the previous collapse of multiple products. The original source products remain inactivated and clones of all of those original source products (and their child business objects) are created. Optionally, new product definitions may be provided for some or all of the new products. The consolidated product created through the collapse is inactivated.
Web Services
Operation name: undoCollapseMultipleProducts
Service name: ProductService
Example
Usage 1: Given a consolidated product, inactivate it and clone all original source products that were collapsed.

Usage 2: Given a consolidated product and a list of source products with new product definitions, inactivate the consolidated product and create copies of all original source products that were collapsed. For each of the original source products specified in the request input, the transaction creates new products as per the new product definition provided. For each of the original source products not specified in the request input, the transaction creates clones of those original source products.

Usage information
InfoSphere® MDM provides a number of transactions and processes to manage the integrity of a single correct version of a product.

The undoCollapseMultipleProducts transaction addresses the situation where products have been collapsed in error. InfoSphere MDM must provide Data Stewards the ability to reverse such operations in order to maintain the golden master copy of enterprise data.

The input to this transaction is the product id of the consolidated product to be inactivated, and an optional list of complete source product business objects (with child business objects) to be created to replace the original source products.

Preconditions
  • The specified product must exist.
  • The specified product must be active.
  • The specified product must have been created through a previous collapse.
Mandatory input
  • ProductId of consolidated product.
Inquiry levels
Not applicable
Filter values
Not applicable
Transaction behavior
The transaction creates clones of all original source products that were collapsed. The level of product information to be cloned depends on the configured inquiry levels. The configured inquiry levels mirror those used by the getProductInstance transaction, and these configured values can be changed by your systems administrator.
For each of the original source products specified, the transaction creates a new product based on the supplied product definition (usage 2).
The transaction creates suspect records between each of the cloned source products with a suspect status indicating the products are not duplicates.
The transaction performs suspect re-identification and creates suspect records for the newly cloned products that were collapsed.
The transaction inactivates the consolidated product that was created during the collapse.
The transaction creates product (traceability) links between the original source products and the cloned source products, and sets the link reason type indicating an undo collapse clone.

The transaction also creates new product party roles to replace any product party roles that included the inactivated consolidated product. The existing product party roles are then expired.

When cloning source products, the service will automatically create the necessary relationships for each of the cloned products. Products with new product definitions (that is, usage 2) may include relationship definitions using an existing product id for either the RelationshipFromValue or RelationshipToValue. The service also supports relationships between two cloned products both having new product definitions if pluggable keys are used.

Request message
<TCRMTxType> undoCollapseMultipleProducts

<TCRMTxObject> ClonedProductBObj

<TCRMTObject> ClonedProductBObj

with:

ProductBObj and an optional ProductListBObj with a list of new product definitions with product IDs matching the source product IDs.

Response objects
ClonedProductBObj with ProductBObj and ProductListBObj with a list of newly created product business objects
Special note
Not applicable