Define a List Actions Menu

List Actions Menus allow a set of actions associated with a particular row to be encapsulated into a menu.

Figure 1. Person Search Page With List Actions Menu

Expanded List Actions Menu
List Actions Menu Icon
View Action Control

Define a List Actions Menu shows the Person Search page which has been modified to include a list action menu. The following are some points to note:

At the end of each row, an list actions menu icon is displayed. Clicking on this will expand the List Actions Menu.
In this example, as a view action control was added to the List Actions Menu, the Actions column (refer to the first column in User Interface Element 4 of Define the Search Page) was removed.

The following is the modified code for the Person Search page:

Figure 2. SimpleSearch.uim

        <PAGE PAGE_ID="SimpleSearch">

   ...

  <LIST TITLE="List.Title.Results">

     ...
         <ACTION_SET TYPE="LIST_ROW_MENU">
      <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>

      <ACTION_CONTROL LABEL="Control.Label.CreateEmployment">
        <LINK PAGE_ID="CreateEmployments" OPEN_MODAL="true">
          <CONNECT>
            <SOURCE NAME="ACTION" PROPERTY="personID"/>
            <TARGET NAME="PAGE" PROPERTY="personID"/>
          </CONNECT>
        </LINK>
      </ACTION_CONTROL>
      <ACTION_CONTROL
         LABEL="Control.Label.CreateEmploymentWizard">
         <LINK PAGE_ID="CreateEmploymentWizard_pageOne"
           OPEN_MODAL="true">
           <CONNECT>
             <SOURCE NAME="ACTION" PROPERTY="personID"/>
             <TARGET NAME="PAGE" PROPERTY="personID"/>
           </CONNECT>
        </LINK>
      </ACTION_CONTROL>
    </ACTION_SET>

    <!-- Removing Actions Column -->
    <!--<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>--> 
        ...

   </LIST>
</PAGE>

An ACTION_SET containing the three action controls has been added to the list. The attribute TYPE has been set to LIST_ROW_MENU, indicating that the action controls in this set are to be displayed on a List Actions Menu.

As the View action control has been added to the List Actions Menu, the column containing it is no longer necessary, and thus the UIM code for this has been commented out.

Localizable labels for the new action controls are placed in the corresponding .properties file content. For example:

Control.Label.CreateEmployment=Create Employment
Control.Label.CreateEmploymentWizard=Create Employment Wizard