Novell Doc: Identity Manager 3.5.1 User Application: Administration Guide

11.3 Setting Preferences

Preferences allow you to configure the types of objects and the attributes that users are prompted for. There are two types of preferences: general and complex. The general preferences are described in Table 11-3 followed by the complex preferences in Table 11-4.

Table 11-3 Create Portlet: General Preferences

Preference	Description
Detail Portlet Name	Specify the instance of the Detail Portlet to display when the user clicks the Object Created link after the object is successfully created. It defaults to the standard DetailPortlet. See Section 12.6, Setting up Detail for Anonymous Access.
Custom Class Name	Specify the name of the class for processing create events. The default is com.novell.srvprv.impl.portlet.create.CreateCustomEventDefaultHandler.
Expire password on initial login	Specify whether to expire the newly created user’s password on initial login (True), or whether to default to the Identity Vault’s password policy GraceLogin setting.
Display password with attributes	Specify whether to display the password on the same page as the other attributes (True) or on its own page (false).
Create Virtual Entity complex preference	Click View/Edit Custom Preference to access the Entity and Attribute definitions for the create portlet. The preferences are described in Table 11-4.

Table 11-4 Create Portlet: Complex Preferences

Preference	Description
Entity Definition	The name of the object type to create. This represents the beginning of an entity definition block where you define how the portlet handles the create operation. Objects listed in the complex preferences are displayed to the user in a drop-down list. To restrict the objects that users can create, remove objects from this preference sheet with the delete button. To add other entities, click Add Entity Definition and complete the wizard.
Attributes	Controls the attributes that the user is prompted to populate. You must include all of the object’s required attributes; otherwise, the actual create of the object will fail. In addition, the preferences do not save properly if a required attribute is missing. To add or remove an attribute: Click the Modify Attributes button. To add an attribute, select it (from the list of Available attributes). You can multi-select attributes by using the Ctrl or Shift keys. Click the arrow to move the attribute to the Selected list. Do the reverse to remove an attribute. To reorder the attributes list, click the up and down arrows to the right of the Selected list. Click Submit. Attributes and data types: The attribute’s data type affects the way it is displayed. For example, if an attribute is defined as a Local or Global list subtype, then it displays in a list box. NOTE:The create portlet automatically prompts for an object ID. (The label displays as the entity type and appends the string ID, for example, user ID or Group ID.) The object ID is the naming attribute for the object. for the object. You do not have to add the CN as an attribute. For more information, see the Novel Identity Manager 3.5 User Application: Design Guide.

Preference

Description

Entity Definition

The name of the object type to create. This represents the beginning of an entity definition block where you define how the portlet handles the create operation.

Objects listed in the complex preferences are displayed to the user in a drop-down list. To restrict the objects that users can create, remove objects from this preference sheet with the delete button. To add other entities, click Add Entity Definition and complete the wizard.

Attributes

Controls the attributes that the user is prompted to populate. You must include all of the object’s required attributes; otherwise, the actual create of the object will fail. In addition, the preferences do not save properly if a required attribute is missing.

To add or remove an attribute:

Click the Modify Attributes button.
To add an attribute, select it (from the list of Available attributes). You can multi-select attributes by using the Ctrl or Shift keys.
Click the arrow to move the attribute to the Selected list. Do the reverse to remove an attribute.
To reorder the attributes list, click the up and down arrows to the right of the Selected list. Click Submit.

Attributes and data types:

The attribute’s data type affects the way it is displayed. For example, if an attribute is defined as a Local or Global list subtype, then it displays in a list box.

NOTE:The create portlet automatically prompts for an object ID. (The label displays as the entity type and appends the string ID, for example, user ID or Group ID.) The object ID is the naming attribute for the object. for the object. You do not have to add the CN as an attribute.

For more information, see the Novel Identity Manager 3.5 User Application: Design Guide.

Completing the Preferences Panel

To verify that you submitted valid entries, click Submit. If an entry is invalid, an error message is displayed at the top of the preferences page. Click Return to List View when you are able to click Submit and no errors occur. You must click Save Preferences when you return to List View.