Adding Validation Scripts to your Plugin
Note: The steps described here are part of whole process of creating a Plugin. This process is described in full in the Roadmap.
A Validation Script is a script written in the SerioScript language which tests the value of an SNMP Variable and takes actions such as triggering Responses or setting the Device Status to Red or Amber.
Tip: See the standard Plugins provided with Serio IT Service View for examples of Validation Scripts.
To add a Validation Script to your Plugin,
Right click on your Plugin in the left pane of Serio IT Service View and choose 'View/Amend Plugin'.
Each Validation Script is linked to one of the SNMP Variables read from the device. These are listed in the left pane of the Plugin Editor dialog. Clicking on one of these SNMP Variables shows a description of the variable in the pane below.
Tip: SNMP Variables which already have a Validation Script linked to them are marked with a blue tick. For examples of Validation Scripts, see the standard Plugins provided with Serio IT Service View. Within the Plugin Editor Dialog, right click on an SNMP Variable with tick already marked against it, and choose 'Amend Validation Statements'.
Right click the SNMP Variable you are interested in adding a Validation Script to, and choose 'Add Validation Statements'.
In the 'Edit Validation Statements' dialog, enter your Validation Script in the SerioScript language. Use the Validation Scripts provided with the standard Plugins as well as the Plugin Function Reference to help you.
Tip: Some useful SerioScript functions for your Validation Script are:
doResponse – triggers one of the Responses you have defined for your Plugin.
updateCCDisplay – changes the Device Status of the Device.
updateCCLog – adds a message to the Online Log.
Once you have completed your Validation Script press Ctrl+L to check it compiles. Then click 'Ok' to close the 'Edit Validation Statements' dialog.
When finished adding Validation Statements, click 'Save and Close' to save your changes.