Previous Topic: Configure Standard Profile ScreenNext Topic: Configure Standard Search Screen


Configure Standard List Screen

Configure a list screen to format the output on the current tab. For example, if the tab includes a list of users or roles, you configure the columns and sorting for the users or roles.

Name

Defines the user-visible name of the tab.

Tag

An identifier that is unique within the task. It can contain ASCII characters (a-z, A-Z), numbers (0-9), or underscore characters, beginning with a letter or underscore. The tag is used for setting data values through XML documents or HTTP parameters.

Select the fields that appear in the search results

Select the fields that CA Identity Manager displays in the search results. You can select fields that are not available in the search query.

To add additional fields, select the fields in the list box below the search fields table.

Style

When you select a field to display in the search results, you can select one of the following style options:

Note: The options that you see in the Style field depend on the type of field that you are adding to the list screen. Some Relationship tabs may display a list of relationship objects that have attributes which you can edit. For example, a list screen may display SAP roles that can be assigned to a user. The administrator who uses the list screen to assign the role can specify a start and end date for each role. Additional style options, which allow modification, such as Date, Radio Button, Drop-down, Drop-down Combo, and Object Selector, are available for these fields.

  • Boolean Display Name

    Displays the name of the field for all results that are true. For example, if you enter Enabled as the name of the attribute that indicates a user’s account status, "Enabled" would appear in the search results for all active user accounts.

  • Checkmark

    Displays the value as a selected check mark, based on the value of the attribute. For example, if you select the check mark style to represent the Enabled/Disabled state of user accounts, CA Identity Manager displays a selected check mark for all active accounts.

  • Multi-Value String

    Displays the values in a multi-value attribute on separate lines. The values are listed alphabetically.

  • Read-Only Checkbox

    Displays the value as a read only checkbox.

  • String

    Displays the value as a text string.

  • Task

    Adds a task list to a field. Users click an arrow icon to see a list of tasks that they can perform on the object associated with the search field. For example, if you add a task list to a Last Name field in the search results, users can click on the arrow icon in that field to see a list of tasks they can perform on the user they select.

    This setting can also be used to make an attribute value appear as a link to a task.

    If you select the Task style, a right arrow icon appears next to the Style column. Click the arrow to open a Field Properties dialog. Use this dialog to configure a task list.

  • HTML

    Displays the value as HTML. Select this field to display attributes in the user store that include HTML formatting, such as <p>some attribute </p>.

  • Radio Button

    Displays a standard option control that users can select to click a single option.

  • Dropdown

    Displays a list of options that a user can select. The options that appear are configurable.

  • Dropdown Combo

    Displays a list of options that a user can select. A user can also enter an option that does not appear in the list.

    The options that appear are configurable.

  • Date

    Allows users to enter a date. CA Identity Manager validates the date against a configurable date pattern.

  • Object Selector

    Allows selection of a managed object through a nested search screen.

    When you select this style option, you configure with an object type and search screen.

  • Task List

    Adds additional tasks that users can perform on objects in search and list screens. For example, a search screen in the Modify User task can provide a link for administrators to reset a user password for a user in the search results list without leaving the current task.

    When you select this option, you determine whether users access the task by clicking an icon, or a text link.

  • Task Menu

    Adds additional tasks (similar to the Task List style) as pop-up menu items.

    When you select this option, an Action button appears next to each object in a search or list screen. Users click the Action button to see the list of tasks they can perform for that object.

Note: To see the Task List and Task Menu style options, select (Separator) when you add a field to the search results table. For more information about adding additional tasks to search and list screens, see the User Console Design Guide.

Sortable

Select this checkbox to allow administrators to sort search results by a field or fields.

Set the default sort order for the search results

Specifies the order in which search results are displayed. Search results are sorted initially by the first field in the list and then by each additional field in the order in which they appear. Select the Descending checkbox to sort the results in descending order.

Return N results per page

Select the number of results to display per page. When search results exceed the number you specify, CA Identity Manager displays a link to each page of results.

Enter HTML to appear before the list

Specifies custom text that you enter using standard HTML tags. The text that you enter appears above the list of fields in the list screen.

Enter HTML to appear after the list

Specifies custom text that you enter using standard HTML tags. The text that you enter appears below the list of fields in the list screen.