Object Selector Options

Contents
cim1265
The Object Selector style allows administrators to add search functionality to a field on a profile screen. Users can use this functionality to search for and select an object to associate with the attribute described in the profile. For example, an administrator may add an object selector to the Manager field to allow users to search for a new user's manager in a Create User task. When the user selects a manager and submits the Create User task,
Identity Manager
stores information about that manager in the new user's profile.
In most cases, the object selector search allows users to select and store a single value. However, administrators can also configure the object selector to allow users to search for and select multiple values. In this case, the selected values are stored in a multi-valued attribute on the object.

Configure an Object Selector

The object selector style adds a Browse button to a field. Users can click the button to search for and select an object to populate the field.
The object selector can be applied to fields for single value or multivalue attributes.
To Configure an Object Selector
  1. Add an additional field to the profile screen by using the controls below the list of fields.
  2. Click the right arrow icon to open the Field Properties dialog for the attribute that you are adding.
  3. Specify values for the following fields:
    • Attribute Name
      Select the attribute that is associated with the field.
      For example, if you are configuring the field that specifies a user manager, select the attribute in the user store that stores that information.
      If you are configuring a field for an attribute that stores multiple values, be sure that the attribute is defined as multivalued in the directory configuration file (directory.xml). See the
      Configuration Guide
      for more information.
    • Style
      Select the Object Selector style.
    • Object Type
      Specify the type of object that the user will search for. For example, if you are configuring an object selector for the Manager field, select the Users object type.
    • Restrict to Single Value
      Allows administrators to select only a single value when they search for an object.
      This option is available only when you specify a multi-valued attribute in the Attribute Name field.
    • Display attribute
      Select the attribute of the selected object that is displayed when the value is selected.
      In the Manager example, select Full Name or User ID so that users can easily identify the manager.
      The unique identifier of the object is stored in the attribute.
    • Search Screen
      Select the search screen that administrators use to search for the object.
    • Size
      Specifies the number of items to show in the list box.
    This field is available only when you specify a multi-valued attribute in the Attribute Name field.
  4. Click Apply, then click OK to return to the Select Screen page.
    Identity Manager
    adds the object selector to the field that you edited.
  5. Select the tab that you edited and click OK.
    Identity Manager
    saves the changes to the screen.