Merge Data Examples
SuiteBundler uses the following rules when you update a bundle that contains record data with parent-child relationships and use the Merge Data option:
-
Relationships removed in the source account are also removed in the target account.
-
Relationships in the target account that include non-bundle custom records may be overwritten, if they conflict with the parent-child relationships in the source account.
-
If you delete a parent record in the source account, SuiteBundler retains the parent record and any relationship to child records in the target account.
-
SuiteBundler adds any new records and the associated parent-child relationships, added in the source account, to the target account.
-
SuiteBundler retains any new target account records and parent-child relationships if they do not conflict with records and relationships from the source account.
The examples in this section assume that the source bundle has already been installed one time in the target account.
The following table includes bundle update examples for the Merge Data update option:
Change Made In Account ... |
Description of Changes |
Effect on Source Account |
Effect on Target Account |
---|---|---|---|
Source |
Remove parent-child relationship a : b in the source account. After upgrade, relationship is removed in the target account. |
Before edit: After edit: |
Before update: After update: |
Source and target |
In the source account, rename parent record, b to p, with a child record. In the target account, edit parent-child relationship, b : c to b : n, where n is a non-bundle record. After upgrade, parent-child relationship b : n is overwritten in the target account. |
Before edit: After edit: |
After target edit and before update: After update: |
Source |
In the source account, delete parent record e in a parent-child relationship e : f. In the target account, the parent-child relationship is retained, although the parent record and relationship was removed in the source account. |
Before edit: After edit: |
Before and after update: |
Source and target |
In the source account, add two new records with the parent-child relationship v : w. In the target account, add two new records with the parent-child relationship y : z. After upgrade, the two new records and the relationship are copied to the target account. The two new records and the relationship remain in the target account. |
Before edit: After edit: |
Before edit: After edit: After update: |
For more examples for the the Preserve Data or Replace Data preferences, see Preserve Data Examples or Replace Data Examples.