In most cases, you specify a multi-value property, such as an array or Collection, using the property
element, just as you specify a single-value property. In the following example, the phoneNumbers
property stores an array of phone numbers:
<text-properties> <property name="city"/> <property name="state"/> <property name="postalCode"/> <property name="phoneNumbers"/> </text-properties>
Notice that phoneNumbers
is specified in the same way as city
, state
, and postalCode
, which are all single-value properties. The XHTML output document will include a separate element for each value in the phoneNumbers
array.
If a property is an array or Collection of repository items, you specify it using the item
element, and set the is-multi
attribute to true
. For example, in a product catalog, a product
item will typically have a multi-valued childSKUs
property whose values are the various SKUs for the product. You might specify the property like this:
<item property-name="childSKUs" is-multi="true"> <text-properties> <property name="displayName"/> <property name="description"/> </text-properties> </item>
If you index by product (and product is document-level item), the output document will include the displayName
and description
value for each of the product’s SKUs.