A property group contains a set of properties defined for a given item type that business users can edit at the same time in the Multi Edit tab. There are no property groups provided by default, so if you want to edit items in bulk, you need to define one or more property groups yourself.
Before you create property groups, consider how they will be used. Typically the property groups you create should be appropriate for a single task performed by the same user.
Properties can be part of as many property groups as you like. When you build your property groups, keep in mind that you can make some properties read only as a point of reference, even if they are editable in other tabs. See as follows for instructions.
If a property group is designed for a given workflow task, you can configure it to display only to the users performing tasks that require it. By default, all property groups are available to all users. When users can see a property group, it is visible to Step Edit, List Edit and Apply to All modes.
Consider a property group that lets users update the auto-applied roles and organizational roles in Step Edit mode. The steps as follows show how to create such a property group:
Create one item mapping for organizations that supports the multi edit map mode. Provide values to the following properties as follows:
In the Name text box, provide a name that identifies your custom property group. The name is used by the task configuration file to determine the circumstances in which the property group is visible to users. If all property groups should be visible at the same time, provide the same name to all property groups. The item mapping is identified in the list to the left by an automatically generated ID, not by the name you are providing for it now.
In the Map mode text box, specify
AssetManager.multiEdit
.In the Item name text box, enter the item type or subtype. In this case, enter
organization
.In the Item path text box, enter the path and name to the repository that holds the item type or subtype you entered in the Item name property. In this case, enter
/atg/userprofiling/ProfileAdapterRepository:organization
.In the Form handler text box, enter the default form handler,
AssetManager AssetRepositoryFormHandler
.
Note: In general you need one item mapping per item type that supports the multi edit map mode. If your item type has subtypes, you can also create an item mapping for each subtype, so your property groups can be tailored to your subtypes.
Click OK.
Create an item view mapping for each property group.
In the Name text box, provide a name that identifies your property group. The item mapping is identified in the list to the left by an automatically generated ID not the name you are providing for it now.
In the View text box, provide the name of the item view used in the item view mapping for this item type with
AssetManager.edit
mode.
Click OK.
Identify the properties that should display in the property group as described in the Specifying Properties to Display section. In this case, you use the
specificProperties
key and define an object to holdroles
andrelativeRoles
properties.Add the name of the new item view mapping to the
viewMappings
property in the new item mapping.Click Save.
To make editable properties read only when viewed in a property group, follow these steps:
Create the property group as shown above.
In the Property mappings text box, enter the property view mapping used for items of that type in
AssetManager.view
mode. The best way to find the property view mapping is to locate the item view mapping used for items of that type in view mode and check thepropertyMappings
property.Click OK.