向导页面的定义

该序列将包含两个页面;第一个页面要求用户输入雇主详细信息,第二个页面要求用户输入日期。

图 1. CreateEmploymentWizard_pageOne.uim
<PAGE PAGE_ID="CreateEmploymentWizard_pageOne">

  <MENU MODE="WIZARD_PROGRESS_BAR">
      <CONNECT>
        <SOURCE NAME="CONSTANT" PROPERTY="Wizard" />
      </CONNECT>
  </MENU>

  <SERVER_INTERFACE NAME="ACTION" CLASS="EmploymentFacade"
    OPERATION="validateEmployerAndJobTitle" PHASE="ACTION"/>

  <PAGE_TITLE>
    <CONNECT>
      <SOURCE NAME="TEXT" PROPERTY="Page.Title"/>
    </CONNECT>
  </PAGE_TITLE>

  <CONNECT>
    <SOURCE NAME="PAGE" PROPERTY="personID"/>
    <TARGET NAME="ACTION" PROPERTY="personID"/>
  </CONNECT>

  <PAGE_PARAMETER NAME="personID"/>

  <CLUSTER TITLE="Cluster.Title.Details">
    <FIELD LABEL="Field.Label.EmployerName">
      <CONNECT>
        <TARGET NAME="ACTION" PROPERTY="employerName"/>
      </CONNECT>
    </FIELD>
    <FIELD LABEL="Field.Label.JobTitle">
      <CONNECT>
        <TARGET NAME="ACTION" PROPERTY="jobTitle"/>
      </CONNECT>
    </FIELD>

  </CLUSTER>

  <ACTION_SET TOP="false">
    <ACTION_CONTROL LABEL="Control.Label.Next" TYPE="SUBMIT">
      <LINK PAGE_ID="CreateEmploymentWizard_pageTwo"
        DISMISS_MODAL="false">
        <CONNECT>
           <SOURCE NAME="ACTION" PROPERTY="personID"/>
           <TARGET NAME="PAGE" PROPERTY="personID"/>
        </CONNECT>
        <CONNECT>
           <SOURCE NAME="ACTION" PROPERTY="employerName"/>
           <TARGET NAME="PAGE" PROPERTY="employerName"/>
        </CONNECT>
        <CONNECT>
          <SOURCE NAME="ACTION" PROPERTY="jobTitle"/>
          <TARGET NAME="PAGE" PROPERTY="jobTitle"/>
        </CONNECT>
      </LINK>
      </ACTION_CONTROL>
  </ACTION_SET>
</PAGE>

向导进度条工件是通过包含 MENU 元素(具有属性 MODE="WIZARD_PROGRESS_BAR")来添加至页面的。该元素引用称为向导的常量。此属性的值在 Constants.properties 中定义为 CreateEmploymentWizard。对于此示例,这是每个页面与已装入到数据库中的向导进度条配置关联的方式。

向导的第一个页面的对应 .properties 包括该页面的可本地化内容:

Page.Title=Create Employment
Cluster.Title.Details=Details

Control.Label.Next=Next

Field.Label.EmployerName=Employer Name
Field.Label.JobTitle=Job Title

以下是用于显示向导进度条的第二个页面:

图 2. CreateEmploymentWizard_pageTwo.uim
<PAGE PAGE_ID="CreateEmploymentWizard_pageTwo">

  <MENU MODE="WIZARD_PROGRESS_BAR">
        <CONNECT>
          <SOURCE NAME="CONSTANT" PROPERTY="Wizard" />
        </CONNECT>
  </MENU>

  <PAGE_TITLE>
    <CONNECT>
      <SOURCE NAME="TEXT" PROPERTY="Page.Title"/>
    </CONNECT>
  </PAGE_TITLE>

  <PAGE_PARAMETER NAME="personID"/>

  <CONNECT>
    <SOURCE NAME="PAGE" PROPERTY="personID"/>
    <TARGET NAME="ACTION" PROPERTY="personID"/>
  </CONNECT>

  <PAGE_PARAMETER NAME="employerName"/>

  <CONNECT>
    <SOURCE NAME="PAGE" PROPERTY="employerName"/>
    <TARGET NAME="ACTION" PROPERTY="employerName"/>
  </CONNECT>


  <PAGE_PARAMETER NAME="jobTitle"/>

  <CONNECT>
      <SOURCE NAME="PAGE" PROPERTY="jobTitle"/>
      <TARGET NAME="ACTION" PROPERTY="jobTitle"/>
  </CONNECT>

  <SERVER_INTERFACE NAME="ACTION" CLASS="EmploymentFacade"
    OPERATION="createEmployment" PHASE="ACTION"/>

  <CLUSTER TITLE="Cluster.Title.Details" NUM_COLS="2">

    <FIELD LABEL="Field.Label.FromDate">
      <CONNECT>
        <TARGET NAME="ACTION" PROPERTY="fromDate"/>
      </CONNECT>
    </FIELD>
    <FIELD LABEL="Field.Label.ToDate">
      <CONNECT>
        <TARGET NAME="ACTION" PROPERTY="toDate"/>
      </CONNECT>
    </FIELD>
  </CLUSTER>

  <ACTION_SET TOP="false">
    <ACTION_CONTROL LABEL="Control.Label.Save" TYPE="SUBMIT">
      <LINK PAGE_ID="Employments" DISMISS_MODAL="TRUE">
        <CONNECT>
    <SOURCE NAME="ACTION" PROPERTY="personID" />
    <TARGET NAME="PAGE" PROPERTY="personID"/>
        </CONNECT>
      </LINK>
    </ACTION_CONTROL>
  </ACTION_SET>

</PAGE>

对应 .properties 包括该页面的可本地化内容:

Page.Title=Create Employment
Cluster.Title.Details=Details
Control.Label.Save=Save

Field.Label.FromDate=From
Field.Label.ToDate=To