Wizards (tgwzr1500m000)

The Wizards (tgwzr1500m000) session is used to create new wizards or to modify existing wizards. A wizard is used to group several wizard steps. The wizard does not contain any questions. It only shows a dialog box with an introductory text and, when finished, a dialog box with an end text. The questions can be found in the wizard steps of the wizard.

Like most model items, wizards are version dependent.

To create a wizard:

• In the Wizard field, specify a name for the wizard.
• If it is compulsory that the wizard is carried out in the business function model, in the Mandatory field, select the value Yes.
• In the Owner field, select the LN user who created or who is responsible for the wizard.
• Click Save

This table shows the key fields of the Wizards (tgwzr1100s000) session:

Wizard Steps (tgwzr2500m000)

The wizard steps are used to ask questions and to receive input. A wizard can have multiple wizard steps. Each step has one question and can have a range of possible answers. That range can only be limited by the domain of the parameter that must be set. Or you are referred to an LN session that must be executed.

To create new wizard steps or to modify existing steps, use the Wizard Steps (tgwzr2500m000) session. This session can be used to modify additional data that is related to the wizard steps.

There are two ways to create wizard steps:

• You can import parameters from the Parameters (tgbrg9100m000) session. To select the parameters that must be set through one or more wizard steps, from the appropriate menu, select Import Parameters

  Next, a wizard step is created for each selected parameter. If you use this option, the value is set automatically of these fields:

  • Description
  • Domain
  • Default Answer
  • Mandatory
  • Question Text
  • Apply Constraint
  • Help text
• You can define answers manually if you leave the Domain field blank. In this case, you must define the possible answers to the wizard question manually in the Wizard Step Answers (tgwzr2120m000) session.

To manually create a wizard step:

• From the Sessions (ttadv2506s000) session in the Zoom/Browse Session field, select a session, to which you can zoom. Select a value from when you carry out the wizard.
• The values in the Return Field and the Show Field are defined automatically. The Return Field field is the value returned to the parameter; for example, the employee code 1234. The Show Field field is the field displayed in the dialog box to clarify the return field; for example, Mr. John Doe.
• In the Domain field, specify the domain of the data that must be returned to the parameter. A domain determines some characteristics of the Return Field field, such as data type, string or integer, the length of the field, and allowed values. If answers are defined manually, this field cannot be modified.

This table shows the key fields of the Wizard Steps (tgwzr2100s000) session:

Wizard Step Answers (tgwzr2120m000)

To manually define answers for the wizard step, use the Wizard Step Answers (tgwzr2120m000) session.

Usually, the possible answers are set automatically based on the domain that is linked to the parameter. But if an answer results in setting several parameters, you cannot define one domain for this step. Therefore, to access this session, the Domain field in the Wizard Steps (tgwzr2100s000) session must be left blank.

To make a wizard step that sets several parameters, use this session to specify the answers.

• Click Apply Constraint to start the text editor and define what must be done for each possible answer.
• Because the Domain field in the Wizard Steps (tgwzr2100s000) session is blank, the domains for the parameters must be included in the apply constraint.

Wizard Constraints

To start the text editor and define a wizard constraint, in the Wizard Steps (tgwzr2100s000) session:

• Click Wizard Constraint; alternatively, on the appropriate menu of the Wizard Steps (tgwzr2500m000) session, click Edit Wizard Constraint.

Wizard constraints define which nonstandard actions must be taken based on certain conditions. Therefore, a wizard constraint is only required when the actions involve more than setting a parameter. For example, if a certain question in a step is answered with Yes, another nested wizard is started.

Functions that are required in wizard constraints can be included using the Use menu option Options - Start Zoomsession to zoom in rule condition option in the text editor’s Options menu.

Apply Constraints

To activate the text editor and define the apply constraints of the wizard step, in the Wizard Steps (tgwzr2100s000) session:

• Click Apply Constraint; alternatively, on the appropriate menu of the Wizard Steps (tgwzr2500m000) session, click Edit Apply Constraint.

Apply constraints define what must be done when you have worked through the wizard steps and choose to apply the answers.

Wizard step answers can be applied in the business function model of a project model. When you have answered all wizard steps, the question is asked if the answers you have given must be applied based on certain conditions.

The apply constraints are created automatically when parameters are imported in the Wizards (tgwzr1100s000) session. If you have created the wizard step answers manually, the apply constraints must be created manually.

Functions that are needed in the apply constraints can be included using the Use menu option Options - Start Zoomsession to zoom in rule condition option in the text editor’s Options menu.