All properties defined in an item descriptor can display in the Details pane when an item of that type is selected. For out-of-the-box items, a subset of those properties display. You can modify the properties that display for existing items, or specify the list of properties that you want to display for custom or customized items.
There are two ways to manage the display of properties.
Control the properties visible on a given tab using an item view mapping.
Prevent properties from appearing anywhere in the UI using an item mapping.
By default, all properties defined in the custom item descriptor will display.
Regardless of where you specify properties (item view mapping or item mapping), the process is the same: you update a map property by setting the type of action you want to perform as the key and creating a component that holds the actual property names as the value. For item view mappings, the map property is called attributeValues
; for item mappings the map property is called attributes
.
Use the following keys in an item view mapping attributeValues
property to indicate properties that you want to be visible in the Details pane:
specificProperties
maps to an object containing properties that should display.categorizedGrouping
maps to an object containing categories that have properties that should display. Categories are groupings of properties defined in an item descriptor.showNewProperties
maps to an object that holds atrue
value to indicate that any properties you added to the application should display by default. This setting is configured for all out-of-the-box item view mappings that represent the first tab for an item type. Add this setting to custom item view mappings when appropriate.
To prevent properties from displaying, set one of the following keys in the item view mapping attributeValues
property or the item mapping attributes
property of an item mapping:
excludedProperties
maps to an object containing properties that won’t display, even if they are explicitly permitted by another setting, such ascategorizedGrouping
orshowNewProperties
.excludedCategories
maps to an object containing categories with properties that won’t display, even if they are permitted by another setting, such asspecificProperties
.
You can specify as many keys as you want for an item view mapping and item mapping. If you indicate excluded properties only, all other properties on a given item descriptor will display. The reverse is true when you designate properties for inclusion. If one key includes a property that’s excluded by another, the exclusion setting prevails.
When you specify properties, use the name defined for the property in the item descriptor, not the display name you see in the Details pane. You can find a description of item types in the Personalization Programming Guide.
Making New Properties Visible on the First Tab: Item View Mapping Example
If you add new properties to the external users item descriptor and want to be sure that all new properties display on the first tab automatically, perform the following tasks:
In the ACC, open the Publishing > View Mapping task area.
In the Items of Type drop-down list, select
itemViewMapping
, and click List.From the list of item mappings, click the name of the item view mapping you created, such as AssetManager Editable Mapping for External User Items.
Click the text box beside the
attributeValues
property, then click the “…” button.In the Attributes dialog box, click Add. You need to provide a key and a value to the map. First, you’ll provide an object that represents the value.
In the New Item dialog box, click New Item. Always create an object when you are providing a value to a new key.
Beside the Value property, enter
true
. Click OK.In the New Dictionary Entry dialog box, enter
showNewProperties
as the key. Click OK.Once you see the new key and value pair in the Attributes dialog box, click OK to save your changes.
Hiding a Category’s Properties: Item Mapping Example
Assume that you created several new external user properties in a category you called MyCategory
and you don’t want any of those properties to display when the Details pane is editable. Because you want custom properties in other categories to display, and this tab permits new properties, you need to disallow the properties in MyCategory
. The steps as follows show how to adjust your view mapping settings:
In the ACC, open the Publishing > View Mapping task area.
In the Items of Type drop-down list, select
itemMapping
, and click List.From the list of item mappings, click AssetManager editable mapping for external user items. Notice that each item mapping is named for an item type and map mode.
Click the text box beside the attributes property, then click the “…” button.
In the Attributes dialog box, click Add. You need to provide a key and a value to the map. First, you’ll provide an object that represents the value.
In the New Item dialog box, click New Item. Always create an object when you are providing a value to a new key.
Beside the Value property, enter
MyCategory
. Click OK.In the New Dictionary Entry dialog box, enter
excludeCategories
as the key. Click OK.Once you see the new key and value pair in the Attributes dialog box, click OK to save your changes.