Creating a Train

To create a train:

In the Design Structure Window of the desired file, expand the pageLayout node to locate the location node.
If the pageLayout node is not visible, expand page | content | dataScope | document | body | form. The location node is under pageLayout Named Children in pageLayout.
In the Component Palette, select Navigation Components from the dropdown list, and then drag and drop the train component from the list to the location node.
The train node is inserted and highlighted under the location node.
Right-click the train node and choose Insert inside train | link.
The link node is inserted and highlighted under the expanded train node.
In the Property Inspector, set the following attributes for the link component you inserted:
- text - Enter the text for the train link.
- disabled - Set to true if you want to disable the link.
Repeat steps 3 and 4 to add the desired number of links.
In the Design Structure Window, select the train node.
The Property Inspector displays the properties of the train component.
In the Property Inspector, set the following attributes for the train component:
- value - Enter the current page for the multi-page process. This is also known as the "active" page. The values start from 1.
- id - Enter a name for the train component.
- destination - Enter the base URL for the train links. This is ignored if formSubmitted is set to true or if the formName attribute is set.
- formSubmitted - If using Javascript form submission, set this to true. If no formName is specified, the parent form is used.
- formName - Enter the name of the form to which events are submitted. Setting this attribute without setting formSubmitted also enables Javascript form submission.
- maxVisited - Enter the index of the highest visited step. You should set the maxVisited attribute only if a user has already visited a step but then moved backwards to an earlier step.
- subTrain - Select true to render this train as a subtrain, i.e., this train is part of a subprocess.
- unvalidated - By default, validation is used if form submission is enabled. Set this attribute to true if you don't want the form values to be validated when the form is submitted.

Notes:

You must set a "goto" event handler for the train links to function properly because the train sends a "goto" event when a user clicks a link on the train.
To use data binding, see Data Binding a Component Attribute.

Example (UIX XML)


...
<pageLayout>
  <contents/>
  <location>
    <train value="4" formSubmitted="true" destination="http://www.oracle.com/products/shop/mainshop.html" id="TrainControl">
      <contents>
        <link text="Shop"/>
        <link text="Place Order"/>
        <link text="Enter Shipping Address"/>
        <link text="Pay Online"/>
        <link text="Sumbit Order"/>
      </contents>
    </train>
  </location> 
  
  <!-- REST OF PAGE LAYOUT-->
  
</pageLayout>
...