<!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-linktag encloses a <link-via-id> tag, the repository ID of the item is used for linking.If the
primary-item-descriptor-linktag encloses a <link-via-property> tag, a unique item property specified in thelink-via-propertytag 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
firstNameproperty matches the value of the contributing item’suserFirstNamepropertyThe value of the primary item’s
lastNameproperty matches the value of the contributing item’suserLastNameproperty.
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.
