Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Section
Column
width600px

Action Output Monitors allow you to automatically scan an action's output for certain content, and perform various actions if that content is found. For example, you can have an action fail if text like "warning" is found - even though normally that action would succeed.

Only output created while the action is running is monitored - output from the BeforeAction and AfterAction script events is not monitored.

To edit Action Output Monitors, go to

...

the Runtime property page

...

 and click on the ellipsis (...) edit button for Output Monitors.

Image Modified

Column
width300px
Panel
borderColor#D8D8D8
bgColor#FFFFFF
titleColor#FFFFFF
titleBGColor#006396
borderWidth1
titleOn this page:
borderStylesolid

Table of Contents
maxLevel3
minLevel2
printablefalse
 

Column

 

 

  • Click the "Add New Output Monitor" button to add an output monitor to the action. There is no limit on the number of monitors an action can have. All output monitors operate independently of each other.
  • Click "Remove Monitor" to remove a monitor from the action.

...

Monitors

Search String

This is the string to search for in the action output. In the example above, the monitor will match any line that contains the string "Warning :".

...

The total number of matching lines will be written to a variable.

Note
* Using Multiple Monitors multiple monitors with Failfail/Succeedsucceed

If there are multiple monitors which force the action to both fail and succeed, and both find matches in the action is output, then the monitors are applied in the order they are shown in the dialog box, ie if a "Succeed" monitor is triggered followed by a "Fail" monitor, the action will fail. The action log output will show the status of both monitors, in order.

The AfterAction script event has the opportunity to futher modify the action result.

Note
Monitors Are Applied Liveare applied live

Monitoring is applied to the output immediately as it is received from the action, before the OnStatusMessage script event. However, results (like setting variables) are not applied until the action finishes running. If you use variable references in the search string, be aware that the variable values may change as the action runs.