Navigation can be added to steps using commands. The following commands are used for navigation in a step:
NEXT_STEP
—Process the next step in the step list.REDO_STEP
—Process the current step again, using default values.PREVIOUS_STEP
—Process the previous step in the step list.GOTO_STEP
—Process the step given in the requiredtargetId
attribute. Requiresvalue="step ID to go to"
.REDO_INPUT
—Causes CIM to re-render the last label and input request. Can only be used in the POSTINPUT phase of an input validator.PROCESS_COMPLETE
—Notifies CIM that a process has been completed.QUIT
—Shut down CIM with no saving of data.
The following example shows how you can use navigation commands along with task commands in your steps:
<step id="FirstStep"> <title>First Step</title> <detail>Details of the first step: Demonstrates simple navigation </detail> <navoption> <option default="true"> <label>Next Step</label> <command type="EXECUTE_STEP_TASKS" /> <command type="NEXT_STEP" /> </option> <option > <label>Redo Step</label> <command type="DROP_STEP_TASKS" /> <command type="REDO_STEP" /> </option> <option > <label>Jump to [T]hird Step</label> <command type="DROP_STEP_TASKS" /> <command type="GOTO_STEP" value="ThirdStep" /> </option> <option > <label>Jump to [F]ourth Step</label> <command type="DROP_STEP_TASKS" /> <command type="GOTO_STEP" value="FourthStep" /> </option> </navoption> </step>
Note that when adding navigation options, you should surround the hot-key letter with brackets:
Load [W]izard.
If no brackets are present, CIM automatically designates the first letter as the hot key. CIM will throw a runtime error if a single step includes multiple equivalent hotkeys.