<?xml version="1.0" encoding="utf-8"?>
<ManualTopic ID="/baanerp/tg/onlinemanual/em000640" xml:lang="de">
   <Header>
      <Title>Wizards (tgwzr1500m000)</Title>
      <Keyword type="header" order="d1e2443267">
         <Level1>Wizards (tgwzr1500m000)</Level1>
      </Keyword>
   </Header>
   <GeneralSection>
      <Paragraph ID="tgwzr1500">The <GUIRef href="/baanerp/tg/wzr/tgwzr1500m000" role="session">Wizards (tgwzr1500m000)</GUIRef> session is used to create new wizards or to modify
		existing wizards. A wizard is used to group a number of wizard steps. The
		wizard does not contain any questions, but only shows a dialog box with an
		introductory text and, when finished, a dialog box with an end
		text.</Paragraph>
      <Paragraph>Like most model items, wizards are version
		dependent.</Paragraph>
      <List>
         <ListIntro>To create a wizard, complete the following steps:</ListIntro>
         <ListItem>In the <GUIRef href="/baanerp/tg/wzr/tgwzr1100s000#tgwzr100.wzrd" role="manual">Wizard</GUIRef> field, specify a name for the
		  wizard.</ListItem>
         <ListItem>If it is compulsory that the wizard is carried out in the
		  business function model, in the <GUIRef href="/baanerp/tg/wzr/tgwzr1100s000#tgwzr100.mand" role="manual">Mandatory</GUIRef> field, select the value <GUIRef href="/baanerp/tg/domains/yeno#yes" role="option">Yes</GUIRef>.</ListItem>
         <ListItem>In the <GUIRef href="/baanerp/tg/brg/tgbrg1100s000#tgbrg100.user" role="manual">Owner</GUIRef> field, select the LN user who created or
		  who is responsible for the wizard.</ListItem>
         <ListItem>Click <GUIRef href="/baanerp/tg/brg/tgbrg1110s000#exec.user.0" role="manual">Save</GUIRef>
         </ListItem>
      </List>
      <TABLE width="100%" border="1" space-and-orientation="indented-custom"
             borderstyle="default">
         <THEAD noTR="1">
            <TR no="1" isLast="true">
               <TD colspan="2" rowspan="1">Key fields for the <GUIRef href="/baanerp/tg/wzr/tgwzr1100s000" role="session">Wizards (tgwzr1100s000)</GUIRef> session</TD>
               <TH rowspan="1" colspan="1"> </TH>
            </TR>
         </THEAD>
         <TBODY noTR="6">
            <TR no="1" isLast="false">
               <TH rowspan="1" colspan="1">Field</TH>
               <TH rowspan="1" colspan="1">Description</TH>
               <TH rowspan="1" colspan="1"> </TH>
            </TR>
            <TR no="2" isLast="false">
               <TD rowspan="1" colspan="1">
                  <GUIRef href="/baanerp/tg/wzr/tgwzr1100s000#tgwzr100.icon" role="manual">Image</GUIRef>
               </TD>
               <TD rowspan="1" colspan="1">To illustrate the wizard, select a graphic representation shown
				in the Wizard dialog box.</TD>
               <TD rowspan="1" colspan="1"> </TD>
            </TR>
            <TR no="3" isLast="false">
               <TD rowspan="1" colspan="1">
                  <GUIRef href="/baanerp/tg/wzr/tgwzr1100s000#txta.yn" role="manual">Start Text</GUIRef>
               </TD>
               <TD colspan="2" rowspan="1">Starts the text editor so you can define the wizard
				start text. This text explains the function of the wizard, but does not ask any
				questions, because that is done in the individual wizard steps. If no start
				text has been defined, the first wizard step is directly shown when the wizard
				is carried out.</TD>
            </TR>
            <TR no="4" isLast="false">
               <TD rowspan="1" colspan="1">
                  <GUIRef href="/baanerp/tg/wzr/tgwzr1100s000#txtb.yn" role="manual">End Text</GUIRef>
               </TD>
               <TD colspan="2" rowspan="1">Starts the text editor so you can define the wizard
				end text. This text explains the result of the wizard or indicates you have
				completed all wizard steps.</TD>
            </TR>
            <TR no="5" isLast="false">
               <TD rowspan="1" colspan="1">
                  <GUIRef href="/baanerp/tg/wzr/tgwzr1100s000#txtn.yn" role="manual">Help Text</GUIRef>
               </TD>
               <TD colspan="2" rowspan="1">Starts the text editor so you can define the wizard
				Help text. This text explains the objective of the wizard.</TD>
            </TR>
            <TR no="6" isLast="true">
               <TD rowspan="1" colspan="1">
                  <GUIRef href="/baanerp/tg/wzr/tgwzr1100s000#exec.user.5" role="manual">Execute Wizard</GUIRef>
               </TD>
               <TD colspan="2" rowspan="1">Carries out the wizard without actually setting the
				parameter values</TD>
            </TR>
         </TBODY>
      </TABLE>
   </GeneralSection>
   <GeneralSection>
      <SectionTitle>Wizard Steps (tgwzr2500m000)</SectionTitle>
      <GeneralSection ID="wizard_steps">
         <Paragraph>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
		  a range of possible answers that can only be limited by the domain of the
		  parameter that must be set.</Paragraph>
         <Paragraph>To create new wizard steps or to modify existing steps, use
		  the <GUIRef href="/baanerp/tg/wzr/tgwzr2500m000" role="session">Wizard Steps (tgwzr2500m000)</GUIRef> session. Furthermore, this session can be used to
		  modify additional data related to the wizard steps.</Paragraph>
         <List>
            <ListIntro>There are two ways to create wizard steps:</ListIntro>
            <ListItem>
               <Paragraph>You can import parameters from the <GUIRef href="/baanerp/tg/brg/tgbrg9100m000" role="session">Parameters (tgbrg9100m000)</GUIRef> session. To select the parameters that must be set
				through one or more wizard steps, from the <Link href="/baanerp/tc/glossary/glossary#specific" role="glossary">Zusatzoptionen</Link> menu, select <GUIRef href="/baanerp/tg/wzr/tgwzr2500m000#exec.user.1" role="manual">Import Parameters</GUIRef>
               </Paragraph>
               <List>
                  <ListIntro>Next, a wizard step is created for each selected
				  parameter. If you use this option, the value of the following fields is set
				  automatically:</ListIntro>
                  <ListItem>
                     <GUIRef href="/baanerp/tg/brg/tgbrg2500m000#tgbrg200.desc" role="manual">Description</GUIRef>
                  </ListItem>
                  <ListItem>
                     <GUIRef href="/baanerp/tg/wms/tgwms1531m000#tgwms131.dnam" role="manual">Domain</GUIRef>
                  </ListItem>
                  <ListItem>
                     <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#default.value" role="manual">Default Answer</GUIRef>
                  </ListItem>
                  <ListItem>
                     <GUIRef href="/baanerp/tg/wzr/tgwzr1100s000#tgwzr100.mand" role="manual">Mandatory</GUIRef>
                  </ListItem>
                  <ListItem>
                     <GUIRef href="/baanerp/tg/wzr/tgwzr2500m000#txtv.yn" role="manual">Question Text</GUIRef>
                  </ListItem>
                  <ListItem>
                     <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#txtb.yn" role="manual">Apply Constraint</GUIRef>
                  </ListItem>
                  <ListItem>
                     <GUIRef href="/baanerp/tg/brg/tgbrg0112s000#txtn.yn" role="manual">Help text</GUIRef>
                  </ListItem>
               </List>
            </ListItem>
            <ListItem>You can define answers manually if you leave the <GUIRef href="/baanerp/tg/wms/tgwms1531m000#tgwms131.dnam" role="manual">Domain</GUIRef> field empty. In this case, you must define the
			 possible answers to the wizard question manually in the <GUIRef href="/baanerp/tg/wzr/tgwzr2120m000" role="session">Wizard Step Answers (tgwzr2120m000)</GUIRef> session.</ListItem>
         </List>
         <Note>
            <SectionTitle> Hinweis</SectionTitle>
            <Paragraph>It is recommended you use the first user-friendly option to
			 create consistent and correct wizard steps.</Paragraph>
         </Note>
      </GeneralSection>
      <GeneralSection>
         <List>
            <ListIntro>To manually create a wizard step:</ListIntro>
            <ListItem>From the <GUIRef href="/baanerp/tt/adv/ttadv2506s000" role="session">Sessions (ttadv2506s000)</GUIRef> session in the <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#tgwzr200.sesd" role="manual">Zoom/Browse Session</GUIRef> field, select a session, to which
			 you can zoom, and select a value from when you carry out the wizard.</ListItem>
            <ListItem>The values in the <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#tgwzr200.rfld" role="manual">Return Field</GUIRef> and the <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#tgwzr200.sfld" role="manual">Show Field</GUIRef> are defined automatically. The <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#tgwzr200.rfld" role="manual">Return Field</GUIRef> field is the value returned to the
			 parameter; for example, the employee code 1234. The <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#tgwzr200.sfld" role="manual">Show Field</GUIRef> field is the field displayed in the dialog
			 box to clarify the return field; for example, Mr. John Doe.</ListItem>
            <ListItem>In the <GUIRef href="/baanerp/tg/wms/tgwms1531m000#tgwms131.dnam" role="manual">Domain</GUIRef> field, specify the domain of the data that
			 must be returned to the parameter. A domain determines some characteristics of
			 the <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#tgwzr200.rfld" role="manual">Return Field</GUIRef> field, such as data type such as string
			 or integer, the length of the field, and allowed values. If answers are defined
			 manually, this field cannot be modified.</ListItem>
         </List>
         <TABLE width="100%" border="1" space-and-orientation="indented-custom"
                borderstyle="default">
            <THEAD noTR="1">
               <TR no="1" isLast="true">
                  <TD colspan="2" width="1022" rowspan="1">Key fields for the <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000" role="session">Wizard Steps (tgwzr2100s000)</GUIRef>
                  </TD>
               </TR>
            </THEAD>
            <TBODY noTR="9">
               <TR no="1" isLast="false">
                  <TH width="149" rowspan="1" colspan="1">Field</TH>
                  <TH width="869" rowspan="1" colspan="1">description</TH>
               </TR>
               <TR no="2" isLast="false">
                  <TD width="149" rowspan="1" colspan="1">
                     <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#tgwzr200.sess" role="manual">Session to start</GUIRef>
                  </TD>
                  <TD width="869" rowspan="1" colspan="1">Select a LN session that can be started from the wizard step.
				  This session must be a multi-occurrence session so an LN user can enter new
				  records.</TD>
               </TR>
               <TR no="3" isLast="false">
                  <TD width="149" rowspan="1" colspan="1">
                     <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#tgwzr200.proc" role="manual">Business Process to start</GUIRef>
                  </TD>
                  <TD width="869" rowspan="1" colspan="1">Select a business process that can be started from
				  the wizard step. This business process can be used to enter data by working
				  through the activities included in the business process.</TD>
               </TR>
               <TR no="4" isLast="false">
                  <TD width="149" rowspan="1" colspan="1">
                     <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#txtv.yn" role="manual">Question Text</GUIRef>
                  </TD>
                  <TD width="869" rowspan="1" colspan="1">Starts the text editor yo define the wizard step
				  question text.</TD>
               </TR>
               <TR no="5" isLast="false">
                  <TD width="149" rowspan="1" colspan="1">
                     <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#txtd.yn" role="manual">Wizard Constraint</GUIRef>
                  </TD>
                  <TD width="869" rowspan="1" colspan="1">Starts the text editor to define the wizard
				  constraints.</TD>
               </TR>
               <TR no="6" isLast="false">
                  <TD width="149" rowspan="1" colspan="1">
                     <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#txtb.yn" role="manual">Apply Constraint</GUIRef>
                  </TD>
                  <TD width="869" rowspan="1" colspan="1">Starts the text editor to define apply
				  constraints.</TD>
               </TR>
               <TR no="7" isLast="false">
                  <TD width="149" rowspan="1" colspan="1">
                     <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#txth.yn" role="manual">Hint Text</GUIRef>
                  </TD>
                  <TD width="869" rowspan="1" colspan="1">Starts the text editor to define the wizard step
				  hint text. Unlike the Help text, which gives a direct explanation, hint text
				  directs users to the answer by referring to examples from obvious common
				  practice.</TD>
               </TR>
               <TR no="8" isLast="false">
                  <TD width="149" rowspan="1" colspan="1">
                     <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#txtn.yn" role="manual">Help Text</GUIRef>
                  </TD>
                  <TD width="869" rowspan="1" colspan="1">Starts the text editor so you can define the wizard
				  step Help text. Help text is used to explain the question in more detail, or to
				  place the question in perspective to parts of the reference or project model.
				  It differs from hint text, which advises about possible answers.</TD>
               </TR>
               <TR no="9" isLast="true">
                  <TD width="149" rowspan="1" colspan="1">
                     <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#exec.user.9" role="manual">Execute Wizard Step</GUIRef>
                  </TD>
                  <TD width="869" rowspan="1" colspan="1">Carries out the wizard step.</TD>
               </TR>
            </TBODY>
         </TABLE>
      </GeneralSection>
   </GeneralSection>
   <GeneralSection>
      <SectionTitle>Wizard Step Answers (tgwzr2120m000)</SectionTitle>
      <Paragraph ID="tgwzr2120">To manually define answers for the wizard step,
		use the <GUIRef href="/baanerp/tg/wzr/tgwzr2120m000" role="session">Wizard Step Answers (tgwzr2120m000)</GUIRef> session.</Paragraph>
      <Paragraph ID="tgwzr2120_access">Usually, the possible answers are set
		automatically based on the domain linked to the parameter. However, if an
		answer results in setting several parameters, it is impossible to define just
		one domain for this step. Therefore, to access this session, the <GUIRef href="/baanerp/tg/wms/tgwms1531m000#tgwms131.dnam" role="manual">Domain</GUIRef> field in the <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000" role="session">Wizard Steps (tgwzr2100s000)</GUIRef> session should be left empty.</Paragraph>
      <List>
         <ListIntro>To make a wizard step that sets several parameters, use this
		  session to define the answers.</ListIntro>
         <ListItem>Click <GUIRef href="/baanerp/tg/wzr/tgwzr3400m000#aply.const.yn" role="manual">Apply Constraint</GUIRef> to start the text editor and define
		  what needs to be done for each possible answer.</ListItem>
         <ListItem>Because the <GUIRef href="/baanerp/tg/wms/tgwms1531m000#tgwms131.dnam" role="manual">Domain</GUIRef> field in the <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000" role="session">Wizard Steps (tgwzr2100s000)</GUIRef> session is empty, the domains for the parameters must
		  be included in the apply constraint.</ListItem>
      </List>
   </GeneralSection>
   <GeneralSection>
      <SectionTitle>Wizard Constraints</SectionTitle>
      <List>
         <ListIntro>To start the text editor and define a wizard constraint, in
		  the <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000" role="session">Wizard Steps (tgwzr2100s000)</GUIRef> session:</ListIntro>
         <ListItem>Click <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#txtd.yn" role="manual">Wizard Constraint</GUIRef>; alternatively, on the <Link href="/baanerp/tc/glossary/glossary#specific" role="glossary">Zusatzoptionen</Link> menu of the <GUIRef href="/baanerp/tg/wzr/tgwzr2500m000" role="session">Wizard Steps (tgwzr2500m000)</GUIRef> session, click <GUIRef href="/baanerp/tg/wzr/tgwzr2500m000#exec.user.4" role="manual">Edit Wizard Constraint</GUIRef>.</ListItem>
      </List>
      <GeneralSection ID="wizard_constraints">
         <Paragraph>Wizard constraints define which nonstandard actions must be
		  taken based on certain conditions. Therefore, a wizard constraint is only
		  necessary when the actions involve more than setting a parameter. For example,
		  If a certain question in a step is answered with <GUIRef href="/baanerp/tg/domains/yeno#yes" role="option">Yes</GUIRef>, another
		  nested wizard is started.</Paragraph>
         <Paragraph>Functions that are needed in wizard constraints can be
		  included using the <GUIRef href="/baanerp/tg/messages/brg71002" role="message">Use menu option Options - Start Zoomsession to zoom in rule condition</GUIRef> option in the text editor’s <GUIRef href="" role="menu">Optionen</GUIRef> menu.</Paragraph>
         <ExampleSection>
            <SectionTitle>Beispiel</SectionTitle>
            <Paragraph>
               <Code>IF answer = 10</Code>
            </Paragraph>
            <Paragraph>
               <Code>THEN</Code>
            </Paragraph>
            <Paragraph>
               <Code>Start. wizard ("demowiz1")</Code>
            </Paragraph>
            <Paragraph>
               <Code>ELSE</Code>
            </Paragraph>
            <Paragraph>
               <Code>Start. wizard ("demowiz2")</Code>
            </Paragraph>
            <Paragraph>
               <Code>ENDIF</Code>
            </Paragraph>
            <Paragraph>If the answer given to this wizard step is <Code>10</Code>, then demo wizard <Code>1</Code> is started. In case another answer is given, demo wizard <Code>2</Code> will be started.</Paragraph>
         </ExampleSection>
      </GeneralSection>
   </GeneralSection>
   <GeneralSection>
      <SectionTitle>Apply Constraints</SectionTitle>
      <List>
         <ListIntro>To activate the text editor and define the apply constraints
		  of the wizard step, in the <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000" role="session">Wizard Steps (tgwzr2100s000)</GUIRef> session:</ListIntro>
         <ListItem>Click <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#txtb.yn" role="manual">Apply Constraint</GUIRef>; alternatively, on the <Link href="/baanerp/tc/glossary/glossary#specific" role="glossary">Zusatzoptionen</Link> menu of the <GUIRef href="/baanerp/tg/wzr/tgwzr2500m000" role="session">Wizard Steps (tgwzr2500m000)</GUIRef> session, click <GUIRef href="/baanerp/tg/wzr/tgwzr2100s000#exec.user.5" role="manual">Edit Apply Constraint</GUIRef>.</ListItem>
      </List>
      <GeneralSection ID="apply_constraints">
         <Paragraph>Apply constraints define what must be done when you have
		  worked through the wizard steps and choose to apply the answers.</Paragraph>
         <Paragraph>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.</Paragraph>
         <Paragraph>The apply constraints are created automatically when
		  parameters are imported in the <GUIRef href="/baanerp/tg/wzr/tgwzr1100s000" role="session">Wizards (tgwzr1100s000)</GUIRef> session. If you have created the wizard step answers
		  manually, the apply constraints must be created manually.</Paragraph>
         <Paragraph>Functions needed in the apply constraints can be included
		  using the <GUIRef href="/baanerp/tg/messages/brg71002" role="message">Use menu option Options - Start Zoomsession to zoom in rule condition</GUIRef> option in
		  the text editor’s <GUIRef href="" role="menu">Optionen</GUIRef> menu.</Paragraph>
         <ExampleSection>
            <SectionTitle>Beispiel</SectionTitle>
            <Paragraph>
               <Code>IF answer = 10</Code>
            </Paragraph>
            <Paragraph>
               <Code>THEN fill. Parameter ("tdpur000.cspn.4", 950)</Code>
            </Paragraph>
            <Paragraph>
               <Code>| First position number for additional cost sets</Code>
            </Paragraph>
            <Paragraph>
               <Code>ENDIF</Code>
            </Paragraph>
            <Paragraph>
               <Code>IF answer = 20</Code>
            </Paragraph>
            <Paragraph>
               <Code>THEN fill. Parameter ("tdpur000.cspn.4", 900)</Code>
            </Paragraph>
            <Paragraph>
               <Code>ENDIF</Code>
            </Paragraph>
            <Paragraph>
               <Code>10</Code> and <Code>20</Code> are the sequence numbers of the answers. The parameters get the value <Code>950</Code> if the answer is <Code>10</Code>, and <Code>900</Code> if the answer is <Code>20</Code>.</Paragraph>
         </ExampleSection>
      </GeneralSection>
   </GeneralSection>
</ManualTopic>