<!ELEMENT primary-item-descriptor-link (link-via-id | link-via-property+)>
Parent: <contributing-item-descriptor>
The <primary-item-descriptor-link>
tag specifies how to link items in contributing item descriptors to items in the primary item descriptor, by embedding a <link-via-id> tag or one or more <link-via-property> tags:
If the
primary-item-descriptor-link
tag encloses a <link-via-id> tag, the repository ID of the item is used for linking.If the
primary-item-descriptor-link
tag encloses a <link-via-property> tag, a unique item property specified in thelink-via-property
tag is used for linking.
Examples
In the first example, the contributing item descriptor’s items are linked to the primary item descriptor’s items by the common repository ID of the items:
<primary-item-descriptor-link> <link-via-id/> </primary-item-descriptor-link>
In the next example, a primary item is linked to an item in this contributing item descriptor if two conditions are true:
The value of the primary item’s
firstName
property matches the value of the contributing item’suserFirstName
propertyThe value of the primary item’s
lastName
property matches the value of the contributing item’suserLastName
property.
This is useful when no one property in the primary item descriptor or the contributing item descriptor is uniquely valued. The relationships are AND’d together.
<primary-item-descriptor-link> <link-via-property primary="firstName" contributing="userFirstName"/> <link-via-property primary="lastName" contributing="userLastName"/> </primary-item-descriptor-link>
See Link Methods for more information.