uml13.compare.models

Description

Identify the differences between two models and execute change-corresponding tasks. The models are referred as

old model is considered as the previous version of the model
new model is considered as the new/later version of the model

This macro provides UML 1.3 specific comparison euristics for identification of the model elements and discovering the changed among them. It instantiates the repository, loads the files, finds the differences, delegates them to the change-corresponing tasks and destroys the repository. This way, it is the common base for any comparison of UML 1.3 models, while still allowing the customization:

Before the comparison starts, the init tasks are called.
For each changed element, the changed tasks are executed, where it can refer:
- <new>.element property holds the element form the new model;
- <old>.element property holds the element form the old model;
- attribute.names property the list of names of element's attributes detected as changed;
- association.names property the list of names of element's associations detected as changed.
  The current value of the association in the first model can be retrieved using task;
- for each association name from association.names property two additional properties are defined:
  - <association name>.added contains all elements from the new model that were added, when upgrading from old to the new model, i.e. they have no correspondents as associated in the old model
  - <association name>.deleted contains all elements from the new model that were deleted, when upgrading from old to the new model, i.e. they have no correspondents as associated in the new model
For each added to the model element the added tasks are executed.
For each deleted from the model element the deleted tasks are executed.
At the end the done tasks are executed.

Based on <compare.models> task, using a nested <detect.changes> element. Consider their details in deleted and added elements.

Parameters

Attribute	Description
new	The file with the new version of the model
new.extent.name	The extent name where to load the new version of the model. Use @{new.extent.name}.orphans property set to all model elements, that were ADDED in the new model. Default: NEW
old	The file with the old version of the model
old.extent.name	The extent name where to load the new version of the model. Use @{new.extent.name}.orphans property set to all model elements, that were DELETED in the new model. Default: OLD

Nested elements

Element	Description
report.changed	A condition, which when provided, states which changes to process (report). It may refer the changed element as @{old.extent.name}.element or @{new.extent.name}.element. See / for the available properties
orphans	Tasks to execute after the models are compared and processed, before they are destroyed.
deleted	Tasks to execute for a single deleted element held in 'this' property. All deleted elements are held in @{old.extent.name}.orphans property
added	Tasks to execute for a single added element held in 'this' property. All added elements are held in @{new.extent.name}.orphans property
changed	Tasks to execute for a single changed element held in 'this' property.
done	Tasks to execute after the models are read, before their comparison itself.
init	Tasks to execute after the models are read, before their comparison itself.

Use <typedef resource="uml13/meta.xml"/>