A pop-up which returns existing items

The following is an example of a pop-up page which accepts user input, displays a list of search results, one of which can be selected and its unique identifier returned to the parent page.

<PAGE PAGE_ID="Person_search" POPUP_PAGE="true">
  <PAGE_TITLE ICON="PersonSearchPageIcon">
    <CONNECT>
      <SOURCE NAME="TEXT"
              PROPERTY="PageTitle.StaticText1"/>
    </CONNECT>
  </PAGE_TITLE>
  <SERVER_INTERFACE NAME="ACTION"
    CLASS="Person"
    OPERATION="search"
    PHASE="ACTION"
  />
  <CLUSTER NUM_COLS="2" TITLE="Cluster.Title.SearchCriteria">

    <ACTION_SET ALIGNMENT="CENTER" TOP="false">
      <ACTION_CONTROL LABEL="ActionControl.Label.Search"
        TYPE="SUBMIT" DEFAULT="true">
        <LINK PAGE_ID="THIS"/>
      </ACTION_CONTROL>
      <ACTION_CONTROL LABEL="ActionControl.Label.Cancel"
        IMAGE="CancelButton" TYPE="DISMISS"/>
    </ACTION_SET>

    <FIELD LABEL="Field.Label.ReferenceNumber">
      <CONNECT>
        <TARGET NAME="ACTION"
          PROPERTY="personSearchKey$referenceNumber"/>
      </CONNECT>
    </FIELD>
  </CLUSTER>

  <LIST TITLE="List.Title.SearchResults">
    <CONTAINER LABEL="Container.Label.Action">
      <ACTION_CONTROL LABEL="ActionControl.Label.Select"
        TYPE="DISMISS" >
        <LINK>
          <CONNECT>
            <SOURCE NAME="ACTION" PROPERTY="dtls$personID" />
            <TARGET NAME="PAGE" PROPERTY="value" />
          </CONNECT>
          <CONNECT>
            <SOURCE NAME="ACTION"
              PROPERTY="dtls$personFullName" />
            <TARGET NAME="PAGE" PROPERTY="description" />
          </CONNECT>
        </LINK>
      </ACTION_CONTROL>
    </CONTAINER>
    <FIELD LABEL="Field.Title.ReferenceNumber">
      <CONNECT>
        <SOURCE NAME="ACTION" PROPERTY="dtls$referenceNumber"/>
      </CONNECT>
    </FIELD>
    <FIELD LABEL="Field.Title.FirstName">
      <CONNECT>
        <SOURCE NAME="ACTION" PROPERTY="dtls$personName"/>
      </CONNECT>
    </FIELD>
  </LIST>
</PAGE>

The points to note about this example are:

• The PAGE_ID attributes of the UIM PAGE element and the POPUP_PAGE element in curam-config.xml must match.
• The POPUP_PAGE attribute of the UIM PAGE element must be set to true.
• The submit action is linked to THIS. This means the page will be redisplayed after the submit button is pressed.
• To cancel the pop-up an action control of type DISMISS is used. If the action control does not have a child LINK element, the pop-up will be closed without returning any values to the parent page which opened it.
• The search results list in this example is made up of three columns. The first contains a link which will close the pop-up and return the selected values, the remaining columns display further information about the person.
• To close the pop-up and return values, an action control of type DISMISS is used. This is placed in a CONTAINER so it is the first column in the search results list. The user can click this link to select one of the search results.
• To specify what values should be returned a child LINK element is added to the action control. When used in an action control to close a pop-up all standard attributes of the LINK element (e.g. PAGE_ID) have no meaning and will be ignored.
• For Cúram pop-up pages two values must always be returned. These are specified using CONNECT elements. Both connections must use a target of PAGE and have the PROPERTY set to value and description. The value connection specifies the value required on the page that opened the pop-up, in this example the persons unique record ID. The description connection specifies descriptive text to be shown to the user, in this example the person's name. So, on the page which opened the pop-up, the person's name will be displayed to the user, but it is their unique ID which will be submitted to the server.

It is not necessary for pop-up pages to accept input. For example, the LIST can be populated from a display phase server interface if necessary.