Define the Search Page

Define the Search Page shows a screen shot of the page to search a person (named as Person Search) below. The Person Search page has two distinct areas, a cluster that allows the user to enter search criteria and a list to display the results of a search.

Figure 1. Person Search Page

Cluster
Action Control
List

The following is the UIM code for the page:

Figure 2. SimpleSearch.uim

<PAGE PAGE_ID="SimpleSearch">

  <SERVER_INTERFACE NAME="ACTION" CLASS="PersonFacade"
    OPERATION="advancedSearch" PHASE="ACTION"/>

  <PAGE_TITLE>
    <CONNECT>
      <SOURCE NAME="TEXT"
        PROPERTY="PageTitle.StaticText"/>
    </CONNECT>
  </PAGE_TITLE>

  <CLUSTER TITLE="Cluster.Title.Search" NUM_COLS="2">
    <FIELD LABEL="Field.Label.LastName">
      <CONNECT>
        <TARGET NAME="ACTION" PROPERTY="key$dtls$lastName"/>
      </CONNECT>
    </FIELD>
    <FIELD LABEL="Field.Label.Gender">
      <CONNECT>
        <TARGET NAME="ACTION" PROPERTY="key$dtls$gender"/>
      </CONNECT>
    </FIELD>
    <ACTION_SET TOP="false">
      <ACTION_CONTROL LABEL="Control.Label.Search"
        TYPE="SUBMIT">
        <LINK PAGE_ID="THIS"/>
      </ACTION_CONTROL>
    </ACTION_SET>
  </CLUSTER>

  <LIST TITLE="List.Title.Results">
    <CONTAINER LABEL="Container.Label.Actions">
       <ACTION_CONTROL LABEL="Control.Label.View">
        <LINK PAGE_ID="SimplePerson">
          <CONNECT>
            <SOURCE NAME="ACTION" PROPERTY="personID"/>
            <TARGET NAME="PAGE" PROPERTY="personID"/>
          </CONNECT>
        </LINK>
      </ACTION_CONTROL>
    </CONTAINER>
    <FIELD LABEL="Field.Label.FirstName">
      <CONNECT>
        <SOURCE NAME="ACTION" PROPERTY="firstName"/>
      </CONNECT>
    </FIELD>
    <FIELD LABEL="Field.Label.LastName">
      <CONNECT>
        <SOURCE NAME="ACTION"
          PROPERTY="result$dtls$dtls$lastName"/>
      </CONNECT>
    </FIELD>
    <FIELD LABEL="Field.Label.Title">
      <CONNECT>
        <SOURCE NAME="ACTION" PROPERTY="title"/>
      </CONNECT>
    </FIELD>
   </LIST>
</PAGE>

The following are the main elements of note on this UIM page:

The SERVER_INTERFACE element defines which server interface method is called by the server when the form is submitted.
The CLUSTER defines the cluster on the page that contains two fields that allow the user to enter the search criteria. These are mapped to the input parameters of the server interface method. Refer to User Interface Element 1 in Define the Search Page.
An ACTION_CONTROL element defines the action control on the page that allows the search to be submitted. Refer to User Interface Element 2 in Define the Search Page.
The LIST defines the list on the page that contains the results of a submitted search. For each result a row is displayed which displays the person's details, and an ACTION_CONTROL which defines a link to that person's home page. Refer to User Interface Element 3 in Define the Search Page. Selecting this link will open the person tab which will be defined next.

The corresponding .properties should contain the localizable content for the search page:

PageTitle.StaticText=Person Search

Field.Label.FirstName=First Name
Field.Label.LastName=Last Name
Field.Label.Title=Title
Field.Label.Gender=Gender
Control.Label.View=View

Container.Label.Actions=Actions

Cluster.Title.Search=Search Criteria
List.Title.Results=Results
Control.Label.Search=Search