Directory Search builder inputs

General inputs

Table 1. General inputs

Input name	Description
Name	Required. Enter a name for this builder call. The WebSphere Portlet Factory Designer displays this name in the builder call list.
Page Location	Required. Page or pages on which this builder call acts.
Image for Search	Required. The image file used for the Search button. The default is /factory/images/peoplepicker/Search.gif.
Alternate text for Search	Optional. Provide text that appears when the application user moves the mouse pointer over the Search image.
Image for Remove	Required. The image file used for the Remove button. The default is /factory/images/peoplepicker/Delete.gif.
Alternate text for Remove	Optional. Provide text that appears when the user moves the mouse pointer over the Remove image.
Require Email	Optional. When checked, indicates that only application users who have email can be selected. The default setting is checked.
Allow Multiple Selection	Optional. When checked, allows application users to select more than one name in the Search window. The default setting is unchecked.
Control Type	Optional. Specify what kind of control is used for multiple values: Text field List This input is available when the Allow Multiple Selection input is checked. The default control is List.
Initial Value	Optional. Provides default text for the input box. This option is available when either: Allow Multiple Selection is not checked. Allow Multiple Selection is checked, and Control Type is Text field. Enter a text value in the field; or use the reference chooser to display the results of a service call or method, or the contents of a variable. For example: Enter user name or ${Variables/People}.

XML Data Source Elements

For select data defined in the XML hierarchy, use the inputs in this group to specify those elements that correspond to return values and those that are display text.

Table 2. XML Data Source Elements inputs

Input name	Description
Value Element	If you specify an XML structure, enter the name of the element whose text value is to be passed as the value for the selected option in the list. This input is available if the Control Type input is set to List.
Label Element	If you specify an XML structure, enter the name of the element whose text value is to be listed as an option in the select list.
Delimiter	Optional. Specify the delimiter for multiple name selections. This option is available when Allow Multiple Selection is checked and Control Type is Text field. The default is a comma (,).
Remove duplicates	If this input is enabled, like elements are deleted from the list so that each unique name appears only once. This input is available if the Control Type input is set to List.
List Size	Required. The display size for the List control. The default is 10. This input is available if the Control Type input is set to List.
Lookup Table Used	Optional. Use to translate a text input through a Lookup table. For example, you might identify a value in a lookup table and display the label associated with that value as text. The value to be translated is identified in the Initial Value value. Select the Lookup Table in the model that is to be used for translation. The default selection is None. This input requires that you already have one or more Lookup Table builders in this model. This input is available if the Control Type input is set to List.
Initial Members	Optional. Specify an XML structure or a comma-separated list of values, for example, ${Variables/PeopleXml}. This input is available when Allow Multiple Selection is checked and the Lookup Table Used input is None.

Search Options

Use the inputs in this group to customize the search.

Table 3. Search Options inputs

Input name	Description
Search Scope	Required. Select whether users can search for Users, Groups, or All (both users and groups). The default setting is All.
Returned Value Type	Required. Select the type of value that users see. Name - User Name DN - WP Distinguished Name WMMID - WebSphere Member Manager ID The default is Name - User Name.
Directories	Required. Click the ellipses (...) to select which directories appear in the Search window. If more than one directory is specified, a drop-down list box appears. The default is WMM. Multiple directories are delimited by commas (,). The directories that you select must already be configured to work with WebSphere Portal server. The following are the directory choices: WMM (WebSphere Member Manager) Searches the organization directory that comes with WebSphere Portal server. PAB Searches the personal address book used by Workplace™ Collaboration Services clients. IM Searches the Instant Messaging Contacts List used by Workplace Collaboration Services. CMTY Searches the list of the current community, such as a team space, Web conference, or application. This list is used by Workplace Collaboration Services LDAP Searches an LDAP directory configured for Messaging. DPAB Searches the dynamic personal address book used by Workplace Collaboration Services clients when working offline.

Advanced

Table 4. Advanced input

Input name	Description
HTML Page	Specify the URL of a custom base page to use as the base HTML of the directory search control. To function properly, the custom page must retain the existing span tags and taglib prefix.