Customize search results information

Edit the searchResults.ftl file to customize the display of profile fields in views that render lists of users.

Use the searchResults.ftl template to customize the display of fields in either the Report-to Chain or Directory views.

1. Check out the Profiles configuration files:
   app_server_root/profiles/Dmgr01/bin
   ./wsadmin.sh -lang jython
   execfile("profilesAdmin.py")
   ProfilesConfigService.checkOutConfig("/tmp", "cell_name")

   To determine cell name:

   print AdminControl.getCell()

2. Open the LotusConnections-config/profiles/templates/searchResults.ftl file.

3. Modify the file contents to include any custom HTML or fields.

   The views that use this template are listed in the Section column in the following table.

   Section	Description
   reportTo	Applies to the Full Report-to Chain view and Same Manager view available in the Report-to Chain section of the profile page.
   directory	Applies to the profile directory search results available from the Directory view.

   By default, both views render the same results. To customize one of the view but not the other, use the supplied renderSection macro. For example, to customize only the directory results, the following macro should surround the code section being customized:

   <@util.renderSection sectionLabel=”directory”>
     … mark-up specific to the directory view ...
   </@util.renderSection>

   For more information about using these settings, see Example – Creating a simple profile data model and template customization.

4. Save the changes.

5. After making changes, check the configuration files back in, and we must do so during the same wsadmin session in which you checked them out for the changes to take effect. See Applying property changes in Profiles for information about how to save and apply the changes.

6. If we have enabled template reloading, the changes are reflected immediately in the user interface. If not, restart the application to recompile the template and display the customization changes.

   If the desired customization requires profile record data for resolved codes, extension fields, secretary information, or manager information, also update profiles-config.xml. Use the following procedure to specify the additional required data needed for input to the FreeMarker template processor:

   1. Open profiles-config.xml using a text editor.

   2. Locate the <template/> element whose attribute name is equal to searchResults.

   3. Modify the <templateDataModel/> section, using the following example, to include the <templateData/> element for the required data.

   4. Save the changes.

   5. Check in the updated profiles-config.xml file.

   6. Restart the server.

   Example:

   <template name="searchResults">
    <templateDataModel>
     <!--  include if you render workLocation, organization, department information -->
     <templateData>codes</templateData>
     <!--  include if and only if you render profile extension fields in the template -->
     <templateData>extensions</templateData>
     <!--  include if you render secretary name or email in the template -->
     <templateData>secretary</templateData>
     <!--  include if you render manager name or email in the template -->
     <templateData>manager</templateData>
    </templateDataModel>
   </template>

Parent topic:
Customize display using templates

Related:

Add custom extension attributes for Profiles