Home

 

Configure advanced search

Configure advanced search to display the fields that you want to allow users to use.

To edit configuration files, use the IBM WebSphere Application Server wsadmin client. See Start wsadmin for information about how to start the wsadmin command-line tool.


An advanced search allows the user to search using multiple fields. As administrator, you can customize the Advanced Search form to include custom fields. You can also specify which predefined fields are available on the search form. For example, to protect the privacy of your users, you might want to prevent an e-mail address field from displaying on the form.

To configure advanced search...

  1. Use wsadmin to access and check out the Profiles configuration files.

    1. Access the Profiles configuration files:

    2. Check out the Profiles configuration files...

      ProfilesConfigService.checkOutConfig("<working_directory>", "cell_name")

      where:

      • <working_directory> is the temporary working directory to which the configuration XML and XSD files are copied and are stored while you make changes to them. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.

      • cell_name is the name of the WebSphere Application Server cell hosting the Profiles feature. This argument is required even in stand-alone deployments. This argument is case-sensitive, so type it with care. If you do not know the cell name, do one of the following to determine it:

        • Stand-alone deployment: See:

          WAS_HOME\profiles\profile_name\config\cells\

        • Network deployment: From wsadmin...

          print AdminControl.getCell()

      For example:

      • AIX/Linux:

          ProfilesConfigService.checkOutConfig("/opt/prof/temp","foo01Cell01")
          

    3. Microsoft Windows:

        ProfilesConfigService.checkOutConfig("c:/prof/temp","foo01Cell01")
        

  2. Open the profiles-config.xml file in a text editor.

  3. Locate the <searchLayout> section and edit it to specify which fields should display on the Advanced Search form.

    • To enable a predefined attribute for search, include the following line for each attribute that you want to include:

        <attribute showLabel="true"><attribute_name></attribute>
        

    For a complete list of the predefined attributes that can be included in the Advanced Search form, see Advanced search attributes.

  4. To enable a custom extension attribute for search, include the following line for each custom attribute that you want to include:

      <extensionAttribute showLabel="true" extensionIdRef="<attribute_id>"/>
      

    For more information about adding custom extension attributes to Profiles, see Adding custom extension attributes for Profiles.

    For example:

      <searchLayout>
         <attribute showLabel="true">displayName</attribute>
         <attribute showLabel="false">preferredFirstName</attribute>
         <attribute showLabel="false">preferredLastName</attribute>
         <attribute showLabel="true">profileTags</attribute>
         <attribute showLabel="true">jobResp</attribute>
         <attribute showLabel="false">departmentTitle</attribute>
         <attribute showLabel="false">experience</attribute>
         <attribute showLabel="false">background</attribute>
         <attribute showLabel="true">organizationTitle</attribute>
         <attribute showLabel="false">workLocation.city</attribute>   
         <attribute showLabel="false">workLocation.state</attribute>
         <attribute showLabel="false">countryDisplayValue</attribute>
         <attribute showLabel="false">email</attribute>
         <attribute showLabel="false">telephoneNumber</attribute>
         <extensionAttribute showLabel="true" extensionIdRef="schoolName" />
      </searchLayout>
      

    Apply property changes


Customizing Profiles search

Add custom extension attributes for Profiles

 

Related tasks

Hiding e-mail addresses

Exposing e-mail addresses

Apply property changes


+

Search Tips   |   Advanced Search