Difference between revisions of "OtfWatchWindow"

From emotive
Jump to navigation Jump to search
Line 1: Line 1:
 
{{DISPLAYTITLE:Open Test Framework - Watch Window}}[[Category:OTF]]
 
{{DISPLAYTITLE:Open Test Framework - Watch Window}}[[Category:OTF]]
 
==Overview==
 
==Overview==
The '''Watch window''' allows for tracking and changing the values of declarations during runtime in the debug mode. This makes debugging some of the complex data types much easier. To track and change the value of a declaration when running in debug mode, you first have to add the declaration into the Watch window ,see guideline below. The Watch window stores all the monitored declarations of the solution. Depending on which procedure is being executed, the corresponding declarations are available for changing or not. The Watch window also allows you to copy the current value of the declaration during running the procedure in debug mode.
+
The '''Watch window''' allows for tracking and changing the values of declarations during runtime in the debug mode. This makes debugging some of the complex data types easier. To track and change the value of a declaration when running in debug mode, you first have to add the declaration into the Watch window, see [[#Tracking and changing the value of a declaration|guideline below]]. The Watch window stores all the monitored declarations of the solution. Depending on which procedure is being executed, the corresponding declarations are available for changing or not. The Watch window also allows you to copy the current value of the declaration during debugging.
  
The Watch is a tool window, so it can be docked, floating, opened, closed, resized or set to auto hide. When starting the OTF the first time, the Watch window is already opened and docked under the [[OtfWorkflowDesigner|designer]]. You can open or close it via the "'''Watch window'''" button ("[[File:Watch.png]]") in the [[OtfMenuBar|Ribbon]].
+
The Watch is a tool window, so it can be docked, floating, opened, closed, resized or set to auto hide. When starting the OTF the first time, the Watch window is already opened and docked under the [[OtfWorkflowDesigner|Workflow Designer]]. You can open or close it via the "'''Watch window'''" button ("[[File:Watch.png]]") in the [[OtfMenuBar|Ribbon]].
  
{{ImageStyleCenter|WatchWindow.png||Watch Window allows for monitoring and changing the value of a declaration during debugging.}}
+
{{ImageStyleCenter|WatchWindow.PNG|900|Watch Window allows for monitoring and changing the value of a declaration during debugging.}}
  
==Tracking and changing the values of a declaration==
+
==Tracking and changing the value of a declaration==
 
To track and change the value of a declaration, please proceed as follows:
 
To track and change the value of a declaration, please proceed as follows:
  
# Right-click on the declaration in the [[OtfDeclarationExplorer|declaration explorer]] tool window and select the menu "'''Add to Watch window'''".
+
# Right-click on the declaration in the [[OtfDeclarationExplorer|Declaration Explorer]] tool window and select the menu "'''Add to Watch window'''".
 
# Run the current procedure in debug mode (you can use "'''F11'''" key to step into each activity or use "'''F5'''" key to stop at each breakpoint).
 
# Run the current procedure in debug mode (you can use "'''F11'''" key to step into each activity or use "'''F5'''" key to stop at each breakpoint).
# When the workflow is halted by stepping into an activity or by a breakpoint, double-click on the "'''Value'''" cell in the row of the added declaration in the Watch window (or select the row and click on the "'''Change value'''" command).
+
# When the workflow is halted by stepping into an activity or by a breakpoint, double-click on the "'''Value'''" cell in the row of the corresponding declaration in the Watch window (or select the row and click on the "'''Change value'''" command).
# Input the new value corresponding to the data type of the declaration.
+
# Input the new value for the declaration.
 
# Press "'''ENTER'''" key or "'''TAB'''" key to set the changes.
 
# Press "'''ENTER'''" key or "'''TAB'''" key to set the changes.
 
# Continue the workflow (with "'''F11'''" key or "'''F5'''" key).
 
# Continue the workflow (with "'''F11'''" key or "'''F5'''" key).
# When the workflow is halted by stepping into an activity or by a breakpoint again, you can changes the value again or you can copy the current value of the declaration in the "'''Value'''" cell.
+
# When the workflow is halted by stepping into another activity or by another breakpoint again, you can changes the value again or you can copy the current value of the declaration in the "'''Value'''" cell.
 +
 
 +
{{Note|You can only change the value of the monitored declaration only if the workflow is halted by stepping into an activity or by a breakpoint. The changed value must be correct to the type of the monitored declaration; otherwise, a warning will occur and the changes will have no effect. You can add watch for a constant but you can not change its value during debugging.}}

Revision as of 07:14, 12 September 2014

Overview

The Watch window allows for tracking and changing the values of declarations during runtime in the debug mode. This makes debugging some of the complex data types easier. To track and change the value of a declaration when running in debug mode, you first have to add the declaration into the Watch window, see guideline below. The Watch window stores all the monitored declarations of the solution. Depending on which procedure is being executed, the corresponding declarations are available for changing or not. The Watch window also allows you to copy the current value of the declaration during debugging.

The Watch is a tool window, so it can be docked, floating, opened, closed, resized or set to auto hide. When starting the OTF the first time, the Watch window is already opened and docked under the Workflow Designer. You can open or close it via the "Watch window" button ("Watch.png") in the Ribbon.

WatchWindow.png
Watch Window allows for monitoring and changing the value of a declaration during debugging.

Tracking and changing the value of a declaration

To track and change the value of a declaration, please proceed as follows:

  1. Right-click on the declaration in the Declaration Explorer tool window and select the menu "Add to Watch window".
  2. Run the current procedure in debug mode (you can use "F11" key to step into each activity or use "F5" key to stop at each breakpoint).
  3. When the workflow is halted by stepping into an activity or by a breakpoint, double-click on the "Value" cell in the row of the corresponding declaration in the Watch window (or select the row and click on the "Change value" command).
  4. Input the new value for the declaration.
  5. Press "ENTER" key or "TAB" key to set the changes.
  6. Continue the workflow (with "F11" key or "F5" key).
  7. When the workflow is halted by stepping into another activity or by another breakpoint again, you can changes the value again or you can copy the current value of the declaration in the "Value" cell.
Icons Note.png You can only change the value of the monitored declaration only if the workflow is halted by stepping into an activity or by a breakpoint. The changed value must be correct to the type of the monitored declaration; otherwise, a warning will occur and the changes will have no effect. You can add watch for a constant but you can not change its value during debugging.