Projects and Designs > Design Wide Object

Merging Instances of Design

Wide Objects

This topic details how to merge a design object into another design object. This action is available for signals. Any objects to be merged must be the same type of object.

See Merging of Design Wide Objects for more detailed information about the conditions for using this action.

Procedure

In the diagram window or the Design Browser Window, right-click on the source design wide object that you want to merge into another target design wide object and select Merge Into; the Merge Into Dialog is displayed.
Select the target design wide object into which the selected object will be merged and click OK.
If any property or attribute values in the source object conflict with those in the target object, the Resolve tab becomes available. In the Resolve tab, select each object in the tree in turn and select the values you want to retain in the Attributes list and Properties list, or click either Source or Target in the Choose Results From section.

Results

Any ports with the same name in the source object and target object are merged on the merged object. Any ports with unique names on the source or target object appear on the merged object. Note If the project preference “Disallow port duplication within a design” is set, objects with duplicate port names can not be merged. Such object names will not be selectable in the Merge dialog. A tooltip message displays an explanation of this on hovering over such a row in the Merge dialog.
Properties and attributes on the objects are merged: If either the source object or target object has properties or attributes that the other object does not have, they are retained on the merged object.

If the source object has property or attribute values that conflict with values on the target object, the values selected in the Resolve tab are retained and the other values are discarded.

In the Output Window, the Resolution tab displays. The table in the Resolution tab lists any property or attribute values in the source object that were in conflict with those in the target object, and shows how those conflicts were resolved. Properties/attributes that may require adjustment are indicated by the value of the Type field being “Warning”.
Cross-references are created on the object instances and obey project preferences and styling settings. If there is no home condition set on the source or target object before the merge, it is set on the target object instance.
If merging two portlists results in an invalid mating of ports, the ports on the source instance are disconnected.
If merging two signals results in more than two terminations for a single signal, the source signal connections are disconnected.
If automatic harness connectors generation is enabled, they are generated as required.

Parent Topic:

Design Wide Object