| Description | This optional property is for advanced use. It names the role of the object at this end of the view relation.
It is used as follows:
- data-view-relations between data-views that both have underlying entities (i.e. those with an 'initial-entity') must match to a relation between the underlying entities
- this matching is normally implicit, because there is only one possible relation between the two underlying entities - so this is assumed to be the matching relations, regardless of the role-name.
- however, if there is more than one possibility, the end-role-name can be used to explicitly identify the role-name of the matching relation.
- there is a third possibility - that the data-view-end's role-name is used to match to the correct end on the entity.
This is fine if both levels of relations - at the entity and the data-view level - can use the same role names.
But if this is inconvenient, the end-role-name can be used so that different role names can be used on the entity and data-view relations.
This also affects coding in some tools - such as IBM Rational's RSA-RSM, which joins the concept of role name and setter/getter for the related object.
|