Difference between revisions of "OtfExecution"

From emotive
Jump to navigation Jump to search
(Created page with "{{DISPLAYTITLE:Open Test Framework - Execution of Procedures}}Category:OTF == Overview == The OTF does not only support design time activities but it also supports runtime...")
 
Line 1: Line 1:
 
{{DISPLAYTITLE:Open Test Framework - Execution of Procedures}}[[Category:OTF]]
 
{{DISPLAYTITLE:Open Test Framework - Execution of Procedures}}[[Category:OTF]]
== Overview ==
+
== Introduction ==
The OTF does not only support design time activities but it also supports runtime very well. There are many ways to execute a procedure such as using shortcut keys, using command buttons in the [[OtfMenuBar|Ribbon menu]] or using [[OtfSolutionExplorer#Procedures|context menu]].
+
The OTF does not only support design time activities but it also supports runtime very well. Similar to some other IDEs, users can execute a test sequence with or without debugging. There are many ways to execute a procedure such as using shortcut keys, using command buttons in the [[OtfMenuBar|Ribbon menu]] or using [[OtfSolutionExplorer#Procedures|context menu]].
  
<!--
 
http://emotive.de/wiki/index.php?title=OtfSolutionExplorer#Procedures
 
 
A procedure opened?
 
 
The execution of a procedure
 
 
RRR Setting up before execution relates to the scopes to be executed, the platforms to execute and the modes of execution, which shall be mentioned below.
 
--!>
 
  
 
== Setting Up before Execution ==
 
== Setting Up before Execution ==
  
Setting up before execution relates to the scopes to be executed, the platforms to execute and the modes of execution.
+
Setting up before execution relates to &nbsp;''the scopes to be executed''&nbsp; and &nbsp;''the platforms to execute''&nbsp;.
  
  
 
=== Scopes of Execution ===
 
=== Scopes of Execution ===
Executing a procedure &nbsp;''with shortcut keys''&nbsp; or &nbsp;''with command buttons''&nbsp; depends on which scope selected in the "'''Execute Of'''" combo-box in the [[OtfMenuBar#"Runtime Environment" tab|"'''Runtime Environment'''"]] tab of the [[OtfMenuBar|Ribbon Menu]].  
+
{{Anchor|ExcScope|}}
 +
Executing a procedure [[#ExcBySKey|&nbsp;''with shortcut keys''&nbsp;]] or &nbsp;''with command buttons''&nbsp; depends on which scope selected in the "'''Execute Of'''" combo-box in the [[OtfMenuBar#"Runtime Environment" tab|"'''Runtime Environment'''"]] tab of the [[OtfMenuBar|Ribbon Menu]].  
  
 
There are 4 scopes of execution:
 
There are 4 scopes of execution:
 +
  
 
{|{{TableHeader}}
 
{|{{TableHeader}}
Line 45: Line 38:
 
# Use the "'''Target Platform'''" combo-box in the [[OtfSettings#"Runtime Environment" settings page|"'''Runtime Environment'''"]] settings page of the [[OtfSettings|OTF Settings]]
 
# Use the "'''Target Platform'''" combo-box in the [[OtfSettings#"Runtime Environment" settings page|"'''Runtime Environment'''"]] settings page of the [[OtfSettings|OTF Settings]]
  
 +
== Ways of Executing a Procedure ==
  
 +
There are 3 ways to execute a procedure: using shortcut keys, using command buttons in the [[OtfMenuBar|Ribbon menu]] or using [[OtfSolutionExplorer#Procedures|context menu]].
 +
 +
=== Using Shortcut Keys and Command Buttons===
 +
{{Anchor|ExcBySKey|}}
 +
Below are the Shortcut Keys with their function descriptions:
 +
 +
{|{{TableHeader}}
 +
|- style="background: gray; color: white; vertical-align:top;'''"
 +
| '''Command Button''' || '''Shortcut Key''' || '''Function'''
 +
|-{{TableRow2}}
 +
| Start || CTRL+F5 || Executes the procedure (see [[#ExcScope|execution scopes]]) without debbuging.
 +
|-{{TableRow1}}
 +
| Debug || F5 || Debugs the procedure (see [[#ExcScope|execution scopes]]). Executes from the beginning/current node and suspends the execution ''at the following node with breakpoint'' in the test sequence waiting until a debug command/key is clicked/pressed.
 +
|-{{TableRow2}}
 +
| Step Over{{TooltipIcon2|Debug mode only, it does not work if a procedure has been started without debugging, or the debugging are not suspended at a certain node.}} || F10 || Debugs the procedure (see [[#ExcScope|execution scopes]]). Executes from the beginning/current node (it does not step into called procedures) and suspends the execution ''at the adjacent node followed the current node'' waiting until a debug command/key is clicked/pressed. If there is a breakpoint inside the called procedure, it steps into the called procedure and suspends the execution at the node having breakpoint.
 +
|-{{TableRow1}}
 +
| Step To{{TooltipIcon2|Debug mode only, it does not work if a procedure has been started without debugging, or the debugging are not suspended at a certain node.}} || CTRL+F10 || Debugs the procedure (see [[#ExcScope|execution scopes]]). Executes from the beginning/current node and suspends the execution ''at the next selected node'' waiting until a debug command/key is clicked/pressed. If there is a breakpoint between the current point and the selected node, it suspends the execution at the node having breakpoint. If the selected node precedes the current point, it works the same as Debug button (F5) from the current point.
 +
|-{{TableRow2}}
 +
| Step In{{TooltipIcon2|Debug mode only, it does not work if a procedure has been started without debugging, or the debugging are not suspended at a certain node.}} || F11 || Debugs the procedure (see [[#ExcScope|execution scopes]]). Executes from the beginning/current node and suspends the execution ''at the adjacent node followed the current node'' waiting until a debug command/key is clicked/pressed. If the current point is a [[Core.Actions.ProcedureCall|ProcedureCall]], it steps into the called procedure and suspends the execution at the beginning node.
 +
|-{{TableRow1}}
 +
| Step Out{{TooltipIcon2|Debug mode only, it does not work if a procedure has been started without debugging, or the debugging are not suspended at a certain node.}} || SHIFT+F11 || Debugs the procedure (see [[#ExcScope|execution scopes]]). Steps out (executes all remaining nodes of) the called procedure from the current point and suspends at the corresponding [[Core.Actions.ProcedureCall|ProcedureCall]] waiting until a debug command/key is clicked/pressed. It is only active if the execution is being suspended at a node in a called procedure.
 +
|}
 +
 +
<!--
 
=== Modes of Execution ===
 
=== Modes of Execution ===
  
Line 57: Line 75:
  
  
<!--
+
 
 
To execute a procedure without debugging, you shall use the following shortcut keys and command buttons:
 
To execute a procedure without debugging, you shall use the following shortcut keys and command buttons:
  
Line 70: Line 88:
  
 
== Using Command Buttons in the Ribbon Menu ==
 
== Using Command Buttons in the Ribbon Menu ==
 +
 +
{{TooltipIcon2|A procedure opened?
 +
 +
The execution of a procedure
 +
 +
RRR Setting up before execution relates to the scopes to be executed, the platforms to execute and the modes of execution, which shall be mentioned below.}}
 
--!>
 
--!>

Revision as of 11:41, 28 August 2018

Introduction

The OTF does not only support design time activities but it also supports runtime very well. Similar to some other IDEs, users can execute a test sequence with or without debugging. There are many ways to execute a procedure such as using shortcut keys, using command buttons in the Ribbon menu or using context menu.


Setting Up before Execution

Setting up before execution relates to  the scopes to be executed  and  the platforms to execute .


Scopes of Execution

Executing a procedure  with shortcut keys  or  with command buttons  depends on which scope selected in the "Execute Of" combo-box in the "Runtime Environment" tab of the Ribbon Menu.

There are 4 scopes of execution:


Scope Description
Solution It shall execute the procedure main of the Startup Document in the Startup Project of the Solution.
Current Project It shall execute the procedure main of the Startup Document in the current Project (of the current opened procedure tab or OTL tab).
Current Document It shall execute the procedure main of the current Document (of the current opened procedure tab or OTL tab).
Current Procedure It shall execute the current opened procedure. This scope has no effect when an OTL tab is currently opened.


Platform to Execute

The OTF runtime supports to execute with Dotnet platform or Java platform. There are many ways to change the execution platform:

  1. Use the "Target Platform" combo-box in the "Status Bar"
  2. Use the "Target Platform" combo-box in the "Runtime Environment" tab of the Ribbon Menu
  3. Use the "Target Platform" combo-box in the "Runtime Environment" settings page of the OTF Settings

Ways of Executing a Procedure

There are 3 ways to execute a procedure: using shortcut keys, using command buttons in the Ribbon menu or using context menu.

Using Shortcut Keys and Command Buttons

Below are the Shortcut Keys with their function descriptions:

Command Button Shortcut Key Function
Start CTRL+F5 Executes the procedure (see execution scopes) without debbuging.
Debug F5 Debugs the procedure (see execution scopes). Executes from the beginning/current node and suspends the execution at the following node with breakpoint in the test sequence waiting until a debug command/key is clicked/pressed.
Step OverExclamation.png F10 Debugs the procedure (see execution scopes). Executes from the beginning/current node (it does not step into called procedures) and suspends the execution at the adjacent node followed the current node waiting until a debug command/key is clicked/pressed. If there is a breakpoint inside the called procedure, it steps into the called procedure and suspends the execution at the node having breakpoint.
Step ToExclamation.png CTRL+F10 Debugs the procedure (see execution scopes). Executes from the beginning/current node and suspends the execution at the next selected node waiting until a debug command/key is clicked/pressed. If there is a breakpoint between the current point and the selected node, it suspends the execution at the node having breakpoint. If the selected node precedes the current point, it works the same as Debug button (F5) from the current point.
Step InExclamation.png F11 Debugs the procedure (see execution scopes). Executes from the beginning/current node and suspends the execution at the adjacent node followed the current node waiting until a debug command/key is clicked/pressed. If the current point is a ProcedureCall, it steps into the called procedure and suspends the execution at the beginning node.
Step OutExclamation.png SHIFT+F11 Debugs the procedure (see execution scopes). Steps out (executes all remaining nodes of) the called procedure from the current point and suspends at the corresponding ProcedureCall waiting until a debug command/key is clicked/pressed. It is only active if the execution is being suspended at a node in a called procedure.