Choice lists for custom properties

Use the choiceList configuration parameter to specify a comma-delimited list of values for the custom property. The order of the values that you specify determines the order of the choices in the choice list.

For each choice list that you want to create, specify a choiceList configuration parameter in the properties file. Customize the list for each item type, or item type subset view if you use item type subset views. You can customize the list globally for all item types with the same property. If you create item type subset views and restrict access to the base item type view, you must create a customized list for each item type subset view. You must also create a customized list for the base view with same name as the item type. You can customize the list for each item type subset view that the user has access to, or you can repeat the same list for all subset views. If you are not using item type subset views, use the item type name. If you do not specify an item type subset view that is the active view for a user, the choice list is not listed or validated for that user. For any attributes that belong to an attribute group, you must specify an attribute name by group name.

The values are validated by the IBM® CMIS server for any application that uses the IBM CMIS server. However, most applications that support choice lists do not allow the user to enter any choice except the values from the valid list. The server validation is a secondary validation in case an application uses IBM CMIS but does not restrict choices to valid values.

The properties file settings do not affect or restrict other Content Manager EE applications that are not using IBM CMIS, such as IBM WEBi or eClient.

The choice list values that are based on the choiceList configuration parameter in the properties file override the values from any Content Manager EE native choice lists defined by foreign keys. The values are validated by the IBM CMIS server. The values override a native choice list, but they do not override the server validation against the larger list.

Examples

The following code sample shows the syntax of the choiceList configuration parameter in the properties file that is named cmpathservice.properties:

choiceList.{*|itemTypeName}@GroupName.AttrName = value1, value2, value3

The following code samples show specific examples of using the choiceList configuration parameter in the properties file that is named cmpathservice.properties:

choiceList.*@myAttGroup.myAttr = val1, val2, val3, val4, val5 

choiceList.PageDesign@layout.colors = red, orange, yellow, green, blue, 
purple, brown, black, white

choiceList.MyItemType@oddNumbers = 1, 3, 5, 7, 9

To specify a global choice list for the same attribute in any item type, use item type *, such as choiceList.*@myAttrGroup.myAttr = a,b,c,d. You can add as many choice lists as you want to display.

You can specify a mix of item type-specific choices and global choices. For the item types where you specify a customized list, the users see the customized list. For any other item types, the users see the global list. The item type names, attribute group names, and attribute names are used but not validated. If the user enters a value that does not match the attribute constraints, an error message is displayed.