Difference between revisions of "Form Begin"

From SAP Enable Now Wiki
(Created page with "__NOTOC__ ==Scope== * '''Simulation''' content object > '''Form Begin''' macro ==Purpose== The '''Form Begin''' identifies the start of a set of ''input'' macros (and one...")
 
 
(3 intermediate revisions by the same user not shown)
Line 4: Line 4:
  
 
==Purpose==
 
==Purpose==
The '''Form Begin''' identifies the start of a set of ''input'' macros (and one '''[[Mouse Action]]''' macro) that are to be presented to the user (in [[Practice mode]] and [[Test mode]]) at the same time, and with a single Bubble. There must be a corresponding '''[[Form End]]''' macro within the same [[Step]] that identifies the end of the set.
+
The '''Form Begin''' macro identifies the start of a set of ''input'' macros (and a '''[[Mouse Action (Simulation macro)|Mouse Action]]''' or '''[[Key-Stroke]]''' macro) that are to be presented to the user (in [[Practice mode]] and [[Test mode]]) at the same time, and with a single Bubble. There must be a corresponding '''[[Form End]]''' macro within the same [[Step]] that identifies the end of the set.
  
A ''Form Structure'' allows users to complete all of the input fields within the Form Structure in any order. Validation of the users input will not be performed until the '''[[Mouse Action]]''' within the Form Structure is executed. There can be only one '''[[Mouse Action]]''' macro within the Form Structure, and this must be the last macro in the structure.
+
A ''Form Structure'' allows users to complete all of the input fields within the Form Structure in any order. Validation of the users input will not be performed until a '''[[Mouse Action (Simulation macro)|Mouse Action]]''' or '''[[Key-Stroke]]''' within the Form Structure is executed. You can have multiple '''[[Mouse Action (Simulation macro)|Mouse Action]]''' macros and/or multiple '''[[Key-Stroke]]''' macros within the Form Structure, and these can be in any order (including before or inbetween the ''input'' macros), but the user will only need to perform one of these to validate their input and continue.
  
 
==Use==
 
==Use==
To insert a Form Structure, click on the [[Step]] within which you want to insert the Form Structure, and then select menu option '''Insert > Insert Special Macro > Insert Form Structure'''. A '''Form Begin''' macro is inserted into the [[Step]] immediately after the '''[[Screen]]''' macro, and a '''[[Form End]]''' macro is inserted as the last macro in the [[Step]], so that all other macros fall between these two macros. You can drag macros in and out of the Form Structure, but ultimately the Form Structure must contain a number of ''input'' macros ('''[[Input Text]]''', '''[[Select Single]]''', '''[[Radio/Checkbox]]''', '''[[Key-Stroke]]''') and a single '''[[Mouse Action]]''' macro. Do not include any '''[[Explanation]]''' macros within the Form Structure as these will interfere with its functioning.
+
To insert a Form Structure, click on the [[Step]] within which you want to insert the Form Structure, and then select menu option '''Insert > Insert Special Macro > Insert Form Structure'''. A '''Form Begin''' macro is inserted into the [[Step]] immediately after the '''[[Screen]]''' macro, and a '''[[Form End]]''' macro is inserted as the last macro in the [[Step]], so that all other macros fall between these two macros. You can drag macros in and out of the Form Structure, but ultimately the Form Structure must contain a number of ''input'' macros ('''[[Input Text]]''', '''[[Select Single]]''', '''[[Radio/Checkbox]]''', '''[[Key-Stroke]]''') and a single '''[[Mouse Action (Simulation macro)|Mouse Action]]''' macro. Do not include any '''[[Explanation]]''' macros within the Form Structure as these will interfere with its functioning.
  
 
==Properties==
 
==Properties==

Latest revision as of 19:35, 26 April 2021

Scope

Purpose

The Form Begin macro identifies the start of a set of input macros (and a Mouse Action or Key-Stroke macro) that are to be presented to the user (in Practice mode and Test mode) at the same time, and with a single Bubble. There must be a corresponding Form End macro within the same Step that identifies the end of the set.

A Form Structure allows users to complete all of the input fields within the Form Structure in any order. Validation of the users input will not be performed until a Mouse Action or Key-Stroke within the Form Structure is executed. You can have multiple Mouse Action macros and/or multiple Key-Stroke macros within the Form Structure, and these can be in any order (including before or inbetween the input macros), but the user will only need to perform one of these to validate their input and continue.

Use

To insert a Form Structure, click on the Step within which you want to insert the Form Structure, and then select menu option Insert > Insert Special Macro > Insert Form Structure. A Form Begin macro is inserted into the Step immediately after the Screen macro, and a Form End macro is inserted as the last macro in the Step, so that all other macros fall between these two macros. You can drag macros in and out of the Form Structure, but ultimately the Form Structure must contain a number of input macros (Input Text, Select Single, Radio/Checkbox, Key-Stroke) and a single Mouse Action macro. Do not include any Explanation macros within the Form Structure as these will interfere with its functioning.

Properties

See Also