Difference between revisions of "OtfWatchWindow"
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 | + | 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| | + | 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. | + | {{ImageStyleCenter|WatchWindow.PNG|900|Watch Window allows for monitoring and changing the value of a declaration during debugging.}} |
− | ==Tracking and changing the | + | ==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| | + | # 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 | + | # 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 | + | # 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 | + | # 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 ("") in the Ribbon.
![]() |
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:
- Right-click on the declaration in the 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).
- 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 for the declaration.
- Press "ENTER" key or "TAB" key to set the changes.
- Continue the workflow (with "F11" key or "F5" key).
- 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.