Managing Multi-Value Properties - Alfresco Content Services - 23.4 - 23.4 - Ready - Alfresco - external

By default, a property supports a single value, but this may be changed to support multiple values via the multiple element in the content model definition. Multiple values are rendered as lists in the various Alfresco APIs. A d:text property with multiple set to true will allow you to store multiple string values for the property and the document, and search for them using advanced search capabilities.

The following content model shows an example of a text property (acme:campaign) defined as having multiple values. The possible values are restricted by the values defined in the acme:campaignList constraint. If you wanted to allow any campaign name, then remove this constraint definition.

<constraints>
    <constraint name="acme:campaignList" type="LIST">
        <parameter name="allowedValues">
            <list>
                <value>Campaign A</value>
                <value>Campaign B</value>
                <value>Campaign C</value>
                <value>Campaign D</value>
                <value>Campaign E</value>
            </list>
        </parameter>
    </constraint>
</constraints>

<types>
<type name="acme:marketingDoc">
    <title>Acme Marketing Document</title>
    <parent>acme:doc</parent>
    <properties>
        <property name="acme:campaign">
            <type>d:text</type>
            <multiple>true</multiple>
            <constraints>
                <constraint ref="acme:campaignList" />
            </constraints>
        </property>
    </properties>
</type>
</types>

The data structure to use for multiple values in Java is a list:

ArrayList<Serializable> values = new ArrayList<Serializable>();
values.add("Campaign A");
values.add("Campaign D");
nodeService.setProperty(nodeRef, "cm:campaign", values);

The data structure to use for multiple values in JavaScript is an array:

document.properties["acme:campaign"] = ["Campaign A","Campaign D"];